diff --git a/.github/workflows/update-chart.yml b/.github/workflows/update-chart.yml deleted file mode 100644 index 2ff7a1248d..0000000000 --- a/.github/workflows/update-chart.yml +++ /dev/null @@ -1,24 +0,0 @@ -on: - push: {branches: ['3.11']} - workflow_dispatch: -jobs: - update-chart: - runs-on: ubuntu-latest - steps: - - uses: actions/setup-python@master - with: - python-version: 3 - - run: pip install gitpython matplotlib - - uses: actions/checkout@master - with: - ref: '3.11' - fetch-depth: 0 - - run: python update_switcher_chart.py - - run: git config --local user.email github-actions@github.com - - run: git config --local user.name "GitHub Action's update-chart job" - - run: git add . - - run: git commit -m 'Update language switcher progress chart' || return 0 - - uses: ad-m/github-push-action@master - with: - branch: '3.11' - github_token: ${{ secrets.GITHUB_TOKEN }} diff --git a/.github/workflows/update-lint-and-build.yml b/.github/workflows/update-lint-and-build.yml index 210855fc5c..7205dfff9f 100644 --- a/.github/workflows/update-lint-and-build.yml +++ b/.github/workflows/update-lint-and-build.yml @@ -19,7 +19,7 @@ jobs: with: python-version: 3 - run: sudo apt-get install -y gettext - - run: pip install requests cogapp polib + - run: pip install requests cogapp polib transifex-python - uses: actions/checkout@master with: ref: ${{ matrix.version }} diff --git a/.tx/config b/.tx/config index e567d04e89..736a54391b 100644 --- a/.tx/config +++ b/.tx/config @@ -1,2507 +1,4503 @@ [main] host = https://www.transifex.com -[o:python-doc:p:python-newest:r:about] -file_filter = about.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:bugs] -file_filter = bugs.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--abstract] -file_filter = c-api/abstract.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--allocation] -file_filter = c-api/allocation.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--apiabiversion] -file_filter = c-api/apiabiversion.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--arg] -file_filter = c-api/arg.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--bool] -file_filter = c-api/bool.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--buffer] -file_filter = c-api/buffer.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--bytearray] -file_filter = c-api/bytearray.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--bytes] -file_filter = c-api/bytes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--call] -file_filter = c-api/call.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--capsule] -file_filter = c-api/capsule.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--cell] -file_filter = c-api/cell.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--code] -file_filter = c-api/code.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--codec] -file_filter = c-api/codec.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--complex] -file_filter = c-api/complex.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--concrete] -file_filter = c-api/concrete.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--contextvars] -file_filter = c-api/contextvars.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--conversion] -file_filter = c-api/conversion.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--coro] -file_filter = c-api/coro.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--datetime] -file_filter = c-api/datetime.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--descriptor] -file_filter = c-api/descriptor.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--dict] -file_filter = c-api/dict.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--exceptions] -file_filter = c-api/exceptions.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--file] -file_filter = c-api/file.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--float] -file_filter = c-api/float.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--frame] -file_filter = c-api/frame.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--function] -file_filter = c-api/function.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--gcsupport] -file_filter = c-api/gcsupport.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--gen] -file_filter = c-api/gen.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--import] -file_filter = c-api/import.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--index] -file_filter = c-api/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--init] -file_filter = c-api/init.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--init_config] -file_filter = c-api/init_config.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--intro] -file_filter = c-api/intro.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--iter] -file_filter = c-api/iter.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--iterator] -file_filter = c-api/iterator.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--list] -file_filter = c-api/list.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--long] -file_filter = c-api/long.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--mapping] -file_filter = c-api/mapping.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--marshal] -file_filter = c-api/marshal.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--memory] -file_filter = c-api/memory.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--memoryview] -file_filter = c-api/memoryview.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--method] -file_filter = c-api/method.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--module] -file_filter = c-api/module.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--none] -file_filter = c-api/none.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--number] -file_filter = c-api/number.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--objbuffer] -file_filter = c-api/objbuffer.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--object] -file_filter = c-api/object.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--objimpl] -file_filter = c-api/objimpl.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--refcounting] -file_filter = c-api/refcounting.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--reflection] -file_filter = c-api/reflection.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--sequence] -file_filter = c-api/sequence.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--set] -file_filter = c-api/set.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--slice] -file_filter = c-api/slice.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--stable] -file_filter = c-api/stable.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--structures] -file_filter = c-api/structures.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--sys] -file_filter = c-api/sys.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--tuple] -file_filter = c-api/tuple.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--type] -file_filter = c-api/type.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--typehints] -file_filter = c-api/typehints.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--typeobj] -file_filter = c-api/typeobj.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--unicode] -file_filter = c-api/unicode.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--utilities] -file_filter = c-api/utilities.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--veryhigh] -file_filter = c-api/veryhigh.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:c-api--weakref] -file_filter = c-api/weakref.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:contents] -file_filter = contents.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:copyright] -file_filter = copyright.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distributing--index] -file_filter = distributing/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--apiref] -file_filter = distutils/apiref.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--builtdist] -file_filter = distutils/builtdist.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--commandref] -file_filter = distutils/commandref.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--configfile] -file_filter = distutils/configfile.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--examples] -file_filter = distutils/examples.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--extending] -file_filter = distutils/extending.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--index] -file_filter = distutils/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--introduction] -file_filter = distutils/introduction.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--packageindex] -file_filter = distutils/packageindex.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--setupscript] -file_filter = distutils/setupscript.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--_setuptools_disclaimer] -file_filter = distutils/_setuptools_disclaimer.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--sourcedist] -file_filter = distutils/sourcedist.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:distutils--uploading] -file_filter = distutils/uploading.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:extending--building] -file_filter = extending/building.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:extending--embedding] -file_filter = extending/embedding.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:extending--extending] -file_filter = extending/extending.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:extending--index] -file_filter = extending/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:extending--newtypes] -file_filter = extending/newtypes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:extending--newtypes_tutorial] -file_filter = extending/newtypes_tutorial.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:extending--windows] -file_filter = extending/windows.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--design] -file_filter = faq/design.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--extending] -file_filter = faq/extending.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--general] -file_filter = faq/general.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--gui] -file_filter = faq/gui.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--index] -file_filter = faq/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--installed] -file_filter = faq/installed.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--library] -file_filter = faq/library.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--programming] -file_filter = faq/programming.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:faq--windows] -file_filter = faq/windows.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:glossary_] -file_filter = glossary.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--annotations] -file_filter = howto/annotations.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--argparse] -file_filter = howto/argparse.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--clinic] -file_filter = howto/clinic.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--cporting] -file_filter = howto/cporting.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--curses] -file_filter = howto/curses.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--descriptor] -file_filter = howto/descriptor.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--enum] -file_filter = howto/enum.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--functional] -file_filter = howto/functional.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--index] -file_filter = howto/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--instrumentation] -file_filter = howto/instrumentation.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--ipaddress] -file_filter = howto/ipaddress.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--isolating-extensions] -file_filter = howto/isolating-extensions.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--logging] -file_filter = howto/logging.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--logging-cookbook] -file_filter = howto/logging-cookbook.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--pyporting] -file_filter = howto/pyporting.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--regex] -file_filter = howto/regex.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--sockets] -file_filter = howto/sockets.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--sorting] -file_filter = howto/sorting.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--unicode] -file_filter = howto/unicode.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:howto--urllib2] -file_filter = howto/urllib2.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:includes--wasm-notavail] -file_filter = includes/wasm-notavail.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:install--index] -file_filter = install/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:installing--index] -file_filter = installing/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--2to3] -file_filter = library/2to3.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--abc] -file_filter = library/abc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--aifc] -file_filter = library/aifc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--allos] -file_filter = library/allos.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--archiving] -file_filter = library/archiving.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--argparse] -file_filter = library/argparse.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--array] -file_filter = library/array.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ast] -file_filter = library/ast.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asynchat] -file_filter = library/asynchat.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio] -file_filter = library/asyncio.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-api-index] -file_filter = library/asyncio-api-index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-dev] -file_filter = library/asyncio-dev.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-eventloop] -file_filter = library/asyncio-eventloop.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-exceptions] -file_filter = library/asyncio-exceptions.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-extending] -file_filter = library/asyncio-extending.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-future] -file_filter = library/asyncio-future.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-llapi-index] -file_filter = library/asyncio-llapi-index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-platforms] -file_filter = library/asyncio-platforms.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-policy] -file_filter = library/asyncio-policy.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-protocol] -file_filter = library/asyncio-protocol.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-queue] -file_filter = library/asyncio-queue.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-runner] -file_filter = library/asyncio-runner.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-stream] -file_filter = library/asyncio-stream.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-subprocess] -file_filter = library/asyncio-subprocess.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-sync] -file_filter = library/asyncio-sync.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncio-task] -file_filter = library/asyncio-task.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--asyncore] -file_filter = library/asyncore.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--atexit] -file_filter = library/atexit.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--audioop] -file_filter = library/audioop.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--audit_events] -file_filter = library/audit_events.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--base64] -file_filter = library/base64.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--bdb] -file_filter = library/bdb.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--binary] -file_filter = library/binary.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--binascii] -file_filter = library/binascii.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--binhex] -file_filter = library/binhex.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--bisect] -file_filter = library/bisect.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--builtins] -file_filter = library/builtins.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--bz2] -file_filter = library/bz2.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--calendar] -file_filter = library/calendar.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--cgi] -file_filter = library/cgi.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--cgitb] -file_filter = library/cgitb.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--chunk] -file_filter = library/chunk.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--cmath] -file_filter = library/cmath.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--cmd] -file_filter = library/cmd.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--code] -file_filter = library/code.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--codecs] -file_filter = library/codecs.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--codeop] -file_filter = library/codeop.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--collections] -file_filter = library/collections.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--collections_abc] -file_filter = library/collections_abc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--colorsys] -file_filter = library/colorsys.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--compileall] -file_filter = library/compileall.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--concurrency] -file_filter = library/concurrency.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--concurrent] -file_filter = library/concurrent.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--concurrent_futures] -file_filter = library/concurrent_futures.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--configparser] -file_filter = library/configparser.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--constants] -file_filter = library/constants.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--contextlib] -file_filter = library/contextlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--contextvars] -file_filter = library/contextvars.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--copy] -file_filter = library/copy.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--copyreg] -file_filter = library/copyreg.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--crypt] -file_filter = library/crypt.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--crypto] -file_filter = library/crypto.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--csv] -file_filter = library/csv.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ctypes] -file_filter = library/ctypes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--curses] -file_filter = library/curses.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--curses_ascii] -file_filter = library/curses_ascii.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--curses_panel] -file_filter = library/curses_panel.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--custominterp] -file_filter = library/custominterp.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--dataclasses] -file_filter = library/dataclasses.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--datatypes] -file_filter = library/datatypes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--datetime] -file_filter = library/datetime.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--dbm] -file_filter = library/dbm.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--debug] -file_filter = library/debug.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--decimal] -file_filter = library/decimal.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--development] -file_filter = library/development.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--devmode] -file_filter = library/devmode.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--dialog] -file_filter = library/dialog.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--difflib] -file_filter = library/difflib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--dis] -file_filter = library/dis.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--distribution] -file_filter = library/distribution.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--distutils] -file_filter = library/distutils.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--doctest] -file_filter = library/doctest.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email] -file_filter = library/email.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_charset] -file_filter = library/email_charset.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_compat32-message] -file_filter = library/email_compat32-message.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_contentmanager] -file_filter = library/email_contentmanager.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_encoders] -file_filter = library/email_encoders.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_errors] -file_filter = library/email_errors.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_examples] -file_filter = library/email_examples.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_generator] -file_filter = library/email_generator.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_header] -file_filter = library/email_header.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_headerregistry] -file_filter = library/email_headerregistry.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_iterators] -file_filter = library/email_iterators.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_message] -file_filter = library/email_message.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_mime] -file_filter = library/email_mime.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_parser] -file_filter = library/email_parser.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_policy] -file_filter = library/email_policy.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--email_utils] -file_filter = library/email_utils.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ensurepip] -file_filter = library/ensurepip.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--enum] -file_filter = library/enum.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--errno] -file_filter = library/errno.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--exceptions] -file_filter = library/exceptions.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--faulthandler] -file_filter = library/faulthandler.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--fcntl] -file_filter = library/fcntl.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--filecmp] -file_filter = library/filecmp.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--fileformats] -file_filter = library/fileformats.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--fileinput] -file_filter = library/fileinput.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--filesys] -file_filter = library/filesys.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--fnmatch] -file_filter = library/fnmatch.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--fractions] -file_filter = library/fractions.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--frameworks] -file_filter = library/frameworks.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ftplib] -file_filter = library/ftplib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--functional] -file_filter = library/functional.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--functions] -file_filter = library/functions.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--functools] -file_filter = library/functools.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--__future__] -file_filter = library/__future__.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--gc] -file_filter = library/gc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--getopt] -file_filter = library/getopt.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--getpass] -file_filter = library/getpass.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--gettext] -file_filter = library/gettext.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--glob] -file_filter = library/glob.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--graphlib] -file_filter = library/graphlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--grp] -file_filter = library/grp.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--gzip] -file_filter = library/gzip.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--hashlib] -file_filter = library/hashlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--heapq] -file_filter = library/heapq.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--hmac] -file_filter = library/hmac.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--html] -file_filter = library/html.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--html_entities] -file_filter = library/html_entities.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--html_parser] -file_filter = library/html_parser.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--http] -file_filter = library/http.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--http_client] -file_filter = library/http_client.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--http_cookiejar] -file_filter = library/http_cookiejar.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--http_cookies] -file_filter = library/http_cookies.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--http_server] -file_filter = library/http_server.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--i18n] -file_filter = library/i18n.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--idle] -file_filter = library/idle.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--imaplib] -file_filter = library/imaplib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--imghdr] -file_filter = library/imghdr.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--imp] -file_filter = library/imp.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--importlib] -file_filter = library/importlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--importlib_metadata] -file_filter = library/importlib_metadata.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--importlib_resources] -file_filter = library/importlib_resources.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--importlib_resources_abc] -file_filter = library/importlib_resources_abc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--index] -file_filter = library/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--inspect] -file_filter = library/inspect.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--internet] -file_filter = library/internet.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--intro] -file_filter = library/intro.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--io] -file_filter = library/io.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ipaddress] -file_filter = library/ipaddress.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ipc] -file_filter = library/ipc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--itertools] -file_filter = library/itertools.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--json] -file_filter = library/json.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--keyword] -file_filter = library/keyword.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--language] -file_filter = library/language.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--linecache] -file_filter = library/linecache.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--locale] -file_filter = library/locale.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--logging] -file_filter = library/logging.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--logging_config] -file_filter = library/logging_config.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--logging_handlers] -file_filter = library/logging_handlers.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--lzma] -file_filter = library/lzma.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--mailbox] -file_filter = library/mailbox.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--mailcap] -file_filter = library/mailcap.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--__main__] -file_filter = library/__main__.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--markup] -file_filter = library/markup.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--marshal] -file_filter = library/marshal.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--math] -file_filter = library/math.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--mimetypes] -file_filter = library/mimetypes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--mm] -file_filter = library/mm.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--mmap] -file_filter = library/mmap.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--modulefinder] -file_filter = library/modulefinder.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--modules] -file_filter = library/modules.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--msilib] -file_filter = library/msilib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--msvcrt] -file_filter = library/msvcrt.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--multiprocessing] -file_filter = library/multiprocessing.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--multiprocessing_shared_memory] -file_filter = library/multiprocessing_shared_memory.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--netdata] -file_filter = library/netdata.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--netrc] -file_filter = library/netrc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--nis] -file_filter = library/nis.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--nntplib] -file_filter = library/nntplib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--numbers] -file_filter = library/numbers.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--numeric] -file_filter = library/numeric.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--operator] -file_filter = library/operator.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--optparse] -file_filter = library/optparse.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--os] -file_filter = library/os.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--os_path] -file_filter = library/os_path.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ossaudiodev] -file_filter = library/ossaudiodev.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--othergui] -file_filter = library/othergui.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pathlib] -file_filter = library/pathlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pdb] -file_filter = library/pdb.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--persistence] -file_filter = library/persistence.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pickle] -file_filter = library/pickle.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pickletools] -file_filter = library/pickletools.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pipes] -file_filter = library/pipes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pkgutil] -file_filter = library/pkgutil.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--platform] -file_filter = library/platform.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--plistlib] -file_filter = library/plistlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--poplib] -file_filter = library/poplib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--posix] -file_filter = library/posix.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pprint] -file_filter = library/pprint.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--profile] -file_filter = library/profile.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pty] -file_filter = library/pty.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pwd] -file_filter = library/pwd.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pyclbr] -file_filter = library/pyclbr.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--py_compile] -file_filter = library/py_compile.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pydoc] -file_filter = library/pydoc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--pyexpat] -file_filter = library/pyexpat.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--python] -file_filter = library/python.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--queue] -file_filter = library/queue.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--quopri] -file_filter = library/quopri.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--random] -file_filter = library/random.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--re] -file_filter = library/re.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--readline] -file_filter = library/readline.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--reprlib] -file_filter = library/reprlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--resource] -file_filter = library/resource.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--rlcompleter] -file_filter = library/rlcompleter.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--runpy] -file_filter = library/runpy.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--sched] -file_filter = library/sched.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--secrets] -file_filter = library/secrets.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--security_warnings] -file_filter = library/security_warnings.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--select] -file_filter = library/select.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--selectors] -file_filter = library/selectors.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--shelve] -file_filter = library/shelve.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--shlex] -file_filter = library/shlex.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--shutil] -file_filter = library/shutil.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--signal] -file_filter = library/signal.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--site] -file_filter = library/site.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--smtpd] -file_filter = library/smtpd.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--smtplib] -file_filter = library/smtplib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--sndhdr] -file_filter = library/sndhdr.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--socket] -file_filter = library/socket.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--socketserver] -file_filter = library/socketserver.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--spwd] -file_filter = library/spwd.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--sqlite3] -file_filter = library/sqlite3.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--ssl] -file_filter = library/ssl.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--stat] -file_filter = library/stat.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--statistics] -file_filter = library/statistics.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--stdtypes] -file_filter = library/stdtypes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--string] -file_filter = library/string.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--stringprep] -file_filter = library/stringprep.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--struct] -file_filter = library/struct.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--subprocess] -file_filter = library/subprocess.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--sunau] -file_filter = library/sunau.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--superseded] -file_filter = library/superseded.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--symtable] -file_filter = library/symtable.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--sys] -file_filter = library/sys.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--sysconfig] -file_filter = library/sysconfig.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--syslog] -file_filter = library/syslog.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--sys_path_init] -file_filter = library/sys_path_init.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tabnanny] -file_filter = library/tabnanny.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tarfile] -file_filter = library/tarfile.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--telnetlib] -file_filter = library/telnetlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tempfile] -file_filter = library/tempfile.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--termios] -file_filter = library/termios.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--test] -file_filter = library/test.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--text] -file_filter = library/text.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--textwrap] -file_filter = library/textwrap.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--_thread] -file_filter = library/_thread.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--threading] -file_filter = library/threading.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--time] -file_filter = library/time.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--timeit] -file_filter = library/timeit.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tk] -file_filter = library/tk.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter] -file_filter = library/tkinter.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter_colorchooser] -file_filter = library/tkinter_colorchooser.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter_dnd] -file_filter = library/tkinter_dnd.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter_font] -file_filter = library/tkinter_font.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter_messagebox] -file_filter = library/tkinter_messagebox.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter_scrolledtext] -file_filter = library/tkinter_scrolledtext.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter_tix] -file_filter = library/tkinter_tix.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tkinter_ttk] -file_filter = library/tkinter_ttk.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--token] -file_filter = library/token.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tokenize] -file_filter = library/tokenize.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tomllib] -file_filter = library/tomllib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--trace] -file_filter = library/trace.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--traceback] -file_filter = library/traceback.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tracemalloc] -file_filter = library/tracemalloc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--tty] -file_filter = library/tty.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--turtle] -file_filter = library/turtle.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--types] -file_filter = library/types.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--typing] -file_filter = library/typing.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--undoc] -file_filter = library/undoc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--unicodedata] -file_filter = library/unicodedata.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--unittest] -file_filter = library/unittest.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--unittest_mock] -file_filter = library/unittest_mock.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--unittest_mock-examples] -file_filter = library/unittest_mock-examples.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--unix] -file_filter = library/unix.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--urllib] -file_filter = library/urllib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--urllib_error] -file_filter = library/urllib_error.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--urllib_parse] -file_filter = library/urllib_parse.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--urllib_request] -file_filter = library/urllib_request.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--urllib_robotparser] -file_filter = library/urllib_robotparser.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--uu] -file_filter = library/uu.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--uuid] -file_filter = library/uuid.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--venv] -file_filter = library/venv.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--warnings] -file_filter = library/warnings.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--wave] -file_filter = library/wave.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--weakref] -file_filter = library/weakref.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--webbrowser] -file_filter = library/webbrowser.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--windows] -file_filter = library/windows.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--winreg] -file_filter = library/winreg.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--winsound] -file_filter = library/winsound.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--wsgiref] -file_filter = library/wsgiref.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xdrlib] -file_filter = library/xdrlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml] -file_filter = library/xml.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_dom] -file_filter = library/xml_dom.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_dom_minidom] -file_filter = library/xml_dom_minidom.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_dom_pulldom] -file_filter = library/xml_dom_pulldom.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_etree_elementtree] -file_filter = library/xml_etree_elementtree.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xmlrpc] -file_filter = library/xmlrpc.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xmlrpc_client] -file_filter = library/xmlrpc_client.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xmlrpc_server] -file_filter = library/xmlrpc_server.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_sax] -file_filter = library/xml_sax.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_sax_handler] -file_filter = library/xml_sax_handler.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_sax_reader] -file_filter = library/xml_sax_reader.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--xml_sax_utils] -file_filter = library/xml_sax_utils.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--zipapp] -file_filter = library/zipapp.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--zipfile] -file_filter = library/zipfile.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--zipimport] -file_filter = library/zipimport.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--zlib] -file_filter = library/zlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:library--zoneinfo] -file_filter = library/zoneinfo.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:license] -file_filter = license.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--compound_stmts] -file_filter = reference/compound_stmts.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--datamodel] -file_filter = reference/datamodel.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--executionmodel] -file_filter = reference/executionmodel.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--expressions] -file_filter = reference/expressions.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--grammar] -file_filter = reference/grammar.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--import] -file_filter = reference/import.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--index] -file_filter = reference/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--introduction] -file_filter = reference/introduction.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--lexical_analysis] -file_filter = reference/lexical_analysis.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--simple_stmts] -file_filter = reference/simple_stmts.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:reference--toplevel_components] -file_filter = reference/toplevel_components.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:sphinx] -file_filter = sphinx.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--appendix] -file_filter = tutorial/appendix.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--appetite] -file_filter = tutorial/appetite.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--classes] -file_filter = tutorial/classes.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--controlflow] -file_filter = tutorial/controlflow.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--datastructures] -file_filter = tutorial/datastructures.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--errors] -file_filter = tutorial/errors.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--floatingpoint] -file_filter = tutorial/floatingpoint.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--index] -file_filter = tutorial/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--inputoutput] -file_filter = tutorial/inputoutput.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--interactive] -file_filter = tutorial/interactive.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--interpreter] -file_filter = tutorial/interpreter.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--introduction] -file_filter = tutorial/introduction.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--modules] -file_filter = tutorial/modules.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--stdlib] -file_filter = tutorial/stdlib.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--stdlib2] -file_filter = tutorial/stdlib2.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--venv] -file_filter = tutorial/venv.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:tutorial--whatnow] -file_filter = tutorial/whatnow.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:using--cmdline] -file_filter = using/cmdline.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:using--configure] -file_filter = using/configure.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:using--editors] -file_filter = using/editors.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:using--index] -file_filter = using/index.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:using--mac] -file_filter = using/mac.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:using--unix] -file_filter = using/unix.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:using--windows] -file_filter = using/windows.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_0] -file_filter = whatsnew/2.0.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_1] -file_filter = whatsnew/2.1.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_2] -file_filter = whatsnew/2.2.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_3] -file_filter = whatsnew/2.3.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_4] -file_filter = whatsnew/2.4.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_5] -file_filter = whatsnew/2.5.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_6] -file_filter = whatsnew/2.6.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--2_7] -file_filter = whatsnew/2.7.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_0] -file_filter = whatsnew/3.0.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_1] -file_filter = whatsnew/3.1.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_10] -file_filter = whatsnew/3.10.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_11] -file_filter = whatsnew/3.11.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_2] -file_filter = whatsnew/3.2.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_3] -file_filter = whatsnew/3.3.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_4] -file_filter = whatsnew/3.4.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_5] -file_filter = whatsnew/3.5.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_6] -file_filter = whatsnew/3.6.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_7] -file_filter = whatsnew/3.7.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_8] -file_filter = whatsnew/3.8.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--3_9] -file_filter = whatsnew/3.9.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--changelog] -file_filter = whatsnew/changelog.po -type = PO -source_lang = en - -[o:python-doc:p:python-newest:r:whatsnew--index] -file_filter = whatsnew/index.po -type = PO -source_lang = en +[o:python-doc:p:python-311:r:about] +file_filter = about.po +source_file = pot/about.pot +type = PO +minimum_perc = 0 +resource_name = about +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:bugs] +file_filter = bugs.po +source_file = pot/bugs.pot +type = PO +minimum_perc = 0 +resource_name = bugs +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--abstract] +file_filter = c-api/abstract.po +source_file = pot/c-api/abstract.pot +type = PO +minimum_perc = 0 +resource_name = c-api--abstract +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--allocation] +file_filter = c-api/allocation.po +source_file = pot/c-api/allocation.pot +type = PO +minimum_perc = 0 +resource_name = c-api--allocation +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--apiabiversion] +file_filter = c-api/apiabiversion.po +source_file = pot/c-api/apiabiversion.pot +type = PO +minimum_perc = 0 +resource_name = c-api--apiabiversion +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--arg] +file_filter = c-api/arg.po +source_file = pot/c-api/arg.pot +type = PO +minimum_perc = 0 +resource_name = c-api--arg +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--bool] +file_filter = c-api/bool.po +source_file = pot/c-api/bool.pot +type = PO +minimum_perc = 0 +resource_name = c-api--bool +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--buffer] +file_filter = c-api/buffer.po +source_file = pot/c-api/buffer.pot +type = PO +minimum_perc = 0 +resource_name = c-api--buffer +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--bytearray] +file_filter = c-api/bytearray.po +source_file = pot/c-api/bytearray.pot +type = PO +minimum_perc = 0 +resource_name = c-api--bytearray +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--bytes] +file_filter = c-api/bytes.po +source_file = pot/c-api/bytes.pot +type = PO +minimum_perc = 0 +resource_name = c-api--bytes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--call] +file_filter = c-api/call.po +source_file = pot/c-api/call.pot +type = PO +minimum_perc = 0 +resource_name = c-api--call +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--capsule] +file_filter = c-api/capsule.po +source_file = pot/c-api/capsule.pot +type = PO +minimum_perc = 0 +resource_name = c-api--capsule +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--cell] +file_filter = c-api/cell.po +source_file = pot/c-api/cell.pot +type = PO +minimum_perc = 0 +resource_name = c-api--cell +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--code] +file_filter = c-api/code.po +source_file = pot/c-api/code.pot +type = PO +minimum_perc = 0 +resource_name = c-api--code +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--codec] +file_filter = c-api/codec.po +source_file = pot/c-api/codec.pot +type = PO +minimum_perc = 0 +resource_name = c-api--codec +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--complex] +file_filter = c-api/complex.po +source_file = pot/c-api/complex.pot +type = PO +minimum_perc = 0 +resource_name = c-api--complex +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--concrete] +file_filter = c-api/concrete.po +source_file = pot/c-api/concrete.pot +type = PO +minimum_perc = 0 +resource_name = c-api--concrete +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--contextvars] +file_filter = c-api/contextvars.po +source_file = pot/c-api/contextvars.pot +type = PO +minimum_perc = 0 +resource_name = c-api--contextvars +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--conversion] +file_filter = c-api/conversion.po +source_file = pot/c-api/conversion.pot +type = PO +minimum_perc = 0 +resource_name = c-api--conversion +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--coro] +file_filter = c-api/coro.po +source_file = pot/c-api/coro.pot +type = PO +minimum_perc = 0 +resource_name = c-api--coro +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--datetime] +file_filter = c-api/datetime.po +source_file = pot/c-api/datetime.pot +type = PO +minimum_perc = 0 +resource_name = c-api--datetime +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--descriptor] +file_filter = c-api/descriptor.po +source_file = pot/c-api/descriptor.pot +type = PO +minimum_perc = 0 +resource_name = c-api--descriptor +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--dict] +file_filter = c-api/dict.po +source_file = pot/c-api/dict.pot +type = PO +minimum_perc = 0 +resource_name = c-api--dict +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--exceptions] +file_filter = c-api/exceptions.po +source_file = pot/c-api/exceptions.pot +type = PO +minimum_perc = 0 +resource_name = c-api--exceptions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--file] +file_filter = c-api/file.po +source_file = pot/c-api/file.pot +type = PO +minimum_perc = 0 +resource_name = c-api--file +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--float] +file_filter = c-api/float.po +source_file = pot/c-api/float.pot +type = PO +minimum_perc = 0 +resource_name = c-api--float +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--frame] +file_filter = c-api/frame.po +source_file = pot/c-api/frame.pot +type = PO +minimum_perc = 0 +resource_name = c-api--frame +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--function] +file_filter = c-api/function.po +source_file = pot/c-api/function.pot +type = PO +minimum_perc = 0 +resource_name = c-api--function +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--gcsupport] +file_filter = c-api/gcsupport.po +source_file = pot/c-api/gcsupport.pot +type = PO +minimum_perc = 0 +resource_name = c-api--gcsupport +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--gen] +file_filter = c-api/gen.po +source_file = pot/c-api/gen.pot +type = PO +minimum_perc = 0 +resource_name = c-api--gen +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--hash] +file_filter = c-api/hash.po +source_file = pot/c-api/hash.pot +type = PO +minimum_perc = 0 +resource_name = c-api--hash +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--import] +file_filter = c-api/import.po +source_file = pot/c-api/import.pot +type = PO +minimum_perc = 0 +resource_name = c-api--import +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--index] +file_filter = c-api/index.po +source_file = pot/c-api/index.pot +type = PO +minimum_perc = 0 +resource_name = c-api--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--init] +file_filter = c-api/init.po +source_file = pot/c-api/init.pot +type = PO +minimum_perc = 0 +resource_name = c-api--init +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--init_config] +file_filter = c-api/init_config.po +source_file = pot/c-api/init_config.pot +type = PO +minimum_perc = 0 +resource_name = c-api--init_config +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--intro] +file_filter = c-api/intro.po +source_file = pot/c-api/intro.pot +type = PO +minimum_perc = 0 +resource_name = c-api--intro +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--iter] +file_filter = c-api/iter.po +source_file = pot/c-api/iter.pot +type = PO +minimum_perc = 0 +resource_name = c-api--iter +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--iterator] +file_filter = c-api/iterator.po +source_file = pot/c-api/iterator.pot +type = PO +minimum_perc = 0 +resource_name = c-api--iterator +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--list] +file_filter = c-api/list.po +source_file = pot/c-api/list.pot +type = PO +minimum_perc = 0 +resource_name = c-api--list +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--long] +file_filter = c-api/long.po +source_file = pot/c-api/long.pot +type = PO +minimum_perc = 0 +resource_name = c-api--long +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--mapping] +file_filter = c-api/mapping.po +source_file = pot/c-api/mapping.pot +type = PO +minimum_perc = 0 +resource_name = c-api--mapping +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--marshal] +file_filter = c-api/marshal.po +source_file = pot/c-api/marshal.pot +type = PO +minimum_perc = 0 +resource_name = c-api--marshal +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--memory] +file_filter = c-api/memory.po +source_file = pot/c-api/memory.pot +type = PO +minimum_perc = 0 +resource_name = c-api--memory +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--memoryview] +file_filter = c-api/memoryview.po +source_file = pot/c-api/memoryview.pot +type = PO +minimum_perc = 0 +resource_name = c-api--memoryview +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--method] +file_filter = c-api/method.po +source_file = pot/c-api/method.pot +type = PO +minimum_perc = 0 +resource_name = c-api--method +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--module] +file_filter = c-api/module.po +source_file = pot/c-api/module.pot +type = PO +minimum_perc = 0 +resource_name = c-api--module +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--none] +file_filter = c-api/none.po +source_file = pot/c-api/none.pot +type = PO +minimum_perc = 0 +resource_name = c-api--none +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--number] +file_filter = c-api/number.po +source_file = pot/c-api/number.pot +type = PO +minimum_perc = 0 +resource_name = c-api--number +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--objbuffer] +file_filter = c-api/objbuffer.po +source_file = pot/c-api/objbuffer.pot +type = PO +minimum_perc = 0 +resource_name = c-api--objbuffer +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--object] +file_filter = c-api/object.po +source_file = pot/c-api/object.pot +type = PO +minimum_perc = 0 +resource_name = c-api--object +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--objimpl] +file_filter = c-api/objimpl.po +source_file = pot/c-api/objimpl.pot +type = PO +minimum_perc = 0 +resource_name = c-api--objimpl +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--refcounting] +file_filter = c-api/refcounting.po +source_file = pot/c-api/refcounting.pot +type = PO +minimum_perc = 0 +resource_name = c-api--refcounting +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--reflection] +file_filter = c-api/reflection.po +source_file = pot/c-api/reflection.pot +type = PO +minimum_perc = 0 +resource_name = c-api--reflection +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--sequence] +file_filter = c-api/sequence.po +source_file = pot/c-api/sequence.pot +type = PO +minimum_perc = 0 +resource_name = c-api--sequence +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--set] +file_filter = c-api/set.po +source_file = pot/c-api/set.pot +type = PO +minimum_perc = 0 +resource_name = c-api--set +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--slice] +file_filter = c-api/slice.po +source_file = pot/c-api/slice.pot +type = PO +minimum_perc = 0 +resource_name = c-api--slice +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--stable] +file_filter = c-api/stable.po +source_file = pot/c-api/stable.pot +type = PO +minimum_perc = 0 +resource_name = c-api--stable +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--structures] +file_filter = c-api/structures.po +source_file = pot/c-api/structures.pot +type = PO +minimum_perc = 0 +resource_name = c-api--structures +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--sys] +file_filter = c-api/sys.po +source_file = pot/c-api/sys.pot +type = PO +minimum_perc = 0 +resource_name = c-api--sys +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--tuple] +file_filter = c-api/tuple.po +source_file = pot/c-api/tuple.pot +type = PO +minimum_perc = 0 +resource_name = c-api--tuple +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--type] +file_filter = c-api/type.po +source_file = pot/c-api/type.pot +type = PO +minimum_perc = 0 +resource_name = c-api--type +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--typehints] +file_filter = c-api/typehints.po +source_file = pot/c-api/typehints.pot +type = PO +minimum_perc = 0 +resource_name = c-api--typehints +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--typeobj] +file_filter = c-api/typeobj.po +source_file = pot/c-api/typeobj.pot +type = PO +minimum_perc = 0 +resource_name = c-api--typeobj +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--unicode] +file_filter = c-api/unicode.po +source_file = pot/c-api/unicode.pot +type = PO +minimum_perc = 0 +resource_name = c-api--unicode +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--utilities] +file_filter = c-api/utilities.po +source_file = pot/c-api/utilities.pot +type = PO +minimum_perc = 0 +resource_name = c-api--utilities +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--veryhigh] +file_filter = c-api/veryhigh.po +source_file = pot/c-api/veryhigh.pot +type = PO +minimum_perc = 0 +resource_name = c-api--veryhigh +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:c-api--weakref] +file_filter = c-api/weakref.po +source_file = pot/c-api/weakref.pot +type = PO +minimum_perc = 0 +resource_name = c-api--weakref +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:contents] +file_filter = contents.po +source_file = pot/contents.pot +type = PO +minimum_perc = 0 +resource_name = contents +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:copyright] +file_filter = copyright.po +source_file = pot/copyright.pot +type = PO +minimum_perc = 0 +resource_name = copyright +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distributing--index] +file_filter = distributing/index.po +source_file = pot/distributing/index.pot +type = PO +minimum_perc = 0 +resource_name = distributing--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--_setuptools_disclaimer] +file_filter = distutils/_setuptools_disclaimer.po +source_file = pot/distutils/_setuptools_disclaimer.pot +type = PO +minimum_perc = 0 +resource_name = distutils--_setuptools_disclaimer +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--apiref] +file_filter = distutils/apiref.po +source_file = pot/distutils/apiref.pot +type = PO +minimum_perc = 0 +resource_name = distutils--apiref +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--builtdist] +file_filter = distutils/builtdist.po +source_file = pot/distutils/builtdist.pot +type = PO +minimum_perc = 0 +resource_name = distutils--builtdist +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--commandref] +file_filter = distutils/commandref.po +source_file = pot/distutils/commandref.pot +type = PO +minimum_perc = 0 +resource_name = distutils--commandref +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--configfile] +file_filter = distutils/configfile.po +source_file = pot/distutils/configfile.pot +type = PO +minimum_perc = 0 +resource_name = distutils--configfile +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--examples] +file_filter = distutils/examples.po +source_file = pot/distutils/examples.pot +type = PO +minimum_perc = 0 +resource_name = distutils--examples +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--extending] +file_filter = distutils/extending.po +source_file = pot/distutils/extending.pot +type = PO +minimum_perc = 0 +resource_name = distutils--extending +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--index] +file_filter = distutils/index.po +source_file = pot/distutils/index.pot +type = PO +minimum_perc = 0 +resource_name = distutils--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--introduction] +file_filter = distutils/introduction.po +source_file = pot/distutils/introduction.pot +type = PO +minimum_perc = 0 +resource_name = distutils--introduction +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--packageindex] +file_filter = distutils/packageindex.po +source_file = pot/distutils/packageindex.pot +type = PO +minimum_perc = 0 +resource_name = distutils--packageindex +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--setupscript] +file_filter = distutils/setupscript.po +source_file = pot/distutils/setupscript.pot +type = PO +minimum_perc = 0 +resource_name = distutils--setupscript +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--sourcedist] +file_filter = distutils/sourcedist.po +source_file = pot/distutils/sourcedist.pot +type = PO +minimum_perc = 0 +resource_name = distutils--sourcedist +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:distutils--uploading] +file_filter = distutils/uploading.po +source_file = pot/distutils/uploading.pot +type = PO +minimum_perc = 0 +resource_name = distutils--uploading +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:extending--building] +file_filter = extending/building.po +source_file = pot/extending/building.pot +type = PO +minimum_perc = 0 +resource_name = extending--building +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:extending--embedding] +file_filter = extending/embedding.po +source_file = pot/extending/embedding.pot +type = PO +minimum_perc = 0 +resource_name = extending--embedding +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:extending--extending] +file_filter = extending/extending.po +source_file = pot/extending/extending.pot +type = PO +minimum_perc = 0 +resource_name = extending--extending +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:extending--index] +file_filter = extending/index.po +source_file = pot/extending/index.pot +type = PO +minimum_perc = 0 +resource_name = extending--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:extending--newtypes] +file_filter = extending/newtypes.po +source_file = pot/extending/newtypes.pot +type = PO +minimum_perc = 0 +resource_name = extending--newtypes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:extending--newtypes_tutorial] +file_filter = extending/newtypes_tutorial.po +source_file = pot/extending/newtypes_tutorial.pot +type = PO +minimum_perc = 0 +resource_name = extending--newtypes_tutorial +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:extending--windows] +file_filter = extending/windows.po +source_file = pot/extending/windows.pot +type = PO +minimum_perc = 0 +resource_name = extending--windows +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--design] +file_filter = faq/design.po +source_file = pot/faq/design.pot +type = PO +minimum_perc = 0 +resource_name = faq--design +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--extending] +file_filter = faq/extending.po +source_file = pot/faq/extending.pot +type = PO +minimum_perc = 0 +resource_name = faq--extending +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--general] +file_filter = faq/general.po +source_file = pot/faq/general.pot +type = PO +minimum_perc = 0 +resource_name = faq--general +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--gui] +file_filter = faq/gui.po +source_file = pot/faq/gui.pot +type = PO +minimum_perc = 0 +resource_name = faq--gui +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--index] +file_filter = faq/index.po +source_file = pot/faq/index.pot +type = PO +minimum_perc = 0 +resource_name = faq--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--installed] +file_filter = faq/installed.po +source_file = pot/faq/installed.pot +type = PO +minimum_perc = 0 +resource_name = faq--installed +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--library] +file_filter = faq/library.po +source_file = pot/faq/library.pot +type = PO +minimum_perc = 0 +resource_name = faq--library +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--programming] +file_filter = faq/programming.po +source_file = pot/faq/programming.pot +type = PO +minimum_perc = 0 +resource_name = faq--programming +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:faq--windows] +file_filter = faq/windows.po +source_file = pot/faq/windows.pot +type = PO +minimum_perc = 0 +resource_name = faq--windows +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:glossary_] +file_filter = glossary.po +source_file = pot/glossary.pot +type = PO +minimum_perc = 0 +resource_name = glossary_ +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--annotations] +file_filter = howto/annotations.po +source_file = pot/howto/annotations.pot +type = PO +minimum_perc = 0 +resource_name = howto--annotations +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--argparse] +file_filter = howto/argparse.po +source_file = pot/howto/argparse.pot +type = PO +minimum_perc = 0 +resource_name = howto--argparse +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--clinic] +file_filter = howto/clinic.po +source_file = pot/howto/clinic.pot +type = PO +minimum_perc = 0 +resource_name = howto--clinic +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--cporting] +file_filter = howto/cporting.po +source_file = pot/howto/cporting.pot +type = PO +minimum_perc = 0 +resource_name = howto--cporting +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--curses] +file_filter = howto/curses.po +source_file = pot/howto/curses.pot +type = PO +minimum_perc = 0 +resource_name = howto--curses +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--descriptor] +file_filter = howto/descriptor.po +source_file = pot/howto/descriptor.pot +type = PO +minimum_perc = 0 +resource_name = howto--descriptor +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--enum] +file_filter = howto/enum.po +source_file = pot/howto/enum.pot +type = PO +minimum_perc = 0 +resource_name = howto--enum +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--functional] +file_filter = howto/functional.po +source_file = pot/howto/functional.pot +type = PO +minimum_perc = 0 +resource_name = howto--functional +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--gdb_helpers] +file_filter = howto/gdb_helpers.po +source_file = pot/howto/gdb_helpers.pot +type = PO +minimum_perc = 0 +resource_name = howto--gdb_helpers +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--index] +file_filter = howto/index.po +source_file = pot/howto/index.pot +type = PO +minimum_perc = 0 +resource_name = howto--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--instrumentation] +file_filter = howto/instrumentation.po +source_file = pot/howto/instrumentation.pot +type = PO +minimum_perc = 0 +resource_name = howto--instrumentation +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--ipaddress] +file_filter = howto/ipaddress.po +source_file = pot/howto/ipaddress.pot +type = PO +minimum_perc = 0 +resource_name = howto--ipaddress +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--isolating-extensions] +file_filter = howto/isolating-extensions.po +source_file = pot/howto/isolating-extensions.pot +type = PO +minimum_perc = 0 +resource_name = howto--isolating-extensions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--logging] +file_filter = howto/logging.po +source_file = pot/howto/logging.pot +type = PO +minimum_perc = 0 +resource_name = howto--logging +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--logging-cookbook] +file_filter = howto/logging-cookbook.po +source_file = pot/howto/logging-cookbook.pot +type = PO +minimum_perc = 0 +resource_name = howto--logging-cookbook +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--pyporting] +file_filter = howto/pyporting.po +source_file = pot/howto/pyporting.pot +type = PO +minimum_perc = 0 +resource_name = howto--pyporting +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--regex] +file_filter = howto/regex.po +source_file = pot/howto/regex.pot +type = PO +minimum_perc = 0 +resource_name = howto--regex +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--sockets] +file_filter = howto/sockets.po +source_file = pot/howto/sockets.pot +type = PO +minimum_perc = 0 +resource_name = howto--sockets +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--sorting] +file_filter = howto/sorting.po +source_file = pot/howto/sorting.pot +type = PO +minimum_perc = 0 +resource_name = howto--sorting +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--unicode] +file_filter = howto/unicode.po +source_file = pot/howto/unicode.pot +type = PO +minimum_perc = 0 +resource_name = howto--unicode +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:howto--urllib2] +file_filter = howto/urllib2.po +source_file = pot/howto/urllib2.pot +type = PO +minimum_perc = 0 +resource_name = howto--urllib2 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:install--index] +file_filter = install/index.po +source_file = pot/install/index.pot +type = PO +minimum_perc = 0 +resource_name = install--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:installing--index] +file_filter = installing/index.po +source_file = pot/installing/index.pot +type = PO +minimum_perc = 0 +resource_name = installing--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--2to3] +file_filter = library/2to3.po +source_file = pot/library/2to3.pot +type = PO +minimum_perc = 0 +resource_name = library--2to3 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--__future__] +file_filter = library/__future__.po +source_file = pot/library/__future__.pot +type = PO +minimum_perc = 0 +resource_name = library--__future__ +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--__main__] +file_filter = library/__main__.po +source_file = pot/library/__main__.pot +type = PO +minimum_perc = 0 +resource_name = library--__main__ +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--_thread] +file_filter = library/_thread.po +source_file = pot/library/_thread.pot +type = PO +minimum_perc = 0 +resource_name = library--_thread +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--abc] +file_filter = library/abc.po +source_file = pot/library/abc.pot +type = PO +minimum_perc = 0 +resource_name = library--abc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--aifc] +file_filter = library/aifc.po +source_file = pot/library/aifc.pot +type = PO +minimum_perc = 0 +resource_name = library--aifc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--allos] +file_filter = library/allos.po +source_file = pot/library/allos.pot +type = PO +minimum_perc = 0 +resource_name = library--allos +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--archiving] +file_filter = library/archiving.po +source_file = pot/library/archiving.pot +type = PO +minimum_perc = 0 +resource_name = library--archiving +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--argparse] +file_filter = library/argparse.po +source_file = pot/library/argparse.pot +type = PO +minimum_perc = 0 +resource_name = library--argparse +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--array] +file_filter = library/array.po +source_file = pot/library/array.pot +type = PO +minimum_perc = 0 +resource_name = library--array +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ast] +file_filter = library/ast.po +source_file = pot/library/ast.pot +type = PO +minimum_perc = 0 +resource_name = library--ast +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asynchat] +file_filter = library/asynchat.po +source_file = pot/library/asynchat.pot +type = PO +minimum_perc = 0 +resource_name = library--asynchat +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio] +file_filter = library/asyncio.po +source_file = pot/library/asyncio.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-api-index] +file_filter = library/asyncio-api-index.po +source_file = pot/library/asyncio-api-index.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-api-index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-dev] +file_filter = library/asyncio-dev.po +source_file = pot/library/asyncio-dev.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-dev +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-eventloop] +file_filter = library/asyncio-eventloop.po +source_file = pot/library/asyncio-eventloop.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-eventloop +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-exceptions] +file_filter = library/asyncio-exceptions.po +source_file = pot/library/asyncio-exceptions.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-exceptions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-extending] +file_filter = library/asyncio-extending.po +source_file = pot/library/asyncio-extending.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-extending +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-future] +file_filter = library/asyncio-future.po +source_file = pot/library/asyncio-future.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-future +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-llapi-index] +file_filter = library/asyncio-llapi-index.po +source_file = pot/library/asyncio-llapi-index.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-llapi-index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-platforms] +file_filter = library/asyncio-platforms.po +source_file = pot/library/asyncio-platforms.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-platforms +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-policy] +file_filter = library/asyncio-policy.po +source_file = pot/library/asyncio-policy.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-policy +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-protocol] +file_filter = library/asyncio-protocol.po +source_file = pot/library/asyncio-protocol.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-protocol +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-queue] +file_filter = library/asyncio-queue.po +source_file = pot/library/asyncio-queue.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-queue +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-runner] +file_filter = library/asyncio-runner.po +source_file = pot/library/asyncio-runner.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-runner +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-stream] +file_filter = library/asyncio-stream.po +source_file = pot/library/asyncio-stream.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-stream +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-subprocess] +file_filter = library/asyncio-subprocess.po +source_file = pot/library/asyncio-subprocess.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-subprocess +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-sync] +file_filter = library/asyncio-sync.po +source_file = pot/library/asyncio-sync.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-sync +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncio-task] +file_filter = library/asyncio-task.po +source_file = pot/library/asyncio-task.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncio-task +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--asyncore] +file_filter = library/asyncore.po +source_file = pot/library/asyncore.pot +type = PO +minimum_perc = 0 +resource_name = library--asyncore +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--atexit] +file_filter = library/atexit.po +source_file = pot/library/atexit.pot +type = PO +minimum_perc = 0 +resource_name = library--atexit +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--audioop] +file_filter = library/audioop.po +source_file = pot/library/audioop.pot +type = PO +minimum_perc = 0 +resource_name = library--audioop +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--audit_events] +file_filter = library/audit_events.po +source_file = pot/library/audit_events.pot +type = PO +minimum_perc = 0 +resource_name = library--audit_events +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--base64] +file_filter = library/base64.po +source_file = pot/library/base64.pot +type = PO +minimum_perc = 0 +resource_name = library--base64 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--bdb] +file_filter = library/bdb.po +source_file = pot/library/bdb.pot +type = PO +minimum_perc = 0 +resource_name = library--bdb +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--binary] +file_filter = library/binary.po +source_file = pot/library/binary.pot +type = PO +minimum_perc = 0 +resource_name = library--binary +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--binascii] +file_filter = library/binascii.po +source_file = pot/library/binascii.pot +type = PO +minimum_perc = 0 +resource_name = library--binascii +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--bisect] +file_filter = library/bisect.po +source_file = pot/library/bisect.pot +type = PO +minimum_perc = 0 +resource_name = library--bisect +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--builtins] +file_filter = library/builtins.po +source_file = pot/library/builtins.pot +type = PO +minimum_perc = 0 +resource_name = library--builtins +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--bz2] +file_filter = library/bz2.po +source_file = pot/library/bz2.pot +type = PO +minimum_perc = 0 +resource_name = library--bz2 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--calendar] +file_filter = library/calendar.po +source_file = pot/library/calendar.pot +type = PO +minimum_perc = 0 +resource_name = library--calendar +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--cgi] +file_filter = library/cgi.po +source_file = pot/library/cgi.pot +type = PO +minimum_perc = 0 +resource_name = library--cgi +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--cgitb] +file_filter = library/cgitb.po +source_file = pot/library/cgitb.pot +type = PO +minimum_perc = 0 +resource_name = library--cgitb +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--chunk] +file_filter = library/chunk.po +source_file = pot/library/chunk.pot +type = PO +minimum_perc = 0 +resource_name = library--chunk +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--cmath] +file_filter = library/cmath.po +source_file = pot/library/cmath.pot +type = PO +minimum_perc = 0 +resource_name = library--cmath +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--cmd] +file_filter = library/cmd.po +source_file = pot/library/cmd.pot +type = PO +minimum_perc = 0 +resource_name = library--cmd +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--cmdline] +file_filter = library/cmdline.po +source_file = pot/library/cmdline.pot +type = PO +minimum_perc = 0 +resource_name = library--cmdline +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--code] +file_filter = library/code.po +source_file = pot/library/code.pot +type = PO +minimum_perc = 0 +resource_name = library--code +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--codecs] +file_filter = library/codecs.po +source_file = pot/library/codecs.pot +type = PO +minimum_perc = 0 +resource_name = library--codecs +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--codeop] +file_filter = library/codeop.po +source_file = pot/library/codeop.pot +type = PO +minimum_perc = 0 +resource_name = library--codeop +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--collections] +file_filter = library/collections.po +source_file = pot/library/collections.pot +type = PO +minimum_perc = 0 +resource_name = library--collections +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--collections_abc] +file_filter = library/collections.abc.po +source_file = pot/library/collections.abc.pot +type = PO +minimum_perc = 0 +resource_name = library--collections_abc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--colorsys] +file_filter = library/colorsys.po +source_file = pot/library/colorsys.pot +type = PO +minimum_perc = 0 +resource_name = library--colorsys +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--compileall] +file_filter = library/compileall.po +source_file = pot/library/compileall.pot +type = PO +minimum_perc = 0 +resource_name = library--compileall +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--concurrency] +file_filter = library/concurrency.po +source_file = pot/library/concurrency.pot +type = PO +minimum_perc = 0 +resource_name = library--concurrency +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--concurrent] +file_filter = library/concurrent.po +source_file = pot/library/concurrent.pot +type = PO +minimum_perc = 0 +resource_name = library--concurrent +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--concurrent_futures] +file_filter = library/concurrent.futures.po +source_file = pot/library/concurrent.futures.pot +type = PO +minimum_perc = 0 +resource_name = library--concurrent_futures +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--configparser] +file_filter = library/configparser.po +source_file = pot/library/configparser.pot +type = PO +minimum_perc = 0 +resource_name = library--configparser +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--constants] +file_filter = library/constants.po +source_file = pot/library/constants.pot +type = PO +minimum_perc = 0 +resource_name = library--constants +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--contextlib] +file_filter = library/contextlib.po +source_file = pot/library/contextlib.pot +type = PO +minimum_perc = 0 +resource_name = library--contextlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--contextvars] +file_filter = library/contextvars.po +source_file = pot/library/contextvars.pot +type = PO +minimum_perc = 0 +resource_name = library--contextvars +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--copy] +file_filter = library/copy.po +source_file = pot/library/copy.pot +type = PO +minimum_perc = 0 +resource_name = library--copy +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--copyreg] +file_filter = library/copyreg.po +source_file = pot/library/copyreg.pot +type = PO +minimum_perc = 0 +resource_name = library--copyreg +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--crypt] +file_filter = library/crypt.po +source_file = pot/library/crypt.pot +type = PO +minimum_perc = 0 +resource_name = library--crypt +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--crypto] +file_filter = library/crypto.po +source_file = pot/library/crypto.pot +type = PO +minimum_perc = 0 +resource_name = library--crypto +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--csv] +file_filter = library/csv.po +source_file = pot/library/csv.pot +type = PO +minimum_perc = 0 +resource_name = library--csv +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ctypes] +file_filter = library/ctypes.po +source_file = pot/library/ctypes.pot +type = PO +minimum_perc = 0 +resource_name = library--ctypes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--curses] +file_filter = library/curses.po +source_file = pot/library/curses.pot +type = PO +minimum_perc = 0 +resource_name = library--curses +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--curses_ascii] +file_filter = library/curses.ascii.po +source_file = pot/library/curses.ascii.pot +type = PO +minimum_perc = 0 +resource_name = library--curses_ascii +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--curses_panel] +file_filter = library/curses.panel.po +source_file = pot/library/curses.panel.pot +type = PO +minimum_perc = 0 +resource_name = library--curses_panel +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--custominterp] +file_filter = library/custominterp.po +source_file = pot/library/custominterp.pot +type = PO +minimum_perc = 0 +resource_name = library--custominterp +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--dataclasses] +file_filter = library/dataclasses.po +source_file = pot/library/dataclasses.pot +type = PO +minimum_perc = 0 +resource_name = library--dataclasses +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--datatypes] +file_filter = library/datatypes.po +source_file = pot/library/datatypes.pot +type = PO +minimum_perc = 0 +resource_name = library--datatypes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--datetime] +file_filter = library/datetime.po +source_file = pot/library/datetime.pot +type = PO +minimum_perc = 0 +resource_name = library--datetime +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--dbm] +file_filter = library/dbm.po +source_file = pot/library/dbm.pot +type = PO +minimum_perc = 0 +resource_name = library--dbm +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--debug] +file_filter = library/debug.po +source_file = pot/library/debug.pot +type = PO +minimum_perc = 0 +resource_name = library--debug +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--decimal] +file_filter = library/decimal.po +source_file = pot/library/decimal.pot +type = PO +minimum_perc = 0 +resource_name = library--decimal +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--development] +file_filter = library/development.po +source_file = pot/library/development.pot +type = PO +minimum_perc = 0 +resource_name = library--development +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--devmode] +file_filter = library/devmode.po +source_file = pot/library/devmode.pot +type = PO +minimum_perc = 0 +resource_name = library--devmode +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--dialog] +file_filter = library/dialog.po +source_file = pot/library/dialog.pot +type = PO +minimum_perc = 0 +resource_name = library--dialog +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--difflib] +file_filter = library/difflib.po +source_file = pot/library/difflib.pot +type = PO +minimum_perc = 0 +resource_name = library--difflib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--dis] +file_filter = library/dis.po +source_file = pot/library/dis.pot +type = PO +minimum_perc = 0 +resource_name = library--dis +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--distribution] +file_filter = library/distribution.po +source_file = pot/library/distribution.pot +type = PO +minimum_perc = 0 +resource_name = library--distribution +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--distutils] +file_filter = library/distutils.po +source_file = pot/library/distutils.pot +type = PO +minimum_perc = 0 +resource_name = library--distutils +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--doctest] +file_filter = library/doctest.po +source_file = pot/library/doctest.pot +type = PO +minimum_perc = 0 +resource_name = library--doctest +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email] +file_filter = library/email.po +source_file = pot/library/email.pot +type = PO +minimum_perc = 0 +resource_name = library--email +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_charset] +file_filter = library/email.charset.po +source_file = pot/library/email.charset.pot +type = PO +minimum_perc = 0 +resource_name = library--email_charset +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_compat32-message] +file_filter = library/email.compat32-message.po +source_file = pot/library/email.compat32-message.pot +type = PO +minimum_perc = 0 +resource_name = library--email_compat32-message +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_contentmanager] +file_filter = library/email.contentmanager.po +source_file = pot/library/email.contentmanager.pot +type = PO +minimum_perc = 0 +resource_name = library--email_contentmanager +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_encoders] +file_filter = library/email.encoders.po +source_file = pot/library/email.encoders.pot +type = PO +minimum_perc = 0 +resource_name = library--email_encoders +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_errors] +file_filter = library/email.errors.po +source_file = pot/library/email.errors.pot +type = PO +minimum_perc = 0 +resource_name = library--email_errors +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_examples] +file_filter = library/email.examples.po +source_file = pot/library/email.examples.pot +type = PO +minimum_perc = 0 +resource_name = library--email_examples +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_generator] +file_filter = library/email.generator.po +source_file = pot/library/email.generator.pot +type = PO +minimum_perc = 0 +resource_name = library--email_generator +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_header] +file_filter = library/email.header.po +source_file = pot/library/email.header.pot +type = PO +minimum_perc = 0 +resource_name = library--email_header +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_headerregistry] +file_filter = library/email.headerregistry.po +source_file = pot/library/email.headerregistry.pot +type = PO +minimum_perc = 0 +resource_name = library--email_headerregistry +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_iterators] +file_filter = library/email.iterators.po +source_file = pot/library/email.iterators.pot +type = PO +minimum_perc = 0 +resource_name = library--email_iterators +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_message] +file_filter = library/email.message.po +source_file = pot/library/email.message.pot +type = PO +minimum_perc = 0 +resource_name = library--email_message +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_mime] +file_filter = library/email.mime.po +source_file = pot/library/email.mime.pot +type = PO +minimum_perc = 0 +resource_name = library--email_mime +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_parser] +file_filter = library/email.parser.po +source_file = pot/library/email.parser.pot +type = PO +minimum_perc = 0 +resource_name = library--email_parser +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_policy] +file_filter = library/email.policy.po +source_file = pot/library/email.policy.pot +type = PO +minimum_perc = 0 +resource_name = library--email_policy +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--email_utils] +file_filter = library/email.utils.po +source_file = pot/library/email.utils.pot +type = PO +minimum_perc = 0 +resource_name = library--email_utils +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ensurepip] +file_filter = library/ensurepip.po +source_file = pot/library/ensurepip.pot +type = PO +minimum_perc = 0 +resource_name = library--ensurepip +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--enum] +file_filter = library/enum.po +source_file = pot/library/enum.pot +type = PO +minimum_perc = 0 +resource_name = library--enum +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--errno] +file_filter = library/errno.po +source_file = pot/library/errno.pot +type = PO +minimum_perc = 0 +resource_name = library--errno +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--exceptions] +file_filter = library/exceptions.po +source_file = pot/library/exceptions.pot +type = PO +minimum_perc = 0 +resource_name = library--exceptions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--faulthandler] +file_filter = library/faulthandler.po +source_file = pot/library/faulthandler.pot +type = PO +minimum_perc = 0 +resource_name = library--faulthandler +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--fcntl] +file_filter = library/fcntl.po +source_file = pot/library/fcntl.pot +type = PO +minimum_perc = 0 +resource_name = library--fcntl +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--filecmp] +file_filter = library/filecmp.po +source_file = pot/library/filecmp.pot +type = PO +minimum_perc = 0 +resource_name = library--filecmp +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--fileformats] +file_filter = library/fileformats.po +source_file = pot/library/fileformats.pot +type = PO +minimum_perc = 0 +resource_name = library--fileformats +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--fileinput] +file_filter = library/fileinput.po +source_file = pot/library/fileinput.pot +type = PO +minimum_perc = 0 +resource_name = library--fileinput +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--filesys] +file_filter = library/filesys.po +source_file = pot/library/filesys.pot +type = PO +minimum_perc = 0 +resource_name = library--filesys +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--fnmatch] +file_filter = library/fnmatch.po +source_file = pot/library/fnmatch.pot +type = PO +minimum_perc = 0 +resource_name = library--fnmatch +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--fractions] +file_filter = library/fractions.po +source_file = pot/library/fractions.pot +type = PO +minimum_perc = 0 +resource_name = library--fractions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--frameworks] +file_filter = library/frameworks.po +source_file = pot/library/frameworks.pot +type = PO +minimum_perc = 0 +resource_name = library--frameworks +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ftplib] +file_filter = library/ftplib.po +source_file = pot/library/ftplib.pot +type = PO +minimum_perc = 0 +resource_name = library--ftplib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--functional] +file_filter = library/functional.po +source_file = pot/library/functional.pot +type = PO +minimum_perc = 0 +resource_name = library--functional +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--functions] +file_filter = library/functions.po +source_file = pot/library/functions.pot +type = PO +minimum_perc = 0 +resource_name = library--functions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--functools] +file_filter = library/functools.po +source_file = pot/library/functools.pot +type = PO +minimum_perc = 0 +resource_name = library--functools +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--gc] +file_filter = library/gc.po +source_file = pot/library/gc.pot +type = PO +minimum_perc = 0 +resource_name = library--gc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--getopt] +file_filter = library/getopt.po +source_file = pot/library/getopt.pot +type = PO +minimum_perc = 0 +resource_name = library--getopt +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--getpass] +file_filter = library/getpass.po +source_file = pot/library/getpass.pot +type = PO +minimum_perc = 0 +resource_name = library--getpass +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--gettext] +file_filter = library/gettext.po +source_file = pot/library/gettext.pot +type = PO +minimum_perc = 0 +resource_name = library--gettext +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--glob] +file_filter = library/glob.po +source_file = pot/library/glob.pot +type = PO +minimum_perc = 0 +resource_name = library--glob +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--graphlib] +file_filter = library/graphlib.po +source_file = pot/library/graphlib.pot +type = PO +minimum_perc = 0 +resource_name = library--graphlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--grp] +file_filter = library/grp.po +source_file = pot/library/grp.pot +type = PO +minimum_perc = 0 +resource_name = library--grp +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--gzip] +file_filter = library/gzip.po +source_file = pot/library/gzip.pot +type = PO +minimum_perc = 0 +resource_name = library--gzip +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--hashlib] +file_filter = library/hashlib.po +source_file = pot/library/hashlib.pot +type = PO +minimum_perc = 0 +resource_name = library--hashlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--heapq] +file_filter = library/heapq.po +source_file = pot/library/heapq.pot +type = PO +minimum_perc = 0 +resource_name = library--heapq +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--hmac] +file_filter = library/hmac.po +source_file = pot/library/hmac.pot +type = PO +minimum_perc = 0 +resource_name = library--hmac +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--html] +file_filter = library/html.po +source_file = pot/library/html.pot +type = PO +minimum_perc = 0 +resource_name = library--html +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--html_entities] +file_filter = library/html.entities.po +source_file = pot/library/html.entities.pot +type = PO +minimum_perc = 0 +resource_name = library--html_entities +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--html_parser] +file_filter = library/html.parser.po +source_file = pot/library/html.parser.pot +type = PO +minimum_perc = 0 +resource_name = library--html_parser +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--http] +file_filter = library/http.po +source_file = pot/library/http.pot +type = PO +minimum_perc = 0 +resource_name = library--http +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--http_client] +file_filter = library/http.client.po +source_file = pot/library/http.client.pot +type = PO +minimum_perc = 0 +resource_name = library--http_client +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--http_cookiejar] +file_filter = library/http.cookiejar.po +source_file = pot/library/http.cookiejar.pot +type = PO +minimum_perc = 0 +resource_name = library--http_cookiejar +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--http_cookies] +file_filter = library/http.cookies.po +source_file = pot/library/http.cookies.pot +type = PO +minimum_perc = 0 +resource_name = library--http_cookies +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--http_server] +file_filter = library/http.server.po +source_file = pot/library/http.server.pot +type = PO +minimum_perc = 0 +resource_name = library--http_server +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--i18n] +file_filter = library/i18n.po +source_file = pot/library/i18n.pot +type = PO +minimum_perc = 0 +resource_name = library--i18n +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--idle] +file_filter = library/idle.po +source_file = pot/library/idle.pot +type = PO +minimum_perc = 0 +resource_name = library--idle +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--imaplib] +file_filter = library/imaplib.po +source_file = pot/library/imaplib.pot +type = PO +minimum_perc = 0 +resource_name = library--imaplib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--imghdr] +file_filter = library/imghdr.po +source_file = pot/library/imghdr.pot +type = PO +minimum_perc = 0 +resource_name = library--imghdr +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--imp] +file_filter = library/imp.po +source_file = pot/library/imp.pot +type = PO +minimum_perc = 0 +resource_name = library--imp +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--importlib] +file_filter = library/importlib.po +source_file = pot/library/importlib.pot +type = PO +minimum_perc = 0 +resource_name = library--importlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--importlib_metadata] +file_filter = library/importlib.metadata.po +source_file = pot/library/importlib.metadata.pot +type = PO +minimum_perc = 0 +resource_name = library--importlib_metadata +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--importlib_resources] +file_filter = library/importlib.resources.po +source_file = pot/library/importlib.resources.pot +type = PO +minimum_perc = 0 +resource_name = library--importlib_resources +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--importlib_resources_abc] +file_filter = library/importlib.resources.abc.po +source_file = pot/library/importlib.resources.abc.pot +type = PO +minimum_perc = 0 +resource_name = library--importlib_resources_abc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--index] +file_filter = library/index.po +source_file = pot/library/index.pot +type = PO +minimum_perc = 0 +resource_name = library--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--inspect] +file_filter = library/inspect.po +source_file = pot/library/inspect.pot +type = PO +minimum_perc = 0 +resource_name = library--inspect +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--internet] +file_filter = library/internet.po +source_file = pot/library/internet.pot +type = PO +minimum_perc = 0 +resource_name = library--internet +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--intro] +file_filter = library/intro.po +source_file = pot/library/intro.pot +type = PO +minimum_perc = 0 +resource_name = library--intro +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--io] +file_filter = library/io.po +source_file = pot/library/io.pot +type = PO +minimum_perc = 0 +resource_name = library--io +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ipaddress] +file_filter = library/ipaddress.po +source_file = pot/library/ipaddress.pot +type = PO +minimum_perc = 0 +resource_name = library--ipaddress +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ipc] +file_filter = library/ipc.po +source_file = pot/library/ipc.pot +type = PO +minimum_perc = 0 +resource_name = library--ipc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--itertools] +file_filter = library/itertools.po +source_file = pot/library/itertools.pot +type = PO +minimum_perc = 0 +resource_name = library--itertools +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--json] +file_filter = library/json.po +source_file = pot/library/json.pot +type = PO +minimum_perc = 0 +resource_name = library--json +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--keyword] +file_filter = library/keyword.po +source_file = pot/library/keyword.pot +type = PO +minimum_perc = 0 +resource_name = library--keyword +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--language] +file_filter = library/language.po +source_file = pot/library/language.pot +type = PO +minimum_perc = 0 +resource_name = library--language +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--linecache] +file_filter = library/linecache.po +source_file = pot/library/linecache.pot +type = PO +minimum_perc = 0 +resource_name = library--linecache +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--locale] +file_filter = library/locale.po +source_file = pot/library/locale.pot +type = PO +minimum_perc = 0 +resource_name = library--locale +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--logging] +file_filter = library/logging.po +source_file = pot/library/logging.pot +type = PO +minimum_perc = 0 +resource_name = library--logging +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--logging_config] +file_filter = library/logging.config.po +source_file = pot/library/logging.config.pot +type = PO +minimum_perc = 0 +resource_name = library--logging_config +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--logging_handlers] +file_filter = library/logging.handlers.po +source_file = pot/library/logging.handlers.pot +type = PO +minimum_perc = 0 +resource_name = library--logging_handlers +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--lzma] +file_filter = library/lzma.po +source_file = pot/library/lzma.pot +type = PO +minimum_perc = 0 +resource_name = library--lzma +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--mailbox] +file_filter = library/mailbox.po +source_file = pot/library/mailbox.pot +type = PO +minimum_perc = 0 +resource_name = library--mailbox +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--mailcap] +file_filter = library/mailcap.po +source_file = pot/library/mailcap.pot +type = PO +minimum_perc = 0 +resource_name = library--mailcap +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--markup] +file_filter = library/markup.po +source_file = pot/library/markup.pot +type = PO +minimum_perc = 0 +resource_name = library--markup +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--marshal] +file_filter = library/marshal.po +source_file = pot/library/marshal.pot +type = PO +minimum_perc = 0 +resource_name = library--marshal +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--math] +file_filter = library/math.po +source_file = pot/library/math.pot +type = PO +minimum_perc = 0 +resource_name = library--math +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--mimetypes] +file_filter = library/mimetypes.po +source_file = pot/library/mimetypes.pot +type = PO +minimum_perc = 0 +resource_name = library--mimetypes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--mm] +file_filter = library/mm.po +source_file = pot/library/mm.pot +type = PO +minimum_perc = 0 +resource_name = library--mm +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--mmap] +file_filter = library/mmap.po +source_file = pot/library/mmap.pot +type = PO +minimum_perc = 0 +resource_name = library--mmap +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--modulefinder] +file_filter = library/modulefinder.po +source_file = pot/library/modulefinder.pot +type = PO +minimum_perc = 0 +resource_name = library--modulefinder +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--modules] +file_filter = library/modules.po +source_file = pot/library/modules.pot +type = PO +minimum_perc = 0 +resource_name = library--modules +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--msilib] +file_filter = library/msilib.po +source_file = pot/library/msilib.pot +type = PO +minimum_perc = 0 +resource_name = library--msilib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--msvcrt] +file_filter = library/msvcrt.po +source_file = pot/library/msvcrt.pot +type = PO +minimum_perc = 0 +resource_name = library--msvcrt +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--multiprocessing] +file_filter = library/multiprocessing.po +source_file = pot/library/multiprocessing.pot +type = PO +minimum_perc = 0 +resource_name = library--multiprocessing +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--multiprocessing_shared_memory] +file_filter = library/multiprocessing.shared_memory.po +source_file = pot/library/multiprocessing.shared_memory.pot +type = PO +minimum_perc = 0 +resource_name = library--multiprocessing_shared_memory +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--netdata] +file_filter = library/netdata.po +source_file = pot/library/netdata.pot +type = PO +minimum_perc = 0 +resource_name = library--netdata +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--netrc] +file_filter = library/netrc.po +source_file = pot/library/netrc.pot +type = PO +minimum_perc = 0 +resource_name = library--netrc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--nis] +file_filter = library/nis.po +source_file = pot/library/nis.pot +type = PO +minimum_perc = 0 +resource_name = library--nis +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--nntplib] +file_filter = library/nntplib.po +source_file = pot/library/nntplib.pot +type = PO +minimum_perc = 0 +resource_name = library--nntplib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--numbers] +file_filter = library/numbers.po +source_file = pot/library/numbers.pot +type = PO +minimum_perc = 0 +resource_name = library--numbers +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--numeric] +file_filter = library/numeric.po +source_file = pot/library/numeric.pot +type = PO +minimum_perc = 0 +resource_name = library--numeric +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--operator] +file_filter = library/operator.po +source_file = pot/library/operator.pot +type = PO +minimum_perc = 0 +resource_name = library--operator +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--optparse] +file_filter = library/optparse.po +source_file = pot/library/optparse.pot +type = PO +minimum_perc = 0 +resource_name = library--optparse +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--os] +file_filter = library/os.po +source_file = pot/library/os.pot +type = PO +minimum_perc = 0 +resource_name = library--os +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--os_path] +file_filter = library/os.path.po +source_file = pot/library/os.path.pot +type = PO +minimum_perc = 0 +resource_name = library--os_path +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ossaudiodev] +file_filter = library/ossaudiodev.po +source_file = pot/library/ossaudiodev.pot +type = PO +minimum_perc = 0 +resource_name = library--ossaudiodev +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pathlib] +file_filter = library/pathlib.po +source_file = pot/library/pathlib.pot +type = PO +minimum_perc = 0 +resource_name = library--pathlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pdb] +file_filter = library/pdb.po +source_file = pot/library/pdb.pot +type = PO +minimum_perc = 0 +resource_name = library--pdb +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--persistence] +file_filter = library/persistence.po +source_file = pot/library/persistence.pot +type = PO +minimum_perc = 0 +resource_name = library--persistence +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pickle] +file_filter = library/pickle.po +source_file = pot/library/pickle.pot +type = PO +minimum_perc = 0 +resource_name = library--pickle +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pickletools] +file_filter = library/pickletools.po +source_file = pot/library/pickletools.pot +type = PO +minimum_perc = 0 +resource_name = library--pickletools +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pipes] +file_filter = library/pipes.po +source_file = pot/library/pipes.pot +type = PO +minimum_perc = 0 +resource_name = library--pipes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pkgutil] +file_filter = library/pkgutil.po +source_file = pot/library/pkgutil.pot +type = PO +minimum_perc = 0 +resource_name = library--pkgutil +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--platform] +file_filter = library/platform.po +source_file = pot/library/platform.pot +type = PO +minimum_perc = 0 +resource_name = library--platform +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--plistlib] +file_filter = library/plistlib.po +source_file = pot/library/plistlib.pot +type = PO +minimum_perc = 0 +resource_name = library--plistlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--poplib] +file_filter = library/poplib.po +source_file = pot/library/poplib.pot +type = PO +minimum_perc = 0 +resource_name = library--poplib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--posix] +file_filter = library/posix.po +source_file = pot/library/posix.pot +type = PO +minimum_perc = 0 +resource_name = library--posix +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pprint] +file_filter = library/pprint.po +source_file = pot/library/pprint.pot +type = PO +minimum_perc = 0 +resource_name = library--pprint +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--profile] +file_filter = library/profile.po +source_file = pot/library/profile.pot +type = PO +minimum_perc = 0 +resource_name = library--profile +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pty] +file_filter = library/pty.po +source_file = pot/library/pty.pot +type = PO +minimum_perc = 0 +resource_name = library--pty +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pwd] +file_filter = library/pwd.po +source_file = pot/library/pwd.pot +type = PO +minimum_perc = 0 +resource_name = library--pwd +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--py_compile] +file_filter = library/py_compile.po +source_file = pot/library/py_compile.pot +type = PO +minimum_perc = 0 +resource_name = library--py_compile +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pyclbr] +file_filter = library/pyclbr.po +source_file = pot/library/pyclbr.pot +type = PO +minimum_perc = 0 +resource_name = library--pyclbr +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pydoc] +file_filter = library/pydoc.po +source_file = pot/library/pydoc.pot +type = PO +minimum_perc = 0 +resource_name = library--pydoc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--pyexpat] +file_filter = library/pyexpat.po +source_file = pot/library/pyexpat.pot +type = PO +minimum_perc = 0 +resource_name = library--pyexpat +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--python] +file_filter = library/python.po +source_file = pot/library/python.pot +type = PO +minimum_perc = 0 +resource_name = library--python +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--queue] +file_filter = library/queue.po +source_file = pot/library/queue.pot +type = PO +minimum_perc = 0 +resource_name = library--queue +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--quopri] +file_filter = library/quopri.po +source_file = pot/library/quopri.pot +type = PO +minimum_perc = 0 +resource_name = library--quopri +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--random] +file_filter = library/random.po +source_file = pot/library/random.pot +type = PO +minimum_perc = 0 +resource_name = library--random +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--re] +file_filter = library/re.po +source_file = pot/library/re.pot +type = PO +minimum_perc = 0 +resource_name = library--re +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--readline] +file_filter = library/readline.po +source_file = pot/library/readline.pot +type = PO +minimum_perc = 0 +resource_name = library--readline +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--reprlib] +file_filter = library/reprlib.po +source_file = pot/library/reprlib.pot +type = PO +minimum_perc = 0 +resource_name = library--reprlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--resource] +file_filter = library/resource.po +source_file = pot/library/resource.pot +type = PO +minimum_perc = 0 +resource_name = library--resource +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--rlcompleter] +file_filter = library/rlcompleter.po +source_file = pot/library/rlcompleter.pot +type = PO +minimum_perc = 0 +resource_name = library--rlcompleter +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--runpy] +file_filter = library/runpy.po +source_file = pot/library/runpy.pot +type = PO +minimum_perc = 0 +resource_name = library--runpy +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--sched] +file_filter = library/sched.po +source_file = pot/library/sched.pot +type = PO +minimum_perc = 0 +resource_name = library--sched +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--secrets] +file_filter = library/secrets.po +source_file = pot/library/secrets.pot +type = PO +minimum_perc = 0 +resource_name = library--secrets +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--security_warnings] +file_filter = library/security_warnings.po +source_file = pot/library/security_warnings.pot +type = PO +minimum_perc = 0 +resource_name = library--security_warnings +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--select] +file_filter = library/select.po +source_file = pot/library/select.pot +type = PO +minimum_perc = 0 +resource_name = library--select +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--selectors] +file_filter = library/selectors.po +source_file = pot/library/selectors.pot +type = PO +minimum_perc = 0 +resource_name = library--selectors +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--shelve] +file_filter = library/shelve.po +source_file = pot/library/shelve.pot +type = PO +minimum_perc = 0 +resource_name = library--shelve +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--shlex] +file_filter = library/shlex.po +source_file = pot/library/shlex.pot +type = PO +minimum_perc = 0 +resource_name = library--shlex +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--shutil] +file_filter = library/shutil.po +source_file = pot/library/shutil.pot +type = PO +minimum_perc = 0 +resource_name = library--shutil +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--signal] +file_filter = library/signal.po +source_file = pot/library/signal.pot +type = PO +minimum_perc = 0 +resource_name = library--signal +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--site] +file_filter = library/site.po +source_file = pot/library/site.pot +type = PO +minimum_perc = 0 +resource_name = library--site +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--smtpd] +file_filter = library/smtpd.po +source_file = pot/library/smtpd.pot +type = PO +minimum_perc = 0 +resource_name = library--smtpd +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--smtplib] +file_filter = library/smtplib.po +source_file = pot/library/smtplib.pot +type = PO +minimum_perc = 0 +resource_name = library--smtplib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--sndhdr] +file_filter = library/sndhdr.po +source_file = pot/library/sndhdr.pot +type = PO +minimum_perc = 0 +resource_name = library--sndhdr +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--socket] +file_filter = library/socket.po +source_file = pot/library/socket.pot +type = PO +minimum_perc = 0 +resource_name = library--socket +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--socketserver] +file_filter = library/socketserver.po +source_file = pot/library/socketserver.pot +type = PO +minimum_perc = 0 +resource_name = library--socketserver +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--spwd] +file_filter = library/spwd.po +source_file = pot/library/spwd.pot +type = PO +minimum_perc = 0 +resource_name = library--spwd +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--sqlite3] +file_filter = library/sqlite3.po +source_file = pot/library/sqlite3.pot +type = PO +minimum_perc = 0 +resource_name = library--sqlite3 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--ssl] +file_filter = library/ssl.po +source_file = pot/library/ssl.pot +type = PO +minimum_perc = 0 +resource_name = library--ssl +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--stat] +file_filter = library/stat.po +source_file = pot/library/stat.pot +type = PO +minimum_perc = 0 +resource_name = library--stat +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--statistics] +file_filter = library/statistics.po +source_file = pot/library/statistics.pot +type = PO +minimum_perc = 0 +resource_name = library--statistics +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--stdtypes] +file_filter = library/stdtypes.po +source_file = pot/library/stdtypes.pot +type = PO +minimum_perc = 0 +resource_name = library--stdtypes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--string] +file_filter = library/string.po +source_file = pot/library/string.pot +type = PO +minimum_perc = 0 +resource_name = library--string +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--stringprep] +file_filter = library/stringprep.po +source_file = pot/library/stringprep.pot +type = PO +minimum_perc = 0 +resource_name = library--stringprep +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--struct] +file_filter = library/struct.po +source_file = pot/library/struct.pot +type = PO +minimum_perc = 0 +resource_name = library--struct +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--subprocess] +file_filter = library/subprocess.po +source_file = pot/library/subprocess.pot +type = PO +minimum_perc = 0 +resource_name = library--subprocess +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--sunau] +file_filter = library/sunau.po +source_file = pot/library/sunau.pot +type = PO +minimum_perc = 0 +resource_name = library--sunau +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--superseded] +file_filter = library/superseded.po +source_file = pot/library/superseded.pot +type = PO +minimum_perc = 0 +resource_name = library--superseded +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--symtable] +file_filter = library/symtable.po +source_file = pot/library/symtable.pot +type = PO +minimum_perc = 0 +resource_name = library--symtable +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--sys] +file_filter = library/sys.po +source_file = pot/library/sys.pot +type = PO +minimum_perc = 0 +resource_name = library--sys +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--sys_path_init] +file_filter = library/sys_path_init.po +source_file = pot/library/sys_path_init.pot +type = PO +minimum_perc = 0 +resource_name = library--sys_path_init +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--sysconfig] +file_filter = library/sysconfig.po +source_file = pot/library/sysconfig.pot +type = PO +minimum_perc = 0 +resource_name = library--sysconfig +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--syslog] +file_filter = library/syslog.po +source_file = pot/library/syslog.pot +type = PO +minimum_perc = 0 +resource_name = library--syslog +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tabnanny] +file_filter = library/tabnanny.po +source_file = pot/library/tabnanny.pot +type = PO +minimum_perc = 0 +resource_name = library--tabnanny +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tarfile] +file_filter = library/tarfile.po +source_file = pot/library/tarfile.pot +type = PO +minimum_perc = 0 +resource_name = library--tarfile +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--telnetlib] +file_filter = library/telnetlib.po +source_file = pot/library/telnetlib.pot +type = PO +minimum_perc = 0 +resource_name = library--telnetlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tempfile] +file_filter = library/tempfile.po +source_file = pot/library/tempfile.pot +type = PO +minimum_perc = 0 +resource_name = library--tempfile +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--termios] +file_filter = library/termios.po +source_file = pot/library/termios.pot +type = PO +minimum_perc = 0 +resource_name = library--termios +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--test] +file_filter = library/test.po +source_file = pot/library/test.pot +type = PO +minimum_perc = 0 +resource_name = library--test +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--text] +file_filter = library/text.po +source_file = pot/library/text.pot +type = PO +minimum_perc = 0 +resource_name = library--text +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--textwrap] +file_filter = library/textwrap.po +source_file = pot/library/textwrap.pot +type = PO +minimum_perc = 0 +resource_name = library--textwrap +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--threading] +file_filter = library/threading.po +source_file = pot/library/threading.pot +type = PO +minimum_perc = 0 +resource_name = library--threading +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--time] +file_filter = library/time.po +source_file = pot/library/time.pot +type = PO +minimum_perc = 0 +resource_name = library--time +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--timeit] +file_filter = library/timeit.po +source_file = pot/library/timeit.pot +type = PO +minimum_perc = 0 +resource_name = library--timeit +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tk] +file_filter = library/tk.po +source_file = pot/library/tk.pot +type = PO +minimum_perc = 0 +resource_name = library--tk +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter] +file_filter = library/tkinter.po +source_file = pot/library/tkinter.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter_colorchooser] +file_filter = library/tkinter.colorchooser.po +source_file = pot/library/tkinter.colorchooser.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter_colorchooser +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter_dnd] +file_filter = library/tkinter.dnd.po +source_file = pot/library/tkinter.dnd.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter_dnd +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter_font] +file_filter = library/tkinter.font.po +source_file = pot/library/tkinter.font.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter_font +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter_messagebox] +file_filter = library/tkinter.messagebox.po +source_file = pot/library/tkinter.messagebox.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter_messagebox +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter_scrolledtext] +file_filter = library/tkinter.scrolledtext.po +source_file = pot/library/tkinter.scrolledtext.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter_scrolledtext +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter_tix] +file_filter = library/tkinter.tix.po +source_file = pot/library/tkinter.tix.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter_tix +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tkinter_ttk] +file_filter = library/tkinter.ttk.po +source_file = pot/library/tkinter.ttk.pot +type = PO +minimum_perc = 0 +resource_name = library--tkinter_ttk +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--token] +file_filter = library/token.po +source_file = pot/library/token.pot +type = PO +minimum_perc = 0 +resource_name = library--token +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tokenize] +file_filter = library/tokenize.po +source_file = pot/library/tokenize.pot +type = PO +minimum_perc = 0 +resource_name = library--tokenize +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tomllib] +file_filter = library/tomllib.po +source_file = pot/library/tomllib.pot +type = PO +minimum_perc = 0 +resource_name = library--tomllib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--trace] +file_filter = library/trace.po +source_file = pot/library/trace.pot +type = PO +minimum_perc = 0 +resource_name = library--trace +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--traceback] +file_filter = library/traceback.po +source_file = pot/library/traceback.pot +type = PO +minimum_perc = 0 +resource_name = library--traceback +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tracemalloc] +file_filter = library/tracemalloc.po +source_file = pot/library/tracemalloc.pot +type = PO +minimum_perc = 0 +resource_name = library--tracemalloc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--tty] +file_filter = library/tty.po +source_file = pot/library/tty.pot +type = PO +minimum_perc = 0 +resource_name = library--tty +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--turtle] +file_filter = library/turtle.po +source_file = pot/library/turtle.pot +type = PO +minimum_perc = 0 +resource_name = library--turtle +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--types] +file_filter = library/types.po +source_file = pot/library/types.pot +type = PO +minimum_perc = 0 +resource_name = library--types +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--typing] +file_filter = library/typing.po +source_file = pot/library/typing.pot +type = PO +minimum_perc = 0 +resource_name = library--typing +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--unicodedata] +file_filter = library/unicodedata.po +source_file = pot/library/unicodedata.pot +type = PO +minimum_perc = 0 +resource_name = library--unicodedata +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--unittest] +file_filter = library/unittest.po +source_file = pot/library/unittest.pot +type = PO +minimum_perc = 0 +resource_name = library--unittest +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--unittest_mock] +file_filter = library/unittest.mock.po +source_file = pot/library/unittest.mock.pot +type = PO +minimum_perc = 0 +resource_name = library--unittest_mock +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--unittest_mock-examples] +file_filter = library/unittest.mock-examples.po +source_file = pot/library/unittest.mock-examples.pot +type = PO +minimum_perc = 0 +resource_name = library--unittest_mock-examples +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--unix] +file_filter = library/unix.po +source_file = pot/library/unix.pot +type = PO +minimum_perc = 0 +resource_name = library--unix +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--urllib] +file_filter = library/urllib.po +source_file = pot/library/urllib.pot +type = PO +minimum_perc = 0 +resource_name = library--urllib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--urllib_error] +file_filter = library/urllib.error.po +source_file = pot/library/urllib.error.pot +type = PO +minimum_perc = 0 +resource_name = library--urllib_error +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--urllib_parse] +file_filter = library/urllib.parse.po +source_file = pot/library/urllib.parse.pot +type = PO +minimum_perc = 0 +resource_name = library--urllib_parse +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--urllib_request] +file_filter = library/urllib.request.po +source_file = pot/library/urllib.request.pot +type = PO +minimum_perc = 0 +resource_name = library--urllib_request +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--urllib_robotparser] +file_filter = library/urllib.robotparser.po +source_file = pot/library/urllib.robotparser.pot +type = PO +minimum_perc = 0 +resource_name = library--urllib_robotparser +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--uu] +file_filter = library/uu.po +source_file = pot/library/uu.pot +type = PO +minimum_perc = 0 +resource_name = library--uu +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--uuid] +file_filter = library/uuid.po +source_file = pot/library/uuid.pot +type = PO +minimum_perc = 0 +resource_name = library--uuid +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--venv] +file_filter = library/venv.po +source_file = pot/library/venv.pot +type = PO +minimum_perc = 0 +resource_name = library--venv +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--warnings] +file_filter = library/warnings.po +source_file = pot/library/warnings.pot +type = PO +minimum_perc = 0 +resource_name = library--warnings +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--wave] +file_filter = library/wave.po +source_file = pot/library/wave.pot +type = PO +minimum_perc = 0 +resource_name = library--wave +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--weakref] +file_filter = library/weakref.po +source_file = pot/library/weakref.pot +type = PO +minimum_perc = 0 +resource_name = library--weakref +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--webbrowser] +file_filter = library/webbrowser.po +source_file = pot/library/webbrowser.pot +type = PO +minimum_perc = 0 +resource_name = library--webbrowser +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--windows] +file_filter = library/windows.po +source_file = pot/library/windows.pot +type = PO +minimum_perc = 0 +resource_name = library--windows +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--winreg] +file_filter = library/winreg.po +source_file = pot/library/winreg.pot +type = PO +minimum_perc = 0 +resource_name = library--winreg +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--winsound] +file_filter = library/winsound.po +source_file = pot/library/winsound.pot +type = PO +minimum_perc = 0 +resource_name = library--winsound +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--wsgiref] +file_filter = library/wsgiref.po +source_file = pot/library/wsgiref.pot +type = PO +minimum_perc = 0 +resource_name = library--wsgiref +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xdrlib] +file_filter = library/xdrlib.po +source_file = pot/library/xdrlib.pot +type = PO +minimum_perc = 0 +resource_name = library--xdrlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml] +file_filter = library/xml.po +source_file = pot/library/xml.pot +type = PO +minimum_perc = 0 +resource_name = library--xml +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_dom] +file_filter = library/xml.dom.po +source_file = pot/library/xml.dom.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_dom +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_dom_minidom] +file_filter = library/xml.dom.minidom.po +source_file = pot/library/xml.dom.minidom.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_dom_minidom +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_dom_pulldom] +file_filter = library/xml.dom.pulldom.po +source_file = pot/library/xml.dom.pulldom.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_dom_pulldom +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_etree_elementtree] +file_filter = library/xml.etree.elementtree.po +source_file = pot/library/xml.etree.elementtree.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_etree_elementtree +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_sax] +file_filter = library/xml.sax.po +source_file = pot/library/xml.sax.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_sax +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_sax_handler] +file_filter = library/xml.sax.handler.po +source_file = pot/library/xml.sax.handler.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_sax_handler +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_sax_reader] +file_filter = library/xml.sax.reader.po +source_file = pot/library/xml.sax.reader.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_sax_reader +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xml_sax_utils] +file_filter = library/xml.sax.utils.po +source_file = pot/library/xml.sax.utils.pot +type = PO +minimum_perc = 0 +resource_name = library--xml_sax_utils +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xmlrpc] +file_filter = library/xmlrpc.po +source_file = pot/library/xmlrpc.pot +type = PO +minimum_perc = 0 +resource_name = library--xmlrpc +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xmlrpc_client] +file_filter = library/xmlrpc.client.po +source_file = pot/library/xmlrpc.client.pot +type = PO +minimum_perc = 0 +resource_name = library--xmlrpc_client +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--xmlrpc_server] +file_filter = library/xmlrpc.server.po +source_file = pot/library/xmlrpc.server.pot +type = PO +minimum_perc = 0 +resource_name = library--xmlrpc_server +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--zipapp] +file_filter = library/zipapp.po +source_file = pot/library/zipapp.pot +type = PO +minimum_perc = 0 +resource_name = library--zipapp +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--zipfile] +file_filter = library/zipfile.po +source_file = pot/library/zipfile.pot +type = PO +minimum_perc = 0 +resource_name = library--zipfile +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--zipimport] +file_filter = library/zipimport.po +source_file = pot/library/zipimport.pot +type = PO +minimum_perc = 0 +resource_name = library--zipimport +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--zlib] +file_filter = library/zlib.po +source_file = pot/library/zlib.pot +type = PO +minimum_perc = 0 +resource_name = library--zlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:library--zoneinfo] +file_filter = library/zoneinfo.po +source_file = pot/library/zoneinfo.pot +type = PO +minimum_perc = 0 +resource_name = library--zoneinfo +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:license] +file_filter = license.po +source_file = pot/license.pot +type = PO +minimum_perc = 0 +resource_name = license +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--compound_stmts] +file_filter = reference/compound_stmts.po +source_file = pot/reference/compound_stmts.pot +type = PO +minimum_perc = 0 +resource_name = reference--compound_stmts +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--datamodel] +file_filter = reference/datamodel.po +source_file = pot/reference/datamodel.pot +type = PO +minimum_perc = 0 +resource_name = reference--datamodel +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--executionmodel] +file_filter = reference/executionmodel.po +source_file = pot/reference/executionmodel.pot +type = PO +minimum_perc = 0 +resource_name = reference--executionmodel +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--expressions] +file_filter = reference/expressions.po +source_file = pot/reference/expressions.pot +type = PO +minimum_perc = 0 +resource_name = reference--expressions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--grammar] +file_filter = reference/grammar.po +source_file = pot/reference/grammar.pot +type = PO +minimum_perc = 0 +resource_name = reference--grammar +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--import] +file_filter = reference/import.po +source_file = pot/reference/import.pot +type = PO +minimum_perc = 0 +resource_name = reference--import +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--index] +file_filter = reference/index.po +source_file = pot/reference/index.pot +type = PO +minimum_perc = 0 +resource_name = reference--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--introduction] +file_filter = reference/introduction.po +source_file = pot/reference/introduction.pot +type = PO +minimum_perc = 0 +resource_name = reference--introduction +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--lexical_analysis] +file_filter = reference/lexical_analysis.po +source_file = pot/reference/lexical_analysis.pot +type = PO +minimum_perc = 0 +resource_name = reference--lexical_analysis +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--simple_stmts] +file_filter = reference/simple_stmts.po +source_file = pot/reference/simple_stmts.pot +type = PO +minimum_perc = 0 +resource_name = reference--simple_stmts +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:reference--toplevel_components] +file_filter = reference/toplevel_components.po +source_file = pot/reference/toplevel_components.pot +type = PO +minimum_perc = 0 +resource_name = reference--toplevel_components +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:sphinx] +file_filter = sphinx.po +source_file = pot/sphinx.pot +type = PO +minimum_perc = 0 +resource_name = sphinx +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--appendix] +file_filter = tutorial/appendix.po +source_file = pot/tutorial/appendix.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--appendix +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--appetite] +file_filter = tutorial/appetite.po +source_file = pot/tutorial/appetite.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--appetite +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--classes] +file_filter = tutorial/classes.po +source_file = pot/tutorial/classes.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--classes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--controlflow] +file_filter = tutorial/controlflow.po +source_file = pot/tutorial/controlflow.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--controlflow +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--datastructures] +file_filter = tutorial/datastructures.po +source_file = pot/tutorial/datastructures.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--datastructures +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--errors] +file_filter = tutorial/errors.po +source_file = pot/tutorial/errors.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--errors +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--floatingpoint] +file_filter = tutorial/floatingpoint.po +source_file = pot/tutorial/floatingpoint.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--floatingpoint +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--index] +file_filter = tutorial/index.po +source_file = pot/tutorial/index.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--inputoutput] +file_filter = tutorial/inputoutput.po +source_file = pot/tutorial/inputoutput.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--inputoutput +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--interactive] +file_filter = tutorial/interactive.po +source_file = pot/tutorial/interactive.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--interactive +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--interpreter] +file_filter = tutorial/interpreter.po +source_file = pot/tutorial/interpreter.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--interpreter +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--introduction] +file_filter = tutorial/introduction.po +source_file = pot/tutorial/introduction.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--introduction +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--modules] +file_filter = tutorial/modules.po +source_file = pot/tutorial/modules.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--modules +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--stdlib] +file_filter = tutorial/stdlib.po +source_file = pot/tutorial/stdlib.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--stdlib +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--stdlib2] +file_filter = tutorial/stdlib2.po +source_file = pot/tutorial/stdlib2.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--stdlib2 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--venv] +file_filter = tutorial/venv.po +source_file = pot/tutorial/venv.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--venv +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:tutorial--whatnow] +file_filter = tutorial/whatnow.po +source_file = pot/tutorial/whatnow.pot +type = PO +minimum_perc = 0 +resource_name = tutorial--whatnow +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:using--cmdline] +file_filter = using/cmdline.po +source_file = pot/using/cmdline.pot +type = PO +minimum_perc = 0 +resource_name = using--cmdline +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:using--configure] +file_filter = using/configure.po +source_file = pot/using/configure.pot +type = PO +minimum_perc = 0 +resource_name = using--configure +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:using--editors] +file_filter = using/editors.po +source_file = pot/using/editors.pot +type = PO +minimum_perc = 0 +resource_name = using--editors +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:using--index] +file_filter = using/index.po +source_file = pot/using/index.pot +type = PO +minimum_perc = 0 +resource_name = using--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:using--mac] +file_filter = using/mac.po +source_file = pot/using/mac.pot +type = PO +minimum_perc = 0 +resource_name = using--mac +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:using--unix] +file_filter = using/unix.po +source_file = pot/using/unix.pot +type = PO +minimum_perc = 0 +resource_name = using--unix +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:using--windows] +file_filter = using/windows.po +source_file = pot/using/windows.pot +type = PO +minimum_perc = 0 +resource_name = using--windows +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_0] +file_filter = whatsnew/2.0.po +source_file = pot/whatsnew/2.0.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_0 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_1] +file_filter = whatsnew/2.1.po +source_file = pot/whatsnew/2.1.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_1 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_2] +file_filter = whatsnew/2.2.po +source_file = pot/whatsnew/2.2.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_2 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_3] +file_filter = whatsnew/2.3.po +source_file = pot/whatsnew/2.3.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_3 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_4] +file_filter = whatsnew/2.4.po +source_file = pot/whatsnew/2.4.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_4 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_5] +file_filter = whatsnew/2.5.po +source_file = pot/whatsnew/2.5.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_5 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_6] +file_filter = whatsnew/2.6.po +source_file = pot/whatsnew/2.6.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_6 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--2_7] +file_filter = whatsnew/2.7.po +source_file = pot/whatsnew/2.7.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--2_7 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_0] +file_filter = whatsnew/3.0.po +source_file = pot/whatsnew/3.0.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_0 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_1] +file_filter = whatsnew/3.1.po +source_file = pot/whatsnew/3.1.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_1 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_10] +file_filter = whatsnew/3.10.po +source_file = pot/whatsnew/3.10.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_10 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_11] +file_filter = whatsnew/3.11.po +source_file = pot/whatsnew/3.11.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_11 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_2] +file_filter = whatsnew/3.2.po +source_file = pot/whatsnew/3.2.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_2 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_3] +file_filter = whatsnew/3.3.po +source_file = pot/whatsnew/3.3.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_3 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_4] +file_filter = whatsnew/3.4.po +source_file = pot/whatsnew/3.4.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_4 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_5] +file_filter = whatsnew/3.5.po +source_file = pot/whatsnew/3.5.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_5 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_6] +file_filter = whatsnew/3.6.po +source_file = pot/whatsnew/3.6.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_6 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_7] +file_filter = whatsnew/3.7.po +source_file = pot/whatsnew/3.7.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_7 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_8] +file_filter = whatsnew/3.8.po +source_file = pot/whatsnew/3.8.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_8 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--3_9] +file_filter = whatsnew/3.9.po +source_file = pot/whatsnew/3.9.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--3_9 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--changelog] +file_filter = whatsnew/changelog.po +source_file = pot/whatsnew/changelog.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--changelog +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-311:r:whatsnew--index] +file_filter = whatsnew/index.po +source_file = pot/whatsnew/index.pot +type = PO +minimum_perc = 0 +resource_name = whatsnew--index +replace_edited_strings = false +keep_translations = false + diff --git a/README.md b/README.md deleted file mode 100644 index a1d3da3041..0000000000 --- a/README.md +++ /dev/null @@ -1,73 +0,0 @@ -Polskie tłumaczenie dokumentacji Pythona -======================================== - -![build](https://github.com/python/python-docs-pl/workflows/.github/workflows/update-and-build.yml/badge.svg) -![49.64% przełącznika języków](https://img.shields.io/badge/przełącznik_języków-49.64%25-0.svg) -![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-3.56%25-0.svg) -![18 tłumaczy](https://img.shields.io/badge/tłumaczy-18-0.svg) - - -Jeśli znalazłeś(-aś) błąd lub masz sugestię, -[dodaj zgłoszenie](https://github.com/python/python-docs-pl/issues) w tym projekcie lub -napraw go sam(a): - -* Wejdź na stronę -projektu [dokumentacji Pythona](https://explore.transifex.com/python-doc/python-newest/). -* Naciśnij przycisk „Join this project”, aby dołączyć do projektu. -* Utwórz konto Transifex. -* Na stronie projektu wybierz język polski. -* Po dołączeniu do zespołu, wybierz zasób, który chcesz poprawić/zaktualizować. - -Więcej informacji o używaniu Transifeksa znajdziesz w -[jego dokumentacji](https://docs.transifex.com/getting-started-1/translators). - -**Postęp tłumaczenia** - -![postęp tłumaczenia do przełącznika języków](language-switcher-progress.svg) - -Język polski pojawi się w przełączniku języków na docs.python.org, -[kiedy w pełni przetłumaczone będą](https://www.python.org/dev/peps/pep-0545/#add-translation-to-the-language-switcher): -* `bugs`, -* wszystkie zasoby z katalogu `tutorial`, -* `library/functions`. - -**Jak obejrzeć najnowszy build dokumentacji?** - -Pobierz ostatnią zbudowaną dokumentację z listy artefaktów w ostatniej GitHub Action (zakładka Actions). -Tłumaczenia pobierane są z Transifeksa do tego repozytorium co około pół godziny. -Dokumentacja na python.org aktualizowana jest około raz dziennie. - -**Kanały komunikacji** - -* [python-docs-pl Discord](https://discord.gg/3faJmGKhta) -* [Python translations working group](https://mail.python.org/mailman3/lists/translation.python.org/) -* [Python Documentation Special Interest Group](https://www.python.org/community/sigs/current/doc-sig/) - -**Licencja** - -Zapraszając do współtworzenia projektu na platformie Transifex, proponujemy umowę na -przekazanie twoich tłumaczeń Python Software Foundation -[na licencji CC0](https://creativecommons.org/publicdomain/zero/1.0/deed.pl). -W zamian będzie widoczne, że jesteś tłumaczem(-ką) części, którą przetłumaczyłeś(-łaś). -Wyrażasz akceptację tej umowy przesyłając swoją pracę do włączenia do dokumentacji. - -**Aktualizacja tłumaczeń** -* `./manage_translation.py recreate_tx_config` -* `./manage_translation.py fetch` -* `cog -rP README.md` - -**Potencjalnie przydatne materiały** -* [polskie tłumaczenie dokumentacji Pythona 2.3](https://pl.python.org/docs/). diff --git a/about.po b/about.po index efaafa89f8..585937385c 100644 --- a/about.po +++ b/about.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Maciej Olko , 2023 +# Rafael Fontenelle , 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 00:47+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/bugs.po b/bugs.po index 895b36b9d1..29dc5c41ab 100644 --- a/bugs.po +++ b/bugs.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Ciarbin , 2021 -# Krzysztof Achinger, 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -111,11 +109,11 @@ msgstr "" "Pythona." msgid "" -"`Documentation Translations `_" +"`Documentation Translations `_" msgstr "" -"`Tłumaczenia dokumentacji `_" +"`Tłumaczenie dokumentacji `_" msgid "" "A list of GitHub pages for documentation translation and their primary " diff --git a/c-api/abstract.po b/c-api/abstract.po index 2676774373..b092332361 100644 --- a/c-api/abstract.po +++ b/c-api/abstract.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Krzysztof Wierzbicki , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Krzysztof Wierzbicki , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/c-api/allocation.po b/c-api/allocation.po index bc53448b6c..2d7c600675 100644 --- a/c-api/allocation.po +++ b/c-api/allocation.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -24,7 +24,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Allocating Objects on the Heap" -msgstr "" +msgstr "Przydzielanie obiektów na stercie" msgid "" "Initialize a newly allocated object *op* with its type and initial " @@ -33,34 +33,44 @@ msgid "" "detector's set of observed objects. Other fields of the object are not " "affected." msgstr "" +"Inicjalizacja nowo przydzielonego obiektu o nazwie *op*, określa jego typ " +"oraz początkowe odniesienie. Funkcja zwraca zainicjowany obiekt. Jeżeli " +"wartość *type* wskazuje, że obiekt bierze udział w detekcji cyklicznych " +"zbędnych danych \"garbage detector\", to zostaje on dodany do zbioru " +"obiektów obserwowanych przez detektor. Pozostałe pola obiektu pozostają " +"niezmienione." msgid "" "This does everything :c:func:`PyObject_Init` does, and also initializes the " "length information for a variable-size object." msgstr "" +"To wszystko, czym zajmie się funkcja :c:func:`PyObject_Init`, a ponadto " +"zainicjuje informacje o długości dla obiektu o zmiennym rozmiarze." msgid "" "Allocate a new Python object using the C structure type *TYPE* and the " -"Python type object *type*. Fields not defined by the Python object header " -"are not initialized; the object's reference count will be one. The size of " +"Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the " +"Python object header are not initialized. The caller will own the only " +"reference to the object (i.e. its reference count will be one). The size of " "the memory allocation is determined from the :c:member:`~PyTypeObject." "tp_basicsize` field of the type object." msgstr "" msgid "" "Allocate a new Python object using the C structure type *TYPE* and the " -"Python type object *type*. Fields not defined by the Python object header " -"are not initialized. The allocated memory allows for the *TYPE* structure " -"plus *size* fields of the size given by the :c:member:`~PyTypeObject." -"tp_itemsize` field of *type*. This is useful for implementing objects like " -"tuples, which are able to determine their size at construction time. " -"Embedding the array of fields into the same allocation decreases the number " -"of allocations, improving the memory management efficiency." +"Python type object *typeobj* (``PyTypeObject*``). Fields not defined by the " +"Python object header are not initialized. The allocated memory allows for " +"the *TYPE* structure plus *size* (``Py_ssize_t``) fields of the size given " +"by the :c:member:`~PyTypeObject.tp_itemsize` field of *typeobj*. This is " +"useful for implementing objects like tuples, which are able to determine " +"their size at construction time. Embedding the array of fields into the " +"same allocation decreases the number of allocations, improving the memory " +"management efficiency." msgstr "" msgid "" -"Releases memory allocated to an object using :c:func:`PyObject_New` or :c:" -"func:`PyObject_NewVar`. This is normally called from the :c:member:" +"Releases memory allocated to an object using :c:macro:`PyObject_New` or :c:" +"macro:`PyObject_NewVar`. This is normally called from the :c:member:" "`~PyTypeObject.tp_dealloc` handler specified in the object's type. The " "fields of the object should not be accessed after this call as the memory is " "no longer a valid Python object." @@ -71,6 +81,9 @@ msgid "" "using the :c:macro:`Py_None` macro, which evaluates to a pointer to this " "object." msgstr "" +"Obiekt widoczny w Pythonie jako ``None``. Dostęp do tego należy uzyskać " +"wyłącznie za pomocą makra :c:macro:`Py_None`, którego wartością jest " +"wskaźnik do tego obiektu." msgid ":c:func:`PyModule_Create`" msgstr ":c:func:`PyModule_Create`" diff --git a/c-api/apiabiversion.po b/c-api/apiabiversion.po index 147f203b7d..32a228bfa3 100644 --- a/c-api/apiabiversion.po +++ b/c-api/apiabiversion.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,128 +25,147 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "API and ABI Versioning" -msgstr "" +msgstr "API i wersjonowanie ABI" msgid "" "CPython exposes its version number in the following macros. Note that these " "correspond to the version code is **built** with, not necessarily the " "version used at **run time**." msgstr "" +"CPython (standardowa implementacja) ujawnia swój numer wersji w " +"następujących makrach. Należy pamiętać, że odpowiadają one kodowi wersji, z " +"którym został **zbudowany**, niekoniecznie wersji używanej w **czasie " +"działania**." msgid "" "See :ref:`stable` for a discussion of API and ABI stability across versions." msgstr "" +"Więcej informacji na temat stabilności API i ABI w różnych wersjach można " +"znaleźć na stronie :ref:`stable`." msgid "The ``3`` in ``3.4.1a2``." -msgstr "" +msgstr "``3`` w ``3.4.1a2``." msgid "The ``4`` in ``3.4.1a2``." -msgstr "" +msgstr "``4`` w ``3.4.1a2``." msgid "The ``1`` in ``3.4.1a2``." -msgstr "" +msgstr "``1`` w ``3.4.1a2``." msgid "" "The ``a`` in ``3.4.1a2``. This can be ``0xA`` for alpha, ``0xB`` for beta, " "``0xC`` for release candidate or ``0xF`` for final." msgstr "" +"``a`` w ``3.4.1a2``. Może to być ``0xA`` dla wersji alfa, ``0xB`` dla wersji " +"beta, ``0xC`` dla wersji kandydującej do wydania lub ``0xF`` dla wersji " +"finalnej." msgid "The ``2`` in ``3.4.1a2``. Zero for final releases." -msgstr "" +msgstr "``2`` w ``3.4.1a2``. Zero dla ostatecznych wydań." msgid "The Python version number encoded in a single integer." -msgstr "" +msgstr "Numer wersji Pythona zakodowany w pojedynczej liczbie całkowitej." msgid "" "The underlying version information can be found by treating it as a 32 bit " "number in the following manner:" msgstr "" +"Podstawowe informacje wersji można znaleźć, traktując je jako 32-bitową " +"liczbę w następujący sposób:" msgid "Bytes" -msgstr "" +msgstr "Bajty" msgid "Bits (big endian order)" -msgstr "" +msgstr "Bity (kolejność big endian)" msgid "Meaning" msgstr "Znaczenie" msgid "Value for ``3.4.1a2``" -msgstr "" +msgstr "Wartość dla ``3.4.1a2``" msgid "1" msgstr "1" msgid "1-8" -msgstr "" +msgstr "1-8" msgid "``PY_MAJOR_VERSION``" -msgstr "" +msgstr "``PY_MAJOR_VERSION``" msgid "``0x03``" -msgstr "" +msgstr "``0x03``" msgid "2" msgstr "2" msgid "9-16" -msgstr "" +msgstr "9-16" msgid "``PY_MINOR_VERSION``" -msgstr "" +msgstr "``PY_MINOR_VERSION``" msgid "``0x04``" -msgstr "" +msgstr "``0x04``" msgid "3" -msgstr "" +msgstr "3" msgid "17-24" -msgstr "" +msgstr "17-24" msgid "``PY_MICRO_VERSION``" -msgstr "" +msgstr "``PY_MICRO_VERSION``" msgid "``0x01``" -msgstr "" +msgstr "``0x01``" msgid "4" msgstr "4" msgid "25-28" -msgstr "" +msgstr "25-28" msgid "``PY_RELEASE_LEVEL``" -msgstr "" +msgstr "``PY_RELEASE_LEVEL``" msgid "``0xA``" -msgstr "" +msgstr "``0xA``" msgid "29-32" -msgstr "" +msgstr "29-32" msgid "``PY_RELEASE_SERIAL``" -msgstr "" +msgstr "``PY_RELEASE_SERIAL``" msgid "``0x2``" -msgstr "" +msgstr "``0x2``" msgid "" "Thus ``3.4.1a2`` is hexversion ``0x030401a2`` and ``3.10.0`` is hexversion " "``0x030a00f0``." msgstr "" +"Tak więc ``3.4.1a2`` jest hekswersją ``0x030401a2``, a ``3.10.0`` jest " +"hekswersją ``0x030a00f0``." msgid "Use this for numeric comparisons, e.g. ``#if PY_VERSION_HEX >= ...``." -msgstr "" +msgstr "Służy do porównywania liczb, np. ``#if PY_VERSION_HEX >= ...``." -msgid "This version is also available via the symbol :data:`Py_Version`." +msgid "This version is also available via the symbol :c:var:`Py_Version`." msgstr "" +"Ta strona wersji jest również dostępna za pośrednictwem symbolu :c:var:" +"`Py_Version`." msgid "" "The Python runtime version number encoded in a single constant integer, with " "the same format as the :c:macro:`PY_VERSION_HEX` macro. This contains the " "Python version used at run time." msgstr "" +"Wersja Python runtime jest zakodowana w pojedynczej stałej liczba całkowita, " +"w tym samym formacie co makro :c:macro:`PY_VERSION_HEX`. Zawiera on Python " +"wersja używany w czasie wykonywania." msgid "All the given macros are defined in :source:`Include/patchlevel.h`." msgstr "" +"Wszystkie podane makra są zdefiniowane w :source:`Include/patchlevel.h`." diff --git a/c-api/arg.po b/c-api/arg.po index 822e8d9339..10d60a039e 100644 --- a/c-api/arg.po +++ b/c-api/arg.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,12 +76,15 @@ msgid "" "These formats allow accessing an object as a contiguous chunk of memory. You " "don't have to provide raw storage for the returned unicode or bytes area." msgstr "" +"Formaty te umożliwiają dostęp do obiektu jako ciągłego fragmentu pamięci. " +"Nie musisz zapewniać nieprzetworzonej pamięci dla zwróconego obszaru unicode " +"lub bajtów." msgid "Unless otherwise stated, buffers are not NUL-terminated." msgstr "Bufory nie są zakończone znakiem NULL, chyba że zaznaczono inaczej." msgid "There are three ways strings and buffers can be converted to C:" -msgstr "" +msgstr "Istnieją trzy sposoby konwersji łańcuchów i buforów na język C:" msgid "" "Formats such as ``y*`` and ``s*`` fill a :c:type:`Py_buffer` structure. This " @@ -217,7 +220,7 @@ msgid "" msgstr "" msgid "``y*`` (:term:`bytes-like object`) [Py_buffer]" -msgstr "" +msgstr "``y*`` (:term:`bytes-like object`) [Py_buffer]" msgid "" "This variant on ``s*`` doesn't accept Unicode objects, only bytes-like " @@ -237,7 +240,7 @@ msgstr "" "obiekty." msgid "``S`` (:class:`bytes`) [PyBytesObject \\*]" -msgstr "" +msgstr "``S`` (:class:`bytes`) [PyBytesObject \\*]" msgid "" "Requires that the Python object is a :class:`bytes` object, without " @@ -246,7 +249,7 @@ msgid "" msgstr "" msgid "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]" -msgstr "" +msgstr "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]" msgid "" "Requires that the Python object is a :class:`bytearray` object, without " @@ -301,7 +304,7 @@ msgid "" msgstr "" msgid "``U`` (:class:`str`) [PyObject \\*]" -msgstr "" +msgstr "``U`` (:class:`str`) [PyObject \\*]" msgid "" "Requires that the Python object is a Unicode object, without attempting any " @@ -430,7 +433,7 @@ msgid "Numbers" msgstr "Liczby" msgid "``b`` (:class:`int`) [unsigned char]" -msgstr "" +msgstr "``b`` (:class:`int`) [unsigned char]" msgid "" "Convert a nonnegative Python integer to an unsigned tiny int, stored in a C :" @@ -438,7 +441,7 @@ msgid "" msgstr "" msgid "``B`` (:class:`int`) [unsigned char]" -msgstr "" +msgstr "``B`` (:class:`int`) [unsigned char]" msgid "" "Convert a Python integer to a tiny int without overflow checking, stored in " @@ -446,7 +449,7 @@ msgid "" msgstr "" msgid "``h`` (:class:`int`) [short int]" -msgstr "" +msgstr "``h`` (:class:`int`) [short int]" msgid "Convert a Python integer to a C :c:expr:`short int`." msgstr "" @@ -460,13 +463,13 @@ msgid "" msgstr "" msgid "``i`` (:class:`int`) [int]" -msgstr "" +msgstr "``i`` (:class:`int`) [int]" msgid "Convert a Python integer to a plain C :c:expr:`int`." msgstr "" msgid "``I`` (:class:`int`) [unsigned int]" -msgstr "" +msgstr "``I`` (:class:`int`) [unsigned int]" msgid "" "Convert a Python integer to a C :c:expr:`unsigned int`, without overflow " @@ -474,13 +477,13 @@ msgid "" msgstr "" msgid "``l`` (:class:`int`) [long int]" -msgstr "" +msgstr "``l`` (:class:`int`) [long int]" msgid "Convert a Python integer to a C :c:expr:`long int`." msgstr "" msgid "``k`` (:class:`int`) [unsigned long]" -msgstr "" +msgstr "``k`` (:class:`int`) [unsigned long]" msgid "" "Convert a Python integer to a C :c:expr:`unsigned long` without overflow " @@ -488,7 +491,7 @@ msgid "" msgstr "" msgid "``L`` (:class:`int`) [long long]" -msgstr "" +msgstr "``L`` (:class:`int`) [long long]" msgid "Convert a Python integer to a C :c:expr:`long long`." msgstr "" @@ -502,7 +505,7 @@ msgid "" msgstr "" msgid "``n`` (:class:`int`) [:c:type:`Py_ssize_t`]" -msgstr "" +msgstr "``n`` (:class:`int`) [:c:type:`Py_ssize_t`]" msgid "Convert a Python integer to a C :c:type:`Py_ssize_t`." msgstr "" @@ -527,19 +530,19 @@ msgid "" msgstr "" msgid "``f`` (:class:`float`) [float]" -msgstr "" +msgstr "``f`` (:class:`float`) [float]" msgid "Convert a Python floating point number to a C :c:expr:`float`." msgstr "" msgid "``d`` (:class:`float`) [double]" -msgstr "" +msgstr "``d`` (:class:`float`) [double]" msgid "Convert a Python floating point number to a C :c:expr:`double`." msgstr "" msgid "``D`` (:class:`complex`) [Py_complex]" -msgstr "" +msgstr "``D`` (:class:`complex`) [Py_complex]" msgid "Convert a Python complex number to a C :c:type:`Py_complex` structure." msgstr "" @@ -548,12 +551,13 @@ msgid "Other objects" msgstr "Inne obiekty" msgid "``O`` (object) [PyObject \\*]" -msgstr "" +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. The object's " -"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 \\*]" @@ -568,7 +572,7 @@ msgid "" msgstr "" msgid "``O&`` (object) [*converter*, *anything*]" -msgstr "" +msgstr "``O&`` (object) [*converter*, *anything*]" msgid "" "Convert a Python object to a C variable through a *converter* function. " @@ -595,10 +599,10 @@ msgid "" msgstr "" msgid "``Py_CLEANUP_SUPPORTED`` was added." -msgstr "" +msgstr "``Py_CLEANUP_SUPPORTED`` został dodany." msgid "``p`` (:class:`bool`) [int]" -msgstr "" +msgstr "``p`` (:class:`bool`) [int]" msgid "" "Tests the value passed in for truth (a boolean **p**\\ redicate) and " @@ -623,18 +627,11 @@ msgstr "" msgid "" "It is possible to pass \"long\" integers (integers whose value exceeds the " -"platform's :const:`LONG_MAX`) however no proper range checking is done --- " +"platform's :c:macro:`LONG_MAX`) however no proper range checking is done --- " "the most significant bits are silently truncated when the receiving field is " "too small to receive the value (actually, the semantics are inherited from " "downcasts in C --- your mileage may vary)." msgstr "" -"Możliwe jest przekazywanie liczb całkowitych \"długich\" (liczb całkowitych, " -"których wartość przekracza wartość stałej :const:`LONG_MAX` określoną dla " -"danej architektury) chociaż żadne właściwe sprawdzenie zakresu nie jest " -"wykonywane - najbardziej znaczące cyfry dwójkowe są w milczeniu obcinane, " -"gdy docelowy obszar pamięci jest zbyt mały, aby przyjąć wartość (w " -"rzeczywistości składnia jest odziedziczona po rzutowaniu z języka C --- " -"twoje doświadczenia mogą się różnić)." msgid "" "A few other characters have a meaning in a format string. These may not " @@ -644,7 +641,7 @@ msgstr "" "wystąpić wewnątrz zagnieżdżonych nawiasach okrągłych. Są to:" msgid "``|``" -msgstr "" +msgstr "``|``" msgid "" "Indicates that the remaining arguments in the Python argument list are " @@ -655,7 +652,7 @@ msgid "" msgstr "" msgid "``$``" -msgstr "" +msgstr "``$``" msgid "" ":c:func:`PyArg_ParseTupleAndKeywords` only: Indicates that the remaining " @@ -665,7 +662,7 @@ msgid "" msgstr "" msgid "``:``" -msgstr "" +msgstr "``:``" msgid "" "The list of format units ends here; the string after the colon is used as " @@ -674,7 +671,7 @@ msgid "" msgstr "" msgid "``;``" -msgstr "" +msgstr "``;``" msgid "" "The list of format units ends here; the string after the semicolon is used " @@ -687,11 +684,9 @@ msgstr "" msgid "" "Note that any Python object references which are provided to the caller are " -"*borrowed* references; do not decrement their reference count!" +"*borrowed* references; do not release them (i.e. do not decrement their " +"reference count)!" msgstr "" -"Zauważ, że dowolne odniesienia do przedmiotów języka pytonowskiego, które są " -"dostarczone wołającemu są *pożyczonymi* odniesieniami; nie zmniejszaj liczby " -"tych odniesień." msgid "" "Additional arguments passed to these functions must be addresses of " @@ -768,7 +763,7 @@ msgstr "" msgid "" "A simpler form of parameter retrieval which does not use a format string to " "specify the types of the arguments. Functions which use this method to " -"retrieve their parameters should be declared as :const:`METH_VARARGS` in " +"retrieve their parameters should be declared as :c:macro:`METH_VARARGS` in " "function or method tables. The tuple containing the actual parameters " "should be passed as *args*; it must actually be a tuple. The length of the " "tuple must be at least *min* and no more than *max*; *min* and *max* may be " @@ -784,7 +779,7 @@ msgstr "" msgid "" "This is an example of the use of this function, taken from the sources for " -"the :mod:`_weakref` helper module for weak references::" +"the :mod:`!_weakref` helper module for weak references::" msgstr "" msgid "" @@ -881,7 +876,7 @@ msgid "``u`` (:class:`str`) [const wchar_t \\*]" msgstr "" msgid "" -"Convert a null-terminated :c:expr:`wchar_t` buffer of Unicode (UTF-16 or " +"Convert a null-terminated :c:type:`wchar_t` buffer of Unicode (UTF-16 or " "UCS-4) data to a Python Unicode object. If the Unicode buffer pointer is " "``NULL``, ``None`` is returned." msgstr "" @@ -906,7 +901,7 @@ msgid "Convert a plain C :c:expr:`int` to a Python integer object." msgstr "" msgid "``b`` (:class:`int`) [char]" -msgstr "" +msgstr "``b`` (:class:`int`) [char]" msgid "Convert a plain C :c:expr:`char` to a Python integer object." msgstr "" @@ -958,33 +953,33 @@ msgid "Convert a C :c:expr:`float` to a Python floating point number." msgstr "" msgid "``D`` (:class:`complex`) [Py_complex \\*]" -msgstr "" +msgstr "``D`` (:class:`complex`) [Py_complex \\*]" msgid "Convert a C :c:type:`Py_complex` structure to a Python complex number." msgstr "" msgid "" -"Pass a Python object untouched (except for its reference count, which 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." +"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." msgstr "" msgid "``S`` (object) [PyObject \\*]" -msgstr "" +msgstr "``S`` (object) [PyObject \\*]" msgid "Same as ``O``." msgstr "" msgid "``N`` (object) [PyObject \\*]" -msgstr "" +msgstr "``N`` (object) [PyObject \\*]" msgid "" -"Same as ``O``, except it doesn't increment the reference count on the " -"object. Useful when the object is created by a call to an object constructor " -"in the argument list." +"Same as ``O``, except it doesn't create a new :term:`strong reference`. " +"Useful when the object is created by a call to an object constructor in the " +"argument list." msgstr "" msgid "" @@ -1008,7 +1003,7 @@ msgid "" msgstr "" msgid "``{items}`` (:class:`dict`) [*matching-items*]" -msgstr "" +msgstr "``{items}`` (:class:`dict`) [*matching-items*]" msgid "" "Convert a sequence of C values to a Python dictionary. Each pair of " diff --git a/c-api/bool.po b/c-api/bool.po new file mode 100644 index 0000000000..46696505ae --- /dev/null +++ b/c-api/bool.po @@ -0,0 +1,79 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "Boolean Objects" +msgstr "Obiekty logiczne" + +msgid "" +"Booleans in Python are implemented as a subclass of integers. There are " +"only two booleans, :const:`Py_False` and :const:`Py_True`. As such, the " +"normal creation and deletion functions don't apply to booleans. The " +"following macros are available, however." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python boolean type; " +"it is the same object as :class:`bool` in the Python layer." +msgstr "" + +msgid "" +"Return true if *o* is of type :c:data:`PyBool_Type`. This function always " +"succeeds." +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. It needs to be " +"treated just like any other object with respect to reference counts." +msgstr "" + +msgid "" +"The Python ``True`` object. This object has no methods. It needs to be " +"treated just like any other object with respect to reference counts." +msgstr "" +"Obiekt Python ``True``. Ten obiekt nie ma żadnych metod. Musi być " +"traktowany jak każdy inny obiekt w odniesieniu do liczby referencji." + +msgid "" +"Return :const:`Py_False` from a function, properly incrementing its " +"reference count." +msgstr "" +"Zwraca :const:`Py_False` z funkcji, odpowiednio zwiększając jej liczbę " +"odwołań." + +msgid "" +"Return :const:`Py_True` from a function, properly incrementing its reference " +"count." +msgstr "" +"Zwraca :const:`Py_True` z funkcji, odpowiednio zwiększając jej liczbę " +"odwołań." + +msgid "" +"Return a new reference to :const:`Py_True` or :const:`Py_False` depending on " +"the truth value of *v*." +msgstr "" +"Zwraca nowe odwołanie do :const:`Py_True` lub :const:`Py_False` w zależności " +"od wartości *v*." diff --git a/c-api/buffer.po b/c-api/buffer.po index e97590c46b..3ec0a28761 100644 --- a/c-api/buffer.po +++ b/c-api/buffer.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +67,7 @@ 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` " +"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 " @@ -136,9 +136,9 @@ msgstr "" msgid "" "A new reference to the exporting object. The reference is owned by the " -"consumer and automatically decremented and set to ``NULL`` by :c:func:" -"`PyBuffer_Release`. The field is the equivalent of the return value of any " -"standard C-API function." +"consumer and automatically released (i.e. reference count decremented) and " +"set to ``NULL`` by :c:func:`PyBuffer_Release`. The field is the equivalent " +"of the return value of any standard C-API function." msgstr "" msgid "" @@ -203,13 +203,8 @@ 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``." -msgstr "" - -msgid "" -"The macro :c:macro:`PyBUF_MAX_NDIM` limits the maximum number of dimensions " -"to 64. Exporters MUST respect this limit, consumers of multi-dimensional " -"buffers SHOULD be able to handle up to :c:macro:`PyBUF_MAX_NDIM` dimensions." +"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 "" @@ -270,6 +265,15 @@ msgid "" "the buffer is released. The consumer MUST NOT alter this value." msgstr "" +msgid "Constants:" +msgstr "" + +msgid "" +"The maximum number of dimensions the memory represents. Exporters MUST " +"respect this limit, consumers of multi-dimensional buffers SHOULD be able to " +"handle up to :c:macro:`!PyBUF_MAX_NDIM` dimensions. Currently set to 64." +msgstr "" + msgid "Buffer request types" msgstr "" @@ -281,7 +285,7 @@ msgid "" msgstr "" msgid "" -"All :c:data:`Py_buffer` fields are unambiguously defined by the request type." +"All :c:type:`Py_buffer` fields are unambiguously defined by the request type." msgstr "" msgid "request-independent fields" @@ -334,7 +338,7 @@ msgid "Request" msgstr "" msgid "shape" -msgstr "" +msgstr "kształt" msgid "strides" msgstr "" @@ -349,7 +353,7 @@ msgid "if needed" msgstr "" msgid "NULL" -msgstr "" +msgstr "NULL" msgid "contiguity requests" msgstr "" @@ -364,16 +368,16 @@ msgid "contig" msgstr "" msgid "C" -msgstr "" +msgstr "C" msgid "F" -msgstr "" +msgstr "F" msgid "C or F" msgstr "" msgid ":c:macro:`PyBUF_ND`" -msgstr "" +msgstr ":c:macro:`PyBUF_ND`" msgid "compound requests" msgstr "" @@ -393,10 +397,10 @@ msgid "readonly" msgstr "" msgid "format" -msgstr "" +msgstr "format" msgid "U" -msgstr "" +msgstr "U" msgid "0" msgstr "0" @@ -465,8 +469,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 :c:" -"data:`PyExc_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 "" @@ -484,7 +488,8 @@ msgid "" msgstr "" msgid "" -"Release the buffer *view* and decrement the reference count for ``view-" +"Release the buffer *view* and release the :term:`strong reference` (i.e. " +"decrement the reference count) to the view's supporting object, ``view-" ">obj``. This function MUST be called when the buffer is no longer being " "used, otherwise reference leaks may occur." msgstr "" @@ -495,8 +500,8 @@ msgid "" msgstr "" msgid "" -"Return the implied :c:data:`~Py_buffer.itemsize` from :c:data:`~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 "" @@ -554,8 +559,8 @@ msgstr "" msgid "" "On success, set ``view->obj`` to a new reference to *exporter* and return 0. " -"Otherwise, raise :c:data:`PyExc_BufferError`, set ``view->obj`` to ``NULL`` " -"and return ``-1``;" +"Otherwise, raise :exc:`BufferError`, set ``view->obj`` to ``NULL`` and " +"return ``-1``;" msgstr "" msgid "" @@ -576,7 +581,7 @@ msgstr "" msgid "buffer object" msgstr "" -msgid "PyBufferProcs" +msgid "PyBufferProcs (C type)" msgstr "" msgid "contiguous" diff --git a/c-api/bytearray.po b/c-api/bytearray.po new file mode 100644 index 0000000000..19e066f432 --- /dev/null +++ b/c-api/bytearray.po @@ -0,0 +1,95 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "Byte Array Objects" +msgstr "" + +msgid "" +"This subtype of :c:type:`PyObject` represents a Python bytearray object." +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." +msgstr "" + +msgid "Type check macros" +msgstr "" + +msgid "" +"Return true if the object *o* is a bytearray object or an instance of a " +"subtype of the bytearray type. This function always succeeds." +msgstr "" + +msgid "" +"Return true if the object *o* is a bytearray object, but not an instance of " +"a subtype of the bytearray type. This function always succeeds." +msgstr "" + +msgid "Direct API functions" +msgstr "" + +msgid "" +"Return a new bytearray object from any object, *o*, that implements the :ref:" +"`buffer protocol `." +msgstr "" + +msgid "" +"Create a new bytearray object from *string* and its length, *len*. On " +"failure, ``NULL`` is returned." +msgstr "" + +msgid "" +"Concat bytearrays *a* and *b* and return a new bytearray with the result." +msgstr "" + +msgid "Return the size of *bytearray* after checking for a ``NULL`` pointer." +msgstr "" + +msgid "" +"Return the contents of *bytearray* as a char array after checking for a " +"``NULL`` pointer. The returned array always has an extra null byte appended." +msgstr "" + +msgid "Resize the internal buffer of *bytearray* to *len*." +msgstr "" + +msgid "Macros" +msgstr "" + +msgid "These macros trade safety for speed and they don't check pointers." +msgstr "" + +msgid "Similar to :c:func:`PyByteArray_AsString`, but without error checking." +msgstr "" + +msgid "Similar to :c:func:`PyByteArray_Size`, but without error checking." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "bytearray" +msgstr "" diff --git a/c-api/bytes.po b/c-api/bytes.po index acab271a51..ea72e7490c 100644 --- a/c-api/bytes.po +++ b/c-api/bytes.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,22 +75,22 @@ msgid "Format Characters" msgstr "" msgid "Type" -msgstr "" +msgstr "Typ" msgid "Comment" -msgstr "" +msgstr "komentarz" -msgid ":attr:`%%`" -msgstr "" +msgid "``%%``" +msgstr "``%%``" msgid "*n/a*" -msgstr "" +msgstr "*n/a*" msgid "The literal % character." msgstr "" -msgid ":attr:`%c`" -msgstr "" +msgid "``%c``" +msgstr "``%c``" msgid "int" msgstr "int" @@ -97,14 +98,14 @@ msgstr "int" msgid "A single byte, represented as a C int." msgstr "" -msgid ":attr:`%d`" -msgstr "" +msgid "``%d``" +msgstr "``%d``" msgid "Equivalent to ``printf(\"%d\")``. [1]_" msgstr "" -msgid ":attr:`%u`" -msgstr "" +msgid "``%u``" +msgstr "``%u``" msgid "unsigned int" msgstr "nieoznaczony typ int" @@ -112,8 +113,8 @@ msgstr "nieoznaczony typ int" msgid "Equivalent to ``printf(\"%u\")``. [1]_" msgstr "" -msgid ":attr:`%ld`" -msgstr "" +msgid "``%ld``" +msgstr "``%ld``" msgid "long" msgstr "" @@ -121,8 +122,8 @@ msgstr "" msgid "Equivalent to ``printf(\"%ld\")``. [1]_" msgstr "" -msgid ":attr:`%lu`" -msgstr "" +msgid "``%lu``" +msgstr "``%lu``" msgid "unsigned long" msgstr "nieoznaczony typ długi" @@ -130,8 +131,8 @@ msgstr "nieoznaczony typ długi" msgid "Equivalent to ``printf(\"%lu\")``. [1]_" msgstr "" -msgid ":attr:`%zd`" -msgstr "" +msgid "``%zd``" +msgstr "``%zd``" msgid ":c:type:`\\ Py_ssize_t`" msgstr "" @@ -139,29 +140,29 @@ msgstr "" msgid "Equivalent to ``printf(\"%zd\")``. [1]_" msgstr "" -msgid ":attr:`%zu`" -msgstr "" +msgid "``%zu``" +msgstr "``%zu``" msgid "size_t" -msgstr "" +msgstr "size_t" msgid "Equivalent to ``printf(\"%zu\")``. [1]_" msgstr "" -msgid ":attr:`%i`" -msgstr "" +msgid "``%i``" +msgstr "``%i``" msgid "Equivalent to ``printf(\"%i\")``. [1]_" msgstr "" -msgid ":attr:`%x`" -msgstr "" +msgid "``%x``" +msgstr "``%x``" msgid "Equivalent to ``printf(\"%x\")``. [1]_" msgstr "" -msgid ":attr:`%s`" -msgstr "" +msgid "``%s``" +msgstr "``%s``" msgid "const char\\*" msgstr "" @@ -169,8 +170,8 @@ msgstr "" msgid "A null-terminated C character array." msgstr "" -msgid ":attr:`%p`" -msgstr "" +msgid "``%p``" +msgstr "``%p``" msgid "const void\\*" msgstr "" @@ -222,7 +223,7 @@ msgstr "" msgid "" "Return the null-terminated contents of the object *obj* through the output " -"variables *buffer* and *length*." +"variables *buffer* and *length*. Returns ``0`` on success." msgstr "" msgid "" @@ -255,8 +256,8 @@ msgstr "" msgid "" "Create a new bytes object in *\\*bytes* containing the contents of *newpart* " -"appended to *bytes*. This version decrements the reference count of " -"*newpart*." +"appended to *bytes*. This version releases the :term:`strong reference` to " +"*newpart* (i.e. decrements its reference count)." msgstr "" msgid "" @@ -273,7 +274,7 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "bytes" msgstr "" diff --git a/c-api/call.po b/c-api/call.po index 53500c75a3..ea41e76c3d 100644 --- a/c-api/call.po +++ b/c-api/call.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +87,7 @@ msgid "" msgstr "" msgid "" -"Classes can implement the vectorcall protocol by enabling the :const:" +"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 " @@ -110,7 +110,7 @@ msgid "*nargsf* is the number of positional arguments plus possibly the" msgstr "" msgid "" -":const:`PY_VECTORCALL_ARGUMENTS_OFFSET` flag. To get the actual number of " +":c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` flag. To get the actual number of " "positional arguments from *nargsf*, use :c:func:`PyVectorcall_NARGS`." msgstr "" @@ -137,7 +137,7 @@ msgstr "" msgid "" "Whenever they can do so cheaply (without additional allocation), callers are " -"encouraged to use :const:`PY_VECTORCALL_ARGUMENTS_OFFSET`. Doing so will " +"encouraged to use :c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET`. Doing so will " "allow callables such as bound methods to make their onward calls (which " "include a prepended *self* argument) very efficiently." msgstr "" @@ -207,7 +207,7 @@ 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 :const:`Py_TPFLAGS_HAVE_VECTORCALL` flag and it does " +"It does not check the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag and it does " "not fall back to ``tp_call``." msgstr "" @@ -227,7 +227,7 @@ msgid "" msgstr "" msgid "Function" -msgstr "" +msgstr "Funkcja" msgid "callable" msgstr "" @@ -239,76 +239,76 @@ msgid "kwargs" msgstr "" msgid ":c:func:`PyObject_Call`" -msgstr "" +msgstr ":c:func:`PyObject_Call`" msgid "``PyObject *``" -msgstr "" +msgstr "``PyObject *``" msgid "tuple" -msgstr "" +msgstr "tuple" msgid "dict/``NULL``" -msgstr "" +msgstr "dict/``NULL``" msgid ":c:func:`PyObject_CallNoArgs`" -msgstr "" +msgstr ":c:func:`PyObject_CallNoArgs`" msgid "---" msgstr "" msgid ":c:func:`PyObject_CallOneArg`" -msgstr "" +msgstr ":c:func:`PyObject_CallOneArg`" msgid "1 object" msgstr "" msgid ":c:func:`PyObject_CallObject`" -msgstr "" +msgstr ":c:func:`PyObject_CallObject`" msgid "tuple/``NULL``" -msgstr "" +msgstr "tuple/``NULL``" msgid ":c:func:`PyObject_CallFunction`" -msgstr "" +msgstr ":c:func:`PyObject_CallFunction`" msgid "format" -msgstr "" +msgstr "format" msgid ":c:func:`PyObject_CallMethod`" -msgstr "" +msgstr ":c:func:`PyObject_CallMethod`" msgid "obj + ``char*``" -msgstr "" +msgstr "obj + ``char*``" msgid ":c:func:`PyObject_CallFunctionObjArgs`" -msgstr "" +msgstr ":c:func:`PyObject_CallFunctionObjArgs`" msgid "variadic" msgstr "" msgid ":c:func:`PyObject_CallMethodObjArgs`" -msgstr "" +msgstr ":c:func:`PyObject_CallMethodObjArgs`" msgid "obj + name" msgstr "" msgid ":c:func:`PyObject_CallMethodNoArgs`" -msgstr "" +msgstr ":c:func:`PyObject_CallMethodNoArgs`" msgid ":c:func:`PyObject_CallMethodOneArg`" -msgstr "" +msgstr ":c:func:`PyObject_CallMethodOneArg`" msgid ":c:func:`PyObject_Vectorcall`" -msgstr "" +msgstr ":c:func:`PyObject_Vectorcall`" msgid "vectorcall" msgstr "" msgid ":c:func:`PyObject_VectorcallDict`" -msgstr "" +msgstr ":c:func:`PyObject_VectorcallDict`" msgid ":c:func:`PyObject_VectorcallMethod`" -msgstr "" +msgstr ":c:func:`PyObject_VectorcallMethod`" msgid "arg + name" msgstr "" @@ -441,14 +441,14 @@ 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 :" -"const:`PY_VECTORCALL_ARGUMENTS_OFFSET` if the value of ``args[0]`` may " +"*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 "" -"If the object has the :const:`Py_TPFLAGS_METHOD_DESCRIPTOR` feature, this " +"If the object has the :c:macro:`Py_TPFLAGS_METHOD_DESCRIPTOR` feature, this " "will call the unbound method object with the full *args* vector as arguments." msgstr "" diff --git a/c-api/capsule.po b/c-api/capsule.po new file mode 100644 index 0000000000..af700061e7 --- /dev/null +++ b/c-api/capsule.po @@ -0,0 +1,184 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "Capsules" +msgstr "" + +msgid "" +"Refer to :ref:`using-capsules` for more information on using these objects." +msgstr "" + +msgid "" +"This subtype of :c:type:`PyObject` represents an opaque value, useful for C " +"extension modules who need to pass an opaque value (as a :c:expr:`void*` " +"pointer) through Python code to other C code. It is often used to make a C " +"function pointer defined in one module available to other modules, so the " +"regular import mechanism can be used to access C APIs defined in dynamically " +"loaded modules." +msgstr "" + +msgid "The type of a destructor callback for a capsule. Defined as::" +msgstr "" + +msgid "" +"See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor " +"callbacks." +msgstr "" + +msgid "" +"Return true if its argument is a :c:type:`PyCapsule`. This function always " +"succeeds." +msgstr "" + +msgid "" +"Create a :c:type:`PyCapsule` encapsulating the *pointer*. The *pointer* " +"argument may not be ``NULL``." +msgstr "" + +msgid "On failure, set an exception and return ``NULL``." +msgstr "" + +msgid "" +"The *name* string may either be ``NULL`` or a pointer to a valid C string. " +"If non-``NULL``, this string must outlive the capsule. (Though it is " +"permitted to free it inside the *destructor*.)" +msgstr "" + +msgid "" +"If the *destructor* argument is not ``NULL``, it will be called with the " +"capsule as its argument when it is destroyed." +msgstr "" + +msgid "" +"If this capsule will be stored as an attribute of a module, the *name* " +"should be specified as ``modulename.attributename``. This will enable other " +"modules to import the capsule using :c:func:`PyCapsule_Import`." +msgstr "" + +msgid "" +"Retrieve the *pointer* stored in the capsule. On failure, set an exception " +"and return ``NULL``." +msgstr "" + +msgid "" +"The *name* parameter must compare exactly to the name stored in the capsule. " +"If the name stored in the capsule is ``NULL``, the *name* passed in must " +"also be ``NULL``. Python uses the C function :c:func:`!strcmp` to compare " +"capsule names." +msgstr "" + +msgid "" +"Return the current destructor stored in the capsule. On failure, set an " +"exception and return ``NULL``." +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." +msgstr "" + +msgid "" +"Return the current context stored in the capsule. On failure, set an " +"exception and return ``NULL``." +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." +msgstr "" + +msgid "" +"Return the current name stored in the capsule. On failure, set an exception " +"and return ``NULL``." +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." +msgstr "" + +msgid "" +"Import a pointer to a C object from a capsule attribute in a module. The " +"*name* parameter should specify the full name to the attribute, as in " +"``module.attribute``. The *name* stored in the capsule must match this " +"string exactly." +msgstr "" + +msgid "" +"Return the capsule's internal *pointer* on success. On failure, set an " +"exception and return ``NULL``." +msgstr "" + +msgid "*no_block* has no effect anymore." +msgstr "" + +msgid "" +"Determines whether or not *capsule* is a valid capsule. A valid capsule is " +"non-``NULL``, passes :c:func:`PyCapsule_CheckExact`, has a non-``NULL`` " +"pointer stored in it, and its internal name matches the *name* parameter. " +"(See :c:func:`PyCapsule_GetPointer` for information on how capsule names are " +"compared.)" +msgstr "" + +msgid "" +"In other words, if :c:func:`PyCapsule_IsValid` returns a true value, calls " +"to any of the accessors (any function starting with ``PyCapsule_Get``) are " +"guaranteed to succeed." +msgstr "" + +msgid "" +"Return a nonzero value if the object is valid and matches the name passed " +"in. Return ``0`` otherwise. This function will not fail." +msgstr "" + +msgid "Set the context pointer inside *capsule* to *context*." +msgstr "" + +msgid "" +"Return ``0`` on success. Return nonzero and set an exception on failure." +msgstr "" + +msgid "Set the destructor inside *capsule* to *destructor*." +msgstr "" + +msgid "" +"Set the name inside *capsule* to *name*. If non-``NULL``, the name must " +"outlive the capsule. If the previous *name* stored in the capsule was not " +"``NULL``, no attempt is made to free it." +msgstr "" + +msgid "" +"Set the void pointer inside *capsule* to *pointer*. The pointer may not be " +"``NULL``." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "Capsule" +msgstr "" diff --git a/c-api/cell.po b/c-api/cell.po new file mode 100644 index 0000000000..1ed1cd37db --- /dev/null +++ b/c-api/cell.po @@ -0,0 +1,85 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Cell Objects" +msgstr "" + +msgid "" +"\"Cell\" objects are used to implement variables referenced by multiple " +"scopes. For each such variable, a cell object is created to store the value; " +"the local variables of each stack frame that references the value contains a " +"reference to the cells from outer scopes which also use that variable. When " +"the value is accessed, the value contained in the cell is used instead of " +"the cell object itself. This de-referencing of the cell object requires " +"support from the generated byte-code; these are not automatically de-" +"referenced when accessed. Cell objects are not likely to be useful elsewhere." +msgstr "" +"Obiekty \"Cell\" są używane do implementacji zmiennych, do których odwołuje " +"się wiele zakresów. Dla każdej takiej zmiennej tworzony jest obiekt komórki " +"do przechowywania wartości; zmienne lokalne każdej ramki stosu, która " +"odwołuje się do wartości, zawierają odniesienie do komórek z zewnętrznych " +"zakresów, które również używają tej zmiennej. Gdy wartość jest dostępna, " +"wartość zawarta w komórce jest używana zamiast samego obiektu komórki. " +"Odwoływanie się do obiektu komórki wymaga wsparcia ze strony wygenerowanego " +"kodu bajtowego; nie są one automatycznie odwoływane, gdy uzyskuje się do " +"nich dostęp. Obiekty komórek prawdopodobnie nie będą przydatne w innych " +"miejscach." + +msgid "The C structure used for cell objects." +msgstr "" + +msgid "The type object corresponding to cell objects." +msgstr "" + +msgid "" +"Return true if *ob* is a cell object; *ob* must not be ``NULL``. This " +"function always succeeds." +msgstr "" + +msgid "" +"Create and return a new cell object containing the value *ob*. The parameter " +"may be ``NULL``." +msgstr "" + +msgid "Return the contents of the cell *cell*." +msgstr "" + +msgid "" +"Return the contents of the cell *cell*, but without checking that *cell* is " +"non-``NULL`` and a cell object." +msgstr "" + +msgid "" +"Set the contents of the cell object *cell* to *value*. This releases the " +"reference to any current content of the cell. *value* may be ``NULL``. " +"*cell* must be non-``NULL``; if it is not a cell object, ``-1`` will be " +"returned. On success, ``0`` will be returned." +msgstr "" + +msgid "" +"Sets the value of the cell object *cell* to *value*. No reference counts " +"are adjusted, and no checks are made for safety; *cell* must be non-``NULL`` " +"and must be a cell object." +msgstr "" diff --git a/c-api/code.po b/c-api/code.po new file mode 100644 index 0000000000..39831ec4f9 --- /dev/null +++ b/c-api/code.po @@ -0,0 +1,140 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "Code Objects" +msgstr "" + +msgid "" +"Code objects are a low-level detail of the CPython implementation. Each one " +"represents a chunk of executable code that hasn't yet been bound into a " +"function." +msgstr "" + +msgid "" +"The C structure of the objects used to describe code objects. The fields of " +"this type are subject to change at any time." +msgstr "" + +msgid "" +"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:" +"`code object `." +msgstr "" + +msgid "" +"Return true if *co* is a :ref:`code object `. This function " +"always succeeds." +msgstr "" + +msgid "Return the number of free variables in *co*." +msgstr "" + +msgid "" +"Return a new code object. If you need a dummy code object to create a " +"frame, use :c:func:`PyCode_NewEmpty` instead. Calling :c:func:`PyCode_New` " +"directly will bind you to a precise Python version since the definition of " +"the bytecode changes often. The many arguments of this function are inter-" +"dependent in complex ways, meaning that subtle changes to values are likely " +"to result in incorrect execution or VM crashes. Use this function only with " +"extreme care." +msgstr "" + +msgid "Added ``qualname`` and ``exceptiontable`` parameters." +msgstr "" + +msgid "" +"Similar to :c:func:`PyCode_New`, but with an extra \"posonlyargcount\" for " +"positional-only arguments. The same caveats that apply to ``PyCode_New`` " +"also apply to this function." +msgstr "" + +msgid "Added ``qualname`` and ``exceptiontable`` parameters." +msgstr "" + +msgid "" +"Return a new empty code object with the specified filename, function name, " +"and first line number. The resulting code object will raise an ``Exception`` " +"if executed." +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." +msgstr "" + +msgid "" +"For efficiently iterating over the line numbers in a code object, use `the " +"API described in PEP 626 `_." +msgstr "" + +msgid "" +"Sets the passed ``int`` pointers to the source code line and column numbers " +"for the instruction at ``byte_offset``. Sets the value to ``0`` when " +"information is not available for any particular element." +msgstr "" + +msgid "Returns ``1`` if the function succeeds and 0 otherwise." +msgstr "" + +msgid "" +"Equivalent to the Python code ``getattr(co, 'co_code')``. Returns a strong " +"reference to a :c:type:`PyBytesObject` representing the bytecode in a code " +"object. On error, ``NULL`` is returned and an exception is raised." +msgstr "" + +msgid "" +"This ``PyBytesObject`` may be created on-demand by the interpreter and does " +"not necessarily represent the bytecode actually executed by CPython. The " +"primary use case for this function is debuggers and profilers." +msgstr "" + +msgid "" +"Equivalent to the Python code ``getattr(co, 'co_varnames')``. Returns a new " +"reference to a :c:type:`PyTupleObject` containing the names of the local " +"variables. On error, ``NULL`` is returned and an exception is raised." +msgstr "" + +msgid "" +"Equivalent to the Python code ``getattr(co, 'co_cellvars')``. Returns a new " +"reference to a :c:type:`PyTupleObject` containing the names of the local " +"variables that are referenced by nested functions. On error, ``NULL`` is " +"returned and an exception is raised." +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 free " +"variables. On error, ``NULL`` is returned and an exception is raised." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "code" +msgstr "" + +msgid "code object" +msgstr "" diff --git a/c-api/complex.po b/c-api/complex.po index a16d7f76a9..cdd06690df 100644 --- a/c-api/complex.po +++ b/c-api/complex.po @@ -1,20 +1,22 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# gresm gresm, 2022 -# Maciej Olko , 2022 +# Waldemar Stoczkowski, 2023 +# gresm, 2024 +# Maciej Olko , 2024 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +35,10 @@ msgid "" "and the other is a C structure which represents the actual complex number " "value. The API provides functions for working with both." msgstr "" -"Pythonowe liczby zespolone są stworzone w implementacji C jako dwa oddzielne " -"typy: jeden jest strukturą w C która reprezentuje prawdziwe liczby " -"zespolone, a drugi ujawnia tą strukturę dla Pythonowego kodu. API ma funkcje " -"do operacji na obydwu typach." +"Python-owe obiekty liczby zespolonej są stworzone w C jako dwa oddzielne " +"typy: jeden jest strukturą w która reprezentuje prawdziwe liczby zespolone, " +"a drugi ujawnia tą strukturę dla Python-owego kodu. API ma funkcje do " +"operacji na obydwu typach." msgid "Complex Numbers as C Structures" msgstr "Liczby zespolone jako struktury w C" @@ -58,11 +60,15 @@ 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ę." msgid "" "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ę." msgid "" "Return the negation of the complex number *num*, using the C :c:type:" @@ -73,15 +79,19 @@ 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ę." 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ę." msgid "" "If *divisor* is null, this method returns zero and sets :c:data:`errno` to :" -"c:data:`EDOM`." +"c:macro:`!EDOM`." msgstr "" msgid "" @@ -91,7 +101,7 @@ msgstr "" msgid "" "If *num* is null and *exp* is not a positive real number, this method " -"returns zero and sets :c:data:`errno` to :c:data:`EDOM`." +"returns zero and sets :c:data:`errno` to :c:macro:`!EDOM`." msgstr "" msgid "Complex Numbers as Python Objects" @@ -134,19 +144,19 @@ 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:`__complex__` " -"method, this method will first be called to convert *op* to a Python complex " -"number object. If ``__complex__()`` is not defined then it falls back to :" -"meth:`__float__`. If ``__float__()`` is not defined then it falls back to :" -"meth:`__index__`. Upon failure, this method returns ``-1.0`` as a real " -"value." +"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__`. Upon failure, this " +"method returns ``-1.0`` as a real value." msgstr "" -msgid "Use :meth:`__index__` if available." +msgid "Use :meth:`~object.__index__` if available." msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "complex number" -msgstr "" +msgstr "liczba zespolona" diff --git a/c-api/concrete.po b/c-api/concrete.po index ad8fd399c1..c7516c3507 100644 --- a/c-api/concrete.po +++ b/c-api/concrete.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: # Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,13 +73,13 @@ msgid "Other Objects" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "numeric" msgstr "" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "mapping" msgstr "" diff --git a/c-api/contextvars.po b/c-api/contextvars.po new file mode 100644 index 0000000000..3823032f9b --- /dev/null +++ b/c-api/contextvars.po @@ -0,0 +1,151 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Context Variables Objects" +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.::" +msgstr "" + +msgid "See :issue:`34762` for more details." +msgstr "" + +msgid "" +"This section details the public C API for the :mod:`contextvars` module." +msgstr "" + +msgid "" +"The C structure used to represent a :class:`contextvars.Context` object." +msgstr "" + +msgid "" +"The C structure used to represent a :class:`contextvars.ContextVar` object." +msgstr "" + +msgid "The C structure used to represent a :class:`contextvars.Token` object." +msgstr "" + +msgid "The type object representing the *context* type." +msgstr "" + +msgid "The type object representing the *context variable* type." +msgstr "" + +msgid "The type object representing the *context variable token* type." +msgstr "" + +msgid "Type-check macros:" +msgstr "Sprawdzanie typu makr:" + +msgid "" +"Return true if *o* is of type :c:data:`PyContext_Type`. *o* must not be " +"``NULL``. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *o* is of type :c:data:`PyContextVar_Type`. *o* must not be " +"``NULL``. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *o* is of type :c:data:`PyContextToken_Type`. *o* must not be " +"``NULL``. This function always succeeds." +msgstr "" + +msgid "Context object management functions:" +msgstr "" + +msgid "" +"Create a new empty context object. Returns ``NULL`` if an error has " +"occurred." +msgstr "" + +msgid "" +"Create a shallow copy of the passed *ctx* context object. Returns ``NULL`` " +"if an error has occurred." +msgstr "" + +msgid "" +"Create a shallow copy of the current thread context. Returns ``NULL`` if an " +"error has occurred." +msgstr "" + +msgid "" +"Set *ctx* as the current context for the current thread. Returns ``0`` on " +"success, and ``-1`` on error." +msgstr "" + +msgid "" +"Deactivate the *ctx* context and restore the previous context as the current " +"context for the current thread. Returns ``0`` on success, and ``-1`` on " +"error." +msgstr "" + +msgid "Context variable functions:" +msgstr "" + +msgid "" +"Create a new ``ContextVar`` object. The *name* parameter is used for " +"introspection and debug purposes. The *def* parameter specifies a default " +"value for the context variable, or ``NULL`` for no default. If an error has " +"occurred, this function returns ``NULL``." +msgstr "" + +msgid "" +"Get the value of a context variable. Returns ``-1`` if an error has " +"occurred during lookup, and ``0`` if no error occurred, whether or not a " +"value was found." +msgstr "" + +msgid "" +"If the context variable was found, *value* will be a pointer to it. If the " +"context variable was *not* found, *value* will point to:" +msgstr "" + +msgid "*default_value*, if not ``NULL``;" +msgstr "" + +msgid "the default value of *var*, if not ``NULL``;" +msgstr "" + +msgid "``NULL``" +msgstr "``NULL``" + +msgid "Except for ``NULL``, the function returns a new reference." +msgstr "" + +msgid "" +"Set the value of *var* to *value* in the current context. Returns a new " +"token object for this change, or ``NULL`` if an error has occurred." +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." +msgstr "" diff --git a/c-api/datetime.po b/c-api/datetime.po new file mode 100644 index 0000000000..83fd3545c9 --- /dev/null +++ b/c-api/datetime.po @@ -0,0 +1,262 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "DateTime Objects" +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." +msgstr "" + +msgid "This subtype of :c:type:`PyObject` represents a Python date object." +msgstr "" + +msgid "This subtype of :c:type:`PyObject` represents a Python datetime object." +msgstr "" + +msgid "This subtype of :c:type:`PyObject` represents a Python time object." +msgstr "" + +msgid "" +"This subtype of :c:type:`PyObject` represents the difference between two " +"datetime values." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python date type; it " +"is the same object as :class:`datetime.date` in the Python layer." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python datetime type; " +"it is the same object as :class:`datetime.datetime` in the Python layer." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python time type; it " +"is the same object as :class:`datetime.time` in the Python layer." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents Python type for the " +"difference between two datetime values; it is the same object as :class:" +"`datetime.timedelta` in the Python layer." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python time zone info " +"type; it is the same object as :class:`datetime.tzinfo` in the Python layer." +msgstr "" + +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`." +msgstr "" + +msgid "Type-check macros:" +msgstr "Sprawdzanie typu makr:" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_DateType` or a subtype " +"of :c:data:`!PyDateTime_DateType`. *ob* must not be ``NULL``. This " +"function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_DateType`. *ob* must not " +"be ``NULL``. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_DateTimeType` or a " +"subtype of :c:data:`!PyDateTime_DateTimeType`. *ob* must not be ``NULL``. " +"This function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_DateTimeType`. *ob* must " +"not be ``NULL``. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_TimeType` or a subtype " +"of :c:data:`!PyDateTime_TimeType`. *ob* must not be ``NULL``. This " +"function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_TimeType`. *ob* must not " +"be ``NULL``. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_DeltaType` or a subtype " +"of :c:data:`!PyDateTime_DeltaType`. *ob* must not be ``NULL``. This " +"function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_DeltaType`. *ob* must not " +"be ``NULL``. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_TZInfoType` or a subtype " +"of :c:data:`!PyDateTime_TZInfoType`. *ob* must not be ``NULL``. This " +"function always succeeds." +msgstr "" + +msgid "" +"Return true if *ob* is of type :c:data:`PyDateTime_TZInfoType`. *ob* must " +"not be ``NULL``. This function always succeeds." +msgstr "" + +msgid "Macros to create objects:" +msgstr "" + +msgid "" +"Return a :class:`datetime.date` object with the specified year, month and " +"day." +msgstr "" + +msgid "" +"Return a :class:`datetime.datetime` object with the specified year, month, " +"day, hour, minute, second and microsecond." +msgstr "" + +msgid "" +"Return a :class:`datetime.datetime` object with the specified year, month, " +"day, hour, minute, second, microsecond and fold." +msgstr "" + +msgid "" +"Return a :class:`datetime.time` object with the specified hour, minute, " +"second and microsecond." +msgstr "" + +msgid "" +"Return a :class:`datetime.time` object with the specified hour, minute, " +"second, microsecond and fold." +msgstr "" + +msgid "" +"Return a :class:`datetime.timedelta` object representing the given number of " +"days, seconds and microseconds. Normalization is performed so that the " +"resulting number of microseconds and seconds lie in the ranges documented " +"for :class:`datetime.timedelta` objects." +msgstr "" + +msgid "" +"Return a :class:`datetime.timezone` object with an unnamed fixed offset " +"represented by the *offset* argument." +msgstr "" + +msgid "" +"Return a :class:`datetime.timezone` object with a fixed offset represented " +"by the *offset* argument and with tzname *name*." +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:" +msgstr "" + +msgid "Return the year, as a positive int." +msgstr "" + +msgid "Return the month, as an int from 1 through 12." +msgstr "" + +msgid "Return the day, as an int from 1 through 31." +msgstr "" + +msgid "" +"Macros to extract fields from datetime objects. The argument must be an " +"instance of :c:type:`PyDateTime_DateTime`, including subclasses. The " +"argument must not be ``NULL``, and the type is not checked:" +msgstr "" + +msgid "Return the hour, as an int from 0 through 23." +msgstr "" + +msgid "Return the minute, as an int from 0 through 59." +msgstr "" + +msgid "Return the second, as an int from 0 through 59." +msgstr "" + +msgid "Return the microsecond, as an int from 0 through 999999." +msgstr "" + +msgid "Return the fold, as an int from 0 through 1." +msgstr "" + +msgid "Return the tzinfo (which may be ``None``)." +msgstr "" + +msgid "" +"Macros to extract fields from time objects. The argument must be an " +"instance of :c:type:`PyDateTime_Time`, including subclasses. The argument " +"must not be ``NULL``, and the type is not checked:" +msgstr "" + +msgid "" +"Macros to extract fields from time delta objects. The argument must be an " +"instance of :c:type:`PyDateTime_Delta`, including subclasses. The argument " +"must not be ``NULL``, and the type is not checked:" +msgstr "" + +msgid "Return the number of days, as an int from -999999999 to 999999999." +msgstr "" + +msgid "Return the number of seconds, as an int from 0 through 86399." +msgstr "" + +msgid "Return the number of microseconds, as an int from 0 through 999999." +msgstr "" + +msgid "Macros for the convenience of modules implementing the DB API:" +msgstr "" + +msgid "" +"Create and return a new :class:`datetime.datetime` object given an argument " +"tuple suitable for passing to :meth:`datetime.datetime.fromtimestamp()`." +msgstr "" + +msgid "" +"Create and return a new :class:`datetime.date` object given an argument " +"tuple suitable for passing to :meth:`datetime.date.fromtimestamp()`." +msgstr "" diff --git a/c-api/dict.po b/c-api/dict.po index e96bed2d5b..4d3ca4bb3e 100644 --- a/c-api/dict.po +++ b/c-api/dict.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,29 +25,35 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Dictionary Objects" -msgstr "" +msgstr "Obiekty słownika" msgid "" "This subtype of :c:type:`PyObject` represents a Python dictionary object." -msgstr "" +msgstr "Ten podtyp :c:type:`PyObject` reprezentuje obiekt słownika Pythona." msgid "" "This instance of :c:type:`PyTypeObject` represents the Python dictionary " "type. This is the same object as :class:`dict` in the Python layer." msgstr "" +"Ta instancja :c:type:`PyTypeObject` reprezentuje typ słownika Pythona. Jest " +"to ten sam obiekt, co :class:`dict` w warstwie Pythona." msgid "" "Return true if *p* is a dict object or an instance of a subtype of the dict " "type. This function always succeeds." msgstr "" +"Zwraca wartość true, jeśli *p* jest obiektem typu dict lub instancją podtypu " +"typu dict. Funkcja ta zawsze kończy się powodzeniem." msgid "" "Return true if *p* is a dict object, but not an instance of a subtype of the " "dict type. This function always succeeds." msgstr "" +"Zwraca wartość true, jeśli *p* jest obiektem typu dict, ale nie jest " +"instancją podtypu typu dict. Funkcja ta zawsze kończy się powodzeniem." msgid "Return a new empty dictionary, or ``NULL`` on failure." -msgstr "" +msgstr "Zwraca nowy pusty słownik lub ``NULL`` w przypadku niepowodzenia." msgid "" "Return a :class:`types.MappingProxyType` object for a mapping which enforces " @@ -64,7 +71,7 @@ msgid "" msgstr "" msgid "Return a new dictionary that contains the same key-value pairs as *p*." -msgstr "" +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 :" @@ -74,10 +81,9 @@ msgid "" msgstr "" msgid "" -"Insert *val* into the dictionary *p* using *key* as a key. *key* should be " -"a :c:expr:`const char*`. The key object is created using " -"``PyUnicode_FromString(key)``. Return ``0`` on success or ``-1`` on " -"failure. This function *does not* steal a reference to *val*." +"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 "" @@ -88,9 +94,9 @@ msgid "" msgstr "" msgid "" -"Remove the entry in dictionary *p* which has a key specified by the string " -"*key*. If *key* is not in the dictionary, :exc:`KeyError` is raised. Return " -"``0`` on success or ``-1`` on failure." +"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 "" @@ -99,9 +105,9 @@ msgid "" msgstr "" msgid "" -"Note that exceptions which occur while calling :meth:`__hash__` and :meth:" -"`__eq__` methods will get suppressed. To get error reporting use :c:func:" -"`PyDict_GetItemWithError()` 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 "" @@ -117,13 +123,15 @@ msgstr "" msgid "" "This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:" -"expr:`const char*`, rather than a :c:expr:`PyObject*`." +"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" +"`PyObject*`." msgstr "" msgid "" -"Note that exceptions which occur while calling :meth:`__hash__` and :meth:" -"`__eq__` methods and creating a temporary string object will get suppressed. " -"To get error reporting use :c:func:`PyDict_GetItemWithError()` 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 "" @@ -147,6 +155,7 @@ msgid "" "Return a :c:type:`PyListObject` containing all the values from the " "dictionary *p*." msgstr "" +"Zwraca :c:type:`PyListObject` zawierający wszystkie wartości ze słownika *p*." msgid "" "Return the number of items in the dictionary. This is equivalent to " @@ -201,16 +210,13 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "dictionary" -msgstr "" - -msgid "PyUnicode_FromString()" -msgstr "" +msgstr "słownik" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "len" -msgstr "" +msgstr "len" diff --git a/c-api/exceptions.po b/c-api/exceptions.po index dfab9d958a..77e1e1d5b5 100644 --- a/c-api/exceptions.po +++ b/c-api/exceptions.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -114,7 +114,7 @@ msgid "" "This utility function prints a warning message to ``sys.stderr`` when an " "exception has been set but it is impossible for the interpreter to actually " "raise the exception. It is used, for example, when an exception occurs in " -"an :meth:`__del__` method." +"an :meth:`~object.__del__` method." msgstr "" msgid "" @@ -138,9 +138,9 @@ msgstr "" msgid "" "This is the most common way to set the error indicator. The first argument " "specifies the exception type; it is normally one of the standard exceptions, " -"e.g. :c:data:`PyExc_RuntimeError`. You need not increment its reference " -"count. The second argument is an error message; it is decoded from " -"``'utf-8'``." +"e.g. :c:data:`PyExc_RuntimeError`. You need not create a new :term:`strong " +"reference` to it (e.g. with :c:func:`Py_INCREF`). The second argument is an " +"error message; it is decoded from ``'utf-8'``." msgstr "" msgid "" @@ -180,8 +180,8 @@ msgid "" "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 :const:`EINTR`, indicating an " +"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 " @@ -192,7 +192,7 @@ msgid "" "Similar to :c:func:`PyErr_SetFromErrno`, with the additional behavior that " "if *filenameObject* is not ``NULL``, it is passed to the constructor of " "*type* as a third parameter. In the case of :exc:`OSError` exception, this " -"is used to define the :attr:`filename` attribute of the exception instance." +"is used to define the :attr:`!filename` attribute of the exception instance." msgstr "" msgid "" @@ -209,12 +209,12 @@ msgstr "" msgid "" "This is a convenience function to raise :exc:`WindowsError`. If called with " -"*ierr* of ``0``, the error code returned by a call to :c:func:`GetLastError` " -"is used instead. It calls the Win32 function :c:func:`FormatMessage` to " -"retrieve the Windows description of error code given by *ierr* or :c:func:" -"`GetLastError`, then it constructs a tuple object whose first item is the " -"*ierr* value and whose second item is the corresponding error message " -"(gotten from :c:func:`FormatMessage`), and then calls " +"*ierr* of ``0``, the error code returned by a call to :c:func:`!" +"GetLastError` is used instead. It calls the Win32 function :c:func:`!" +"FormatMessage` to retrieve the Windows description of error code given by " +"*ierr* or :c:func:`!GetLastError`, then it constructs a tuple object whose " +"first item is the *ierr* value and whose second item is the corresponding " +"error message (gotten from :c:func:`!FormatMessage`), and then calls " "``PyErr_SetObject(PyExc_WindowsError, object)``. This function always " "returns ``NULL``." msgstr "" @@ -228,14 +228,18 @@ msgid "" msgstr "" msgid "" -"Similar to :c:func:`PyErr_SetFromWindowsErrWithFilenameObject`, but the " -"filename is given as a C string. *filename* is decoded from the filesystem " -"encoding (:func:`os.fsdecode`)." +"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." msgstr "" msgid "" -"Similar to :c:func:`PyErr_SetFromWindowsErrWithFilenameObject`, with an " -"additional parameter specifying the exception type to be raised." +"Similar to :c:func:`PyErr_SetExcFromWindowsErr`, with the additional " +"behavior that if *filename* is not ``NULL``, it is 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 "" @@ -346,7 +350,8 @@ msgstr "" msgid "" "Function similar to :c:func:`PyErr_WarnFormat`, but *category* is :exc:" -"`ResourceWarning` and it passes *source* to :func:`warnings.WarningMessage`." +"`ResourceWarning` and it passes *source* to :class:`!warnings." +"WarningMessage`." msgstr "" msgid "Querying the error indicator" @@ -425,9 +430,9 @@ msgid "" msgstr "" msgid "" -"This function *does not* implicitly set the ``__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 "" @@ -527,13 +532,13 @@ msgid "" msgstr "" msgid "" -"The default Python signal handler for :const:`SIGINT` raises the :exc:" +"The default Python signal handler for :c:macro:`!SIGINT` raises the :exc:" "`KeyboardInterrupt` exception." msgstr "" msgid "" -"Simulate the effect of a :const:`SIGINT` signal arriving. This is equivalent " -"to ``PyErr_SetInterruptEx(SIGINT)``." +"Simulate the effect of a :c:macro:`!SIGINT` signal arriving. This is " +"equivalent to ``PyErr_SetInterruptEx(SIGINT)``." msgstr "" msgid "" @@ -555,8 +560,8 @@ msgid "" msgstr "" msgid "" -"If the given signal isn't handled by Python (it was set to :data:`signal." -"SIG_DFL` or :data:`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 "" @@ -593,7 +598,7 @@ msgid "" msgstr "" msgid "" -"The :attr:`__module__` attribute of the new class is set to the first part " +"The :attr:`!__module__` attribute of the new class is set to the first part " "(up to the last dot) of the *name* argument, and the class name is set to " "the last part (after the last dot). The *base* argument can be used to " "specify alternate base classes; it can either be only one class or a tuple " @@ -612,8 +617,8 @@ msgstr "Przedmioty Sytuacji Wyjątkowych" msgid "" "Return the traceback associated with the exception as a new reference, as " -"accessible from Python through :attr:`__traceback__`. If there is no " -"traceback associated, this returns ``NULL``." +"accessible from Python through the :attr:`~BaseException.__traceback__` " +"attribute. If there is no traceback associated, this returns ``NULL``." msgstr "" msgid "" @@ -624,8 +629,8 @@ msgstr "" msgid "" "Return the context (another exception instance during whose handling *ex* " "was raised) associated with the exception as a new reference, as accessible " -"from Python through :attr:`__context__`. If there is no context associated, " -"this returns ``NULL``." +"from Python through the :attr:`~BaseException.__context__` attribute. If " +"there is no context associated, this returns ``NULL``." msgstr "" msgid "" @@ -635,19 +640,21 @@ msgid "" msgstr "" msgid "" -"Return the cause (either an exception instance, or :const:`None`, set by " +"Return the cause (either an exception instance, or ``None``, set by " "``raise ... from ...``) associated with the exception as a new reference, as " -"accessible from Python through :attr:`__cause__`." +"accessible from Python through the :attr:`~BaseException.__cause__` " +"attribute." 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 :const:`None`. This steals a reference to *cause*." +"exception instance or ``None``. This steals a reference to *cause*." msgstr "" msgid "" -":attr:`__suppress_context__` is implicitly set to ``True`` by this function." +"The :attr:`~BaseException.__suppress_context__` attribute is implicitly set " +"to ``True`` by this function." msgstr "" msgid "Unicode Exception Objects" @@ -716,9 +723,9 @@ msgid "Marks a point where a recursive C-level call is about to be performed." msgstr "" msgid "" -"If :const:`USE_STACKCHECK` is defined, this function checks if the OS stack " -"overflowed using :c:func:`PyOS_CheckStack`. In this is the case, it sets a :" -"exc:`MemoryError` and returns a nonzero value." +"If :c:macro:`!USE_STACKCHECK` is defined, this function checks if the OS " +"stack overflowed using :c:func:`PyOS_CheckStack`. If this is the case, it " +"sets a :exc:`MemoryError` and returns a nonzero value." msgstr "" msgid "" @@ -733,7 +740,9 @@ msgid "" "recursion depth limit." msgstr "" -msgid "This function is now also available in the limited API." +msgid "" +"This function is now also available in the :ref:`limited API `." msgstr "" msgid "" @@ -797,7 +806,7 @@ msgid "Notes" msgstr "Notatki" msgid ":c:data:`PyExc_BaseException`" -msgstr "" +msgstr ":c:data:`PyExc_BaseException`" msgid ":exc:`BaseException`" msgstr ":exc:`BaseException`" @@ -806,313 +815,313 @@ msgid "[1]_" msgstr "" msgid ":c:data:`PyExc_Exception`" -msgstr "" +msgstr ":c:data:`PyExc_Exception`" msgid ":exc:`Exception`" msgstr ":exc:`Exception`" msgid ":c:data:`PyExc_ArithmeticError`" -msgstr "" +msgstr ":c:data:`PyExc_ArithmeticError`" msgid ":exc:`ArithmeticError`" msgstr ":exc:`ArithmeticError`" msgid ":c:data:`PyExc_AssertionError`" -msgstr "" +msgstr ":c:data:`PyExc_AssertionError`" msgid ":exc:`AssertionError`" msgstr ":exc:`AssertionError`" msgid ":c:data:`PyExc_AttributeError`" -msgstr "" +msgstr ":c:data:`PyExc_AttributeError`" msgid ":exc:`AttributeError`" msgstr ":exc:`AttributeError`" msgid ":c:data:`PyExc_BlockingIOError`" -msgstr "" +msgstr ":c:data:`PyExc_BlockingIOError`" msgid ":exc:`BlockingIOError`" -msgstr "" +msgstr ":exc:`BlockingIOError`" msgid ":c:data:`PyExc_BrokenPipeError`" -msgstr "" +msgstr ":c:data:`PyExc_BrokenPipeError`" msgid ":exc:`BrokenPipeError`" -msgstr "" +msgstr ":exc:`BrokenPipeError`" msgid ":c:data:`PyExc_BufferError`" -msgstr "" +msgstr ":c:data:`PyExc_BufferError`" msgid ":exc:`BufferError`" -msgstr "" +msgstr ":exc:`BufferError`" msgid ":c:data:`PyExc_ChildProcessError`" -msgstr "" +msgstr ":c:data:`PyExc_ChildProcessError`" msgid ":exc:`ChildProcessError`" -msgstr "" +msgstr ":exc:`ChildProcessError`" msgid ":c:data:`PyExc_ConnectionAbortedError`" -msgstr "" +msgstr ":c:data:`PyExc_ConnectionAbortedError`" msgid ":exc:`ConnectionAbortedError`" -msgstr "" +msgstr ":exc:`ConnectionAbortedError`" msgid ":c:data:`PyExc_ConnectionError`" -msgstr "" +msgstr ":c:data:`PyExc_ConnectionError`" msgid ":exc:`ConnectionError`" -msgstr "" +msgstr ":exc:`ConnectionError`" msgid ":c:data:`PyExc_ConnectionRefusedError`" -msgstr "" +msgstr ":c:data:`PyExc_ConnectionRefusedError`" msgid ":exc:`ConnectionRefusedError`" -msgstr "" +msgstr ":exc:`ConnectionRefusedError`" msgid ":c:data:`PyExc_ConnectionResetError`" -msgstr "" +msgstr ":c:data:`PyExc_ConnectionResetError`" msgid ":exc:`ConnectionResetError`" -msgstr "" +msgstr ":exc:`ConnectionResetError`" msgid ":c:data:`PyExc_EOFError`" -msgstr "" +msgstr ":c:data:`PyExc_EOFError`" msgid ":exc:`EOFError`" msgstr ":exc:`EOFError`" msgid ":c:data:`PyExc_FileExistsError`" -msgstr "" +msgstr ":c:data:`PyExc_FileExistsError`" msgid ":exc:`FileExistsError`" -msgstr "" +msgstr ":exc:`FileExistsError`" msgid ":c:data:`PyExc_FileNotFoundError`" -msgstr "" +msgstr ":c:data:`PyExc_FileNotFoundError`" msgid ":exc:`FileNotFoundError`" -msgstr "" +msgstr ":exc:`FileNotFoundError`" msgid ":c:data:`PyExc_FloatingPointError`" -msgstr "" +msgstr ":c:data:`PyExc_FloatingPointError`" msgid ":exc:`FloatingPointError`" msgstr ":exc:`FloatingPointError`" msgid ":c:data:`PyExc_GeneratorExit`" -msgstr "" +msgstr ":c:data:`PyExc_GeneratorExit`" msgid ":exc:`GeneratorExit`" -msgstr "" +msgstr ":exc:`GeneratorExit`" msgid ":c:data:`PyExc_ImportError`" -msgstr "" +msgstr ":c:data:`PyExc_ImportError`" msgid ":exc:`ImportError`" msgstr ":exc:`ImportError`" msgid ":c:data:`PyExc_IndentationError`" -msgstr "" +msgstr ":c:data:`PyExc_IndentationError`" msgid ":exc:`IndentationError`" -msgstr "" +msgstr ":exc:`IndentationError`" msgid ":c:data:`PyExc_IndexError`" -msgstr "" +msgstr ":c:data:`PyExc_IndexError`" msgid ":exc:`IndexError`" msgstr ":exc:`IndexError`" msgid ":c:data:`PyExc_InterruptedError`" -msgstr "" +msgstr ":c:data:`PyExc_InterruptedError`" msgid ":exc:`InterruptedError`" -msgstr "" +msgstr ":exc:`InterruptedError`" msgid ":c:data:`PyExc_IsADirectoryError`" -msgstr "" +msgstr ":c:data:`PyExc_IsADirectoryError`" msgid ":exc:`IsADirectoryError`" -msgstr "" +msgstr ":exc:`IsADirectoryError`" msgid ":c:data:`PyExc_KeyError`" -msgstr "" +msgstr ":c:data:`PyExc_KeyError`" msgid ":exc:`KeyError`" msgstr ":exc:`KeyError`" msgid ":c:data:`PyExc_KeyboardInterrupt`" -msgstr "" +msgstr ":c:data:`PyExc_KeyboardInterrupt`" msgid ":exc:`KeyboardInterrupt`" msgstr ":exc:`KeyboardInterrupt`" msgid ":c:data:`PyExc_LookupError`" -msgstr "" +msgstr ":c:data:`PyExc_LookupError`" msgid ":exc:`LookupError`" msgstr ":exc:`LookupError`" msgid ":c:data:`PyExc_MemoryError`" -msgstr "" +msgstr ":c:data:`PyExc_MemoryError`" msgid ":exc:`MemoryError`" msgstr ":exc:`MemoryError`" msgid ":c:data:`PyExc_ModuleNotFoundError`" -msgstr "" +msgstr ":c:data:`PyExc_ModuleNotFoundError`" msgid ":exc:`ModuleNotFoundError`" -msgstr "" +msgstr ":exc:`ModuleNotFoundError`" msgid ":c:data:`PyExc_NameError`" -msgstr "" +msgstr ":c:data:`PyExc_NameError`" msgid ":exc:`NameError`" msgstr ":exc:`NameError`" msgid ":c:data:`PyExc_NotADirectoryError`" -msgstr "" +msgstr ":c:data:`PyExc_NotADirectoryError`" msgid ":exc:`NotADirectoryError`" -msgstr "" +msgstr ":exc:`NotADirectoryError`" msgid ":c:data:`PyExc_NotImplementedError`" -msgstr "" +msgstr ":c:data:`PyExc_NotImplementedError`" msgid ":exc:`NotImplementedError`" msgstr ":exc:`NotImplementedError`" msgid ":c:data:`PyExc_OSError`" -msgstr "" +msgstr ":c:data:`PyExc_OSError`" msgid ":exc:`OSError`" msgstr ":exc:`OSError`" msgid ":c:data:`PyExc_OverflowError`" -msgstr "" +msgstr ":c:data:`PyExc_OverflowError`" msgid ":exc:`OverflowError`" msgstr ":exc:`OverflowError`" msgid ":c:data:`PyExc_PermissionError`" -msgstr "" +msgstr ":c:data:`PyExc_PermissionError`" msgid ":exc:`PermissionError`" -msgstr "" +msgstr ":exc:`PermissionError`" msgid ":c:data:`PyExc_ProcessLookupError`" -msgstr "" +msgstr ":c:data:`PyExc_ProcessLookupError`" msgid ":exc:`ProcessLookupError`" -msgstr "" +msgstr ":exc:`ProcessLookupError`" msgid ":c:data:`PyExc_RecursionError`" -msgstr "" +msgstr ":c:data:`PyExc_RecursionError`" msgid ":exc:`RecursionError`" -msgstr "" +msgstr ":exc:`RecursionError`" msgid ":c:data:`PyExc_ReferenceError`" -msgstr "" +msgstr ":c:data:`PyExc_ReferenceError`" msgid ":exc:`ReferenceError`" msgstr ":exc:`ReferenceError`" msgid ":c:data:`PyExc_RuntimeError`" -msgstr "" +msgstr ":c:data:`PyExc_RuntimeError`" msgid ":exc:`RuntimeError`" msgstr ":exc:`RuntimeError`" msgid ":c:data:`PyExc_StopAsyncIteration`" -msgstr "" +msgstr ":c:data:`PyExc_StopAsyncIteration`" msgid ":exc:`StopAsyncIteration`" -msgstr "" +msgstr ":exc:`StopAsyncIteration`" msgid ":c:data:`PyExc_StopIteration`" -msgstr "" +msgstr ":c:data:`PyExc_StopIteration`" msgid ":exc:`StopIteration`" -msgstr "" +msgstr ":exc:`StopIteration`" msgid ":c:data:`PyExc_SyntaxError`" -msgstr "" +msgstr ":c:data:`PyExc_SyntaxError`" msgid ":exc:`SyntaxError`" msgstr ":exc:`SyntaxError`" msgid ":c:data:`PyExc_SystemError`" -msgstr "" +msgstr ":c:data:`PyExc_SystemError`" msgid ":exc:`SystemError`" msgstr ":exc:`SystemError`" msgid ":c:data:`PyExc_SystemExit`" -msgstr "" +msgstr ":c:data:`PyExc_SystemExit`" msgid ":exc:`SystemExit`" msgstr ":exc:`SystemExit`" msgid ":c:data:`PyExc_TabError`" -msgstr "" +msgstr ":c:data:`PyExc_TabError`" msgid ":exc:`TabError`" -msgstr "" +msgstr ":exc:`TabError`" msgid ":c:data:`PyExc_TimeoutError`" -msgstr "" +msgstr ":c:data:`PyExc_TimeoutError`" msgid ":exc:`TimeoutError`" -msgstr "" +msgstr ":exc:`TimeoutError`" msgid ":c:data:`PyExc_TypeError`" -msgstr "" +msgstr ":c:data:`PyExc_TypeError`" msgid ":exc:`TypeError`" msgstr ":exc:`TypeError`" msgid ":c:data:`PyExc_UnboundLocalError`" -msgstr "" +msgstr ":c:data:`PyExc_UnboundLocalError`" msgid ":exc:`UnboundLocalError`" -msgstr "" +msgstr ":exc:`UnboundLocalError`" msgid ":c:data:`PyExc_UnicodeDecodeError`" -msgstr "" +msgstr ":c:data:`PyExc_UnicodeDecodeError`" msgid ":exc:`UnicodeDecodeError`" -msgstr "" +msgstr ":exc:`UnicodeDecodeError`" msgid ":c:data:`PyExc_UnicodeEncodeError`" -msgstr "" +msgstr ":c:data:`PyExc_UnicodeEncodeError`" msgid ":exc:`UnicodeEncodeError`" -msgstr "" +msgstr ":exc:`UnicodeEncodeError`" msgid ":c:data:`PyExc_UnicodeError`" -msgstr "" +msgstr ":c:data:`PyExc_UnicodeError`" msgid ":exc:`UnicodeError`" -msgstr "" +msgstr ":exc:`UnicodeError`" msgid ":c:data:`PyExc_UnicodeTranslateError`" -msgstr "" +msgstr ":c:data:`PyExc_UnicodeTranslateError`" msgid ":exc:`UnicodeTranslateError`" -msgstr "" +msgstr ":exc:`UnicodeTranslateError`" msgid ":c:data:`PyExc_ValueError`" -msgstr "" +msgstr ":c:data:`PyExc_ValueError`" msgid ":exc:`ValueError`" msgstr ":exc:`ValueError`" msgid ":c:data:`PyExc_ZeroDivisionError`" -msgstr "" +msgstr ":c:data:`PyExc_ZeroDivisionError`" msgid ":exc:`ZeroDivisionError`" msgstr ":exc:`ZeroDivisionError`" @@ -1132,19 +1141,19 @@ msgid ":c:data:`PyExc_StopAsyncIteration` and :c:data:`PyExc_RecursionError`." msgstr "" msgid ":c:data:`PyExc_ModuleNotFoundError`." -msgstr "" +msgstr ":c:data:`PyExc_ModuleNotFoundError`." msgid "These are compatibility aliases to :c:data:`PyExc_OSError`:" msgstr "" -msgid ":c:data:`PyExc_EnvironmentError`" -msgstr "" +msgid ":c:data:`!PyExc_EnvironmentError`" +msgstr ":c:data:`!PyExc_EnvironmentError`" -msgid ":c:data:`PyExc_IOError`" -msgstr "" +msgid ":c:data:`!PyExc_IOError`" +msgstr ":c:data:`!PyExc_IOError`" -msgid ":c:data:`PyExc_WindowsError`" -msgstr "" +msgid ":c:data:`!PyExc_WindowsError`" +msgstr ":c:data:`!PyExc_WindowsError`" msgid "[2]_" msgstr "" @@ -1178,81 +1187,81 @@ msgid "" msgstr "" msgid ":c:data:`PyExc_Warning`" -msgstr "" +msgstr ":c:data:`PyExc_Warning`" msgid ":exc:`Warning`" -msgstr "" +msgstr ":exc:`Warning`" msgid "[3]_" msgstr "" msgid ":c:data:`PyExc_BytesWarning`" -msgstr "" +msgstr ":c:data:`PyExc_BytesWarning`" msgid ":exc:`BytesWarning`" -msgstr "" +msgstr ":exc:`BytesWarning`" msgid ":c:data:`PyExc_DeprecationWarning`" -msgstr "" +msgstr ":c:data:`PyExc_DeprecationWarning`" msgid ":exc:`DeprecationWarning`" -msgstr "" +msgstr ":exc:`DeprecationWarning`" msgid ":c:data:`PyExc_FutureWarning`" -msgstr "" +msgstr ":c:data:`PyExc_FutureWarning`" msgid ":exc:`FutureWarning`" -msgstr "" +msgstr ":exc:`FutureWarning`" msgid ":c:data:`PyExc_ImportWarning`" -msgstr "" +msgstr ":c:data:`PyExc_ImportWarning`" msgid ":exc:`ImportWarning`" -msgstr "" +msgstr ":exc:`ImportWarning`" msgid ":c:data:`PyExc_PendingDeprecationWarning`" -msgstr "" +msgstr ":c:data:`PyExc_PendingDeprecationWarning`" msgid ":exc:`PendingDeprecationWarning`" -msgstr "" +msgstr ":exc:`PendingDeprecationWarning`" msgid ":c:data:`PyExc_ResourceWarning`" -msgstr "" +msgstr ":c:data:`PyExc_ResourceWarning`" msgid ":exc:`ResourceWarning`" -msgstr "" +msgstr ":exc:`ResourceWarning`" msgid ":c:data:`PyExc_RuntimeWarning`" -msgstr "" +msgstr ":c:data:`PyExc_RuntimeWarning`" msgid ":exc:`RuntimeWarning`" -msgstr "" +msgstr ":exc:`RuntimeWarning`" msgid ":c:data:`PyExc_SyntaxWarning`" -msgstr "" +msgstr ":c:data:`PyExc_SyntaxWarning`" msgid ":exc:`SyntaxWarning`" -msgstr "" +msgstr ":exc:`SyntaxWarning`" msgid ":c:data:`PyExc_UnicodeWarning`" -msgstr "" +msgstr ":c:data:`PyExc_UnicodeWarning`" msgid ":exc:`UnicodeWarning`" -msgstr "" +msgstr ":exc:`UnicodeWarning`" msgid ":c:data:`PyExc_UserWarning`" -msgstr "" +msgstr ":c:data:`PyExc_UserWarning`" msgid ":exc:`UserWarning`" -msgstr "" +msgstr ":exc:`UserWarning`" msgid ":c:data:`PyExc_ResourceWarning`." -msgstr "" +msgstr ":c:data:`PyExc_ResourceWarning`." msgid "This is a base class for other standard warning categories." msgstr "" -msgid "strerror()" +msgid "strerror (C function)" msgstr "" msgid "module" @@ -1261,209 +1270,209 @@ msgstr "moduł" msgid "signal" msgstr "" -msgid "SIGINT" +msgid "SIGINT (C macro)" msgstr "" msgid "KeyboardInterrupt (built-in exception)" msgstr "" -msgid "PyExc_BaseException" +msgid "PyExc_BaseException (C var)" msgstr "" -msgid "PyExc_Exception" +msgid "PyExc_Exception (C var)" msgstr "" -msgid "PyExc_ArithmeticError" +msgid "PyExc_ArithmeticError (C var)" msgstr "" -msgid "PyExc_AssertionError" +msgid "PyExc_AssertionError (C var)" msgstr "" -msgid "PyExc_AttributeError" +msgid "PyExc_AttributeError (C var)" msgstr "" -msgid "PyExc_BlockingIOError" +msgid "PyExc_BlockingIOError (C var)" msgstr "" -msgid "PyExc_BrokenPipeError" +msgid "PyExc_BrokenPipeError (C var)" msgstr "" -msgid "PyExc_BufferError" +msgid "PyExc_BufferError (C var)" msgstr "" -msgid "PyExc_ChildProcessError" +msgid "PyExc_ChildProcessError (C var)" msgstr "" -msgid "PyExc_ConnectionAbortedError" +msgid "PyExc_ConnectionAbortedError (C var)" msgstr "" -msgid "PyExc_ConnectionError" +msgid "PyExc_ConnectionError (C var)" msgstr "" -msgid "PyExc_ConnectionRefusedError" +msgid "PyExc_ConnectionRefusedError (C var)" msgstr "" -msgid "PyExc_ConnectionResetError" +msgid "PyExc_ConnectionResetError (C var)" msgstr "" -msgid "PyExc_EOFError" +msgid "PyExc_EOFError (C var)" msgstr "" -msgid "PyExc_FileExistsError" +msgid "PyExc_FileExistsError (C var)" msgstr "" -msgid "PyExc_FileNotFoundError" +msgid "PyExc_FileNotFoundError (C var)" msgstr "" -msgid "PyExc_FloatingPointError" +msgid "PyExc_FloatingPointError (C var)" msgstr "" -msgid "PyExc_GeneratorExit" +msgid "PyExc_GeneratorExit (C var)" msgstr "" -msgid "PyExc_ImportError" +msgid "PyExc_ImportError (C var)" msgstr "" -msgid "PyExc_IndentationError" +msgid "PyExc_IndentationError (C var)" msgstr "" -msgid "PyExc_IndexError" +msgid "PyExc_IndexError (C var)" msgstr "" -msgid "PyExc_InterruptedError" +msgid "PyExc_InterruptedError (C var)" msgstr "" -msgid "PyExc_IsADirectoryError" +msgid "PyExc_IsADirectoryError (C var)" msgstr "" -msgid "PyExc_KeyError" +msgid "PyExc_KeyError (C var)" msgstr "" -msgid "PyExc_KeyboardInterrupt" +msgid "PyExc_KeyboardInterrupt (C var)" msgstr "" -msgid "PyExc_LookupError" +msgid "PyExc_LookupError (C var)" msgstr "" -msgid "PyExc_MemoryError" +msgid "PyExc_MemoryError (C var)" msgstr "" -msgid "PyExc_ModuleNotFoundError" +msgid "PyExc_ModuleNotFoundError (C var)" msgstr "" -msgid "PyExc_NameError" +msgid "PyExc_NameError (C var)" msgstr "" -msgid "PyExc_NotADirectoryError" +msgid "PyExc_NotADirectoryError (C var)" msgstr "" -msgid "PyExc_NotImplementedError" +msgid "PyExc_NotImplementedError (C var)" msgstr "" -msgid "PyExc_OSError" +msgid "PyExc_OSError (C var)" msgstr "" -msgid "PyExc_OverflowError" +msgid "PyExc_OverflowError (C var)" msgstr "" -msgid "PyExc_PermissionError" +msgid "PyExc_PermissionError (C var)" msgstr "" -msgid "PyExc_ProcessLookupError" +msgid "PyExc_ProcessLookupError (C var)" msgstr "" -msgid "PyExc_RecursionError" +msgid "PyExc_RecursionError (C var)" msgstr "" -msgid "PyExc_ReferenceError" +msgid "PyExc_ReferenceError (C var)" msgstr "" -msgid "PyExc_RuntimeError" +msgid "PyExc_RuntimeError (C var)" msgstr "" -msgid "PyExc_StopAsyncIteration" +msgid "PyExc_StopAsyncIteration (C var)" msgstr "" -msgid "PyExc_StopIteration" +msgid "PyExc_StopIteration (C var)" msgstr "" -msgid "PyExc_SyntaxError" +msgid "PyExc_SyntaxError (C var)" msgstr "" -msgid "PyExc_SystemError" +msgid "PyExc_SystemError (C var)" msgstr "" -msgid "PyExc_SystemExit" +msgid "PyExc_SystemExit (C var)" msgstr "" -msgid "PyExc_TabError" +msgid "PyExc_TabError (C var)" msgstr "" -msgid "PyExc_TimeoutError" +msgid "PyExc_TimeoutError (C var)" msgstr "" -msgid "PyExc_TypeError" +msgid "PyExc_TypeError (C var)" msgstr "" -msgid "PyExc_UnboundLocalError" +msgid "PyExc_UnboundLocalError (C var)" msgstr "" -msgid "PyExc_UnicodeDecodeError" +msgid "PyExc_UnicodeDecodeError (C var)" msgstr "" -msgid "PyExc_UnicodeEncodeError" +msgid "PyExc_UnicodeEncodeError (C var)" msgstr "" -msgid "PyExc_UnicodeError" +msgid "PyExc_UnicodeError (C var)" msgstr "" -msgid "PyExc_UnicodeTranslateError" +msgid "PyExc_UnicodeTranslateError (C var)" msgstr "" -msgid "PyExc_ValueError" +msgid "PyExc_ValueError (C var)" msgstr "" -msgid "PyExc_ZeroDivisionError" +msgid "PyExc_ZeroDivisionError (C var)" msgstr "" -msgid "PyExc_EnvironmentError" +msgid "PyExc_EnvironmentError (C var)" msgstr "" -msgid "PyExc_IOError" +msgid "PyExc_IOError (C var)" msgstr "" -msgid "PyExc_WindowsError" +msgid "PyExc_WindowsError (C var)" msgstr "" -msgid "PyExc_Warning" +msgid "PyExc_Warning (C var)" msgstr "" -msgid "PyExc_BytesWarning" +msgid "PyExc_BytesWarning (C var)" msgstr "" -msgid "PyExc_DeprecationWarning" +msgid "PyExc_DeprecationWarning (C var)" msgstr "" -msgid "PyExc_FutureWarning" +msgid "PyExc_FutureWarning (C var)" msgstr "" -msgid "PyExc_ImportWarning" +msgid "PyExc_ImportWarning (C var)" msgstr "" -msgid "PyExc_PendingDeprecationWarning" +msgid "PyExc_PendingDeprecationWarning (C var)" msgstr "" -msgid "PyExc_ResourceWarning" +msgid "PyExc_ResourceWarning (C var)" msgstr "" -msgid "PyExc_RuntimeWarning" +msgid "PyExc_RuntimeWarning (C var)" msgstr "" -msgid "PyExc_SyntaxWarning" +msgid "PyExc_SyntaxWarning (C var)" msgstr "" -msgid "PyExc_UnicodeWarning" +msgid "PyExc_UnicodeWarning (C var)" msgstr "" -msgid "PyExc_UserWarning" +msgid "PyExc_UserWarning (C var)" msgstr "" diff --git a/c-api/file.po b/c-api/file.po index ae7232d8b1..226e8a6f69 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Michał Frontczak, 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Michał Frontczak, 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -80,9 +81,12 @@ msgid "" "through the provided handler." msgstr "" +msgid "The *handler* is a function of type:" +msgstr "" + msgid "" -"The handler is a function of type :c:expr:`PyObject *(\\*)(PyObject *path, " -"void *userData)`, where *path* is guaranteed to be :c:type:`PyUnicodeObject`." +"Equivalent of :c:expr:`PyObject *(\\*)(PyObject *path, void *userData)`, " +"where *path* is guaranteed to be :c:type:`PyUnicodeObject`." msgstr "" msgid "" @@ -114,9 +118,9 @@ msgstr "" msgid "" "Write object *obj* to file object *p*. The only supported flag for *flags* " -"is :const:`Py_PRINT_RAW`; if given, the :func:`str` of the object is written " -"instead of the :func:`repr`. Return ``0`` on success or ``-1`` on failure; " -"the appropriate exception will be set." +"is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of the object is " +"written instead of the :func:`repr`. Return ``0`` on success or ``-1`` on " +"failure; the appropriate exception will be set." msgstr "" msgid "" @@ -125,13 +129,13 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "file" -msgstr "" +msgstr "plik" msgid "EOFError (built-in exception)" msgstr "" -msgid "Py_PRINT_RAW" +msgid "Py_PRINT_RAW (C macro)" msgstr "" diff --git a/c-api/float.po b/c-api/float.po new file mode 100644 index 0000000000..36be1e9031 --- /dev/null +++ b/c-api/float.po @@ -0,0 +1,189 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "Floating Point Objects" +msgstr "" + +msgid "" +"This subtype of :c:type:`PyObject` represents a Python floating point object." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python floating point " +"type. This is the same object as :class:`float` in the Python layer." +msgstr "" + +msgid "" +"Return true if its argument is a :c:type:`PyFloatObject` or a subtype of :c:" +"type:`PyFloatObject`. This function always succeeds." +msgstr "" + +msgid "" +"Return true if its argument is a :c:type:`PyFloatObject`, but not a subtype " +"of :c:type:`PyFloatObject`. This function always succeeds." +msgstr "" + +msgid "" +"Create a :c:type:`PyFloatObject` object based on the string value in *str*, " +"or ``NULL`` on failure." +msgstr "" + +msgid "" +"Create a :c:type:`PyFloatObject` object from *v*, or ``NULL`` on failure." +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." +msgstr "" + +msgid "Use :meth:`~object.__index__` if available." +msgstr "" + +msgid "" +"Return a C :c:expr:`double` representation of the contents of *pyfloat*, but " +"without error checking." +msgstr "" + +msgid "" +"Return a structseq instance which contains information about the precision, " +"minimum and maximum values of a float. It's a thin wrapper around the header " +"file :file:`float.h`." +msgstr "" + +msgid "" +"Return the maximum representable finite float *DBL_MAX* as C :c:expr:" +"`double`." +msgstr "" + +msgid "" +"Return the minimum normalized positive float *DBL_MIN* as C :c:expr:`double`." +msgstr "" + +msgid "Pack and Unpack functions" +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." +msgstr "" + +msgid "" +"On platforms that appear to use IEEE 754 formats these functions work by " +"copying bits. On other platforms, the 2-byte format is identical to the IEEE " +"754 binary16 half-precision format, the 4-byte format (32-bit) is identical " +"to the IEEE 754 binary32 single precision format, and the 8-byte format to " +"the IEEE 754 binary64 double precision format, although the packing of INFs " +"and NaNs (if such things exist on the platform) isn't handled correctly, and " +"attempting to unpack a bytes string containing an IEEE INF or NaN will raise " +"an exception." +msgstr "" + +msgid "" +"On non-IEEE platforms with more precision, or larger dynamic range, than " +"IEEE 754 supports, not all values can be packed; on non-IEEE platforms with " +"less precision, or smaller dynamic range, not all values can be unpacked. " +"What happens in such cases is partly accidental (alas)." +msgstr "" + +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`` ``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." +msgstr "" + +msgid "" +"Return value: ``0`` if all is OK, ``-1`` if error (and an exception is set, " +"most likely :exc:`OverflowError`)." +msgstr "" + +msgid "There are two problems on non-IEEE platforms:" +msgstr "" + +msgid "What this does is undefined if *x* is a NaN or infinity." +msgstr "" + +msgid "``-0.0`` and ``+0.0`` produce the same bytes string." +msgstr "" + +msgid "Pack a C double as the IEEE 754 binary16 half-precision format." +msgstr "" + +msgid "Pack a C double as the IEEE 754 binary32 single precision format." +msgstr "" + +msgid "Pack a C double as the IEEE 754 binary64 double precision format." +msgstr "" + +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." +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`)." +msgstr "" + +msgid "" +"Note that on a non-IEEE platform this will refuse to unpack a bytes string " +"that represents a NaN or infinity." +msgstr "" + +msgid "Unpack the IEEE 754 binary16 half-precision format as a C double." +msgstr "" + +msgid "Unpack the IEEE 754 binary32 single precision format as a C double." +msgstr "" + +msgid "Unpack the IEEE 754 binary64 double precision format as a C double." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "floating point" +msgstr "" diff --git a/c-api/function.po b/c-api/function.po index c57e4dedea..b2c2fdc9e9 100644 --- a/c-api/function.po +++ b/c-api/function.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: +# Rafael Fontenelle , 2023 # Waldemar Stoczkowski, 2023 -# Maciej Olko , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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" @@ -52,17 +52,18 @@ msgid "" msgstr "" msgid "" -"The function's docstring and name are retrieved from the code object. " -"*__module__* is retrieved from *globals*. The argument defaults, annotations " -"and closure are set to ``NULL``. *__qualname__* is set to the same value as " -"the code object's ``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 " -"``__qualname__`` attribute. *qualname* should be a unicode object or " -"``NULL``; if ``NULL``, the ``__qualname__`` attribute is set to the same " -"value as the code object's ``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*." @@ -72,13 +73,14 @@ msgid "Return the globals dictionary associated with the function object *op*." msgstr "" msgid "" -"Return a :term:`borrowed reference` to the *__module__* attribute of the " -"function object *op*. It can be *NULL*." +"Return a :term:`borrowed reference` to the :attr:`~function.__module__` " +"attribute of the :ref:`function object ` *op*. It can be " +"*NULL*." msgstr "" msgid "" -"This is normally a string containing the module name, but can be set to any " -"other object by Python code." +"This is normally a :class:`string ` containing the module name, but can " +"be set to any other object by Python code." msgstr "" msgid "" @@ -115,7 +117,7 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "function" msgstr "funkcja" diff --git a/c-api/import.po b/c-api/import.po index 0584a85b4f..bc50e14003 100644 --- a/c-api/import.po +++ b/c-api/import.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:08+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,20 +27,8 @@ msgid "Importing Modules" msgstr "" msgid "" -"This is a simplified interface to :c:func:`PyImport_ImportModuleEx` below, " -"leaving the *globals* and *locals* arguments set to ``NULL`` and *level* set " -"to 0. When the *name* argument contains a dot (when it specifies a " -"submodule of a package), the *fromlist* argument is set to the list " -"``['*']`` so that the return value is the named module rather than the top-" -"level package containing it as would otherwise be the case. (Unfortunately, " -"this has an additional side effect when *name* in fact specifies a " -"subpackage instead of a submodule: the submodules specified in the package's " -"``__all__`` variable are loaded.) Return a new reference to the imported " -"module, or ``NULL`` with an exception set on failure. A failing import of a " -"module doesn't leave the module in :data:`sys.modules`." -msgstr "" - -msgid "This function always uses absolute imports." +"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`." @@ -92,6 +80,9 @@ msgid "" "hooks are installed in the current environment." msgstr "" +msgid "This function always uses absolute imports." +msgstr "" + msgid "" "Reload a module. Return a new reference to the reloaded module, or ``NULL`` " "with an exception set on failure (the module still exists in this case)." @@ -122,10 +113,10 @@ msgid "" "object read from a Python bytecode file or obtained from the built-in " "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 :attr:`sys.modules` in error cases, even if *name* " -"was already in :attr:`sys.modules` on entry to :c:func:" +"*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 :" -"attr:`sys.modules` is dangerous, as imports of such modules have no way to " +"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 "" @@ -133,13 +124,14 @@ msgstr "" msgid "" "The module's :attr:`__spec__` and :attr:`__loader__` will be set, if not set " "already, with the appropriate values. The spec's loader will be set to the " -"module's ``__loader__`` (if set) and to an instance of :class:" -"`SourceFileLoader` otherwise." +"module's ``__loader__`` (if set) and to an instance of :class:`~importlib." +"machinery.SourceFileLoader` otherwise." msgstr "" msgid "" -"The module's :attr:`__file__` attribute will be set to the code object's :c:" -"member:`co_filename`. If applicable, :attr:`__cached__` will also be set." +"The module's :attr:`__file__` attribute will be set to the code object's :" +"attr:`~codeobject.co_filename`. If applicable, :attr:`__cached__` will also " +"be set." msgstr "" msgid "" @@ -210,7 +202,7 @@ msgid "" msgstr "" msgid "" -"Return a finder object for a :data:`sys.path`/:attr:`pkg.__path__` item " +"Return a finder object for a :data:`sys.path`/:attr:`!pkg.__path__` item " "*path*, possibly by fetching it from the :data:`sys.path_importer_cache` " "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; " @@ -265,22 +257,26 @@ msgid "" msgstr "" msgid "" -"Structure describing a single entry in the list of built-in modules. Each " -"of these structures gives the name and initialization function for a module " -"built into the interpreter. The name is an ASCII encoded string. Programs " -"which embed Python may use an array of these structures in conjunction with :" -"c:func:`PyImport_ExtendInittab` to provide additional built-in modules. The " -"structure is defined in :file:`Include/import.h` as::" +"Structure describing a single entry in the list of built-in modules. " +"Programs which embed Python may use an array of these structures in " +"conjunction with :c:func:`PyImport_ExtendInittab` to provide additional " +"built-in modules. The structure consists of two members:" +msgstr "" + +msgid "The module name, as an ASCII encoded string." +msgstr "" + +msgid "Initialization function for a module built into the interpreter." 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 :attr:" -"`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 "" @@ -302,10 +298,10 @@ msgid "modules (in module sys)" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "__import__" -msgstr "" +msgstr "__import__" msgid "compile" msgstr "" diff --git a/c-api/init.po b/c-api/init.po index 0e92818d77..b82fab6e7f 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,34 +44,34 @@ msgid "" msgstr "" msgid "Configuration functions:" -msgstr "" +msgstr "Konfiguracja funkcja:" msgid ":c:func:`PyImport_AppendInittab`" -msgstr "" +msgstr ":c:func:`PyImport_AppendInittab`" msgid ":c:func:`PyImport_ExtendInittab`" -msgstr "" +msgstr ":c:func:`PyImport_ExtendInittab`" -msgid ":c:func:`PyInitFrozenExtensions`" -msgstr "" +msgid ":c:func:`!PyInitFrozenExtensions`" +msgstr ":c:func:`!PyInitFrozenExtensions`" msgid ":c:func:`PyMem_SetAllocator`" -msgstr "" +msgstr ":c:func:`PyMem_SetAllocator`" msgid ":c:func:`PyMem_SetupDebugHooks`" -msgstr "" +msgstr ":c:func:`PyMem_SetupDebugHooks`" msgid ":c:func:`PyObject_SetArenaAllocator`" -msgstr "" +msgstr ":c:func:`PyObject_SetArenaAllocator`" msgid ":c:func:`Py_SetPath`" msgstr "" msgid ":c:func:`Py_SetProgramName`" -msgstr "" +msgstr ":c:func:`Py_SetProgramName`" msgid ":c:func:`Py_SetPythonHome`" -msgstr "" +msgstr ":c:func:`Py_SetPythonHome`" msgid ":c:func:`Py_SetStandardStreamEncoding`" msgstr "" @@ -83,55 +83,55 @@ msgid ":c:func:`PySys_AddXOption`" msgstr "" msgid ":c:func:`PySys_ResetWarnOptions`" -msgstr "" +msgstr ":c:func:`PySys_ResetWarnOptions`" msgid "Informative functions:" -msgstr "" +msgstr "Informatiwne funkcje:" msgid ":c:func:`Py_IsInitialized`" -msgstr "" +msgstr ":c:func:`Py_IsInitialized`" msgid ":c:func:`PyMem_GetAllocator`" -msgstr "" +msgstr ":c:func:`PyMem_GetAllocator`" msgid ":c:func:`PyObject_GetArenaAllocator`" -msgstr "" +msgstr ":c:func:`PyObject_GetArenaAllocator`" msgid ":c:func:`Py_GetBuildInfo`" -msgstr "" +msgstr ":c:func:`Py_GetBuildInfo`" msgid ":c:func:`Py_GetCompiler`" -msgstr "" +msgstr ":c:func:`Py_GetCompiler`" msgid ":c:func:`Py_GetCopyright`" -msgstr "" +msgstr ":c:func:`Py_GetCopyright`" msgid ":c:func:`Py_GetPlatform`" -msgstr "" +msgstr ":c:func:`Py_GetPlatform`" msgid ":c:func:`Py_GetVersion`" -msgstr "" +msgstr ":c:func:`Py_GetVersion`" msgid "Utilities:" -msgstr "" +msgstr "Narzędzia:" msgid ":c:func:`Py_DecodeLocale`" -msgstr "" +msgstr ":c:func:`Py_DecodeLocale`" msgid "Memory allocators:" -msgstr "" +msgstr "Alokatory pamięci:" msgid ":c:func:`PyMem_RawMalloc`" -msgstr "" +msgstr ":c:func:`PyMem_RawMalloc`" msgid ":c:func:`PyMem_RawRealloc`" -msgstr "" +msgstr ":c:func:`PyMem_RawRealloc`" msgid ":c:func:`PyMem_RawCalloc`" -msgstr "" +msgstr ":c:func:`PyMem_RawCalloc`" msgid ":c:func:`PyMem_RawFree`" -msgstr "" +msgstr ":c:func:`PyMem_RawFree`" msgid "" "The following functions **should not be called** before :c:func:" @@ -205,7 +205,7 @@ msgid "" msgstr "" msgid "" -"Ignore all :envvar:`PYTHON*` environment variables, e.g. :envvar:" +"Ignore all :envvar:`!PYTHON*` environment variables, e.g. :envvar:" "`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." msgstr "" @@ -252,8 +252,8 @@ msgid ":ref:`Availability `: Windows." msgstr "" msgid "" -"If the flag is non-zero, use :class:`io.FileIO` instead of :class:" -"`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 "" @@ -374,16 +374,16 @@ msgstr "" msgid "" "**Bugs and caveats:** The destruction of modules and objects in modules is " -"done in random order; this may cause destructors (:meth:`__del__` methods) " -"to fail when they depend on other objects (even functions) or modules. " -"Dynamically loaded extension modules loaded by Python are not unloaded. " -"Small amounts of memory allocated by the Python interpreter may not be freed " -"(if you find a leak, please report it). Memory tied up in circular " -"references between objects is not freed. Some memory allocated by extension " -"modules may not be freed. Some extensions may not work properly if their " -"initialization routine is called more than once; this can happen if an " -"application calls :c:func:`Py_Initialize` and :c:func:`Py_FinalizeEx` more " -"than once." +"done in random order; this may cause destructors (:meth:`~object.__del__` " +"methods) to fail when they depend on other objects (even functions) or " +"modules. Dynamically loaded extension modules loaded by Python are not " +"unloaded. Small amounts of memory allocated by the Python interpreter may " +"not be freed (if you find a leak, please report it). Memory tied up in " +"circular references between objects is not freed. Some memory allocated by " +"extension modules may not be freed. Some extensions may not work properly " +"if their initialization routine is called more than once; this can happen if " +"an application calls :c:func:`Py_Initialize` and :c:func:`Py_FinalizeEx` " +"more than once." msgstr "" msgid "" @@ -853,7 +853,7 @@ msgid "" "them afterwards. In addition, it resets any :ref:`lock-objects` in the " "child. When extending or embedding Python, there is no way to inform Python " "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 " +"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 " @@ -898,8 +898,10 @@ msgstr "" msgid "" "This data structure represents the state of a single thread. The only " -"public data member is :attr:`interp` (:c:expr:`PyInterpreterState *`), which " -"points to this thread's interpreter state." +"public data member is:" +msgstr "" + +msgid "This thread's interpreter state." msgstr "" msgid "Deprecated function which does nothing." @@ -947,7 +949,7 @@ msgstr "" msgid "" "Calling this function from a thread when the runtime is finalizing will " "terminate the thread, even if the thread was not created by Python. You can " -"use :c:func:`_Py_IsFinalizing` or :func:`sys.is_finalizing` to check if the " +"use :c:func:`!_Py_IsFinalizing` or :func:`sys.is_finalizing` to check if the " "interpreter is in process of being finalized before calling this function to " "avoid unwanted termination." msgstr "" @@ -1222,8 +1224,8 @@ msgid "" "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 the GIL held. 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 :" -"const:`NULL`, the pending exception (if any) for the thread is cleared. This " +"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 "" @@ -1272,6 +1274,14 @@ msgid "" "`PyEval_RestoreThread` or :c:func:`PyEval_AcquireThread` instead." msgstr "" +msgid "" +"Calling this function from a thread when the runtime is finalizing will " +"terminate the thread, even if the thread was not created by Python. You can " +"use :c:func:`_Py_IsFinalizing` or :func:`sys.is_finalizing` to check if the " +"interpreter is in process of being finalized before calling this function to " +"avoid unwanted termination." +msgstr "" + msgid "" "Release the global interpreter lock. The lock must have been created " "earlier." @@ -1494,10 +1504,11 @@ 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 :const:`PyTrace_CALL`, :const:" -"`PyTrace_EXCEPTION`, :const:`PyTrace_LINE`, :const:`PyTrace_RETURN`, :const:" -"`PyTrace_C_CALL`, :const:`PyTrace_C_EXCEPTION`, :const:`PyTrace_C_RETURN`, " -"or :const:`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*" @@ -1506,42 +1517,42 @@ msgstr "" msgid "Meaning of *arg*" msgstr "" -msgid ":const:`PyTrace_CALL`" -msgstr "" +msgid ":c:data:`PyTrace_CALL`" +msgstr ":c:data:`PyTrace_CALL`" msgid "Always :c:data:`Py_None`." -msgstr "" +msgstr "Zawsze :c:data:`Py_None`." -msgid ":const:`PyTrace_EXCEPTION`" -msgstr "" +msgid ":c:data:`PyTrace_EXCEPTION`" +msgstr ":c:data:`PyTrace_EXCEPTION`" msgid "Exception information as returned by :func:`sys.exc_info`." msgstr "" -msgid ":const:`PyTrace_LINE`" -msgstr "" +msgid ":c:data:`PyTrace_LINE`" +msgstr ":c:data:`PyTrace_LINE`" -msgid ":const:`PyTrace_RETURN`" -msgstr "" +msgid ":c:data:`PyTrace_RETURN`" +msgstr ":c:data:`PyTrace_RETURN`" msgid "" "Value being returned to the caller, or ``NULL`` if caused by an exception." msgstr "" -msgid ":const:`PyTrace_C_CALL`" -msgstr "" +msgid ":c:data:`PyTrace_C_CALL`" +msgstr ":c:data:`PyTrace_C_CALL`" msgid "Function object being called." msgstr "" -msgid ":const:`PyTrace_C_EXCEPTION`" -msgstr "" +msgid ":c:data:`PyTrace_C_EXCEPTION`" +msgstr ":c:data:`PyTrace_C_EXCEPTION`" -msgid ":const:`PyTrace_C_RETURN`" -msgstr "" +msgid ":c:data:`PyTrace_C_RETURN`" +msgstr ":c:data:`PyTrace_C_RETURN`" -msgid ":const:`PyTrace_OPCODE`" -msgstr "" +msgid ":c:data:`PyTrace_OPCODE`" +msgstr ":c:data:`PyTrace_OPCODE`" msgid "" "The value of the *what* parameter to a :c:type:`Py_tracefunc` function when " @@ -1565,8 +1576,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:`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 "" @@ -1593,7 +1604,7 @@ 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:`f_trace_opcodes` to *1* on the frame." +"attr:`~frame.f_trace_opcodes` to *1* on the frame." msgstr "" msgid "" @@ -1601,8 +1612,8 @@ 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 :const:" -"`PyTrace_LINE` :const:`PyTrace_OPCODE` and :const:`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." @@ -1616,9 +1627,9 @@ msgid "" "`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 :const:`PyTrace_C_CALL`, :const:" -"`PyTrace_C_EXCEPTION` or :const:`PyTrace_C_RETURN` as a value for the *what* " -"parameter." +"`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." @@ -1819,7 +1830,7 @@ msgid "builtins" msgstr "builtins" msgid "__main__" -msgstr "" +msgstr "__main__" msgid "sys" msgstr "sys" @@ -1830,13 +1841,13 @@ msgstr "wyszukiwanie" msgid "path" msgstr "ścieżka" -msgid "PySys_SetArgv()" +msgid "PySys_SetArgv (C function)" msgstr "" -msgid "PySys_SetArgvEx()" +msgid "PySys_SetArgvEx (C function)" msgstr "" -msgid "Py_FinalizeEx()" +msgid "Py_FinalizeEx (C function)" msgstr "" msgid "Py_Initialize()" @@ -1887,22 +1898,22 @@ msgstr "" msgid "lock, interpreter" msgstr "" -msgid "setswitchinterval() (in module sys)" +msgid "setswitchinterval (in module sys)" msgstr "" -msgid "PyThreadState" +msgid "PyThreadState (C type)" msgstr "" -msgid "Py_BEGIN_ALLOW_THREADS" +msgid "Py_BEGIN_ALLOW_THREADS (C macro)" msgstr "" -msgid "Py_END_ALLOW_THREADS" +msgid "Py_END_ALLOW_THREADS (C macro)" msgstr "" -msgid "PyEval_RestoreThread()" +msgid "PyEval_RestoreThread (C function)" msgstr "" -msgid "PyEval_SaveThread()" +msgid "PyEval_SaveThread (C function)" msgstr "" msgid "PyEval_AcquireThread()" @@ -1911,6 +1922,12 @@ msgstr "" msgid "PyEval_ReleaseThread()" msgstr "" +msgid "PyEval_SaveThread()" +msgstr "" + +msgid "PyEval_RestoreThread()" +msgstr "" + msgid "_thread" msgstr "" @@ -1923,8 +1940,8 @@ msgstr "" msgid "stdin (in module sys)" msgstr "" -msgid "close() (in module os)" +msgid "Py_Initialize (C function)" msgstr "" -msgid "Py_AddPendingCall()" +msgid "close (in module os)" msgstr "" diff --git a/c-api/intro.po b/c-api/intro.po index d37f6fb9c2..b5c1b24c65 100644 --- a/c-api/intro.po +++ b/c-api/intro.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Igor Zubrycki , 2021 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,6 +57,11 @@ msgid "" "applications since its early existence, the process of embedding Python is " "less straightforward than writing an extension." msgstr "" +"Napisanie moduł rozszerzeń jest stosunkowo dobrze zrozumiałym procesem, w " +"którym dobrze sprawdza się podejście \"książki kucharskiej\". Istnieje " +"kilka narzędzi, które w pewnym stopniu automatyzują ten proces. Ludzie " +"wbudowali Pythona w innych aplikacja od początku jego istnienia, proces " +"wbudowania Pythona jest mniej prosty niż pisanie rozszerzenia." msgid "" "Many API functions are useful independent of whether you're embedding or " @@ -75,7 +79,7 @@ msgstr "" "aplikacji." msgid "Coding standards" -msgstr "" +msgstr "Standardy kodowania" msgid "" "If you're writing C code for inclusion in CPython, you **must** follow the " @@ -84,6 +88,11 @@ msgid "" "these conventions is not necessary for your own third party extension " "modules, unless you eventually expect to contribute them to Python." msgstr "" +"Jeśli piszesz C do umieszczenia w CPythonie **musisz** przestrzegać " +"wytycznych standardów zdefiniowanych w :PEP:`7`. Wytyczne te obowiązują " +"niezależnie od tego, do której wersji Pythona wnosisz swój wkład. " +"Przestrzeganie tych konwencji nie jest konieczne dla własnych rozszerzeń, " +"chyba że ostatecznie spodziewasz się wnieść je do Python." msgid "Include Files" msgstr "Pliki Włączania - z ang. Include" @@ -101,6 +110,9 @@ msgid "" "````, ````, ````, ```` and ```` (if available)." msgstr "" +"Oznacza to włączenie następujących standardowych nagłówek: ````, " +"````, ````, ````, ```` i ```` (jeśli są dostępne)." msgid "" "Since Python may define some pre-processor definitions which affect the " @@ -115,6 +127,8 @@ msgid "" "It is recommended to always define ``PY_SSIZE_T_CLEAN`` before including " "``Python.h``. See :ref:`arg-parsing` for a description of this macro." msgstr "" +"Zaleca się, aby zawsze definiować ``PY_SSIZE_T_CLEAN`` przed włączeniem " +"``Python.h``. Zobacz :ref:`arg-parsing` dla opisu tego makro." msgid "" "All user visible names defined by Python.h (except those defined by the " @@ -173,6 +187,19 @@ msgid "" "a complete listing." msgstr "" +msgid "" +"Declare an extension module ``PyInit`` initialization function. The function " +"return type is :c:expr:`PyObject*`. The macro declares any special linkage " +"declarations required by the platform, and for C++ declares the function as " +"``extern \"C\"``." +msgstr "" + +msgid "" +"The initialization function must be named :samp:`PyInit_{name}`, where " +"*name* is the name of the module, and should be the only non-\\ ``static`` " +"item defined in the module file. Example::" +msgstr "" + msgid "Return the absolute value of ``x``." msgstr "" @@ -194,8 +221,9 @@ msgid "" msgstr "" msgid "" -"If Python is :ref:`built in debug mode ` (if the ``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::" @@ -212,7 +240,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "MSVC support was added." msgstr "" @@ -335,94 +363,70 @@ msgstr "Liczby odniesień" msgid "" "The reference count is important because today's computers have a finite " -"(and often severely limited) memory size; it counts how many different " -"places there are that have a reference to an object. Such a place could be " -"another object, or a global (or static) C variable, or a local variable in " -"some C function. When an object's reference count becomes zero, the object " -"is deallocated. If it contains references to other objects, their " -"reference count is decremented. Those other objects may be deallocated in " -"turn, if this decrement makes their reference count become zero, and so on. " -"(There's an obvious problem with objects that reference each other here; " -"for now, the solution is \"don't do that.\")" -msgstr "" -"Liczba odniesień jest istotna, gdyż dzisiejsze komputery mają skończony (i " -"zwykle poważnie ograniczony) rozmiar pamięci; liczy ona jak wiele różnych " -"miejsc istnieje, które przechowują odniesienie do przedmiotu. Takie miejsce " -"może być innym przedmiotem, zmienną C nadrzędnego poziomu (lub statyczną), " -"lub lokalną zmienną w jakimś zadaniu języka C. Gdy liczba odniesień do " -"przedmiotu staje się równa zero, przedmiot jest zdejmowany z pamięci. Jeśli " -"zawiera odniesienia do innych przedmiotów liczba odniesień do nich jest " -"obniżana po jednym dla każdego. Te inne przedmioty mogą być zdejmowane z " -"pamięci w konsekwencji, jeśli obniżenie liczby odniesień do nich spowoduje " -"że liczba odniesień stanie się równa zero, itd. (Istnieje dość oczywisty " -"problem z przedmiotami które wzajemnie się odnoszą do siebie; na razie " -"rozwiązaniem jest \"proszę tak nie robić.\")" - -msgid "" -"Reference counts are always manipulated explicitly. The normal way is to " -"use the macro :c:func:`Py_INCREF` to increment an object's reference count " -"by one, and :c:func:`Py_DECREF` to decrement it by one. The :c:func:" +"(and often severely limited) memory size; it counts how many different " +"places there are that have a :term:`strong reference` to an object. Such a " +"place could be another object, or a global (or static) C variable, or a " +"local variable in some C function. When the last :term:`strong reference` to " +"an object is released (i.e. its reference count becomes zero), the object is " +"deallocated. If it contains references to other objects, those references " +"are released. Those other objects may be deallocated in turn, if there are " +"no more references to them, and so on. (There's an obvious problem with " +"objects that reference each other here; for now, the solution is \"don't do " +"that.\")" +msgstr "" + +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 " +"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 decrementing the reference counts 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 "" -"It is not necessary to increment an object's reference count for every " -"local variable that contains a pointer to an object. In theory, the " -"object's reference count goes up by one when the variable is made to point " -"to it and it goes down by one when the variable goes out of scope. " -"However, these two cancel each other out, so at the end the reference count " -"hasn't changed. The only real reason to use the reference count is to " -"prevent the object from being deallocated as long as our variable is " -"pointing to it. If we know that there is at least one other reference to " -"the object that lives at least as long as our variable, there is no need to " -"increment the reference count temporarily. An important situation where " -"this arises is in objects that are passed as arguments to C functions in an " -"extension module that are called from Python; the call mechanism guarantees " -"to hold a reference to every argument for the duration of the call." -msgstr "" -"Nie jest konieczne zwiększanie zwiększanie liczby odniesień do przedmiotu " -"dla każdej lokalnej zmiennej która zawiera wskaźnik na przedmiot. " -"Teoretycznie, liczba odniesień do przedmiotu zwiększa się o jeden gdy " -"zmienna jest zmuszana do wskazywania nań i jest zmniejszana o jeden gdy " -"zmienna wychodzi z widoku. Jednakże te dwa działania wykluczają się " -"nawzajem, więc ostatecznie liczba odniesień nie ulega zmianie. Jedynym " -"prawdziwym powodem użycia liczby odniesień jest aby uniemożliwić zdjęcie z " -"pamięci przedmiotu tak długo jak nasza zmienna nań wskazuje. Jeśli wiemy, że " -"istnieje przynajmniej jedno inne odniesienie do przedmiotu, które żyje tak " -"długo jak nasza zmienna, nie ma potrzeby zwiększania liczby odniesień " -"tymczasowo. Istotną sytuacją gdzie to się pojawia jest w obiektach które są " -"przekazywane jako parametry do zadań C w modułach rozszerzających które są " -"wywoływane przez polecenia języka pytonowskiego; mechanizm wywołania " -"gwarantuje przytrzymanie odniesienia do każdego parametru na czas wywołania " -"zadania z tym parametrem." +"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 "" +"It is not necessary to hold a :term:`strong reference` (i.e. increment the " +"reference count) for every local variable that contains a pointer to an " +"object. In theory, the object's reference count goes up by one when the " +"variable is made to point to it and it goes down by one when the variable " +"goes out of scope. However, these two cancel each other out, so at the end " +"the reference count hasn't changed. The only real reason to use the " +"reference count is to prevent the object from being deallocated as long as " +"our variable is pointing to it. If we know that there is at least one " +"other reference to the object that lives at least as long as our variable, " +"there is no need to take a new :term:`strong reference` (i.e. increment the " +"reference count) temporarily. An important situation where this arises is in " +"objects that are passed as arguments to C functions in an extension module " +"that are called from Python; the call mechanism guarantees to hold a " +"reference to every argument for the duration of the call." +msgstr "" msgid "" "However, a common pitfall is to extract an object from a list and hold on to " -"it for a while without incrementing its reference count. Some other " -"operation might conceivably remove the object from the list, decrementing " -"its reference count 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." +"it for a while without taking a new reference. Some other operation might " +"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." msgstr "" msgid "" "A safe approach is to always use the generic operations (functions whose " "name begins with ``PyObject_``, ``PyNumber_``, ``PySequence_`` or " -"``PyMapping_``). These operations always increment the reference count of " -"the object they return. This leaves the caller with the responsibility to " -"call :c:func:`Py_DECREF` when they are done with the result; this soon " -"becomes second nature." +"``PyMapping_``). These operations always create a new :term:`strong " +"reference` (i.e. increment the reference count) of the object they return. " +"This leaves the caller with the responsibility to call :c:func:`Py_DECREF` " +"when they are done with the result; this soon becomes second nature." msgstr "" msgid "Reference Count Details" @@ -435,8 +439,8 @@ 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 decref'ing it by calling :" -"c:func:`Py_DECREF` or :c:func:`Py_XDECREF` when it's no longer needed---or " +"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 " @@ -499,8 +503,8 @@ msgid "" "It is much more common to use :c:func:`PyObject_SetItem` and friends with " "items whose references you are only borrowing, like arguments that were " "passed in to the function you are writing. In that case, their behaviour " -"regarding reference counts is much saner, since you don't have to increment " -"a reference count so you can give a reference away (\"have it be stolen\"). " +"regarding references is much saner, since you don't have to take a new " +"reference just so you can give that reference away (\"have it be stolen\"). " "For example, this function sets all items of a list (actually, any mutable " "sequence) to a given item::" msgstr "" @@ -652,7 +656,7 @@ msgstr "" msgid "" "A simple example of detecting exceptions and passing them on is shown in " -"the :c:func:`sum_sequence` example above. It so happens that this example " +"the :c:func:`!sum_sequence` example above. It so happens that this example " "doesn't need to clean up any owned references when it detects an error. The " "following example function shows some error cleanup. First, to remind you " "why you like Python, we show the equivalent Python code::" @@ -781,12 +785,12 @@ msgid "" msgstr "" msgid "" -"Compiling the interpreter with the :c:macro:`Py_DEBUG` macro defined " +"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:" +"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 " +"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 "" @@ -812,30 +816,30 @@ msgstr "" "pytonowskiego po więcej szczegółów." msgid "object" -msgstr "" +msgstr "obiekt" msgid "type" -msgstr "" +msgstr "typ" -msgid "Py_INCREF()" +msgid "Py_INCREF (C function)" msgstr "" -msgid "Py_DECREF()" +msgid "Py_DECREF (C function)" msgstr "" -msgid "PyList_SetItem()" +msgid "PyList_SetItem (C function)" msgstr "" -msgid "PyTuple_SetItem()" +msgid "PyTuple_SetItem (C function)" msgstr "" msgid "set_all()" msgstr "" -msgid "PyList_GetItem()" +msgid "PyList_GetItem (C function)" msgstr "" -msgid "PySequence_GetItem()" +msgid "PySequence_GetItem (C function)" msgstr "" msgid "sum_list()" @@ -844,28 +848,28 @@ msgstr "" msgid "sum_sequence()" msgstr "" -msgid "PyErr_Occurred()" +msgid "PyErr_Occurred (C function)" msgstr "" -msgid "PyErr_SetString()" +msgid "PyErr_SetString (C function)" msgstr "" -msgid "PyErr_Clear()" +msgid "PyErr_Clear (C function)" msgstr "" -msgid "exc_info() (in module sys)" +msgid "exc_info (in module sys)" msgstr "" msgid "incr_item()" msgstr "" -msgid "PyErr_ExceptionMatches()" +msgid "PyErr_ExceptionMatches (C function)" msgstr "" -msgid "Py_XDECREF()" +msgid "Py_XDECREF (C function)" msgstr "" -msgid "Py_Initialize()" +msgid "Py_Initialize (C function)" msgstr "" msgid "module" @@ -875,7 +879,7 @@ msgid "builtins" msgstr "builtins" msgid "__main__" -msgstr "" +msgstr "__main__" msgid "sys" msgstr "sys" @@ -889,20 +893,20 @@ msgstr "ścieżka" msgid "path (in module sys)" msgstr "" -msgid "Py_SetProgramName()" +msgid "Py_SetProgramName (C function)" msgstr "" -msgid "Py_GetPath()" +msgid "Py_GetPath (C function)" msgstr "" -msgid "Py_GetPrefix()" +msgid "Py_GetPrefix (C function)" msgstr "" -msgid "Py_GetExecPrefix()" +msgid "Py_GetExecPrefix (C function)" msgstr "" -msgid "Py_GetProgramFullPath()" +msgid "Py_GetProgramFullPath (C function)" msgstr "" -msgid "Py_IsInitialized()" +msgid "Py_IsInitialized (C function)" msgstr "" diff --git a/c-api/list.po b/c-api/list.po new file mode 100644 index 0000000000..1f770f2374 --- /dev/null +++ b/c-api/list.po @@ -0,0 +1,153 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "List Objects" +msgstr "" + +msgid "This subtype of :c:type:`PyObject` represents a Python list object." +msgstr "Ten podtyp :c:type:`PyObject` reprezentuje obiekt listy Pythona." + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python list type. " +"This is the same object as :class:`list` in the Python layer." +msgstr "" + +msgid "" +"Return true if *p* is a list object or an instance of a subtype of the list " +"type. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *p* is a list object, but not an instance of a subtype of the " +"list type. This function always succeeds." +msgstr "" + +msgid "Return a new list of length *len* on success, or ``NULL`` on failure." +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`." +msgstr "" + +msgid "" +"Return the length of the list object in *list*; this is equivalent to " +"``len(list)`` on a list object." +msgstr "" + +msgid "Similar to :c:func:`PyList_Size`, but without error checking." +msgstr "" + +msgid "" +"Return the object at position *index* in the list pointed to by *list*. The " +"position must be non-negative; indexing from the end of the list is not " +"supported. If *index* is out of bounds (<0 or >=len(list)), return ``NULL`` " +"and set an :exc:`IndexError` exception." +msgstr "" + +msgid "Similar to :c:func:`PyList_GetItem`, but without error checking." +msgstr "" + +msgid "" +"Set the item at index *index* in list to *item*. Return ``0`` on success. " +"If *index* is out of bounds, return ``-1`` and set an :exc:`IndexError` " +"exception." +msgstr "" + +msgid "" +"This function \"steals\" a reference to *item* and discards a reference to " +"an item already in the list at the affected position." +msgstr "" + +msgid "" +"Macro form of :c:func:`PyList_SetItem` without error checking. This is " +"normally only used to fill in new lists where there is no previous content." +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." +msgstr "" + +msgid "" +"Insert the item *item* into list *list* in front of index *index*. Return " +"``0`` if successful; return ``-1`` and set an exception if unsuccessful. " +"Analogous to ``list.insert(index, item)``." +msgstr "" + +msgid "" +"Append the object *item* at the end of list *list*. Return ``0`` if " +"successful; return ``-1`` and set an exception if unsuccessful. Analogous " +"to ``list.append(item)``." +msgstr "" + +msgid "" +"Return a list of the objects in *list* containing the objects *between* " +"*low* and *high*. Return ``NULL`` and set an exception if unsuccessful. " +"Analogous to ``list[low:high]``. Indexing from the end of the list is not " +"supported." +msgstr "" + +msgid "" +"Set the slice of *list* between *low* and *high* to the contents of " +"*itemlist*. Analogous to ``list[low:high] = itemlist``. The *itemlist* may " +"be ``NULL``, indicating the assignment of an empty list (slice deletion). " +"Return ``0`` on success, ``-1`` on failure. Indexing from the end of the " +"list is not supported." +msgstr "" + +msgid "" +"Sort the items of *list* in place. Return ``0`` on success, ``-1`` on " +"failure. This is equivalent to ``list.sort()``." +msgstr "" + +msgid "" +"Reverse the items of *list* in place. Return ``0`` on success, ``-1`` on " +"failure. This is the equivalent of ``list.reverse()``." +msgstr "" + +msgid "" +"Return a new tuple object containing the contents of *list*; equivalent to " +"``tuple(list)``." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "list" +msgstr "lista" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "len" +msgstr "len" + +msgid "tuple" +msgstr "tuple" diff --git a/c-api/long.po b/c-api/long.po new file mode 100644 index 0000000000..4a3e85bcf0 --- /dev/null +++ b/c-api/long.po @@ -0,0 +1,308 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "Integer Objects" +msgstr "" + +msgid "" +"All integers are implemented as \"long\" integer objects of arbitrary size." +msgstr "" + +msgid "" +"On error, most ``PyLong_As*`` APIs return ``(return type)-1`` which cannot " +"be distinguished from a number. Use :c:func:`PyErr_Occurred` to " +"disambiguate." +msgstr "" + +msgid "This subtype of :c:type:`PyObject` represents a Python integer object." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python integer type. " +"This is the same object as :class:`int` in the Python layer." +msgstr "" + +msgid "" +"Return true if its argument is a :c:type:`PyLongObject` or a subtype of :c:" +"type:`PyLongObject`. This function always succeeds." +msgstr "" + +msgid "" +"Return true if its argument is a :c:type:`PyLongObject`, but not a subtype " +"of :c:type:`PyLongObject`. This function always succeeds." +msgstr "" + +msgid "" +"Return a new :c:type:`PyLongObject` object from *v*, or ``NULL`` on failure." +msgstr "" + +msgid "" +"The current implementation keeps an array of integer objects for all " +"integers between ``-5`` and ``256``. When you create an int in that range " +"you actually just get back a reference to the existing object." +msgstr "" + +msgid "" +"Return a new :c:type:`PyLongObject` object from a C :c:expr:`unsigned long`, " +"or ``NULL`` on failure." +msgstr "" + +msgid "" +"Return a new :c:type:`PyLongObject` object from a C :c:type:`Py_ssize_t`, or " +"``NULL`` on failure." +msgstr "" + +msgid "" +"Return a new :c:type:`PyLongObject` object from a C :c:type:`size_t`, or " +"``NULL`` on failure." +msgstr "" + +msgid "" +"Return a new :c:type:`PyLongObject` object from a C :c:expr:`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." +msgstr "" + +msgid "" +"Return a new :c:type:`PyLongObject` object from the integer part of *v*, or " +"``NULL`` on failure." +msgstr "" + +msgid "" +"Return a new :c:type:`PyLongObject` based on the string value in *str*, " +"which is interpreted according to the radix in *base*. If *pend* is non-" +"``NULL``, *\\*pend* will point to the first character in *str* which follows " +"the representation of the number. If *base* is ``0``, *str* is interpreted " +"using the :ref:`integers` definition; in this case, leading zeros in a non-" +"zero decimal number raises a :exc:`ValueError`. If *base* is not ``0``, it " +"must be between ``2`` and ``36``, inclusive. Leading spaces and single " +"underscores after a base specifier and between digits are ignored. If there " +"are no digits, :exc:`ValueError` will be raised." +msgstr "" + +msgid "" +"Python methods :meth:`int.to_bytes` and :meth:`int.from_bytes` to convert a :" +"c:type:`PyLongObject` to/from an array of bytes in base ``256``. You can " +"call those from C using :c:func:`PyObject_CallMethod`." +msgstr "" + +msgid "" +"Convert a sequence of Unicode digits in the string *u* to a Python integer " +"value." +msgstr "" + +msgid "" +"Create a Python integer from the pointer *p*. The pointer value can be " +"retrieved from the resulting value using :c:func:`PyLong_AsVoidPtr`." +msgstr "" + +msgid "" +"Return a C :c:expr:`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`." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "Use :meth:`~object.__index__` if available." +msgstr "" + +msgid "This function will no longer use :meth:`~object.__int__`." +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." +msgstr "" + +msgid "" +"Return a C :c:expr:`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`." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"Return a C :c:type:`Py_ssize_t` representation of *pylong*. *pylong* must " +"be an instance of :c:type:`PyLongObject`." +msgstr "" + +msgid "" +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" +"type:`Py_ssize_t`." +msgstr "" + +msgid "" +"Return a C :c:expr:`unsigned long` representation of *pylong*. *pylong* " +"must be an instance of :c:type:`PyLongObject`." +msgstr "" + +msgid "" +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" +"expr:`unsigned long`." +msgstr "" + +msgid "" +"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to " +"disambiguate." +msgstr "" + +msgid "" +"Return a C :c:type:`size_t` representation of *pylong*. *pylong* must be an " +"instance of :c:type:`PyLongObject`." +msgstr "" + +msgid "" +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" +"type:`size_t`." +msgstr "" + +msgid "" +"Returns ``(size_t)-1`` on error. Use :c:func:`PyErr_Occurred` to " +"disambiguate." +msgstr "" + +msgid "" +"Return a C :c:expr:`unsigned long long` representation of *pylong*. " +"*pylong* must be an instance of :c:type:`PyLongObject`." +msgstr "" + +msgid "" +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for an :" +"c:expr:`unsigned long long`." +msgstr "" + +msgid "" +"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` to " +"disambiguate." +msgstr "" + +msgid "" +"A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`." +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`." +msgstr "" + +msgid "" +"If the value of *obj* is out of range for an :c:expr:`unsigned long`, return " +"the reduction of that value modulo ``ULONG_MAX + 1``." +msgstr "" + +msgid "" +"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to " +"disambiguate." +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`." +msgstr "" + +msgid "" +"If the value of *obj* is out of range for an :c:expr:`unsigned long long`, " +"return the reduction of that value modulo ``ULLONG_MAX + 1``." +msgstr "" + +msgid "" +"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` " +"to disambiguate." +msgstr "" + +msgid "" +"Return a C :c:expr:`double` representation of *pylong*. *pylong* must be an " +"instance of :c:type:`PyLongObject`." +msgstr "" + +msgid "" +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" +"expr:`double`." +msgstr "" + +msgid "" +"Returns ``-1.0`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." +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`." +msgstr "" + +msgid "" +"Returns ``NULL`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "long integer" +msgstr "" + +msgid "integer" +msgstr "" + +msgid "LONG_MAX (C macro)" +msgstr "" + +msgid "OverflowError (built-in exception)" +msgstr "" + +msgid "PY_SSIZE_T_MAX (C macro)" +msgstr "" + +msgid "ULONG_MAX (C macro)" +msgstr "" + +msgid "SIZE_MAX (C macro)" +msgstr "" diff --git a/c-api/mapping.po b/c-api/mapping.po new file mode 100644 index 0000000000..8903a62da3 --- /dev/null +++ b/c-api/mapping.po @@ -0,0 +1,114 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Mapping Protocol" +msgstr "" + +msgid "" +"See also :c:func:`PyObject_GetItem`, :c:func:`PyObject_SetItem` and :c:func:" +"`PyObject_DelItem`." +msgstr "" + +msgid "" +"Return ``1`` if the object provides the mapping protocol or supports " +"slicing, and ``0`` otherwise. Note that it returns ``1`` for Python classes " +"with a :meth:`~object.__getitem__` method, since in general it is impossible " +"to determine what type of keys the class supports. This function always " +"succeeds." +msgstr "" + +msgid "" +"Returns the number of keys in object *o* on success, and ``-1`` on failure. " +"This is equivalent to the Python expression ``len(o)``." +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*`." +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*`." +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*`." +msgstr "" + +msgid "" +"Return ``1`` if the mapping object has the key *key* and ``0`` otherwise. " +"This is equivalent to the Python expression ``key in o``. This function " +"always succeeds." +msgstr "" + +msgid "" +"Exceptions which occur when this calls :meth:`~object.__getitem__` method " +"are silently ignored. For proper error handling, use :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*`." +msgstr "" + +msgid "" +"Exceptions that occur when this calls :meth:`~object.__getitem__` method or " +"while creating the temporary :class:`str` object are silently ignored. For " +"proper error handling, use :c:func:`PyMapping_GetItemString` instead." +msgstr "" + +msgid "" +"On success, return a list of the keys in object *o*. On failure, return " +"``NULL``." +msgstr "" + +msgid "Previously, the function returned a list or a tuple." +msgstr "" + +msgid "" +"On success, return a list of the values in object *o*. On failure, return " +"``NULL``." +msgstr "" + +msgid "" +"On success, return a list of the items in object *o*, where each item is a " +"tuple containing a key-value pair. On failure, return ``NULL``." +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "len" +msgstr "len" diff --git a/c-api/memory.po b/c-api/memory.po index 57cf497aaa..cb255cbbba 100644 --- a/c-api/memory.po +++ b/c-api/memory.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +182,8 @@ msgstr "" msgid "" "The :ref:`default raw memory allocator ` uses the " "following functions: :c:func:`malloc`, :c:func:`calloc`, :c:func:`realloc` " -"and :c:func:`free`; call ``malloc(1)`` (or ``calloc(1, 1)``) when requesting " -"zero bytes." +"and :c:func:`!free`; call ``malloc(1)`` (or ``calloc(1, 1)``) when " +"requesting zero bytes." msgstr "" msgid "" @@ -307,15 +308,15 @@ msgstr "" msgid "" "Same as :c:func:`PyMem_Malloc`, but allocates ``(n * sizeof(TYPE))`` bytes " -"of memory. Returns a pointer cast to :c:expr:`TYPE*`. The memory will not " -"have been initialized in any way." +"of memory. Returns a pointer cast to ``TYPE*``. The memory will not have " +"been initialized in any way." msgstr "" msgid "" "Same as :c:func:`PyMem_Realloc`, but the memory block is resized to ``(n * " -"sizeof(TYPE))`` bytes. Returns a pointer cast to :c:expr:`TYPE*`. On " -"return, *p* will be a pointer to the new memory area, or ``NULL`` in the " -"event of failure." +"sizeof(TYPE))`` bytes. Returns a pointer cast to ``TYPE*``. On return, *p* " +"will be a pointer to the new memory area, or ``NULL`` in the event of " +"failure." msgstr "" msgid "" @@ -340,22 +341,22 @@ msgstr "" "rozszerzających." msgid "``PyMem_MALLOC(size)``" -msgstr "" +msgstr "``PyMem_MALLOC(size)``" msgid "``PyMem_NEW(type, size)``" -msgstr "" +msgstr "``PyMem_NEW(type, size)``" msgid "``PyMem_REALLOC(ptr, size)``" -msgstr "" +msgstr "``PyMem_REALLOC(ptr, size)``" msgid "``PyMem_RESIZE(ptr, type, size)``" msgstr "" msgid "``PyMem_FREE(ptr)``" -msgstr "" +msgstr "``PyMem_FREE(ptr)``" msgid "``PyMem_DEL(ptr)``" -msgstr "" +msgstr "``PyMem_DEL(ptr)``" msgid "Object allocators" msgstr "" @@ -415,37 +416,37 @@ msgid "Default memory allocators:" msgstr "" msgid "Configuration" -msgstr "" +msgstr "Konfiguracja" msgid "Name" msgstr "Nazwa" msgid "PyMem_RawMalloc" -msgstr "" +msgstr "PyMem_RawMalloc" msgid "PyMem_Malloc" -msgstr "" +msgstr "PyMem_Malloc" msgid "PyObject_Malloc" -msgstr "" +msgstr "PyObject_Malloc" msgid "Release build" msgstr "" msgid "``\"pymalloc\"``" -msgstr "" +msgstr "``\"pymalloc\"``" msgid "``malloc``" -msgstr "" +msgstr "``malloc``" msgid "``pymalloc``" -msgstr "" +msgstr "``pymalloc``" msgid "Debug build" msgstr "" msgid "``\"pymalloc_debug\"``" -msgstr "" +msgstr "``\"pymalloc_debug\"``" msgid "``malloc`` + debug" msgstr "" @@ -457,16 +458,16 @@ msgid "Release build, without pymalloc" msgstr "" msgid "``\"malloc\"``" -msgstr "" +msgstr "``\"malloc\"``" msgid "Debug build, without pymalloc" msgstr "" msgid "``\"malloc_debug\"``" -msgstr "" +msgstr "``\"malloc_debug\"``" msgid "Legend:" -msgstr "" +msgstr "Legenda:" msgid "Name: value for :envvar:`PYTHONMALLOC` environment variable." msgstr "" @@ -496,13 +497,13 @@ msgid "" msgstr "" msgid "Field" -msgstr "" +msgstr "Pole" msgid "Meaning" msgstr "Znaczenie" msgid "``void *ctx``" -msgstr "" +msgstr "``void *ctx``" msgid "user context passed as first argument" msgstr "" @@ -532,7 +533,7 @@ msgid "free a memory block" msgstr "" msgid "" -"The :c:type:`PyMemAllocator` structure was renamed to :c:type:" +"The :c:type:`!PyMemAllocator` structure was renamed to :c:type:" "`PyMemAllocatorEx` and a new ``calloc`` field was added." msgstr "" @@ -540,43 +541,43 @@ msgid "Enum used to identify an allocator domain. Domains:" msgstr "" msgid "Functions:" -msgstr "" +msgstr "Funkcje:" msgid ":c:func:`PyMem_RawMalloc`" -msgstr "" +msgstr ":c:func:`PyMem_RawMalloc`" msgid ":c:func:`PyMem_RawRealloc`" -msgstr "" +msgstr ":c:func:`PyMem_RawRealloc`" msgid ":c:func:`PyMem_RawCalloc`" -msgstr "" +msgstr ":c:func:`PyMem_RawCalloc`" msgid ":c:func:`PyMem_RawFree`" -msgstr "" +msgstr ":c:func:`PyMem_RawFree`" msgid ":c:func:`PyMem_Malloc`," -msgstr "" +msgstr ":c:func:`PyMem_Malloc`," msgid ":c:func:`PyMem_Realloc`" -msgstr "" +msgstr ":c:func:`PyMem_Realloc`" msgid ":c:func:`PyMem_Calloc`" -msgstr "" +msgstr ":c:func:`PyMem_Calloc`" msgid ":c:func:`PyMem_Free`" -msgstr "" +msgstr ":c:func:`PyMem_Free`" msgid ":c:func:`PyObject_Malloc`" -msgstr "" +msgstr ":c:func:`PyObject_Malloc`" msgid ":c:func:`PyObject_Realloc`" -msgstr "" +msgstr ":c:func:`PyObject_Realloc`" msgid ":c:func:`PyObject_Calloc`" -msgstr "" +msgstr ":c:func:`PyObject_Calloc`" msgid ":c:func:`PyObject_Free`" -msgstr "" +msgstr ":c:func:`PyObject_Free`" msgid "Get the memory block allocator of the specified domain." msgstr "" @@ -590,7 +591,7 @@ msgid "" msgstr "" msgid "" -"For the :c:data:`PYMEM_DOMAIN_RAW` domain, the allocator must be thread-" +"For the :c:macro:`PYMEM_DOMAIN_RAW` domain, the allocator must be thread-" "safe: the :term:`GIL ` is not held when the " "allocator is called." msgstr "" @@ -675,8 +676,9 @@ msgstr "" msgid "" "Check that the :term:`GIL ` is held when allocator " -"functions of :c:data:`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) and :" -"c:data:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) domains are called." +"functions of :c:macro:`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) " +"and :c:macro:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) domains are " +"called." msgstr "" msgid "" @@ -696,7 +698,7 @@ msgid "" msgstr "" msgid "``p[-2*S:-S]``" -msgstr "" +msgstr "``p[-2*S:-S]``" msgid "" "Number of bytes originally asked for. This is a size_t, big-endian (easier " @@ -704,28 +706,28 @@ msgid "" msgstr "" msgid "``p[-S]``" -msgstr "" +msgstr "``p[-S]``" msgid "API identifier (ASCII character):" msgstr "" -msgid "``'r'`` for :c:data:`PYMEM_DOMAIN_RAW`." +msgid "``'r'`` for :c:macro:`PYMEM_DOMAIN_RAW`." msgstr "" -msgid "``'m'`` for :c:data:`PYMEM_DOMAIN_MEM`." +msgid "``'m'`` for :c:macro:`PYMEM_DOMAIN_MEM`." msgstr "" -msgid "``'o'`` for :c:data:`PYMEM_DOMAIN_OBJ`." +msgid "``'o'`` for :c:macro:`PYMEM_DOMAIN_OBJ`." msgstr "" msgid "``p[-S+1:0]``" -msgstr "" +msgstr "``p[-S+1:0]``" msgid "Copies of PYMEM_FORBIDDENBYTE. Used to catch under- writes and reads." msgstr "" msgid "``p[0:N]``" -msgstr "" +msgstr "``p[0:N]``" msgid "" "The requested memory, filled with copies of PYMEM_CLEANBYTE, used to catch " @@ -738,13 +740,13 @@ msgid "" msgstr "" msgid "``p[N:N+S]``" -msgstr "" +msgstr "``p[N:N+S]``" msgid "Copies of PYMEM_FORBIDDENBYTE. Used to catch over- writes and reads." msgstr "" msgid "``p[N+S:N+2*S]``" -msgstr "" +msgstr "``p[N+S:N+2*S]``" msgid "" "Only used if the ``PYMEM_DEBUG_SERIALNO`` macro is defined (not defined by " @@ -753,11 +755,11 @@ msgstr "" msgid "" "A serial number, incremented by 1 on each call to a malloc-like or realloc-" -"like function. Big-endian ``size_t``. If \"bad memory\" is detected later, " -"the serial number gives an excellent way to set a breakpoint on the next " -"run, to capture the instant at which this block was passed out. The static " -"function bumpserialno() in obmalloc.c is the only place the serial number is " -"incremented, and exists so you can set such a breakpoint easily." +"like function. Big-endian :c:type:`size_t`. If \"bad memory\" is detected " +"later, the serial number gives an excellent way to set a breakpoint on the " +"next run, to capture the instant at which this block was passed out. The " +"static function bumpserialno() in obmalloc.c is the only place the serial " +"number is incremented, and exists so you can set such a breakpoint easily." msgstr "" msgid "" @@ -776,8 +778,8 @@ 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 the GIL is held when functions of :c:data:" -"`PYMEM_DOMAIN_OBJ` and :c:data:`PYMEM_DOMAIN_MEM` domains are called." +"debug hooks now also check if the GIL is held when functions of :c:macro:" +"`PYMEM_DOMAIN_OBJ` and :c:macro:`PYMEM_DOMAIN_MEM` domains are called." msgstr "" msgid "" @@ -793,24 +795,24 @@ msgstr "" 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 256 KiB. It falls back to :c:func:" -"`PyMem_RawMalloc` and :c:func:`PyMem_RawRealloc` for allocations larger than " -"512 bytes." +"\"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." msgstr "" msgid "" "*pymalloc* is the :ref:`default allocator ` of " -"the :c:data:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) and :c:data:" +"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:" msgstr "" -msgid ":c:func:`VirtualAlloc` and :c:func:`VirtualFree` on Windows," +msgid ":c:func:`!VirtualAlloc` and :c:func:`!VirtualFree` on Windows," msgstr "" -msgid ":c:func:`mmap` and :c:func:`munmap` if available," +msgid ":c:func:`!mmap` and :c:func:`!munmap` if available," msgstr "" msgid ":c:func:`malloc` and :c:func:`free` otherwise." @@ -903,8 +905,8 @@ 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:func:" -"`PyObject_New`, :c:func:`PyObject_NewVar` and :c:func:`PyObject_Del`." +"Python heap, objects in Python are allocated and released with :c:macro:" +"`PyObject_New`, :c:macro:`PyObject_NewVar` and :c:func:`PyObject_Del`." msgstr "" msgid "" @@ -914,14 +916,14 @@ msgstr "" "Te zostaną wyjaśnione w następnym rozdziale o określaniu i realizowaniu " "nowych typów obiektów w języku C." -msgid "malloc()" +msgid "malloc (C function)" msgstr "" -msgid "calloc()" +msgid "calloc (C function)" msgstr "" -msgid "realloc()" +msgid "realloc (C function)" msgstr "" -msgid "free()" +msgid "free (C function)" msgstr "" diff --git a/c-api/memoryview.po b/c-api/memoryview.po new file mode 100644 index 0000000000..9b8d20f2ff --- /dev/null +++ b/c-api/memoryview.po @@ -0,0 +1,94 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "MemoryView objects" +msgstr "" + +msgid "" +"A :class:`memoryview` object exposes the C level :ref:`buffer interface " +"` as a Python object which can then be passed around like any " +"other object." +msgstr "" + +msgid "" +"Create a memoryview object from an object that provides the buffer " +"interface. If *obj* supports writable buffer exports, the memoryview object " +"will be read/write, otherwise it may be either read-only or read/write at " +"the discretion of the exporter." +msgstr "" + +msgid "Flag to request a readonly buffer." +msgstr "" + +msgid "Flag to request a writable buffer." +msgstr "" + +msgid "" +"Create a memoryview object using *mem* as the underlying buffer. *flags* can " +"be one of :c:macro:`PyBUF_READ` or :c:macro:`PyBUF_WRITE`." +msgstr "" + +msgid "" +"Create a memoryview object wrapping the given buffer structure *view*. For " +"simple byte buffers, :c:func:`PyMemoryView_FromMemory` is the preferred " +"function." +msgstr "" + +msgid "" +"Create a memoryview object to a :term:`contiguous` chunk of memory (in " +"either 'C' or 'F'ortran *order*) from an object that defines the buffer " +"interface. If memory is contiguous, the memoryview object points to the " +"original memory. Otherwise, a copy is made and the memoryview points to a " +"new bytes object." +msgstr "" + +msgid "" +"*buffertype* can be one of :c:macro:`PyBUF_READ` or :c:macro:`PyBUF_WRITE`." +msgstr "" + +msgid "" +"Return true if the object *obj* is a memoryview object. It is not currently " +"allowed to create subclasses of :class:`memoryview`. This function always " +"succeeds." +msgstr "" + +msgid "" +"Return a pointer to the memoryview's private copy of the exporter's buffer. " +"*mview* **must** be a memoryview instance; this macro doesn't check its " +"type, you must do it yourself or you will risk crashes." +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." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "memoryview" +msgstr "" diff --git a/c-api/method.po b/c-api/method.po new file mode 100644 index 0000000000..8beb99ed17 --- /dev/null +++ b/c-api/method.po @@ -0,0 +1,109 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Instance Method Objects" +msgstr "" + +msgid "" +"An instance method is a wrapper for a :c:type:`PyCFunction` and the new way " +"to bind a :c:type:`PyCFunction` to a class object. It replaces the former " +"call ``PyMethod_New(func, NULL, class)``." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python instance " +"method type. It is not exposed to Python programs." +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." +msgstr "" + +msgid "" +"Return a new instance method object, with *func* being any callable object. " +"*func* is the function that will be called when the instance method is " +"called." +msgstr "" + +msgid "Return the function object associated with the instance method *im*." +msgstr "" + +msgid "" +"Macro version of :c:func:`PyInstanceMethod_Function` which avoids error " +"checking." +msgstr "" + +msgid "Method Objects" +msgstr "Obiekty metod" + +msgid "" +"Methods are bound function objects. Methods are always bound to an instance " +"of a user-defined class. Unbound methods (methods bound to a class object) " +"are no longer available." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python method type. " +"This is exposed to Python programs as ``types.MethodType``." +msgstr "" + +msgid "" +"Return true if *o* is a method object (has type :c:data:`PyMethod_Type`). " +"The parameter must not be ``NULL``. This function always succeeds." +msgstr "" + +msgid "" +"Return a new method object, with *func* being any callable object and *self* " +"the instance the method should be bound. *func* is the function that will be " +"called when the method is called. *self* must not be ``NULL``." +msgstr "" + +msgid "Return the function object associated with the method *meth*." +msgstr "" + +msgid "" +"Macro version of :c:func:`PyMethod_Function` which avoids error checking." +msgstr "" + +msgid "Return the instance associated with the method *meth*." +msgstr "" + +msgid "Macro version of :c:func:`PyMethod_Self` which avoids error checking." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "instancemethod" +msgstr "" + +msgid "method" +msgstr "metoda" + +msgid "MethodType (in module types)" +msgstr "" diff --git a/c-api/module.po b/c-api/module.po new file mode 100644 index 0000000000..1a67bb4357 --- /dev/null +++ b/c-api/module.po @@ -0,0 +1,588 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2023 +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "Module Objects" +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python module type. " +"This is exposed to Python programs as ``types.ModuleType``." +msgstr "" + +msgid "" +"Return true if *p* is a module object, or a subtype of a module object. This " +"function always succeeds." +msgstr "" + +msgid "" +"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 the :attr:`__name__` attribute set to " +"*name*. The module's :attr:`__name__`, :attr:`__doc__`, :attr:`__package__`, " +"and :attr:`__loader__` attributes are filled in (all but :attr:`__name__` " +"are set to ``None``); the caller is responsible for providing a :attr:" +"`__file__` attribute." +msgstr "" + +msgid ":attr:`__package__` and :attr:`__loader__` are set to ``None``." +msgstr "" + +msgid "" +"Similar to :c:func:`PyModule_NewObject`, but the name is a UTF-8 encoded " +"string instead of a Unicode object." +msgstr "" + +msgid "" +"Return the dictionary object that implements *module*'s namespace; this " +"object is the same as the :attr:`~object.__dict__` attribute of the module " +"object. If *module* is not a module object (or a subtype of a module " +"object), :exc:`SystemError` is raised and ``NULL`` is returned." +msgstr "" + +msgid "" +"It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` " +"functions rather than directly manipulate a module's :attr:`~object." +"__dict__`." +msgstr "" + +msgid "" +"Return *module*'s :attr:`__name__` value. If the module does not provide " +"one, or if it is not a string, :exc:`SystemError` is raised and ``NULL`` is " +"returned." +msgstr "" + +msgid "" +"Similar to :c:func:`PyModule_GetNameObject` but return the name encoded to " +"``'utf-8'``." +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`." +msgstr "" + +msgid "" +"Return a pointer to the :c:type:`PyModuleDef` struct from which the module " +"was created, or ``NULL`` if the module wasn't created from a definition." +msgstr "" + +msgid "" +"Return the name of the file from which *module* was loaded using *module*'s :" +"attr:`__file__` attribute. If this is not defined, or if it is not a " +"unicode string, raise :exc:`SystemError` and return ``NULL``; otherwise " +"return a reference to a Unicode object." +msgstr "" + +msgid "" +"Similar to :c:func:`PyModule_GetFilenameObject` but return the filename " +"encoded to 'utf-8'." +msgstr "" + +msgid "" +":c:func:`PyModule_GetFilename` raises :exc:`UnicodeEncodeError` on " +"unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead." +msgstr "" + +msgid "Initializing C modules" +msgstr "" + +msgid "" +"Modules objects are usually created from extension modules (shared libraries " +"which export an initialization function), or compiled-in modules (where the " +"initialization function is added using :c:func:`PyImport_AppendInittab`). " +"See :ref:`building` or :ref:`extending-with-embedding` for details." +msgstr "" + +msgid "" +"The initialization function can either pass a module definition instance to :" +"c:func:`PyModule_Create`, and return the resulting module object, or request " +"\"multi-phase initialization\" by returning the definition struct itself." +msgstr "" + +msgid "" +"The module definition struct, which holds all information needed to create a " +"module object. There is usually only one statically initialized variable of " +"this type for each module." +msgstr "" + +msgid "Always initialize this member to :c:macro:`PyModuleDef_HEAD_INIT`." +msgstr "" + +msgid "Name for the new module." +msgstr "" + +msgid "" +"Docstring for the module; usually a docstring variable created with :c:macro:" +"`PyDoc_STRVAR` is used." +msgstr "" + +msgid "" +"Module state may be kept in a per-module memory area that can be retrieved " +"with :c:func:`PyModule_GetState`, rather than in static globals. This makes " +"modules safe for use in multiple sub-interpreters." +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." +msgstr "" + +msgid "" +"Setting ``m_size`` to ``-1`` means that the module does not support sub-" +"interpreters, because it has global state." +msgstr "" + +msgid "" +"Setting it to a non-negative value means that the module can be re-" +"initialized and specifies the additional amount of memory it requires for " +"its state. Non-negative ``m_size`` is required for multi-phase " +"initialization." +msgstr "" + +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." +msgstr "" + +msgid "" +"An array of slot definitions for multi-phase initialization, terminated by a " +"``{0, NULL}`` entry. When using single-phase initialization, *m_slots* must " +"be ``NULL``." +msgstr "" + +msgid "" +"Prior to version 3.5, this member was always set to ``NULL``, and was " +"defined as:" +msgstr "" + +msgid "" +"A traversal function to call during GC traversal of the module object, or " +"``NULL`` if not needed." +msgstr "" + +msgid "" +"This function is not called if the module state was requested but is not " +"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``." +msgstr "" + +msgid "No longer called before the module state is allocated." +msgstr "" + +msgid "" +"A clear function to call during GC clearing of the module object, or " +"``NULL`` if not needed." +msgstr "" + +msgid "" +"Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called " +"before a module is deallocated. For example, when reference counting is " +"enough to determine that an object is no longer used, the cyclic garbage " +"collector is not involved and :c:member:`~PyModuleDef.m_free` is called " +"directly." +msgstr "" + +msgid "" +"A function to call during deallocation of the module object, or ``NULL`` if " +"not needed." +msgstr "" + +msgid "Single-phase initialization" +msgstr "" + +msgid "" +"The module initialization function may create and return the module object " +"directly. This is referred to as \"single-phase initialization\", and uses " +"one of the following two module creation functions:" +msgstr "" + +msgid "" +"Create a new module object, given the definition in *def*. This behaves " +"like :c:func:`PyModule_Create2` with *module_api_version* set to :c:macro:" +"`PYTHON_API_VERSION`." +msgstr "" + +msgid "" +"Create a new module object, given the definition in *def*, assuming the API " +"version *module_api_version*. If that version does not match the version of " +"the running interpreter, a :exc:`RuntimeWarning` is emitted." +msgstr "" + +msgid "" +"Most uses of this function should be using :c:func:`PyModule_Create` " +"instead; only use this if you are sure you need it." +msgstr "" + +msgid "" +"Before it is returned from in the initialization function, the resulting " +"module object is typically populated using functions like :c:func:" +"`PyModule_AddObjectRef`." +msgstr "" + +msgid "Multi-phase initialization" +msgstr "" + +msgid "" +"An alternate way to specify extensions is to request \"multi-phase " +"initialization\". Extension modules created this way behave more like Python " +"modules: the initialization is split between the *creation phase*, when the " +"module object is created, and the *execution phase*, when it is populated. " +"The distinction is similar to the :py:meth:`!__new__` and :py:meth:`!" +"__init__` methods of classes." +msgstr "" + +msgid "" +"Unlike modules created using single-phase initialization, these modules are " +"not singletons: if the *sys.modules* entry is removed and the module is re-" +"imported, a new module object is created, and the old module is subject to " +"normal garbage collection -- as with Python modules. By default, multiple " +"modules created from the same definition should be independent: changes to " +"one should not affect the others. This means that all state should be " +"specific to the module object (using e.g. using :c:func:" +"`PyModule_GetState`), or its contents (such as the module's :attr:`~object." +"__dict__` or individual classes created with :c:func:`PyType_FromSpec`)." +msgstr "" + +msgid "" +"All modules created using multi-phase initialization are expected to " +"support :ref:`sub-interpreters `. Making sure " +"multiple modules are independent is typically enough to achieve this." +msgstr "" + +msgid "" +"To request multi-phase initialization, the initialization function " +"(PyInit_modulename) returns a :c:type:`PyModuleDef` instance with non-empty :" +"c:member:`~PyModuleDef.m_slots`. Before it is returned, the ``PyModuleDef`` " +"instance must be initialized with the following function:" +msgstr "" + +msgid "" +"Ensures a module definition is a properly initialized Python object that " +"correctly reports its type and reference count." +msgstr "" + +msgid "Returns *def* cast to ``PyObject*``, or ``NULL`` if an error occurred." +msgstr "" + +msgid "" +"The *m_slots* member of the module definition must point to an array of " +"``PyModuleDef_Slot`` structures:" +msgstr "" + +msgid "A slot ID, chosen from the available values explained below." +msgstr "" + +msgid "Value of the slot, whose meaning depends on the slot ID." +msgstr "" + +msgid "The *m_slots* array must be terminated by a slot with id 0." +msgstr "" + +msgid "The available slot types are:" +msgstr "" + +msgid "" +"Specifies a function that is called to create the module object itself. The " +"*value* pointer of this slot must point to a function of the signature:" +msgstr "" + +msgid "" +"The function receives a :py:class:`~importlib.machinery.ModuleSpec` " +"instance, as defined in :PEP:`451`, and the module definition. It should " +"return a new module object, or set an error and return ``NULL``." +msgstr "" + +msgid "" +"This function should be kept minimal. In particular, it should not call " +"arbitrary Python code, as trying to import the same module again may result " +"in an infinite loop." +msgstr "" + +msgid "" +"Multiple ``Py_mod_create`` slots may not be specified in one module " +"definition." +msgstr "" + +msgid "" +"If ``Py_mod_create`` is not specified, the import machinery will create a " +"normal module object using :c:func:`PyModule_New`. The name is taken from " +"*spec*, not the definition, to allow extension modules to dynamically adjust " +"to their place in the module hierarchy and be imported under different names " +"through symlinks, all while sharing a single module definition." +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``." +msgstr "" + +msgid "" +"Specifies a function that is called to *execute* the module. This is " +"equivalent to executing the code of a Python module: typically, this " +"function adds classes and constants to the module. The signature of the " +"function is:" +msgstr "" + +msgid "" +"If multiple ``Py_mod_exec`` slots are specified, they are processed in the " +"order they appear in the *m_slots* array." +msgstr "" + +msgid "See :PEP:`489` for more details on multi-phase initialization." +msgstr "" + +msgid "Low-level module creation functions" +msgstr "" + +msgid "" +"The following functions are called under the hood when using multi-phase " +"initialization. They can be used directly, for example when creating module " +"objects dynamically. Note that both ``PyModule_FromDefAndSpec`` and " +"``PyModule_ExecDef`` must be called to fully initialize a module." +msgstr "" + +msgid "" +"Create a new module object, given the definition in *def* and the ModuleSpec " +"*spec*. This behaves like :c:func:`PyModule_FromDefAndSpec2` with " +"*module_api_version* set to :c:macro:`PYTHON_API_VERSION`." +msgstr "" + +msgid "" +"Create a new module object, given the definition in *def* and the ModuleSpec " +"*spec*, assuming the API version *module_api_version*. If that version does " +"not match the version of the running interpreter, a :exc:`RuntimeWarning` is " +"emitted." +msgstr "" + +msgid "" +"Most uses of this function should be using :c:func:`PyModule_FromDefAndSpec` " +"instead; only use this if you are sure you need it." +msgstr "" + +msgid "Process any execution slots (:c:data:`Py_mod_exec`) given in *def*." +msgstr "" + +msgid "" +"Set the docstring for *module* to *docstring*. This function is called " +"automatically when creating a module from ``PyModuleDef``, using either " +"``PyModule_Create`` or ``PyModule_FromDefAndSpec``." +msgstr "" + +msgid "" +"Add the functions from the ``NULL`` terminated *functions* array to " +"*module*. Refer to the :c:type:`PyMethodDef` documentation for details on " +"individual entries (due to the lack of a shared module namespace, module " +"level \"functions\" implemented in C typically receive the module as their " +"first parameter, making them similar to instance methods on Python classes). " +"This function is called automatically when creating a module from " +"``PyModuleDef``, using either ``PyModule_Create`` or " +"``PyModule_FromDefAndSpec``." +msgstr "" + +msgid "Support functions" +msgstr "" + +msgid "" +"The module initialization function (if using single phase initialization) or " +"a function called from a module execution slot (if using multi-phase " +"initialization), can use the following functions to help initialize the " +"module state:" +msgstr "" + +msgid "" +"Add an object to *module* as *name*. This is a convenience function which " +"can be used from the module's initialization function." +msgstr "" + +msgid "" +"On success, return ``0``. On error, raise an exception and return ``-1``." +msgstr "" + +msgid "" +"Return ``NULL`` if *value* is ``NULL``. It must be called with an exception " +"raised in this case." +msgstr "" + +msgid "Example usage::" +msgstr "" + +msgid "" +"The example can also be written without checking explicitly if *obj* is " +"``NULL``::" +msgstr "" + +msgid "" +"Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this " +"case, since *obj* can be ``NULL``." +msgstr "" + +msgid "" +"Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to " +"*value* on success (if it returns ``0``)." +msgstr "" + +msgid "" +"The new :c:func:`PyModule_AddObjectRef` function is recommended, since it is " +"easy to introduce reference leaks by misusing the :c:func:" +"`PyModule_AddObject` function." +msgstr "" + +msgid "" +"Unlike other functions that steal references, ``PyModule_AddObject()`` only " +"releases the reference to *value* **on success**." +msgstr "" + +msgid "" +"This means that its return value must be checked, and calling code must :c:" +"func:`Py_DECREF` *value* manually on error." +msgstr "" + +msgid "" +"Add an integer constant to *module* as *name*. This convenience function " +"can be used from the module's initialization function. Return ``-1`` on " +"error, ``0`` on success." +msgstr "" + +msgid "" +"Add a string constant to *module* as *name*. This convenience function can " +"be used from the module's initialization function. The string *value* must " +"be ``NULL``-terminated. Return ``-1`` on error, ``0`` on success." +msgstr "" + +msgid "" +"Add an int constant to *module*. The name and the value are taken from " +"*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int " +"constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` on " +"error, ``0`` on success." +msgstr "" + +msgid "Add a string constant to *module*." +msgstr "" + +msgid "" +"Add a type object to *module*. The type object is finalized by calling " +"internally :c:func:`PyType_Ready`. The name of the type object is taken from " +"the last component of :c:member:`~PyTypeObject.tp_name` after dot. Return " +"``-1`` on error, ``0`` on success." +msgstr "" + +msgid "Module lookup" +msgstr "" + +msgid "" +"Single-phase initialization creates singleton modules that can be looked up " +"in the context of the current interpreter. This allows the module object to " +"be retrieved later with only a reference to the module definition." +msgstr "" + +msgid "" +"These functions will not work on modules created using multi-phase " +"initialization, since multiple such modules can be created from a single " +"definition." +msgstr "" + +msgid "" +"Returns the module object that was created from *def* for the current " +"interpreter. This method requires that the module object has been attached " +"to the interpreter state with :c:func:`PyState_AddModule` beforehand. In " +"case the corresponding module object is not found or has not been attached " +"to the interpreter state yet, it returns ``NULL``." +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`." +msgstr "" + +msgid "Only effective on modules created using single-phase initialization." +msgstr "" + +msgid "" +"Python calls ``PyState_AddModule`` automatically after importing a module, " +"so it is unnecessary (but harmless) to call it from module initialization " +"code. An explicit call is needed only if the module's own init code " +"subsequently calls ``PyState_FindModule``. The function is mainly intended " +"for implementing alternative import mechanisms (either by calling it " +"directly, or by referring to its implementation for details of the required " +"state updates)." +msgstr "" + +msgid "The caller must hold the GIL." +msgstr "" + +msgid "Return 0 on success or -1 on failure." +msgstr "" + +msgid "" +"Removes the module object created from *def* from the interpreter state. " +"Return 0 on success or -1 on failure." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "module" +msgstr "moduł" + +msgid "ModuleType (in module types)" +msgstr "" + +msgid "__name__ (module attribute)" +msgstr "" + +msgid "__doc__ (module attribute)" +msgstr "" + +msgid "__file__ (module attribute)" +msgstr "" + +msgid "__package__ (module attribute)" +msgstr "" + +msgid "__loader__ (module attribute)" +msgstr "" + +msgid "__dict__ (module attribute)" +msgstr "" + +msgid "SystemError (built-in exception)" +msgstr "" diff --git a/c-api/none.po b/c-api/none.po new file mode 100644 index 0000000000..7e1d1f3c94 --- /dev/null +++ b/c-api/none.po @@ -0,0 +1,51 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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 "The ``None`` Object" +msgstr "" + +msgid "" +"Note that the :c:type:`PyTypeObject` for ``None`` is not directly exposed in " +"the Python/C API. Since ``None`` is a singleton, testing for object " +"identity (using ``==`` in C) is sufficient. There is no :c:func:`!" +"PyNone_Check` function for the same reason." +msgstr "" + +msgid "" +"The Python ``None`` object, denoting lack of value. This object has no " +"methods. It needs to be treated just like any other object with respect to " +"reference counts." +msgstr "" + +msgid "" +"Properly handle returning :c:data:`Py_None` from within a C function (that " +"is, increment the reference count of ``None`` and return it.)" +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "None" +msgstr "" diff --git a/c-api/number.po b/c-api/number.po index 87603e58b6..dc00913ed6 100644 --- a/c-api/number.po +++ b/c-api/number.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -265,7 +265,7 @@ msgid "" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "divmod" msgstr "" diff --git a/c-api/object.po b/c-api/object.po new file mode 100644 index 0000000000..09ba786f2f --- /dev/null +++ b/c-api/object.po @@ -0,0 +1,413 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Object Protocol" +msgstr "" + +msgid "" +"The ``NotImplemented`` singleton, used to signal that an operation is not " +"implemented for the given type combination." +msgstr "" + +msgid "" +"Properly handle returning :c:data:`Py_NotImplemented` from within a C " +"function (that is, create a new :term:`strong reference` to 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 " +"function would use the :func:`str` of the object instead of the :func:`repr`." +msgstr "" + +msgid "" +"Print an object *o*, on file *fp*. Returns ``-1`` on error. The flags " +"argument is used to enable certain printing options. The only option " +"currently supported is :c:macro:`Py_PRINT_RAW`; if given, the :func:`str` of " +"the object is written instead of the :func:`repr`." +msgstr "" + +msgid "" +"Returns ``1`` if *o* has the attribute *attr_name*, and ``0`` otherwise. " +"This is equivalent to the Python expression ``hasattr(o, attr_name)``. This " +"function always succeeds." +msgstr "" + +msgid "" +"Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:" +"`~object.__getattribute__` methods are silently ignored. For proper error " +"handling, use :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*`." +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_GetAttrString` instead." +msgstr "" + +msgid "" +"Retrieve an attribute named *attr_name* from object *o*. Returns the " +"attribute value on success, or ``NULL`` on failure. This is the equivalent " +"of the Python expression ``o.attr_name``." +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*`." +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." +msgstr "" + +msgid "" +"Set the value of the attribute named *attr_name*, for object *o*, to the " +"value *v*. Raise an exception and return ``-1`` on failure; return ``0`` on " +"success. This is the equivalent of the Python statement ``o.attr_name = v``." +msgstr "" + +msgid "" +"If *v* is ``NULL``, the attribute is deleted. This behaviour is deprecated " +"in favour of using :c:func:`PyObject_DelAttr`, but there are currently no " +"plans to remove it." +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*`." +msgstr "" + +msgid "" +"If *v* is ``NULL``, the attribute is deleted, but this feature is deprecated " +"in favour of using :c:func:`PyObject_DelAttrString`." +msgstr "" + +msgid "" +"Generic attribute setter and deleter function that is meant to be put into a " +"type object's :c:member:`~PyTypeObject.tp_setattro` slot. It looks for a " +"data descriptor in the dictionary of classes in the object's MRO, and if " +"found it takes preference over setting or deleting the attribute in the " +"instance dictionary. Otherwise, the attribute is set or deleted in the " +"object's :attr:`~object.__dict__` (if present). On success, ``0`` is " +"returned, otherwise an :exc:`AttributeError` is raised and ``-1`` is " +"returned." +msgstr "" + +msgid "" +"Delete attribute named *attr_name*, for object *o*. Returns ``-1`` on " +"failure. This is the equivalent of the Python statement ``del o.attr_name``." +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*`." +msgstr "" + +msgid "" +"A generic implementation for the getter of a ``__dict__`` descriptor. It " +"creates the dictionary if necessary." +msgstr "" + +msgid "" +"This function may also be called to get the :py:attr:`~object.__dict__` of " +"the object *o*. Pass ``NULL`` for *context* when calling it. Since this " +"function may need to allocate memory for the dictionary, it may be more " +"efficient to call :c:func:`PyObject_GetAttr` when accessing an attribute on " +"the object." +msgstr "" + +msgid "On failure, returns ``NULL`` with an exception set." +msgstr "" + +msgid "" +"A generic implementation for the setter of a ``__dict__`` descriptor. This " +"implementation does not allow the dictionary to be deleted." +msgstr "" + +msgid "" +"Return a pointer to :py:attr:`~object.__dict__` of the object *obj*. If " +"there is no ``__dict__``, return ``NULL`` without setting an exception." +msgstr "" + +msgid "" +"This function may need to allocate memory for the dictionary, so it may be " +"more efficient to call :c:func:`PyObject_GetAttr` when accessing an " +"attribute on the object." +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." +msgstr "" + +msgid "" +"Compare the values of *o1* and *o2* using the operation specified by *opid*, " +"like :c:func:`PyObject_RichCompare`, but returns ``-1`` on error, ``0`` if " +"the result is false, ``1`` otherwise." +msgstr "" + +msgid "" +"If *o1* and *o2* are the same object, :c:func:`PyObject_RichCompareBool` " +"will always return ``1`` for :c:macro:`Py_EQ` and ``0`` for :c:macro:`Py_NE`." +msgstr "" + +msgid "" +"Format *obj* using *format_spec*. This is equivalent to the Python " +"expression ``format(obj, format_spec)``." +msgstr "" + +msgid "" +"*format_spec* may be ``NULL``. In this case the call is equivalent to " +"``format(obj)``. Returns the formatted string on success, ``NULL`` on " +"failure." +msgstr "" + +msgid "" +"Compute a string representation of object *o*. Returns the string " +"representation on success, ``NULL`` on failure. This is the equivalent of " +"the Python expression ``repr(o)``. Called by the :func:`repr` built-in " +"function." +msgstr "" + +msgid "" +"This function now includes a debug assertion to help ensure that it does not " +"silently discard an active exception." +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." +msgstr "" + +msgid "" +"Compute a string representation of object *o*. Returns the string " +"representation on success, ``NULL`` on failure. This is the equivalent of " +"the Python expression ``str(o)``. Called by the :func:`str` built-in " +"function and, therefore, by the :func:`print` function." +msgstr "" + +msgid "" +"Compute a bytes representation of object *o*. ``NULL`` is returned on " +"failure and a bytes object on success. This is equivalent to the Python " +"expression ``bytes(o)``, when *o* is not an integer. Unlike ``bytes(o)``, a " +"TypeError is raised when *o* is an integer instead of a zero-initialized " +"bytes object." +msgstr "" + +msgid "" +"Return ``1`` if the class *derived* is identical to or derived from the " +"class *cls*, otherwise return ``0``. In case of an error, return ``-1``." +msgstr "" + +msgid "" +"If *cls* is a tuple, the check will be done against every entry in *cls*. " +"The result will be ``1`` when at least one of the checks returns ``1``, " +"otherwise it will be ``0``." +msgstr "" + +msgid "" +"If *cls* has a :meth:`~class.__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 ``cls.__mro__``." +msgstr "" + +msgid "" +"Normally only class objects, i.e. instances of :class:`type` or a derived " +"class, are considered classes. However, objects can override this by having " +"a :attr:`~class.__bases__` attribute (which must be a tuple of base classes)." +msgstr "" + +msgid "" +"Return ``1`` if *inst* is an instance of the class *cls* or a subclass of " +"*cls*, or ``0`` if not. On error, returns ``-1`` and sets an exception." +msgstr "" + +msgid "" +"If *cls* has a :meth:`~class.__instancecheck__` method, it will be called to " +"determine the subclass status as described in :pep:`3119`. Otherwise, " +"*inst* is an instance of *cls* if its class is a subclass of *cls*." +msgstr "" + +msgid "" +"An instance *inst* can override what is considered its class by having a :" +"attr:`~instance.__class__` attribute." +msgstr "" + +msgid "" +"An object *cls* can override if it is considered a class, and what its base " +"classes are, by having a :attr:`~class.__bases__` attribute (which must be a " +"tuple of base classes)." +msgstr "" + +msgid "" +"Compute and return the hash value of an object *o*. On failure, return " +"``-1``. This is the equivalent of the Python expression ``hash(o)``." +msgstr "" + +msgid "" +"The return type is now Py_hash_t. This is a signed integer the same size " +"as :c:type:`Py_ssize_t`." +msgstr "" + +msgid "" +"Set a :exc:`TypeError` indicating that ``type(o)`` is not :term:`hashable` " +"and return ``-1``. This function receives special treatment when stored in a " +"``tp_hash`` slot, allowing a type to explicitly indicate to the interpreter " +"that it is not hashable." +msgstr "" + +msgid "" +"Returns ``1`` if the object *o* is considered to be true, and ``0`` " +"otherwise. This is equivalent to the Python expression ``not not o``. On " +"failure, return ``-1``." +msgstr "" + +msgid "" +"Returns ``0`` if the object *o* is considered to be true, and ``1`` " +"otherwise. This is equivalent to the Python expression ``not o``. On " +"failure, return ``-1``." +msgstr "" + +msgid "" +"When *o* is non-``NULL``, returns a type object corresponding to the object " +"type of object *o*. On failure, raises :exc:`SystemError` and returns " +"``NULL``. This is equivalent to the Python expression ``type(o)``. This " +"function creates a new :term:`strong reference` to the return value. There's " +"really no reason to use this function instead of the :c:func:`Py_TYPE()` " +"function, which returns a pointer of type :c:expr:`PyTypeObject*`, except " +"when a new :term:`strong reference` is needed." +msgstr "" + +msgid "" +"Return non-zero if the object *o* is of type *type* or a subtype of *type*, " +"and ``0`` otherwise. Both parameters must be non-``NULL``." +msgstr "" + +msgid "" +"Return the length of object *o*. If the object *o* provides either the " +"sequence and mapping protocols, the sequence length is returned. On error, " +"``-1`` is returned. This is the equivalent to the Python expression " +"``len(o)``." +msgstr "" + +msgid "" +"Return an estimated length for the object *o*. First try to return its " +"actual length, then an estimate using :meth:`~object.__length_hint__`, and " +"finally return the default value. On error return ``-1``. This is the " +"equivalent to the Python expression ``operator.length_hint(o, " +"defaultvalue)``." +msgstr "" + +msgid "" +"Return element of *o* corresponding to the object *key* or ``NULL`` on " +"failure. This is the equivalent of the Python expression ``o[key]``." +msgstr "" + +msgid "" +"Map the object *key* to the value *v*. Raise an exception and return ``-1`` " +"on failure; return ``0`` on success. This is the equivalent of the Python " +"statement ``o[key] = v``. This function *does not* steal a reference to *v*." +msgstr "" + +msgid "" +"Remove the mapping for the object *key* from the object *o*. Return ``-1`` " +"on failure. This is equivalent to the Python statement ``del o[key]``." +msgstr "" + +msgid "" +"This is equivalent to the Python expression ``dir(o)``, returning a " +"(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." +msgstr "" + +msgid "" +"This is equivalent to the Python expression ``iter(o)``. It returns a new " +"iterator for the object argument, or the object itself if the object is " +"already an iterator. Raises :exc:`TypeError` and returns ``NULL`` if the " +"object cannot be iterated." +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." +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "repr" +msgstr "" + +msgid "ascii" +msgstr "" + +msgid "string" +msgstr "ciąg znaków" + +msgid "PyObject_Str (C function)" +msgstr "" + +msgid "bytes" +msgstr "" + +msgid "hash" +msgstr "" + +msgid "type" +msgstr "typ" + +msgid "len" +msgstr "len" diff --git a/c-api/refcounting.po b/c-api/refcounting.po index a6849005cf..a78adaa1c1 100644 --- a/c-api/refcounting.po +++ b/c-api/refcounting.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -31,7 +31,9 @@ msgid "" "objects." msgstr "" -msgid "Increment the reference count for object *o*." +msgid "" +"Indicate taking a new :term:`strong reference` to object *o*, indicating it " +"is in use and should not be destroyed." msgstr "" msgid "" @@ -40,27 +42,33 @@ msgid "" "used to create a new :term:`strong reference`." msgstr "" +msgid "When done using the object, release it by calling :c:func:`Py_DECREF`." +msgstr "" + msgid "" "The object must not be ``NULL``; if you aren't sure that it isn't ``NULL``, " "use :c:func:`Py_XINCREF`." msgstr "" +msgid "Do not expect this function to actually modify *o* in any way." +msgstr "" + msgid "" -"Increment the reference count for object *o*. The object may be ``NULL``, " -"in which case the macro has no effect." +"Similar to :c:func:`Py_INCREF`, but the object *o* can be ``NULL``, in which " +"case this has no effect." msgstr "" msgid "See also :c:func:`Py_XNewRef`." msgstr "" msgid "" -"Create a new :term:`strong reference` to an object: increment the reference " -"count of the object *o* and return the object *o*." +"Create a new :term:`strong reference` to an object: call :c:func:`Py_INCREF` " +"on *o* and return the object *o*." msgstr "" msgid "" "When the :term:`strong reference` is no longer needed, :c:func:`Py_DECREF` " -"should be called on it to decrement the object reference count." +"should be called on it to release the reference." msgstr "" msgid "" @@ -83,12 +91,15 @@ msgstr "" msgid "If the object *o* is ``NULL``, the function just returns ``NULL``." msgstr "" -msgid "Decrement the reference count for object *o*." +msgid "" +"Release a :term:`strong reference` to object *o*, indicating the reference " +"is no longer used." msgstr "" msgid "" -"If the reference count reaches zero, the object's type's deallocation " -"function (which must not be ``NULL``) is invoked." +"Once the last :term:`strong reference` is released (i.e. the object's " +"reference count reaches 0), the object's type's deallocation function (which " +"must not be ``NULL``) is invoked." msgstr "" msgid "" @@ -103,44 +114,45 @@ msgstr "" msgid "" "The deallocation function can cause arbitrary Python code to be invoked (e." -"g. when a class instance with a :meth:`__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 consistent state before :c:" -"func:`Py_DECREF` is invoked. For example, code to delete an object from a " -"list should copy a reference to the deleted object in a temporary variable, " -"update the list data structure, and then call :c:func:`Py_DECREF` for the " -"temporary variable." +"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 " +"consistent state before :c:func:`Py_DECREF` is invoked. For example, code " +"to delete an object from a list should copy a reference to the deleted " +"object in a temporary variable, update the list data structure, and then " +"call :c:func:`Py_DECREF` for the temporary variable." msgstr "" msgid "" -"Decrement the reference count for object *o*. The object may be ``NULL``, " -"in which case the macro has no effect; otherwise the effect is the same as " -"for :c:func:`Py_DECREF`, and the same warning applies." +"Similar to :c:func:`Py_DECREF`, but the object *o* can be ``NULL``, in which " +"case this has no effect. The same warning from :c:func:`Py_DECREF` applies " +"here as well." msgstr "" msgid "" -"Decrement the reference count for object *o*. The object may be ``NULL``, " -"in which case the macro has no effect; otherwise the effect is the same as " -"for :c:func:`Py_DECREF`, except that the argument is also set to ``NULL``. " -"The warning for :c:func:`Py_DECREF` does not apply with respect to the " -"object passed because the macro carefully uses a temporary variable and sets " -"the argument to ``NULL`` before decrementing its reference count." +"Release a :term:`strong reference` for object *o*. The object may be " +"``NULL``, in which case the macro has no effect; otherwise the effect is the " +"same as for :c:func:`Py_DECREF`, except that the argument is also set to " +"``NULL``. The warning for :c:func:`Py_DECREF` does not apply with respect " +"to the object passed because the macro carefully uses a temporary variable " +"and sets the argument to ``NULL`` before releasing the reference." msgstr "" msgid "" -"It is a good idea to use this macro whenever decrementing the reference " -"count of an object that might be traversed during garbage collection." +"It is a good idea to use this macro whenever releasing a reference to an " +"object that might be traversed during garbage collection." msgstr "" msgid "" -"Increment the reference count for object *o*. A function version of :c:func:" -"`Py_XINCREF`. It can be used for runtime dynamic embedding of Python." +"Indicate taking a new :term:`strong reference` to object *o*. A function " +"version of :c:func:`Py_XINCREF`. It can be used for runtime dynamic " +"embedding of Python." msgstr "" msgid "" -"Decrement the reference count for 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/sequence.po b/c-api/sequence.po new file mode 100644 index 0000000000..0787a37f3e --- /dev/null +++ b/c-api/sequence.po @@ -0,0 +1,188 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Sequence Protocol" +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." +msgstr "" + +msgid "" +"Returns the number of objects in sequence *o* on success, and ``-1`` on " +"failure. This is equivalent to the Python expression ``len(o)``." +msgstr "" + +msgid "" +"Return the concatenation of *o1* and *o2* on success, and ``NULL`` on " +"failure. This is the equivalent of the Python expression ``o1 + o2``." +msgstr "" + +msgid "" +"Return the result of repeating sequence object *o* *count* times, or " +"``NULL`` on failure. This is the equivalent of the Python expression ``o * " +"count``." +msgstr "" + +msgid "" +"Return the concatenation of *o1* and *o2* on success, and ``NULL`` on " +"failure. The operation is done *in-place* when *o1* supports it. This is " +"the equivalent of the Python expression ``o1 += o2``." +msgstr "" + +msgid "" +"Return the result of repeating sequence object *o* *count* times, or " +"``NULL`` on failure. The operation is done *in-place* when *o* supports " +"it. This is the equivalent of the Python expression ``o *= count``." +msgstr "" + +msgid "" +"Return the *i*\\ th element of *o*, or ``NULL`` on failure. This is the " +"equivalent of the Python expression ``o[i]``." +msgstr "" + +msgid "" +"Return the slice of sequence object *o* between *i1* and *i2*, or ``NULL`` " +"on failure. This is the equivalent of the Python expression ``o[i1:i2]``." +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*." +msgstr "" + +msgid "" +"If *v* is ``NULL``, the element is deleted, but this feature is deprecated " +"in favour of using :c:func:`PySequence_DelItem`." +msgstr "" + +msgid "" +"Delete the *i*\\ th element of object *o*. Returns ``-1`` on failure. This " +"is the equivalent of the Python statement ``del o[i]``." +msgstr "" + +msgid "" +"Assign the sequence object *v* to the slice in sequence object *o* from *i1* " +"to *i2*. This is the equivalent of the Python statement ``o[i1:i2] = v``." +msgstr "" + +msgid "" +"Delete the slice in sequence object *o* from *i1* to *i2*. Returns ``-1`` " +"on failure. This is the equivalent of the Python statement ``del o[i1:i2]``." +msgstr "" + +msgid "" +"Return the number of occurrences of *value* in *o*, that is, return the " +"number of keys for which ``o[key] == value``. On failure, return ``-1``. " +"This is equivalent to the Python expression ``o.count(value)``." +msgstr "" + +msgid "" +"Determine if *o* contains *value*. If an item in *o* is equal to *value*, " +"return ``1``, otherwise return ``0``. On error, return ``-1``. This is " +"equivalent to the Python expression ``value in o``." +msgstr "" + +msgid "" +"Return the first index *i* for which ``o[i] == value``. On error, return " +"``-1``. This is equivalent to the Python expression ``o.index(value)``." +msgstr "" + +msgid "" +"Return a list object with the same contents as the sequence or iterable *o*, " +"or ``NULL`` on failure. The returned list is guaranteed to be new. This is " +"equivalent to the Python expression ``list(o)``." +msgstr "" + +msgid "" +"Return a tuple object with the same contents as the sequence or iterable " +"*o*, or ``NULL`` on failure. If *o* is a tuple, a new reference will be " +"returned, otherwise a tuple will be constructed with the appropriate " +"contents. This is equivalent to the Python expression ``tuple(o)``." +msgstr "" + +msgid "" +"Return the sequence or iterable *o* as an object usable by the other " +"``PySequence_Fast*`` family of functions. If the object is not a sequence or " +"iterable, raises :exc:`TypeError` with *m* as the message text. Returns " +"``NULL`` on failure." +msgstr "" + +msgid "" +"The ``PySequence_Fast*`` functions are thus named because they assume *o* is " +"a :c:type:`PyTupleObject` or a :c:type:`PyListObject` and access the data " +"fields of *o* directly." +msgstr "" + +msgid "" +"As a CPython implementation detail, if *o* is already a sequence or list, it " +"will be returned." +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." +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." +msgstr "" + +msgid "" +"Return the underlying array of PyObject pointers. Assumes that *o* was " +"returned by :c:func:`PySequence_Fast` and *o* is not ``NULL``." +msgstr "" + +msgid "" +"Note, if a list gets resized, the reallocation may relocate the items array. " +"So, only use the underlying array pointer in contexts where the sequence " +"cannot change." +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." +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "len" +msgstr "len" + +msgid "tuple" +msgstr "tuple" diff --git a/c-api/set.po b/c-api/set.po new file mode 100644 index 0000000000..7d23106ab0 --- /dev/null +++ b/c-api/set.po @@ -0,0 +1,187 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Set Objects" +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`)." +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 " +"manipulating the values in the structure." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"The following type check macros work on pointers to any Python object. " +"Likewise, the constructor functions work with any iterable Python object." +msgstr "" + +msgid "" +"Return true if *p* is a :class:`set` object or an instance of a subtype. " +"This function always succeeds." +msgstr "" + +msgid "" +"Return true if *p* is a :class:`frozenset` object or an instance of a " +"subtype. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or " +"an instance of a subtype. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *p* is a :class:`set` object but not an instance of a " +"subtype. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *p* is a :class:`set` object or a :class:`frozenset` object " +"but not an instance of a subtype. This function always succeeds." +msgstr "" + +msgid "" +"Return true if *p* is a :class:`frozenset` object but not an instance of a " +"subtype. This function always succeeds." +msgstr "" + +msgid "" +"Return a new :class:`set` containing objects returned by the *iterable*. " +"The *iterable* may be ``NULL`` to create a new empty set. Return the new " +"set on success or ``NULL`` on failure. Raise :exc:`TypeError` if *iterable* " +"is not actually iterable. The constructor is also useful for copying a set " +"(``c=set(s)``)." +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." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "Macro form of :c:func:`PySet_Size` without error checking." +msgstr "" + +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." +msgstr "" + +msgid "" +"Add *key* to a :class:`set` instance. Also works with :class:`frozenset` " +"instances (like :c:func:`PyTuple_SetItem` it can be used to fill in the " +"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." +msgstr "" + +msgid "" +"The following functions are available for instances of :class:`set` or its " +"subtypes but not for instances of :class:`frozenset` or its subtypes." +msgstr "" + +msgid "" +"Return ``1`` if found and removed, ``0`` if not found (no action taken), and " +"``-1`` if an error is encountered. Does not raise :exc:`KeyError` for " +"missing keys. Raise a :exc:`TypeError` if the *key* is unhashable. Unlike " +"the Python :meth:`~frozenset.discard` method, this function does not " +"automatically convert unhashable sets into temporary frozensets. Raise :exc:" +"`SystemError` if *set* is not an instance of :class:`set` or its subtype." +msgstr "" + +msgid "" +"Return a new reference to an arbitrary object in the *set*, and removes the " +"object from the *set*. Return ``NULL`` on failure. Raise :exc:`KeyError` " +"if the set is empty. Raise a :exc:`SystemError` if *set* is not an instance " +"of :class:`set` or its subtype." +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." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "set" +msgstr "zestaw" + +msgid "frozenset" +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "len" +msgstr "len" diff --git a/c-api/stable.po b/c-api/stable.po new file mode 100644 index 0000000000..17e827785a --- /dev/null +++ b/c-api/stable.po @@ -0,0 +1,224 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "C API Stability" +msgstr "" + +msgid "" +"Python's C API is covered by the Backwards Compatibility Policy, :pep:`387`. " +"While the C API will change with every minor release (e.g. from 3.9 to " +"3.10), most changes will be source-compatible, typically by only adding new " +"API. Changing existing API or removing API is only done after a deprecation " +"period or to fix serious issues." +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." +msgstr "" + +msgid "" +"Names prefixed by an underscore, such as ``_Py_InternalState``, are private " +"API that can change without notice even in patch releases." +msgstr "" + +msgid "Stable Application Binary Interface" +msgstr "" + +msgid "" +"For simplicity, this document talks about *extensions*, but the Limited API " +"and Stable ABI work the same way for all uses of the API – for example, " +"embedding Python." +msgstr "" + +msgid "Limited C API" +msgstr "" + +msgid "" +"Python 3.2 introduced the *Limited API*, a subset of Python's C API. " +"Extensions that only use the Limited API can be compiled once and work with " +"multiple versions of Python. Contents of the Limited API are :ref:`listed " +"below `." +msgstr "" + +msgid "" +"Define this macro before including ``Python.h`` to opt in to only use the " +"Limited API, and to select the Limited API version." +msgstr "" + +msgid "" +"Define ``Py_LIMITED_API`` to the value of :c:macro:`PY_VERSION_HEX` " +"corresponding to the lowest Python version your extension supports. The " +"extension will work without recompilation with all Python 3 releases from " +"the specified one onward, and can use Limited API introduced up to that " +"version." +msgstr "" + +msgid "" +"Rather than using the ``PY_VERSION_HEX`` macro directly, hardcode a minimum " +"minor version (e.g. ``0x030A0000`` for Python 3.10) for stability when " +"compiling with future Python versions." +msgstr "" + +msgid "" +"You can also define ``Py_LIMITED_API`` to ``3``. This works the same as " +"``0x03020000`` (Python 3.2, the version that introduced Limited API)." +msgstr "" + +msgid "Stable ABI" +msgstr "stabilnego ABI" + +msgid "" +"To enable this, Python provides a *Stable ABI*: a set of symbols that will " +"remain compatible across Python 3.x versions." +msgstr "" + +msgid "" +"The Stable ABI contains symbols exposed in the :ref:`Limited API `, but also other ones – for example, functions necessary to support " +"older versions of the Limited API." +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``." +msgstr "" + +msgid "" +"On some platforms, Python will look for and load shared library files named " +"with the ``abi3`` tag (e.g. ``mymodule.abi3.so``). It does not check if such " +"extensions conform to a Stable ABI. The user (or their packaging tools) need " +"to ensure that, for example, extensions built with the 3.10+ Limited API are " +"not installed for lower versions of Python." +msgstr "" + +msgid "" +"All functions in the Stable ABI are present as functions in Python's shared " +"library, not solely as macros. This makes them usable from languages that " +"don't use the C preprocessor." +msgstr "" + +msgid "Limited API Scope and Performance" +msgstr "" + +msgid "" +"The goal for the Limited API is to allow everything that is possible with " +"the full C API, but possibly with a performance penalty." +msgstr "" + +msgid "" +"For example, while :c:func:`PyList_GetItem` is available, its “unsafe” macro " +"variant :c:func:`PyList_GET_ITEM` is not. The macro can be faster because it " +"can rely on version-specific implementation details of the list object." +msgstr "" + +msgid "" +"Without ``Py_LIMITED_API`` defined, some C API functions are inlined or " +"replaced by macros. Defining ``Py_LIMITED_API`` disables this inlining, " +"allowing stability as Python's data structures are improved, but possibly " +"reducing performance." +msgstr "" + +msgid "" +"By leaving out the ``Py_LIMITED_API`` definition, it is possible to compile " +"a Limited API extension with a version-specific ABI. This can improve " +"performance for that Python version, but will limit compatibility. Compiling " +"with ``Py_LIMITED_API`` will then yield an extension that can be distributed " +"where a version-specific one is not available – for example, for prereleases " +"of an upcoming Python version." +msgstr "" + +msgid "Limited API Caveats" +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." +msgstr "" + +msgid "" +"One issue that ``Py_LIMITED_API`` does not guard against is calling a " +"function with arguments that are invalid in a lower Python version. For " +"example, consider a function that starts accepting ``NULL`` for an argument. " +"In Python 3.9, ``NULL`` now selects a default behavior, but in Python 3.8, " +"the argument will be used directly, causing a ``NULL`` dereference and " +"crash. A similar argument works for fields of structs." +msgstr "" + +msgid "" +"Another issue is that some struct fields are currently not hidden when " +"``Py_LIMITED_API`` is defined, even though they're part of the Limited API." +msgstr "" + +msgid "" +"For these reasons, we recommend testing an extension with *all* minor Python " +"versions it supports, and preferably to build with the *lowest* such version." +msgstr "" + +msgid "" +"We also recommend reviewing documentation of all used API to check if it is " +"explicitly part of the Limited API. Even with ``Py_LIMITED_API`` defined, a " +"few private declarations are exposed for technical reasons (or even " +"unintentionally, as bugs)." +msgstr "" + +msgid "" +"Also note that the Limited API is not necessarily stable: compiling with " +"``Py_LIMITED_API`` with Python 3.8 means that the extension will run with " +"Python 3.12, but it will not necessarily *compile* with Python 3.12. In " +"particular, parts of the Limited API may be deprecated and removed, provided " +"that the Stable ABI stays stable." +msgstr "" + +msgid "Platform Considerations" +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" +msgstr "" + +msgid "" +"It is the responsibility of each particular distributor of Python to ensure " +"that all Python versions on a particular platform are built in a way that " +"does not break the Stable ABI. This is the case with Windows and macOS " +"releases from ``python.org`` and many third-party distributors." +msgstr "" + +msgid "Contents of Limited API" +msgstr "" + +msgid "" +"Currently, the :ref:`Limited API ` includes the following " +"items:" +msgstr "" diff --git a/c-api/structures.po b/c-api/structures.po index 239f587350..488d48e462 100644 --- a/c-api/structures.po +++ b/c-api/structures.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,11 +57,11 @@ msgid "" msgstr "" msgid "" -"This is an extension of :c:type:`PyObject` that adds the :attr:`ob_size` " -"field. This is only used for objects that have some notion of *length*. " -"This type does not often appear in the Python/C API. Access to the members " -"must be done by using the macros :c:macro:`Py_REFCNT`, :c:macro:`Py_TYPE`, " -"and :c:macro:`Py_SIZE`." +"This is an extension of :c:type:`PyObject` that adds the :c:member:" +"`~PyVarObject.ob_size` field. This is only used for objects that have some " +"notion of *length*. This type does not often appear in the Python/C API. " +"Access to the members must be done by using the macros :c:macro:" +"`Py_REFCNT`, :c:macro:`Py_TYPE`, and :c:macro:`Py_SIZE`." msgstr "" msgid "" @@ -158,8 +159,8 @@ msgstr "" msgid "" "This is a macro which expands to initialization values for a new :c:type:" -"`PyVarObject` type, including the :attr:`ob_size` field. This macro expands " -"to::" +"`PyVarObject` type, including the :c:member:`~PyVarObject.ob_size` field. " +"This macro expands to::" msgstr "" msgid "Implementing functions and methods" @@ -179,23 +180,25 @@ msgstr "" msgid "" "Type of the functions used to implement Python callables in C with " -"signature :const:`METH_VARARGS | METH_KEYWORDS`. The function signature is::" +"signature :ref:`METH_VARARGS | METH_KEYWORDS `. " +"The function signature is::" msgstr "" msgid "" "Type of the functions used to implement Python callables in C with " -"signature :const:`METH_FASTCALL`. The function signature is::" +"signature :c:macro:`METH_FASTCALL`. The function signature is::" msgstr "" msgid "" "Type of the functions used to implement Python callables in C with " -"signature :const:`METH_FASTCALL | METH_KEYWORDS`. The function signature is::" +"signature :ref:`METH_FASTCALL | METH_KEYWORDS `. The function signature is::" msgstr "" msgid "" "Type of the functions used to implement Python callables in C with " -"signature :const:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS`. The function " -"signature is::" +"signature :ref:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS `. The function signature is::" msgstr "" msgid "" @@ -203,31 +206,31 @@ msgid "" "has four fields:" msgstr "" -msgid "name of the method" +msgid "Name of the method." msgstr "" -msgid "pointer to the C implementation" +msgid "Pointer to the C implementation." msgstr "" -msgid "flags bits indicating how the call should be constructed" +msgid "Flags bits indicating how the call should be constructed." msgstr "" -msgid "points to the contents of the docstring" +msgid "Points to the contents of the docstring." msgstr "" msgid "" -"The :c:member:`ml_meth` is a C function pointer. The functions may be of " -"different types, but they always return :c:expr:`PyObject*`. If the " -"function is not of the :c:type:`PyCFunction`, the compiler will require a " -"cast in the method table. Even though :c:type:`PyCFunction` defines the " +"The :c:member:`~PyMethodDef.ml_meth` is a C function pointer. The functions " +"may be of different types, but they always return :c:expr:`PyObject*`. If " +"the function is not of the :c:type:`PyCFunction`, the compiler will require " +"a cast in the method table. Even though :c:type:`PyCFunction` defines the " "first parameter as :c:expr:`PyObject*`, it is common that the method " "implementation uses the specific C type of the *self* object." msgstr "" msgid "" -"The :c:member:`ml_flags` field is a bitfield which can include the following " -"flags. The individual flags indicate either a calling convention or a " -"binding convention." +"The :c:member:`~PyMethodDef.ml_flags` field is a bitfield which can include " +"the following flags. The individual flags indicate either a calling " +"convention or a binding convention." msgstr "" msgid "There are these calling conventions:" @@ -242,6 +245,17 @@ msgid "" "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 `." +msgstr "" + +msgid ":c:expr:`METH_VARARGS | METH_KEYWORDS`" +msgstr "" + msgid "" "Methods with these flags must be of type :c:type:`PyCFunctionWithKeywords`. " "The function expects three parameters: *self*, *args*, *kwargs* where " @@ -258,24 +272,36 @@ msgid "" "the array)." msgstr "" -msgid "``METH_FASTCALL`` is now part of the stable ABI." +msgid "``METH_FASTCALL`` is now part of the :ref:`stable ABI `." +msgstr "" + +msgid ":c:expr:`METH_FASTCALL | METH_KEYWORDS`" msgstr "" msgid "" -"Extension of :const:`METH_FASTCALL` supporting also keyword arguments, with " -"methods of type :c:type:`_PyCFunctionFastWithKeywords`. Keyword arguments " -"are passed the same way as in the :ref:`vectorcall protocol `: " -"there is an additional fourth :c:expr:`PyObject*` parameter which is a tuple " -"representing the names of the keyword arguments (which are guaranteed to be " -"strings) or possibly ``NULL`` if there are no keywords. The values of the " -"keyword arguments are stored in the *args* array, after the positional " -"arguments." +"Extension of :c:macro:`METH_FASTCALL` supporting also keyword arguments, " +"with methods of type :c:type:`_PyCFunctionFastWithKeywords`. Keyword " +"arguments are passed the same way as in the :ref:`vectorcall protocol " +"`: there is an additional fourth :c:expr:`PyObject*` parameter " +"which is a tuple representing the names of the keyword arguments (which are " +"guaranteed to be strings) or possibly ``NULL`` if there are no keywords. " +"The values of the keyword arguments are stored in the *args* array, after " +"the positional arguments." msgstr "" msgid "" -"Extension of :const:`METH_FASTCALL | METH_KEYWORDS` supporting the *defining " -"class*, that is, the class that contains the method in question. The " -"defining class might be a superclass of ``Py_TYPE(self)``." +"Can only be used in the combination with other flags: :ref:`METH_METHOD | " +"METH_FASTCALL | METH_KEYWORDS `." +msgstr "" + +msgid ":c:expr:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS`" +msgstr "" + +msgid "" +"Extension of :ref:`METH_FASTCALL | METH_KEYWORDS ` supporting the *defining class*, that is, the class that " +"contains the method in question. The defining class might be a superclass of " +"``Py_TYPE(self)``." msgstr "" msgid "" @@ -286,7 +312,7 @@ msgstr "" msgid "" "Methods without parameters don't need to check whether arguments are given " -"if they are listed with the :const:`METH_NOARGS` flag. They need to be of " +"if they are listed with the :c:macro:`METH_NOARGS` flag. They need to be of " "type :c:type:`PyCFunction`. The first parameter is typically named *self* " "and will hold a reference to the module or object instance. In all cases " "the second parameter will be ``NULL``." @@ -298,11 +324,11 @@ msgid "" msgstr "" msgid "" -"Methods with a single object argument can be listed with the :const:`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." +"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 "" msgid "" @@ -343,21 +369,44 @@ msgid "" "*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:" -"`__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 "" -"Metoda zostanie załadowana w miejsce istniejących definicji. Bez " -"*METH_COEXIST*, domyślnie pomija się powtórzone definicje. Od kiedy " -"opakowania gniazd są ładowane przed tabelą metod, istnienie na przykład " -"gniazda *sq_contains* generuje opakowaną metodę nazywaną :meth:" -"`__contains__` i zapobiega ładowaniu odpowiadającej funkcji PyCFunction o " -"tej samej nazwie. Ze zdefiniowaną flagą, PyCFunction zostanie załadowana w " -"miejsce obiektu opakowania i będzie współistniała z gniazdem. To jest " -"pomocne ponieważ wywołania PyCFunction są zoptymalizowane bardziej niż " -"odwołania do obiektów opakowań." +"`~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 "" +"Turn *ml* into a Python :term:`callable` object. The caller must ensure that " +"*ml* outlives the :term:`callable`. Typically, *ml* is defined as a static " +"variable." +msgstr "" + +msgid "" +"The *self* parameter will be passed as the *self* argument to the C function " +"in ``ml->ml_meth`` when invoked. *self* can be ``NULL``." +msgstr "" + +msgid "" +"The :term:`callable` object's ``__module__`` attribute can be set from the " +"given *module* argument. *module* should be a Python string, which will be " +"used as name of the module the function is defined in. If unavailable, it " +"can be set to :const:`None` or ``NULL``." +msgstr "" + +msgid ":attr:`function.__module__`" +msgstr ":attr:`function.__module__`" + +msgid "" +"The *cls* parameter will be passed as the *defining_class* argument to the C " +"function. Must be set if :c:macro:`METH_METHOD` is set on ``ml->ml_flags``." +msgstr "" + +msgid "Equivalent to ``PyCMethod_New(ml, self, module, NULL)``." +msgstr "" + +msgid "Equivalent to ``PyCMethod_New(ml, self, NULL, NULL)``." +msgstr "" msgid "Accessing attributes of extension types" msgstr "" @@ -368,7 +417,7 @@ msgid "" msgstr "" msgid "Field" -msgstr "" +msgstr "Pole" msgid "C Type" msgstr "typ języka C" @@ -413,6 +462,9 @@ msgstr "" msgid ":attr:`doc`" msgstr "" +msgid "points to the contents of the docstring" +msgstr "" + msgid "" ":attr:`!type` can be one of many ``T_`` macros corresponding to various C " "types. When the member is accessed in Python, it will be converted to the " @@ -559,7 +611,7 @@ msgid "" msgstr "" msgid "name" -msgstr "" +msgstr "nazwa" msgid "attribute name" msgstr "" @@ -574,7 +626,7 @@ msgid "C function to get the attribute" msgstr "" msgid "set" -msgstr "" +msgstr "zestaw" msgid "setter" msgstr "" @@ -597,12 +649,12 @@ msgid "void \\*" msgstr "" msgid "" -"optional function pointer, providing additional data for getter and setter" +"optional user data pointer, providing additional data for getter and setter" msgstr "" msgid "" "The ``get`` function takes one :c:expr:`PyObject*` parameter (the instance) " -"and a function pointer (the associated ``closure``)::" +"and a user data pointer (the associated ``closure``)::" msgstr "" msgid "" @@ -612,7 +664,7 @@ msgstr "" msgid "" "``set`` functions take two :c:expr:`PyObject*` parameters (the instance and " -"the value to be set) and a function pointer (the associated ``closure``)::" +"the value to be set) and a user data pointer (the associated ``closure``)::" msgstr "" msgid "" @@ -621,7 +673,7 @@ msgid "" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "classmethod" msgstr "" diff --git a/c-api/tuple.po b/c-api/tuple.po index eb11764299..4e004235a0 100644 --- a/c-api/tuple.po +++ b/c-api/tuple.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -140,61 +141,32 @@ msgstr "" msgid "Contains the meta information of a struct sequence type to create." msgstr "" -msgid "Field" +msgid "Name of the struct sequence type." msgstr "" -msgid "C Type" -msgstr "typ języka C" - -msgid "Meaning" -msgstr "Znaczenie" - -msgid "``name``" -msgstr "``nazwa``" - -msgid "``const char *``" -msgstr "" - -msgid "name of the struct sequence type" +msgid "Pointer to docstring for the type or ``NULL`` to omit." msgstr "" -msgid "``doc``" +msgid "Pointer to ``NULL``-terminated array with field names of the new type." msgstr "" -msgid "pointer to docstring for the type or ``NULL`` to omit" -msgstr "" - -msgid "``fields``" -msgstr "" - -msgid "``PyStructSequence_Field *``" -msgstr "" - -msgid "pointer to ``NULL``-terminated array with field names of the new type" -msgstr "" - -msgid "``n_in_sequence``" -msgstr "" - -msgid "``int``" -msgstr "" - -msgid "number of fields visible to the Python side (if used as tuple)" +msgid "Number of fields visible to the Python side (if used as tuple)." 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 :attr:" -"`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" +msgid "Field docstring or ``NULL`` to omit." msgstr "" msgid "Special value for a field name to leave it unnamed." @@ -231,7 +203,7 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "tuple" -msgstr "" +msgstr "tuple" diff --git a/c-api/type.po b/c-api/type.po new file mode 100644 index 0000000000..1387c7970b --- /dev/null +++ b/c-api/type.po @@ -0,0 +1,348 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Type Objects" +msgstr "" + +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." +msgstr "" + +msgid "" +"Return non-zero if the object *o* is a type object, including instances of " +"types derived from the standard type object. Return 0 in all other cases. " +"This function always succeeds." +msgstr "" + +msgid "" +"Return non-zero if the object *o* is a type object, but not a subtype of the " +"standard type object. Return 0 in all other cases. This function always " +"succeeds." +msgstr "" + +msgid "Clear the internal lookup cache. Return the current version tag." +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 `." +msgstr "" + +msgid "The return type is now ``unsigned long`` rather than ``long``." +msgstr "" + +msgid "" +"Invalidate the internal lookup cache for the type and all of its subtypes. " +"This function must be called after any manual modification of the attributes " +"or base classes of the type." +msgstr "" + +msgid "" +"Return non-zero if the type object *o* sets the feature *feature*. Type " +"features are denoted by single bit flags." +msgstr "" + +msgid "" +"Return true if the type object includes support for the cycle detector; this " +"tests the type flag :c:macro:`Py_TPFLAGS_HAVE_GC`." +msgstr "" + +msgid "Return true if *a* is a subtype of *b*." +msgstr "" + +msgid "" +"This function only checks for actual subtypes, which means that :meth:" +"`~class.__subclasscheck__` is not called on *b*. Call :c:func:" +"`PyObject_IsSubclass` to do the same check that :func:`issubclass` would do." +msgstr "" + +msgid "" +"Generic handler for the :c:member:`~PyTypeObject.tp_alloc` slot of a type " +"object. Use Python's default memory allocation mechanism to allocate a new " +"instance and initialize all its contents to ``NULL``." +msgstr "" + +msgid "" +"Generic handler for the :c:member:`~PyTypeObject.tp_new` slot of a type " +"object. Create a new instance using the type's :c:member:`~PyTypeObject." +"tp_alloc` slot." +msgstr "" + +msgid "" +"Finalize a type object. This should be called on all type objects to finish " +"their initialization. This function is responsible for adding inherited " +"slots from a type's base class. Return ``0`` on success, or return ``-1`` " +"and sets an exception on error." +msgstr "" + +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." +msgstr "" + +msgid "" +"Return the type's name. Equivalent to getting the type's ``__name__`` " +"attribute." +msgstr "" + +msgid "" +"Return the type's qualified name. Equivalent to getting the type's " +"``__qualname__`` attribute." +msgstr "" + +msgid "" +"Return the function pointer stored in the given slot. If the result is " +"``NULL``, this indicates that either the slot is ``NULL``, or that the " +"function was called with invalid parameters. Callers will typically cast the " +"result pointer into the appropriate function type." +msgstr "" + +msgid "" +"See :c:member:`PyType_Slot.slot` for possible values of the *slot* argument." +msgstr "" + +msgid "" +":c:func:`PyType_GetSlot` can now accept all types. Previously, it was " +"limited to :ref:`heap types `." +msgstr "" + +msgid "" +"Return the module object associated with the given type when the type was " +"created using :c:func:`PyType_FromModuleAndSpec`." +msgstr "" + +msgid "" +"If no module is associated with the given type, sets :py:class:`TypeError` " +"and returns ``NULL``." +msgstr "" + +msgid "" +"This function is usually used to get the module in which a method is " +"defined. Note that in such a method, ``PyType_GetModule(Py_TYPE(self))`` may " +"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." +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`." +msgstr "" + +msgid "" +"If the *type* has an associated module but its state is ``NULL``, returns " +"``NULL`` without setting an exception." +msgstr "" + +msgid "" +"Find the first superclass whose module was created from the given :c:type:" +"`PyModuleDef` *def*, and return that module." +msgstr "" + +msgid "" +"If no module is found, raises a :py:class:`TypeError` and returns ``NULL``." +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." +msgstr "" + +msgid "Creating Heap-Allocated Types" +msgstr "" + +msgid "" +"The following functions and structs are used to create :ref:`heap types " +"`." +msgstr "" + +msgid "" +"Creates and returns a :ref:`heap type ` from the *spec* (:c:" +"macro:`Py_TPFLAGS_HEAPTYPE`)." +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 " +"*Py_tp_bases* slot is used instead. If that also is ``NULL``, the " +"*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 " +"subclasses; it must be specified for each class individually." +msgstr "" + +msgid "This function calls :c:func:`PyType_Ready` on the new type." +msgstr "" + +msgid "" +"The function now accepts a single class as the *bases* argument and ``NULL`` " +"as the ``tp_doc`` slot." +msgstr "" + +msgid "Equivalent to ``PyType_FromModuleAndSpec(NULL, spec, bases)``." +msgstr "" + +msgid "Equivalent to ``PyType_FromSpecWithBases(spec, NULL)``." +msgstr "" + +msgid "Structure defining a type's behavior." +msgstr "" + +msgid "Name of the type, used to set :c:member:`PyTypeObject.tp_name`." +msgstr "" + +msgid "" +"Size of the instance in bytes, used to set :c:member:`PyTypeObject." +"tp_basicsize` and :c:member:`PyTypeObject.tp_itemsize`." +msgstr "" + +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." +msgstr "" + +msgid "" +"Array of :c:type:`PyType_Slot` structures. Terminated by the special slot " +"value ``{0, NULL}``." +msgstr "" + +msgid "" +"Structure defining optional functionality of a type, containing a slot ID " +"and a value pointer." +msgstr "" + +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:" +msgstr "" + +msgid "``Py_tp_dealloc`` to set :c:member:`PyTypeObject.tp_dealloc`" +msgstr "" + +msgid "``Py_nb_add`` to set :c:member:`PyNumberMethods.nb_add`" +msgstr "" + +msgid "``Py_sq_length`` to set :c:member:`PySequenceMethods.sq_length`" +msgstr "" + +msgid "" +"The following fields cannot be set at all using :c:type:`PyType_Spec` and :c:" +"type:`PyType_Slot`:" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_dict`" +msgstr ":c:member:`~PyTypeObject.tp_dict`" + +msgid ":c:member:`~PyTypeObject.tp_mro`" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_cache`" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_subclasses`" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_weaklist`" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_vectorcall`" +msgstr ":c:member:`~PyTypeObject.tp_vectorcall`" + +msgid "" +":c:member:`~PyTypeObject.tp_weaklistoffset` (see :ref:`PyMemberDef " +"`)" +msgstr "" + +msgid "" +":c:member:`~PyTypeObject.tp_dictoffset` (see :ref:`PyMemberDef `)" +msgstr "" + +msgid "" +":c:member:`~PyTypeObject.tp_vectorcall_offset` (see :ref:`PyMemberDef " +"`)" +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." +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 `." +msgstr "" + +msgid "" +"The desired value of the slot. In most cases, this is a pointer to a " +"function." +msgstr "" + +msgid "Slots other than ``Py_tp_doc`` may not be ``NULL``." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "type" +msgstr "typ" diff --git a/c-api/typeobj.po b/c-api/typeobj.po new file mode 100644 index 0000000000..a2f4e68d3f --- /dev/null +++ b/c-api/typeobj.po @@ -0,0 +1,2746 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Type Objects" +msgstr "" + +msgid "" +"Perhaps one of the most important structures of the Python object system is " +"the structure that defines a new type: the :c:type:`PyTypeObject` " +"structure. Type objects can be handled using any of the ``PyObject_*`` or " +"``PyType_*`` functions, but do not offer much that's interesting to most " +"Python applications. These objects are fundamental to how objects behave, so " +"they are very important to the interpreter itself and to any extension " +"module that implements new types." +msgstr "" + +msgid "" +"Type objects are fairly large compared to most of the standard types. The " +"reason for the size is that each type object stores a large number of " +"values, mostly C function pointers, each of which implements a small part of " +"the type's functionality. The fields of the type object are examined in " +"detail in this section. The fields will be described in the order in which " +"they occur in the structure." +msgstr "" + +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`." +msgstr "" + +msgid "Quick Reference" +msgstr "" + +msgid "\"tp slots\"" +msgstr "" + +msgid "PyTypeObject Slot [#slots]_" +msgstr "" + +msgid ":ref:`Type `" +msgstr ":ref:`Type `" + +msgid "special methods/attrs" +msgstr "" + +msgid "Info [#cols]_" +msgstr "" + +msgid "O" +msgstr "O" + +msgid "T" +msgstr "T" + +msgid "D" +msgstr "D" + +msgid "I" +msgstr "I" + +msgid " :c:member:`~PyTypeObject.tp_name`" +msgstr " :c:member:`~PyTypeObject.tp_name`" + +msgid "const char *" +msgstr "" + +msgid "__name__" +msgstr "__name__" + +msgid "X" +msgstr "X" + +msgid ":c:member:`~PyTypeObject.tp_basicsize`" +msgstr ":c:member:`~PyTypeObject.tp_basicsize`" + +msgid ":c:type:`Py_ssize_t`" +msgstr ":c:type:`Py_ssize_t`" + +msgid ":c:member:`~PyTypeObject.tp_itemsize`" +msgstr ":c:member:`~PyTypeObject.tp_itemsize`" + +msgid ":c:member:`~PyTypeObject.tp_dealloc`" +msgstr ":c:member:`~PyTypeObject.tp_dealloc`" + +msgid ":c:type:`destructor`" +msgstr ":c:type:`destructor`" + +msgid ":c:member:`~PyTypeObject.tp_vectorcall_offset`" +msgstr ":c:member:`~PyTypeObject.tp_vectorcall_offset`" + +msgid "(:c:member:`~PyTypeObject.tp_getattr`)" +msgstr "(:c:member:`~PyTypeObject.tp_getattr`)" + +msgid ":c:type:`getattrfunc`" +msgstr ":c:type:`getattrfunc`" + +msgid "__getattribute__, __getattr__" +msgstr "__getattribute__, __getattr__" + +msgid "G" +msgstr "G" + +msgid "(:c:member:`~PyTypeObject.tp_setattr`)" +msgstr "(:c:member:`~PyTypeObject.tp_setattr`)" + +msgid ":c:type:`setattrfunc`" +msgstr ":c:type:`setattrfunc`" + +msgid "__setattr__, __delattr__" +msgstr "__setattr__, __delattr__" + +msgid ":c:member:`~PyTypeObject.tp_as_async`" +msgstr ":c:member:`~PyTypeObject.tp_as_async`" + +msgid ":c:type:`PyAsyncMethods` *" +msgstr ":c:type:`PyAsyncMethods` *" + +msgid ":ref:`sub-slots`" +msgstr ":ref:`sub-slots`" + +msgid "%" +msgstr "%" + +msgid ":c:member:`~PyTypeObject.tp_repr`" +msgstr ":c:member:`~PyTypeObject.tp_repr`" + +msgid ":c:type:`reprfunc`" +msgstr ":c:type:`reprfunc`" + +msgid "__repr__" +msgstr "__repr__" + +msgid ":c:member:`~PyTypeObject.tp_as_number`" +msgstr ":c:member:`~PyTypeObject.tp_as_number`" + +msgid ":c:type:`PyNumberMethods` *" +msgstr ":c:type:`PyNumberMethods` *" + +msgid ":c:member:`~PyTypeObject.tp_as_sequence`" +msgstr ":c:member:`~PyTypeObject.tp_as_sequence`" + +msgid ":c:type:`PySequenceMethods` *" +msgstr ":c:type:`PySequenceMethods` *" + +msgid ":c:member:`~PyTypeObject.tp_as_mapping`" +msgstr ":c:member:`~PyTypeObject.tp_as_mapping`" + +msgid ":c:type:`PyMappingMethods` *" +msgstr ":c:type:`PyMappingMethods` *" + +msgid ":c:member:`~PyTypeObject.tp_hash`" +msgstr ":c:member:`~PyTypeObject.tp_hash`" + +msgid ":c:type:`hashfunc`" +msgstr ":c:type:`hashfunc`" + +msgid "__hash__" +msgstr "__hash__" + +msgid ":c:member:`~PyTypeObject.tp_call`" +msgstr ":c:member:`~PyTypeObject.tp_call`" + +msgid ":c:type:`ternaryfunc`" +msgstr ":c:type:`ternaryfunc`" + +msgid "__call__" +msgstr "__call__" + +msgid ":c:member:`~PyTypeObject.tp_str`" +msgstr ":c:member:`~PyTypeObject.tp_str`" + +msgid "__str__" +msgstr "__str__" + +msgid ":c:member:`~PyTypeObject.tp_getattro`" +msgstr ":c:member:`~PyTypeObject.tp_getattro`" + +msgid ":c:type:`getattrofunc`" +msgstr ":c:type:`getattrofunc`" + +msgid ":c:member:`~PyTypeObject.tp_setattro`" +msgstr ":c:member:`~PyTypeObject.tp_setattro`" + +msgid ":c:type:`setattrofunc`" +msgstr ":c:type:`setattrofunc`" + +msgid ":c:member:`~PyTypeObject.tp_as_buffer`" +msgstr ":c:member:`~PyTypeObject.tp_as_buffer`" + +msgid ":c:type:`PyBufferProcs` *" +msgstr ":c:type:`PyBufferProcs` *" + +msgid ":c:member:`~PyTypeObject.tp_flags`" +msgstr ":c:member:`~PyTypeObject.tp_flags`" + +msgid "unsigned long" +msgstr "nieoznaczony typ długi" + +msgid "?" +msgstr "?" + +msgid ":c:member:`~PyTypeObject.tp_doc`" +msgstr ":c:member:`~PyTypeObject.tp_doc`" + +msgid "__doc__" +msgstr "__doc__" + +msgid ":c:member:`~PyTypeObject.tp_traverse`" +msgstr ":c:member:`~PyTypeObject.tp_traverse`" + +msgid ":c:type:`traverseproc`" +msgstr ":c:type:`traverseproc`" + +msgid ":c:member:`~PyTypeObject.tp_clear`" +msgstr ":c:member:`~PyTypeObject.tp_clear`" + +msgid ":c:type:`inquiry`" +msgstr ":c:type:`inquiry`" + +msgid ":c:member:`~PyTypeObject.tp_richcompare`" +msgstr ":c:member:`~PyTypeObject.tp_richcompare`" + +msgid ":c:type:`richcmpfunc`" +msgstr ":c:type:`richcmpfunc`" + +msgid "__lt__, __le__, __eq__, __ne__, __gt__, __ge__" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_weaklistoffset`" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_iter`" +msgstr ":c:member:`~PyTypeObject.tp_iter`" + +msgid ":c:type:`getiterfunc`" +msgstr ":c:type:`getiterfunc`" + +msgid "__iter__" +msgstr "__iter__" + +msgid ":c:member:`~PyTypeObject.tp_iternext`" +msgstr ":c:member:`~PyTypeObject.tp_iternext`" + +msgid ":c:type:`iternextfunc`" +msgstr ":c:type:`iternextfunc`" + +msgid "__next__" +msgstr "__next__" + +msgid ":c:member:`~PyTypeObject.tp_methods`" +msgstr ":c:member:`~PyTypeObject.tp_methods`" + +msgid ":c:type:`PyMethodDef` []" +msgstr ":c:type:`PyMethodDef` []" + +msgid ":c:member:`~PyTypeObject.tp_members`" +msgstr ":c:member:`~PyTypeObject.tp_members`" + +msgid ":c:type:`PyMemberDef` []" +msgstr ":c:type:`PyMemberDef` []" + +msgid ":c:member:`~PyTypeObject.tp_getset`" +msgstr ":c:member:`~PyTypeObject.tp_getset`" + +msgid ":c:type:`PyGetSetDef` []" +msgstr ":c:type:`PyGetSetDef` []" + +msgid ":c:member:`~PyTypeObject.tp_base`" +msgstr ":c:member:`~PyTypeObject.tp_base`" + +msgid ":c:type:`PyTypeObject` *" +msgstr ":c:type:`PyTypeObject` *" + +msgid "__base__" +msgstr "__base__" + +msgid ":c:member:`~PyTypeObject.tp_dict`" +msgstr ":c:member:`~PyTypeObject.tp_dict`" + +msgid ":c:type:`PyObject` *" +msgstr ":c:type:`PyObject` *" + +msgid "__dict__" +msgstr "__dict__" + +msgid ":c:member:`~PyTypeObject.tp_descr_get`" +msgstr ":c:member:`~PyTypeObject.tp_descr_get`" + +msgid ":c:type:`descrgetfunc`" +msgstr ":c:type:`descrgetfunc`" + +msgid "__get__" +msgstr "__get__" + +msgid ":c:member:`~PyTypeObject.tp_descr_set`" +msgstr ":c:member:`~PyTypeObject.tp_descr_set`" + +msgid ":c:type:`descrsetfunc`" +msgstr ":c:type:`descrsetfunc`" + +msgid "__set__, __delete__" +msgstr "__set__, __delete__" + +msgid ":c:member:`~PyTypeObject.tp_dictoffset`" +msgstr "" + +msgid ":c:member:`~PyTypeObject.tp_init`" +msgstr ":c:member:`~PyTypeObject.tp_init`" + +msgid ":c:type:`initproc`" +msgstr ":c:type:`initproc`" + +msgid "__init__" +msgstr "__init__" + +msgid ":c:member:`~PyTypeObject.tp_alloc`" +msgstr ":c:member:`~PyTypeObject.tp_alloc`" + +msgid ":c:type:`allocfunc`" +msgstr ":c:type:`allocfunc`" + +msgid ":c:member:`~PyTypeObject.tp_new`" +msgstr ":c:member:`~PyTypeObject.tp_new`" + +msgid ":c:type:`newfunc`" +msgstr ":c:type:`newfunc`" + +msgid "__new__" +msgstr "__new__" + +msgid ":c:member:`~PyTypeObject.tp_free`" +msgstr ":c:member:`~PyTypeObject.tp_free`" + +msgid ":c:type:`freefunc`" +msgstr ":c:type:`freefunc`" + +msgid ":c:member:`~PyTypeObject.tp_is_gc`" +msgstr ":c:member:`~PyTypeObject.tp_is_gc`" + +msgid "<:c:member:`~PyTypeObject.tp_bases`>" +msgstr "<:c:member:`~PyTypeObject.tp_bases`>" + +msgid "__bases__" +msgstr "__bases__" + +msgid "~" +msgstr "~" + +msgid "<:c:member:`~PyTypeObject.tp_mro`>" +msgstr "<:c:member:`~PyTypeObject.tp_mro`>" + +msgid "__mro__" +msgstr "__mro__" + +msgid "[:c:member:`~PyTypeObject.tp_cache`]" +msgstr "[:c:member:`~PyTypeObject.tp_cache`]" + +msgid "[:c:member:`~PyTypeObject.tp_subclasses`]" +msgstr "[:c:member:`~PyTypeObject.tp_subclasses`]" + +msgid "__subclasses__" +msgstr "__subclasses__" + +msgid "[:c:member:`~PyTypeObject.tp_weaklist`]" +msgstr "[:c:member:`~PyTypeObject.tp_weaklist`]" + +msgid "(:c:member:`~PyTypeObject.tp_del`)" +msgstr "(:c:member:`~PyTypeObject.tp_del`)" + +msgid "[:c:member:`~PyTypeObject.tp_version_tag`]" +msgstr "[:c:member:`~PyTypeObject.tp_version_tag`]" + +msgid "unsigned int" +msgstr "nieoznaczony typ int" + +msgid ":c:member:`~PyTypeObject.tp_finalize`" +msgstr ":c:member:`~PyTypeObject.tp_finalize`" + +msgid "__del__" +msgstr "__del__" + +msgid ":c:member:`~PyTypeObject.tp_vectorcall`" +msgstr ":c:member:`~PyTypeObject.tp_vectorcall`" + +msgid ":c:type:`vectorcallfunc`" +msgstr ":c:type:`vectorcallfunc`" + +msgid "" +"**()**: A slot name in parentheses indicates it is (effectively) deprecated." +msgstr "" + +msgid "" +"**<>**: Names in angle brackets should be initially set to ``NULL`` and " +"treated as read-only." +msgstr "" + +msgid "**[]**: Names in square brackets are for internal use only." +msgstr "" + +msgid "" +"**** (as a prefix) means the field is required (must be non-``NULL``)." +msgstr "" + +msgid "Columns:" +msgstr "" + +msgid "**\"O\"**: set on :c:data:`PyBaseObject_Type`" +msgstr "" + +msgid "**\"T\"**: set on :c:data:`PyType_Type`" +msgstr "" + +msgid "**\"D\"**: default (if slot is set to ``NULL``)" +msgstr "" + +msgid "**\"I\"**: inheritance" +msgstr "" + +msgid "" +"Note that some slots are effectively inherited through the normal attribute " +"lookup chain." +msgstr "" + +msgid "sub-slots" +msgstr "sub-slots" + +msgid "Slot" +msgstr "" + +msgid "special methods" +msgstr "" + +msgid ":c:member:`~PyAsyncMethods.am_await`" +msgstr ":c:member:`~PyAsyncMethods.am_await`" + +msgid ":c:type:`unaryfunc`" +msgstr ":c:type:`unaryfunc`" + +msgid "__await__" +msgstr "__await__" + +msgid ":c:member:`~PyAsyncMethods.am_aiter`" +msgstr ":c:member:`~PyAsyncMethods.am_aiter`" + +msgid "__aiter__" +msgstr "__aiter__" + +msgid ":c:member:`~PyAsyncMethods.am_anext`" +msgstr ":c:member:`~PyAsyncMethods.am_anext`" + +msgid "__anext__" +msgstr "__anext__" + +msgid ":c:member:`~PyAsyncMethods.am_send`" +msgstr ":c:member:`~PyAsyncMethods.am_send`" + +msgid ":c:type:`sendfunc`" +msgstr ":c:type:`sendfunc`" + +msgid ":c:member:`~PyNumberMethods.nb_add`" +msgstr ":c:member:`~PyNumberMethods.nb_add`" + +msgid ":c:type:`binaryfunc`" +msgstr ":c:type:`binaryfunc`" + +msgid "__add__ __radd__" +msgstr "__add__ __radd__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_add`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_add`" + +msgid "__iadd__" +msgstr "__iadd__" + +msgid ":c:member:`~PyNumberMethods.nb_subtract`" +msgstr ":c:member:`~PyNumberMethods.nb_subtract`" + +msgid "__sub__ __rsub__" +msgstr "__sub__ __rsub__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_subtract`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_subtract`" + +msgid "__isub__" +msgstr "__isub__" + +msgid ":c:member:`~PyNumberMethods.nb_multiply`" +msgstr ":c:member:`~PyNumberMethods.nb_multiply`" + +msgid "__mul__ __rmul__" +msgstr "__mul__ __rmul__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_multiply`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_multiply`" + +msgid "__imul__" +msgstr "__imul__" + +msgid ":c:member:`~PyNumberMethods.nb_remainder`" +msgstr ":c:member:`~PyNumberMethods.nb_remainder`" + +msgid "__mod__ __rmod__" +msgstr "__mod__ __rmod__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_remainder`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_remainder`" + +msgid "__imod__" +msgstr "__imod__" + +msgid ":c:member:`~PyNumberMethods.nb_divmod`" +msgstr ":c:member:`~PyNumberMethods.nb_divmod`" + +msgid "__divmod__ __rdivmod__" +msgstr "__divmod__ __rdivmod__" + +msgid ":c:member:`~PyNumberMethods.nb_power`" +msgstr ":c:member:`~PyNumberMethods.nb_power`" + +msgid "__pow__ __rpow__" +msgstr "__pow__ __rpow__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_power`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_power`" + +msgid "__ipow__" +msgstr "__ipow__" + +msgid ":c:member:`~PyNumberMethods.nb_negative`" +msgstr ":c:member:`~PyNumberMethods.nb_negative`" + +msgid "__neg__" +msgstr "__neg__" + +msgid ":c:member:`~PyNumberMethods.nb_positive`" +msgstr ":c:member:`~PyNumberMethods.nb_positive`" + +msgid "__pos__" +msgstr "__pos__" + +msgid ":c:member:`~PyNumberMethods.nb_absolute`" +msgstr ":c:member:`~PyNumberMethods.nb_absolute`" + +msgid "__abs__" +msgstr "__abs__" + +msgid ":c:member:`~PyNumberMethods.nb_bool`" +msgstr ":c:member:`~PyNumberMethods.nb_bool`" + +msgid "__bool__" +msgstr "__bool__" + +msgid ":c:member:`~PyNumberMethods.nb_invert`" +msgstr ":c:member:`~PyNumberMethods.nb_invert`" + +msgid "__invert__" +msgstr "__invert__" + +msgid ":c:member:`~PyNumberMethods.nb_lshift`" +msgstr ":c:member:`~PyNumberMethods.nb_lshift`" + +msgid "__lshift__ __rlshift__" +msgstr "__lshift__ __rlshift__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_lshift`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_lshift`" + +msgid "__ilshift__" +msgstr "__ilshift__" + +msgid ":c:member:`~PyNumberMethods.nb_rshift`" +msgstr ":c:member:`~PyNumberMethods.nb_rshift`" + +msgid "__rshift__ __rrshift__" +msgstr "__rshift__ __rrshift__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_rshift`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_rshift`" + +msgid "__irshift__" +msgstr "__irshift__" + +msgid ":c:member:`~PyNumberMethods.nb_and`" +msgstr ":c:member:`~PyNumberMethods.nb_and`" + +msgid "__and__ __rand__" +msgstr "__and__ __rand__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_and`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_and`" + +msgid "__iand__" +msgstr "__iand__" + +msgid ":c:member:`~PyNumberMethods.nb_xor`" +msgstr ":c:member:`~PyNumberMethods.nb_xor`" + +msgid "__xor__ __rxor__" +msgstr "__xor__ __rxor__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_xor`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_xor`" + +msgid "__ixor__" +msgstr "__ixor__" + +msgid ":c:member:`~PyNumberMethods.nb_or`" +msgstr ":c:member:`~PyNumberMethods.nb_or`" + +msgid "__or__ __ror__" +msgstr "__or__ __ror__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_or`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_or`" + +msgid "__ior__" +msgstr "__ior__" + +msgid ":c:member:`~PyNumberMethods.nb_int`" +msgstr ":c:member:`~PyNumberMethods.nb_int`" + +msgid "__int__" +msgstr "__int__" + +msgid ":c:member:`~PyNumberMethods.nb_reserved`" +msgstr ":c:member:`~PyNumberMethods.nb_reserved`" + +msgid "void *" +msgstr "" + +msgid ":c:member:`~PyNumberMethods.nb_float`" +msgstr ":c:member:`~PyNumberMethods.nb_float`" + +msgid "__float__" +msgstr "__float__" + +msgid ":c:member:`~PyNumberMethods.nb_floor_divide`" +msgstr ":c:member:`~PyNumberMethods.nb_floor_divide`" + +msgid "__floordiv__" +msgstr "__floordiv__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_floor_divide`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_floor_divide`" + +msgid "__ifloordiv__" +msgstr "__ifloordiv__" + +msgid ":c:member:`~PyNumberMethods.nb_true_divide`" +msgstr ":c:member:`~PyNumberMethods.nb_true_divide`" + +msgid "__truediv__" +msgstr "__truediv__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_true_divide`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_true_divide`" + +msgid "__itruediv__" +msgstr "__itruediv__" + +msgid ":c:member:`~PyNumberMethods.nb_index`" +msgstr ":c:member:`~PyNumberMethods.nb_index`" + +msgid "__index__" +msgstr "__index__" + +msgid ":c:member:`~PyNumberMethods.nb_matrix_multiply`" +msgstr ":c:member:`~PyNumberMethods.nb_matrix_multiply`" + +msgid "__matmul__ __rmatmul__" +msgstr "__matmul__ __rmatmul__" + +msgid ":c:member:`~PyNumberMethods.nb_inplace_matrix_multiply`" +msgstr ":c:member:`~PyNumberMethods.nb_inplace_matrix_multiply`" + +msgid "__imatmul__" +msgstr "__imatmul__" + +msgid ":c:member:`~PyMappingMethods.mp_length`" +msgstr ":c:member:`~PyMappingMethods.mp_length`" + +msgid ":c:type:`lenfunc`" +msgstr ":c:type:`lenfunc`" + +msgid "__len__" +msgstr "__len__" + +msgid ":c:member:`~PyMappingMethods.mp_subscript`" +msgstr ":c:member:`~PyMappingMethods.mp_subscript`" + +msgid "__getitem__" +msgstr "__getitem__" + +msgid ":c:member:`~PyMappingMethods.mp_ass_subscript`" +msgstr ":c:member:`~PyMappingMethods.mp_ass_subscript`" + +msgid ":c:type:`objobjargproc`" +msgstr ":c:type:`objobjargproc`" + +msgid "__setitem__, __delitem__" +msgstr "__setitem__, __delitem__" + +msgid ":c:member:`~PySequenceMethods.sq_length`" +msgstr ":c:member:`~PySequenceMethods.sq_length`" + +msgid ":c:member:`~PySequenceMethods.sq_concat`" +msgstr ":c:member:`~PySequenceMethods.sq_concat`" + +msgid "__add__" +msgstr "__add__" + +msgid ":c:member:`~PySequenceMethods.sq_repeat`" +msgstr ":c:member:`~PySequenceMethods.sq_repeat`" + +msgid ":c:type:`ssizeargfunc`" +msgstr ":c:type:`ssizeargfunc`" + +msgid "__mul__" +msgstr "__mul__" + +msgid ":c:member:`~PySequenceMethods.sq_item`" +msgstr ":c:member:`~PySequenceMethods.sq_item`" + +msgid ":c:member:`~PySequenceMethods.sq_ass_item`" +msgstr ":c:member:`~PySequenceMethods.sq_ass_item`" + +msgid ":c:type:`ssizeobjargproc`" +msgstr ":c:type:`ssizeobjargproc`" + +msgid "__setitem__ __delitem__" +msgstr "__setitem__ __delitem__" + +msgid ":c:member:`~PySequenceMethods.sq_contains`" +msgstr ":c:member:`~PySequenceMethods.sq_contains`" + +msgid ":c:type:`objobjproc`" +msgstr ":c:type:`objobjproc`" + +msgid "__contains__" +msgstr "__contains__" + +msgid ":c:member:`~PySequenceMethods.sq_inplace_concat`" +msgstr ":c:member:`~PySequenceMethods.sq_inplace_concat`" + +msgid ":c:member:`~PySequenceMethods.sq_inplace_repeat`" +msgstr ":c:member:`~PySequenceMethods.sq_inplace_repeat`" + +msgid ":c:member:`~PyBufferProcs.bf_getbuffer`" +msgstr ":c:member:`~PyBufferProcs.bf_getbuffer`" + +msgid ":c:func:`getbufferproc`" +msgstr ":c:func:`getbufferproc`" + +msgid ":c:member:`~PyBufferProcs.bf_releasebuffer`" +msgstr ":c:member:`~PyBufferProcs.bf_releasebuffer`" + +msgid ":c:func:`releasebufferproc`" +msgstr ":c:func:`releasebufferproc`" + +msgid "slot typedefs" +msgstr "" + +msgid "typedef" +msgstr "typedef" + +msgid "Parameter Types" +msgstr "" + +msgid "Return Type" +msgstr "" + +msgid "void" +msgstr "" + +msgid ":c:type:`visitproc`" +msgstr ":c:type:`visitproc`" + +msgid "int" +msgstr "int" + +msgid "Py_hash_t" +msgstr "Py_hash_t" + +msgid ":c:type:`getbufferproc`" +msgstr ":c:type:`getbufferproc`" + +msgid ":c:type:`Py_buffer` *" +msgstr ":c:type:`Py_buffer` *" + +msgid ":c:type:`releasebufferproc`" +msgstr ":c:type:`releasebufferproc`" + +msgid "See :ref:`slot-typedefs` below for more detail." +msgstr "" + +msgid "PyTypeObject Definition" +msgstr "" + +msgid "" +"The structure definition for :c:type:`PyTypeObject` can be found in :file:" +"`Include/object.h`. For convenience of reference, this repeats the " +"definition found there:" +msgstr "" + +msgid "PyObject Slots" +msgstr "" + +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 :c:member:`~PyVarObject.ob_size` field." +msgstr "" + +msgid "" +"This is the type object's reference count, 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 "" + +msgid "**Inheritance:**" +msgstr "" + +msgid "This field is not inherited by subtypes." +msgstr "" + +msgid "" +"This is the type's type, in other words its metatype. It is initialized by " +"the argument to the ``PyObject_HEAD_INIT`` macro, and its value should " +"normally be ``&PyType_Type``. However, for dynamically loadable extension " +"modules that must be usable on Windows (at least), the compiler complains " +"that this is not a valid initializer. Therefore, the convention is to pass " +"``NULL`` to the ``PyObject_HEAD_INIT`` macro and to initialize this field " +"explicitly at the start of the module's initialization function, before " +"doing anything else. This is typically done like this::" +msgstr "" + +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." +msgstr "" + +msgid "This field is inherited by subtypes." +msgstr "" + +msgid "" +"These fields are only present when the macro ``Py_TRACE_REFS`` is defined " +"(see the :option:`configure --with-trace-refs option <--with-trace-refs>`)." +msgstr "" + +msgid "" +"Their initialization to ``NULL`` is taken care of by the " +"``PyObject_HEAD_INIT`` macro. For :ref:`statically allocated objects " +"`, these fields always remain ``NULL``. For :ref:`dynamically " +"allocated objects `, these two fields are used to link the " +"object into a doubly linked list of *all* live objects on the heap." +msgstr "" + +msgid "" +"This could be used for various debugging purposes; currently the only uses " +"are the :func:`sys.getobjects` function and to print the objects that are " +"still alive at the end of a run when the environment variable :envvar:" +"`PYTHONDUMPREFS` is set." +msgstr "" + +msgid "These fields are not inherited by subtypes." +msgstr "" + +msgid "PyVarObject Slots" +msgstr "" + +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 "" + +msgid "PyTypeObject Slots" +msgstr "" + +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.)" +msgstr "" + +msgid "" +"Pointer to a NUL-terminated string containing the name of the type. For " +"types that are accessible as module globals, the string should be the full " +"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\"``." +msgstr "" + +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 "" + +msgid "" +"For :ref:`statically allocated type objects `, the *tp_name* " +"field should contain a dot. Everything before the last dot is made " +"accessible as the :attr:`__module__` attribute, and everything after the " +"last dot is made accessible as the :attr:`~definition.__name__` attribute." +msgstr "" + +msgid "" +"If no dot is present, the entire :c:member:`~PyTypeObject.tp_name` field is " +"made accessible as the :attr:`~definition.__name__` attribute, and the :attr:" +"`__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 "" + +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`)." +msgstr "" + +msgid "" +"These fields allow calculating the size in bytes of instances of the type." +msgstr "" + +msgid "" +"There are two kinds of types: types with fixed-length instances have a zero :" +"c:member:`~PyTypeObject.tp_itemsize` field, types with variable-length " +"instances have a non-zero :c:member:`~PyTypeObject.tp_itemsize` field. For " +"a type with fixed-length instances, all instances have the same size, given " +"in :c:member:`~PyTypeObject.tp_basicsize`." +msgstr "" + +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:" +"`~PyTypeObject.tp_basicsize` plus N times :c:member:`~PyTypeObject." +"tp_itemsize`, where N is the \"length\" of the object. The value of N is " +"typically stored in the instance's :c:member:`~PyVarObject.ob_size` field. " +"There are exceptions: for example, ints use a negative :c:member:" +"`~PyVarObject.ob_size` to indicate a negative number, and N is " +"``abs(ob_size)`` there. 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 structure for the list type " +"has fixed-length instances, yet those instances have a meaningful :c:member:" +"`~PyVarObject.ob_size` field)." +msgstr "" + +msgid "" +"The basic size includes the fields in the instance declared by the macro :c:" +"macro:`PyObject_HEAD` or :c:macro:`PyObject_VAR_HEAD` (whichever is used to " +"declare the instance struct) and this in turn includes the :c:member:" +"`~PyObject._ob_prev` and :c:member:`~PyObject._ob_next` fields if they are " +"present. This means that the only correct way to get an initializer for " +"the :c:member:`~PyTypeObject.tp_basicsize` is to use the ``sizeof`` operator " +"on the struct used to declare the instance layout. The basic size does not " +"include the GC header size." +msgstr "" + +msgid "" +"A note about alignment: if the variable items require a particular " +"alignment, this should be taken care of by the value of :c:member:" +"`~PyTypeObject.tp_basicsize`. Example: suppose a type implements an array " +"of ``double``. :c:member:`~PyTypeObject.tp_itemsize` is ``sizeof(double)``. " +"It is the programmer's responsibility that :c:member:`~PyTypeObject." +"tp_basicsize` is a multiple of ``sizeof(double)`` (assuming this is the " +"alignment requirement for ``double``)." +msgstr "" + +msgid "" +"For any type with variable-length instances, this field must not be ``NULL``." +msgstr "" + +msgid "" +"These fields are inherited separately by subtypes. If the base type has a " +"non-zero :c:member:`~PyTypeObject.tp_itemsize`, it is generally not safe to " +"set :c:member:`~PyTypeObject.tp_itemsize` to a different non-zero value in a " +"subtype (though this depends on the implementation of the base type)." +msgstr "" + +msgid "" +"A pointer to the instance destructor function. This function must be " +"defined unless the type guarantees that its instances will never be " +"deallocated (as is the case for the singletons ``None`` and ``Ellipsis``). " +"The function signature is::" +msgstr "" + +msgid "" +"The destructor function is called by the :c:func:`Py_DECREF` and :c:func:" +"`Py_XDECREF` macros when the new reference count is zero. At this point, " +"the instance is still in existence, but there are no references to it. The " +"destructor function should free all references which the instance owns, free " +"all memory buffers owned by the instance (using the freeing function " +"corresponding to the allocation function used to allocate the buffer), and " +"call the type's :c:member:`~PyTypeObject.tp_free` function. If the type is " +"not subtypable (doesn't have the :c:macro:`Py_TPFLAGS_BASETYPE` flag bit " +"set), it is permissible to call the object deallocator directly instead of " +"via :c:member:`~PyTypeObject.tp_free`. The object deallocator should be the " +"one used to allocate the instance; this is normally :c:func:`PyObject_Del` " +"if the instance was allocated using :c:macro:`PyObject_New` or :c:macro:" +"`PyObject_NewVar`, or :c:func:`PyObject_GC_Del` if the instance was " +"allocated using :c:macro:`PyObject_GC_New` or :c:macro:`PyObject_GC_NewVar`." +msgstr "" + +msgid "" +"If the type supports garbage collection (has the :c:macro:" +"`Py_TPFLAGS_HAVE_GC` flag bit set), the destructor should call :c:func:" +"`PyObject_GC_UnTrack` before clearing any member fields." +msgstr "" + +msgid "" +"Finally, 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. In order to avoid " +"dangling pointers, the recommended way to achieve this is:" +msgstr "" + +msgid "" +"An optional offset to a per-instance function that implements calling the " +"object using the :ref:`vectorcall protocol `, a more efficient " +"alternative of the simpler :c:member:`~PyTypeObject.tp_call`." +msgstr "" + +msgid "" +"This field is only used if the flag :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` is " +"set. If so, this must be a positive integer containing the offset in the " +"instance of a :c:type:`vectorcallfunc` pointer." +msgstr "" + +msgid "" +"The *vectorcallfunc* pointer may be ``NULL``, in which case the instance " +"behaves as if :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` was not set: calling the " +"instance falls back to :c:member:`~PyTypeObject.tp_call`." +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`." +msgstr "" + +msgid "" +"It is not recommended for :ref:`mutable heap types ` to " +"implement the vectorcall protocol. When a user sets :attr:`__call__` in " +"Python code, only *tp_call* is updated, likely making it inconsistent with " +"the vectorcall function." +msgstr "" + +msgid "" +"Before version 3.8, this slot was named ``tp_print``. In Python 2.x, it was " +"used for printing to a file. In Python 3.0 to 3.7, it was unused." +msgstr "" + +msgid "" +"This field is always inherited. However, the :c:macro:" +"`Py_TPFLAGS_HAVE_VECTORCALL` flag is not always inherited. If it's not, then " +"the subclass won't use :ref:`vectorcall `, except when :c:func:" +"`PyVectorcall_Call` is explicitly called. This is in particular the case for " +"types without the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` flag set (including " +"subclasses defined in Python)." +msgstr "" + +msgid "An optional pointer to the get-attribute-string function." +msgstr "" + +msgid "" +"This field is deprecated. When it is defined, it should point to a function " +"that acts the same as the :c:member:`~PyTypeObject.tp_getattro` function, " +"but taking a C string instead of a Python string object to give the " +"attribute name." +msgstr "" + +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` " +"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``." +msgstr "" + +msgid "" +"An optional pointer to the function for setting and deleting attributes." +msgstr "" + +msgid "" +"This field is deprecated. When it is defined, it should point to a function " +"that acts the same as the :c:member:`~PyTypeObject.tp_setattro` function, " +"but taking a C string instead of a Python string object to give the " +"attribute name." +msgstr "" + +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` " +"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``." +msgstr "" + +msgid "" +"Pointer to an additional structure that contains fields relevant only to " +"objects which implement :term:`awaitable` and :term:`asynchronous iterator` " +"protocols at the C-level. See :ref:`async-structs` for details." +msgstr "" + +msgid "Formerly known as ``tp_compare`` and ``tp_reserved``." +msgstr "" + +msgid "" +"The :c:member:`~PyTypeObject.tp_as_async` field is not inherited, but the " +"contained fields are inherited individually." +msgstr "" + +msgid "" +"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`::" +msgstr "" + +msgid "" +"The function must return a string or a Unicode object. Ideally, this " +"function should return a string that, when passed to :func:`eval`, given a " +"suitable environment, returns an object with the same value. If this is not " +"feasible, it should return a string starting with ``'<'`` and ending with " +"``'>'`` from which both the type and the value of the object can be deduced." +msgstr "" + +msgid "**Default:**" +msgstr "" + +msgid "" +"When this field is not set, a string of the form ``<%s object at %p>`` is " +"returned, where ``%s`` is replaced by the type name, and ``%p`` by the " +"object's memory address." +msgstr "" + +msgid "" +"Pointer to an additional structure that contains fields relevant only to " +"objects which implement the number protocol. These fields are documented " +"in :ref:`number-structs`." +msgstr "" + +msgid "" +"The :c:member:`~PyTypeObject.tp_as_number` field is not inherited, but the " +"contained fields are inherited individually." +msgstr "" + +msgid "" +"Pointer to an additional structure that contains fields relevant only to " +"objects which implement the sequence protocol. These fields are documented " +"in :ref:`sequence-structs`." +msgstr "" + +msgid "" +"The :c:member:`~PyTypeObject.tp_as_sequence` field is not inherited, but the " +"contained fields are inherited individually." +msgstr "" + +msgid "" +"Pointer to an additional structure that contains fields relevant only to " +"objects which implement the mapping protocol. These fields are documented " +"in :ref:`mapping-structs`." +msgstr "" + +msgid "" +"The :c:member:`~PyTypeObject.tp_as_mapping` field is not inherited, but the " +"contained fields are inherited individually." +msgstr "" + +msgid "" +"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`::" +msgstr "" + +msgid "" +"The value ``-1`` should not be returned as a normal return value; when an " +"error occurs during the computation of the hash value, the function should " +"set an exception and return ``-1``." +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`." +msgstr "" + +msgid "" +"This field can be set explicitly to :c:func:`PyObject_HashNotImplemented` to " +"block inheritance of the hash method from a parent type. This is interpreted " +"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`." +msgstr "" + +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``." +msgstr "" + +msgid "" +"An optional pointer to a function that implements calling the object. This " +"should be ``NULL`` if the object is not callable. The signature is the same " +"as for :c:func:`PyObject_Call`::" +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.)" +msgstr "" + +msgid "The signature is the same as for :c:func:`PyObject_Str`::" +msgstr "" + +msgid "" +"The function must return a string or a Unicode object. It should be a " +"\"friendly\" string representation of the object, as this is the " +"representation that will be used, among other things, by the :func:`print` " +"function." +msgstr "" + +msgid "" +"When this field is not set, :c:func:`PyObject_Repr` is called to return a " +"string representation." +msgstr "" + +msgid "An optional pointer to the get-attribute function." +msgstr "" + +msgid "The signature is the same as for :c:func:`PyObject_GetAttr`::" +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." +msgstr "" + +msgid "" +"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``." +msgstr "" + +msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericGetAttr`." +msgstr "" + +msgid "The signature is the same as for :c:func:`PyObject_SetAttr`::" +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." +msgstr "" + +msgid "" +"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``." +msgstr "" + +msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericSetAttr`." +msgstr "" + +msgid "" +"Pointer to an additional structure that contains fields relevant only to " +"objects which implement the buffer interface. These fields are documented " +"in :ref:`buffer-structs`." +msgstr "" + +msgid "" +"The :c:member:`~PyTypeObject.tp_as_buffer` field is not inherited, but the " +"contained fields are inherited individually." +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." +msgstr "" + +msgid "" +"Inheritance of this field is complicated. Most flag bits are inherited " +"individually, i.e. if the base type has a flag bit set, the subtype inherits " +"this flag bit. The flag bits that pertain to extension structures are " +"strictly inherited if the extension structure is inherited, i.e. the base " +"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." +msgstr "" + +msgid "" +":c:data:`PyBaseObject_Type` uses ``Py_TPFLAGS_DEFAULT | " +"Py_TPFLAGS_BASETYPE``." +msgstr "" + +msgid "**Bit Masks:**" +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." +msgstr "" + +msgid "" +"This bit is set when the type object itself is allocated on the heap, for " +"example, types created dynamically using :c:func:`PyType_FromSpec`. In this " +"case, the :c:member:`~PyObject.ob_type` field of its instances is considered " +"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)." +msgstr "" + +msgid "???" +msgstr "???" + +msgid "" +"This bit is set when the type can be used as the base type of another type. " +"If this bit is clear, the type cannot be subtyped (similar to a \"final\" " +"class in Java)." +msgstr "" + +msgid "" +"This bit is set when the type object has been fully initialized by :c:func:" +"`PyType_Ready`." +msgstr "" + +msgid "" +"This bit is set while :c:func:`PyType_Ready` is in the process of " +"initializing the type object." +msgstr "" + +msgid "" +"This bit is set when the object supports garbage collection. If this bit is " +"set, instances must be created using :c:macro:`PyObject_GC_New` and " +"destroyed using :c:func:`PyObject_GC_Del`. More information in section :ref:" +"`supporting-cycle-detection`. This bit also implies that the GC-related " +"fields :c:member:`~PyTypeObject.tp_traverse` and :c:member:`~PyTypeObject." +"tp_clear` are present in the type object." +msgstr "" + +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." +msgstr "" + +msgid "" +"This is a bitmask of all the bits that pertain to the existence of certain " +"fields in the type object and its extension structures. Currently, it " +"includes the following bits: :c:macro:`Py_TPFLAGS_HAVE_STACKLESS_EXTENSION`." +msgstr "" + +msgid "This bit indicates that objects behave like unbound methods." +msgstr "" + +msgid "If this flag is set for ``type(meth)``, then:" +msgstr "" + +msgid "" +"``meth.__get__(obj, cls)(*args, **kwds)`` (with ``obj`` not None) must be " +"equivalent to ``meth(obj, *args, **kwds)``." +msgstr "" + +msgid "" +"``meth.__get__(None, cls)(*args, **kwds)`` must be equivalent to " +"``meth(*args, **kwds)``." +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``." +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." +msgstr "" + +msgid "" +"These flags are used by functions such as :c:func:`PyLong_Check` 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 "" +"This bit is set when the :c:member:`~PyTypeObject.tp_finalize` slot is " +"present in the type structure." +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." +msgstr "" + +msgid "" +"This bit is set when the class implements the :ref:`vectorcall protocol " +"`. See :c:member:`~PyTypeObject.tp_vectorcall_offset` for " +"details." +msgstr "" + +msgid "" +"This bit is inherited for types with the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` " +"flag set, if :c:member:`~PyTypeObject.tp_call` is also inherited." +msgstr "" + +msgid "" +"This bit is set for type objects that are immutable: type attributes cannot " +"be set nor deleted." +msgstr "" + +msgid "" +":c:func:`PyType_Ready` automatically applies this flag to :ref:`static types " +"`." +msgstr "" + +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." +msgstr "" + +msgid "" +"The flag must be set before creating the type, not after. For example, it " +"must be set before :c:func:`PyType_Ready` is called on the type." +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." +msgstr "" + +msgid "" +"This flag is not inherited. However, subclasses will not be instantiable " +"unless they provide a non-NULL :c:member:`~PyTypeObject.tp_new` (which is " +"only possible via the C API)." +msgstr "" + +msgid "" +"To disallow instantiating a class directly but allow instantiating its " +"subclasses (e.g. for an :term:`abstract base class`), do not use this flag. " +"Instead, make :c:member:`~PyTypeObject.tp_new` only succeed for subclasses." +msgstr "" + +msgid "" +"This bit indicates that instances of the class may match mapping patterns " +"when used as the subject of a :keyword:`match` block. It is automatically " +"set when registering or subclassing :class:`collections.abc.Mapping`, and " +"unset when registering :class:`collections.abc.Sequence`." +msgstr "" + +msgid "" +":c:macro:`Py_TPFLAGS_MAPPING` and :c:macro:`Py_TPFLAGS_SEQUENCE` are " +"mutually exclusive; it is an error to enable both flags simultaneously." +msgstr "" + +msgid "" +"This flag is inherited by types that do not already set :c:macro:" +"`Py_TPFLAGS_SEQUENCE`." +msgstr "" + +msgid ":pep:`634` -- Structural Pattern Matching: Specification" +msgstr "" + +msgid "" +"This bit indicates that instances of the class may match sequence patterns " +"when used as the subject of a :keyword:`match` block. It is automatically " +"set when registering or subclassing :class:`collections.abc.Sequence`, and " +"unset when registering :class:`collections.abc.Mapping`." +msgstr "" + +msgid "" +"This flag is inherited by types that do not already set :c:macro:" +"`Py_TPFLAGS_MAPPING`." +msgstr "" + +msgid "" +"An optional pointer to a NUL-terminated C string giving the docstring for " +"this type object. This is exposed as the :attr:`__doc__` attribute on the " +"type and instances of the type." +msgstr "" + +msgid "This field is *not* inherited by subtypes." +msgstr "" + +msgid "" +"An optional pointer to a traversal function for the garbage collector. This " +"is only used if the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is set. The " +"signature is::" +msgstr "" + +msgid "" +"More information about Python's garbage collection scheme can be found in " +"section :ref:`supporting-cycle-detection`." +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::" +msgstr "" + +msgid "" +"Note that :c:func:`Py_VISIT` is called only on those members that can " +"participate in reference cycles. Although there is also a ``self->key`` " +"member, it can only be ``NULL`` or a Python string and therefore cannot be " +"part of a reference cycle." +msgstr "" + +msgid "" +"On the other hand, even if you know a member can never be part of a cycle, " +"as a debugging aid you may want to visit it anyway just so the :mod:`gc` " +"module's :func:`~gc.get_referents` function will include it." +msgstr "" + +msgid "" +"When implementing :c:member:`~PyTypeObject.tp_traverse`, only the members " +"that the instance *owns* (by having :term:`strong references ` to them) must be visited. For instance, if an object supports " +"weak references via the :c:member:`~PyTypeObject.tp_weaklist` slot, the " +"pointer supporting the linked list (what *tp_weaklist* points to) must " +"**not** be visited as the instance does not directly own the weak references " +"to itself (the weakreference list is there to support the weak reference " +"machinery, but the instance has no strong reference to the elements inside " +"it, as they are allowed to be removed even if the instance is still alive)." +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." +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." +msgstr "" + +msgid "" +"Heap-allocated types are expected to visit ``Py_TYPE(self)`` in " +"``tp_traverse``. In earlier versions of Python, due to `bug 40217 `_, doing this may lead to crashes in subclasses." +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." +msgstr "" + +msgid "" +"An optional pointer to a clear function for the garbage collector. This is " +"only used if the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is set. The " +"signature is::" +msgstr "" + +msgid "" +"The :c:member:`~PyTypeObject.tp_clear` member function is used to break " +"reference cycles in cyclic garbage detected by the garbage collector. 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 must be sufficient to break 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 "" +"Implementations of :c:member:`~PyTypeObject.tp_clear` should drop the " +"instance's references to those of its members that may be Python objects, " +"and set its pointers to those members to ``NULL``, as in the following " +"example::" +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 " +"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 " +"for such code to reference *self* again, it's important that the pointer to " +"the contained object be ``NULL`` at that time, so that *self* knows the " +"contained object can no longer be used. The :c:func:`Py_CLEAR` macro " +"performs the operations in a safe order." +msgstr "" + +msgid "" +"Note that :c:member:`~PyTypeObject.tp_clear` is not *always* called before " +"an instance is deallocated. For example, when reference counting is enough " +"to determine that an object is no longer used, the cyclic garbage collector " +"is not involved and :c:member:`~PyTypeObject.tp_dealloc` is called directly." +msgstr "" + +msgid "" +"Because the goal of :c:member:`~PyTypeObject.tp_clear` functions is to break " +"reference cycles, it's not necessary to clear contained objects like Python " +"strings or Python integers, which can't participate in reference cycles. On " +"the other hand, it may be convenient to clear all contained Python objects, " +"and write the type's :c:member:`~PyTypeObject.tp_dealloc` function to " +"invoke :c:member:`~PyTypeObject.tp_clear`." +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." +msgstr "" + +msgid "" +"An optional pointer to the rich comparison function, whose signature is::" +msgstr "" + +msgid "" +"The first parameter is guaranteed to be an instance of the type that is " +"defined by :c:type:`PyTypeObject`." +msgstr "" + +msgid "" +"The function should return the result of the comparison (usually ``Py_True`` " +"or ``Py_False``). If the comparison is undefined, it must return " +"``Py_NotImplemented``, if another error occurred it must return ``NULL`` and " +"set an exception condition." +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`:" +msgstr "" + +msgid "Constant" +msgstr "Stała" + +msgid "Comparison" +msgstr "Porównanie" + +msgid "``<``" +msgstr "``<``" + +msgid "``<=``" +msgstr "``<=``" + +msgid "``==``" +msgstr "``==``" + +msgid "``!=``" +msgstr "``!=``" + +msgid "``>``" +msgstr "``>``" + +msgid "``>=``" +msgstr "``>=``" + +msgid "" +"The following macro is defined to ease writing rich comparison functions:" +msgstr "" + +msgid "" +"Return ``Py_True`` or ``Py_False`` from the function, depending on the " +"result of a comparison. VAL_A and VAL_B must be orderable by C comparison " +"operators (for example, they may be C ints or floats). The third argument " +"specifies the requested operation, as for :c:func:`PyObject_RichCompare`." +msgstr "" + +msgid "The returned value is a new :term:`strong reference`." +msgstr "" + +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``." +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." +msgstr "" + +msgid "" +"If the instances of this type are weakly referenceable, this field is " +"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``." +msgstr "" + +msgid "" +"Do not confuse this field with :c:member:`~PyTypeObject.tp_weaklist`; that " +"is the list head for weak references to the type object itself." +msgstr "" + +msgid "" +"This field is inherited by subtypes, but see the rules listed below. A " +"subtype may override this offset; this means that the subtype uses a " +"different weak reference list head than the base type. Since the list head " +"is always found via :c:member:`~PyTypeObject.tp_weaklistoffset`, this should " +"not be a problem." +msgstr "" + +msgid "" +"When a type defined by a class statement has no :attr:`~object.__slots__` " +"declaration, and none of its base types are weakly referenceable, the type " +"is made weakly referenceable by adding a weak reference list head slot to " +"the instance layout and setting the :c:member:`~PyTypeObject." +"tp_weaklistoffset` of that slot's offset." +msgstr "" + +msgid "" +"When a type's :attr:`__slots__` declaration contains a slot named :attr:" +"`__weakref__`, that slot becomes the weak reference list head for instances " +"of the type, and the slot's offset is stored in the type's :c:member:" +"`~PyTypeObject.tp_weaklistoffset`." +msgstr "" + +msgid "" +"When a type's :attr:`__slots__` declaration does not contain a slot named :" +"attr:`__weakref__`, the type inherits its :c:member:`~PyTypeObject." +"tp_weaklistoffset` from its base type." +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)." +msgstr "" + +msgid "This function has the same signature as :c:func:`PyObject_GetIter`::" +msgstr "" + +msgid "" +"An optional pointer to a function that returns the next item in an :term:" +"`iterator`. The signature is::" +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." +msgstr "" + +msgid "" +"Iterator types should also define the :c:member:`~PyTypeObject.tp_iter` " +"function, and that function should return the iterator instance itself (not " +"a new iterator instance)." +msgstr "" + +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." +msgstr "" + +msgid "" +"For each entry in the array, an entry is added to the type's dictionary " +"(see :c:member:`~PyTypeObject.tp_dict` below) containing a method descriptor." +msgstr "" + +msgid "" +"This field is not inherited by subtypes (methods are inherited through a " +"different mechanism)." +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." +msgstr "" + +msgid "" +"For each entry in the array, an entry is added to the type's dictionary " +"(see :c:member:`~PyTypeObject.tp_dict` below) containing a member descriptor." +msgstr "" + +msgid "" +"This field is not inherited by subtypes (members are inherited through a " +"different mechanism)." +msgstr "" + +msgid "" +"An optional pointer to a static ``NULL``-terminated array of :c:type:" +"`PyGetSetDef` structures, declaring computed attributes of instances of this " +"type." +msgstr "" + +msgid "" +"For each entry in the array, an entry is added to the type's dictionary " +"(see :c:member:`~PyTypeObject.tp_dict` below) containing a getset descriptor." +msgstr "" + +msgid "" +"This field is not inherited by subtypes (computed attributes are inherited " +"through a different mechanism)." +msgstr "" + +msgid "" +"An optional pointer to a base type from which type properties are " +"inherited. At this level, only single inheritance is supported; multiple " +"inheritance require dynamically creating a type object by calling the " +"metatype." +msgstr "" + +msgid "" +"Slot initialization is subject to the rules of initializing globals. C99 " +"requires the initializers to be \"address constants\". Function designators " +"like :c:func:`PyType_GenericNew`, with implicit conversion to a pointer, are " +"valid C99 address constants." +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." +msgstr "" + +msgid "" +"Consequently, :c:member:`~PyTypeObject.tp_base` should be set in the " +"extension module's init function." +msgstr "" + +msgid "This field is not inherited by subtypes (obviously)." +msgstr "" + +msgid "" +"This field defaults to ``&PyBaseObject_Type`` (which to Python programmers " +"is known as the type :class:`object`)." +msgstr "" + +msgid "The type's dictionary is stored here by :c:func:`PyType_Ready`." +msgstr "" + +msgid "" +"This field should normally be initialized to ``NULL`` before PyType_Ready is " +"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__`)." +msgstr "" + +msgid "" +"This field is not inherited by subtypes (though the attributes defined in " +"here are inherited through a different mechanism)." +msgstr "" + +msgid "" +"If this field is ``NULL``, :c:func:`PyType_Ready` will assign a new " +"dictionary to it." +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." +msgstr "" + +msgid "An optional pointer to a \"descriptor get\" function." +msgstr "" + +msgid "The function signature is::" +msgstr "" + +msgid "" +"An optional pointer to a function for setting and deleting a descriptor's " +"value." +msgstr "" + +msgid "The *value* argument is set to ``NULL`` to delete the value." +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`." +msgstr "" + +msgid "" +"Do not confuse this field with :c:member:`~PyTypeObject.tp_dict`; that is " +"the dictionary for attributes of the type object itself." +msgstr "" + +msgid "" +"If the value of this field is greater than zero, it specifies the offset " +"from the start of the instance structure. If the value is less than zero, " +"it specifies the offset from the *end* of the instance structure. A " +"negative offset is more expensive to use, and should only be used when the " +"instance structure contains a variable-length part. This is used for " +"example to add an instance variable dictionary to subtypes of :class:`str` " +"or :class:`tuple`. Note that the :c:member:`~PyTypeObject.tp_basicsize` " +"field should account for the dictionary added to the end in that case, even " +"though the dictionary is not included in the basic object layout. On a " +"system with a pointer size of 4 bytes, :c:member:`~PyTypeObject." +"tp_dictoffset` should be set to ``-4`` to indicate that the dictionary is at " +"the very end of the structure." +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." +msgstr "" + +msgid "" +"This field is inherited by subtypes, but see the rules listed below. A " +"subtype may override this offset; this means that the subtype instances " +"store the dictionary at a difference offset than the base type. Since the " +"dictionary is always found via :c:member:`~PyTypeObject.tp_dictoffset`, this " +"should not be a problem." +msgstr "" + +msgid "" +"When a type defined by a class statement has no :attr:`~object.__slots__` " +"declaration, and none of its base types has an instance variable dictionary, " +"a dictionary slot is added to the instance layout and the :c:member:" +"`~PyTypeObject.tp_dictoffset` is set to that slot's offset." +msgstr "" + +msgid "" +"When a type defined by a class statement has a :attr:`__slots__` " +"declaration, the type inherits its :c:member:`~PyTypeObject.tp_dictoffset` " +"from its base type." +msgstr "" + +msgid "" +"(Adding a slot named :attr:`~object.__dict__` to the :attr:`__slots__` " +"declaration does not have the expected effect, it just causes confusion. " +"Maybe this should be added as a feature just like :attr:`__weakref__` " +"though.)" +msgstr "" + +msgid "" +"This slot has no default. For :ref:`static types `, if the " +"field is ``NULL`` then no :attr:`~object.__dict__` gets created for " +"instances." +msgstr "" + +msgid "An optional pointer to an instance initialization function." +msgstr "" + +msgid "" +"This function corresponds to the :meth:`~object.__init__` method of " +"classes. Like :meth:`!__init__`, it is possible to create an instance " +"without calling :meth:`!__init__`, and it is possible to reinitialize an " +"instance by calling its :meth:`!__init__` method again." +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__`." +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." +msgstr "" + +msgid "Returns ``0`` on success, ``-1`` and sets an exception on error." +msgstr "" + +msgid "" +"For :ref:`static types ` this field does not have a default." +msgstr "" + +msgid "An optional pointer to an instance allocation function." +msgstr "" + +msgid "" +"This field is inherited by static subtypes, but not by dynamic subtypes " +"(subtypes created by a class statement)." +msgstr "" + +msgid "" +"For dynamic subtypes, this field is always set to :c:func:" +"`PyType_GenericAlloc`, to force a standard heap allocation strategy." +msgstr "" + +msgid "" +"For static subtypes, :c:data:`PyBaseObject_Type` uses :c:func:" +"`PyType_GenericAlloc`. That is the recommended value for all statically " +"defined types." +msgstr "" + +msgid "An optional pointer to an instance creation function." +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)." +msgstr "" + +msgid "" +"The :c:member:`~PyTypeObject.tp_new` function should call ``subtype-" +">tp_alloc(subtype, nitems)`` to allocate space for the object, and then do " +"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`." +msgstr "" + +msgid "" +"Set the :c:macro:`Py_TPFLAGS_DISALLOW_INSTANTIATION` flag to disallow " +"creating instances of the type in Python." +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``." +msgstr "" + +msgid "" +"For :ref:`static types ` this field has no default. This means " +"if the slot is defined as ``NULL``, the type cannot be called to create new " +"instances; presumably there is some other way to create instances, like a " +"factory function." +msgstr "" + +msgid "" +"An optional pointer to an instance deallocation function. Its signature is::" +msgstr "" + +msgid "" +"An initializer that is compatible with this signature is :c:func:" +"`PyObject_Free`." +msgstr "" + +msgid "" +"This field is inherited by static subtypes, but not by dynamic subtypes " +"(subtypes created by a class statement)" +msgstr "" + +msgid "" +"In dynamic subtypes, this field is set to a deallocator suitable to match :c:" +"func:`PyType_GenericAlloc` and the value of the :c:macro:" +"`Py_TPFLAGS_HAVE_GC` flag bit." +msgstr "" + +msgid "" +"For static subtypes, :c:data:`PyBaseObject_Type` uses :c:func:`PyObject_Del`." +msgstr "" + +msgid "An optional pointer to a function called by the garbage collector." +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::" +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 `.)" +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"This field should be set to ``NULL`` and treated as read-only. Python will " +"fill it in when the type is :c:func:`initialized `." +msgstr "" + +msgid "" +"For dynamically created classes, the ``Py_tp_bases`` :c:type:`slot " +"` can be used instead of the *bases* argument of :c:func:" +"`PyType_FromSpecWithBases`. The argument form is preferred." +msgstr "" + +msgid "" +"Multiple inheritance does not work well for statically defined types. If you " +"set ``tp_bases`` to a tuple, Python will not raise an error, but some slots " +"will only be inherited from the first base." +msgstr "" + +msgid "This field is not inherited." +msgstr "" + +msgid "" +"Tuple containing the expanded set of base types, starting with the type " +"itself and ending with :class:`object`, in Method Resolution Order." +msgstr "" + +msgid "" +"This field is not inherited; it is calculated fresh by :c:func:" +"`PyType_Ready`." +msgstr "" + +msgid "Unused. Internal use only." +msgstr "" + +msgid "List of weak references to subclasses. Internal use only." +msgstr "" + +msgid "" +"Weak reference list head, for weak references to this type object. Not " +"inherited. Internal use only." +msgstr "" + +msgid "" +"This field is deprecated. Use :c:member:`~PyTypeObject.tp_finalize` instead." +msgstr "" + +msgid "Used to index into the method cache. Internal use only." +msgstr "" + +msgid "" +"An optional pointer to an instance finalization function. Its signature is::" +msgstr "" + +msgid "" +"If :c:member:`~PyTypeObject.tp_finalize` is set, the interpreter calls it " +"once when finalizing an instance. It is called either from the garbage " +"collector (if the instance is part of an isolated reference cycle) or just " +"before the object is deallocated. Either way, it is guaranteed to be called " +"before attempting to break reference cycles, ensuring that it finds the " +"object in a sane state." +msgstr "" + +msgid "" +":c:member:`~PyTypeObject.tp_finalize` should not mutate the current " +"exception status; therefore, a recommended way to write a non-trivial " +"finalizer is::" +msgstr "" + +msgid "" +"Also, note that, in a garbage collected Python, :c:member:`~PyTypeObject." +"tp_dealloc` may be called from any Python thread, not just the thread which " +"created the object (if the object becomes part of a refcount cycle, that " +"cycle might be collected by a garbage collection on any thread). This is " +"not a problem for Python API calls, since the thread on which tp_dealloc is " +"called will own the Global Interpreter Lock (GIL). However, if the object " +"being destroyed in turn destroys objects from some other C or C++ library, " +"care should be taken to ensure that destroying those objects on the thread " +"which called tp_dealloc will not violate any assumptions of the library." +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." +msgstr "" + +msgid "\"Safe object finalization\" (:pep:`442`)" +msgstr "" + +msgid "" +"Vectorcall function to use for calls of this type object. In other words, it " +"is used to implement :ref:`vectorcall ` for ``type.__call__``. " +"If ``tp_vectorcall`` is ``NULL``, the default call implementation using :" +"meth:`~object.__new__` and :meth:`~object.__init__` is used." +msgstr "" + +msgid "This field is never inherited." +msgstr "" + +msgid "(the field exists since 3.8 but it's only used since 3.9)" +msgstr "" + +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`." +msgstr "" + +msgid "" +"This results in types that are limited relative to types defined in Python:" +msgstr "" + +msgid "" +"Static types are limited to one base, i.e. they cannot use multiple " +"inheritance." +msgstr "" + +msgid "" +"Static type objects (but not necessarily their instances) are immutable. It " +"is not possible to add or modify the type object's attributes from Python." +msgstr "" + +msgid "" +"Static type objects are shared across :ref:`sub-interpreters `, so they should not include any subinterpreter-" +"specific state." +msgstr "" + +msgid "" +"Also, since :c:type:`PyTypeObject` is only part of the :ref:`Limited API " +"` as an opaque struct, any extension modules using static " +"types must be compiled for a specific Python minor version." +msgstr "" + +msgid "Heap Types" +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." +msgstr "" + +msgid "" +"This is done by filling a :c:type:`PyType_Spec` structure and calling :c:" +"func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases`, or :c:func:" +"`PyType_FromModuleAndSpec`." +msgstr "" + +msgid "Number Object Structures" +msgstr "" + +msgid "" +"This structure holds pointers to the functions which an object uses to " +"implement the number protocol. Each function is used by the function of " +"similar name documented in the :ref:`number` section." +msgstr "" + +msgid "Here is the structure definition::" +msgstr "" + +msgid "" +"Binary and ternary functions must check the type of all their operands, and " +"implement the necessary conversions (at least one of the operands is an " +"instance of the defined type). If the operation is not defined for the " +"given operands, binary and ternary functions must return " +"``Py_NotImplemented``, if another error occurred they must return ``NULL`` " +"and set an exception." +msgstr "" + +msgid "" +"The :c:member:`~PyNumberMethods.nb_reserved` field should always be " +"``NULL``. It was previously called :c:member:`!nb_long`, and was renamed in " +"Python 3.0.1." +msgstr "" + +msgid "Mapping Object Structures" +msgstr "" + +msgid "" +"This structure holds pointers to the functions which an object uses to " +"implement the mapping protocol. It has three members:" +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." +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." +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:`!" +"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." +msgstr "" + +msgid "Sequence Object Structures" +msgstr "" + +msgid "" +"This structure holds pointers to the functions which an object uses to " +"implement the sequence protocol." +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." +msgstr "" + +msgid "" +"This function is used by :c:func:`PySequence_Concat` and has the same " +"signature. It is also used by the ``+`` operator, after trying the numeric " +"addition via the :c:member:`~PyNumberMethods.nb_add` slot." +msgstr "" + +msgid "" +"This function is used by :c:func:`PySequence_Repeat` and has the same " +"signature. It is also used by the ``*`` operator, after trying numeric " +"multiplication via the :c:member:`~PyNumberMethods.nb_multiply` slot." +msgstr "" + +msgid "" +"This function is used by :c:func:`PySequence_GetItem` and has the same " +"signature. It is also used by :c:func:`PyObject_GetItem`, after trying the " +"subscription via the :c:member:`~PyMappingMethods.mp_subscript` slot. This " +"slot must be filled for the :c:func:`PySequence_Check` function to return " +"``1``, it can be ``NULL`` otherwise." +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." +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." +msgstr "" + +msgid "" +"This function may be used by :c:func:`PySequence_Contains` and has the same " +"signature. This slot may be left to ``NULL``, in this case :c:func:`!" +"PySequence_Contains` simply traverses the sequence until it finds a match." +msgstr "" + +msgid "" +"This function is used by :c:func:`PySequence_InPlaceConcat` and has the same " +"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." +msgstr "" + +msgid "" +"This function is used by :c:func:`PySequence_InPlaceRepeat` and has the same " +"signature. It should modify its first operand, and return it. This slot " +"may be left to ``NULL``, in this case :c:func:`!PySequence_InPlaceRepeat` " +"will fall back to :c:func:`PySequence_Repeat`. It is also used by the " +"augmented assignment ``*=``, after trying numeric in-place multiplication " +"via the :c:member:`~PyNumberMethods.nb_inplace_multiply` slot." +msgstr "" + +msgid "Buffer Object Structures" +msgstr "" + +msgid "" +"This structure holds pointers to the functions required by the :ref:`Buffer " +"protocol `. The protocol defines how an exporter object can " +"expose its internal data to consumer objects." +msgstr "" + +msgid "The signature of this function is::" +msgstr "" + +msgid "" +"Handle a request to *exporter* to fill in *view* as specified by *flags*. " +"Except for point (3), an implementation of this function MUST take these " +"steps:" +msgstr "" + +msgid "" +"Check if the request can be met. If not, raise :exc:`BufferError`, set :c:" +"expr:`view->obj` to ``NULL`` and return ``-1``." +msgstr "" + +msgid "Fill in the requested fields." +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`." +msgstr "" + +msgid "Return ``0``." +msgstr "" + +msgid "" +"If *exporter* is part of a chain or tree of buffer providers, two main " +"schemes can be used:" +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." +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." +msgstr "" + +msgid "" +"The individual fields of *view* are described in section :ref:`Buffer " +"structure `, the rules how an exporter must react to " +"specific requests are in section :ref:`Buffer request types `." +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." +msgstr "" + +msgid "" +":c:func:`PyBuffer_FillInfo` provides an easy way of exposing a simple bytes " +"buffer while dealing correctly with all request types." +msgstr "" + +msgid "" +":c:func:`PyObject_GetBuffer` is the interface for the consumer that wraps " +"this function." +msgstr "" + +msgid "" +"Handle a request to release the resources of the buffer. If no resources " +"need to be released, :c:member:`PyBufferProcs.bf_releasebuffer` may be " +"``NULL``. Otherwise, a standard implementation of this function will take " +"these optional steps:" +msgstr "" + +msgid "Decrement an internal counter for the number of exports." +msgstr "" + +msgid "If the counter is ``0``, free all memory associated with *view*." +msgstr "" + +msgid "" +"The exporter MUST use the :c:member:`~Py_buffer.internal` field to keep " +"track of buffer-specific resources. This field is guaranteed to remain " +"constant, while a consumer MAY pass a copy of the original buffer as the " +"*view* argument." +msgstr "" + +msgid "" +"This function MUST NOT decrement :c:expr:`view->obj`, since that is done " +"automatically in :c:func:`PyBuffer_Release` (this scheme is useful for " +"breaking reference cycles)." +msgstr "" + +msgid "" +":c:func:`PyBuffer_Release` is the interface for the consumer that wraps this " +"function." +msgstr "" + +msgid "Async Object Structures" +msgstr "" + +msgid "" +"This structure holds pointers to the functions required to implement :term:" +"`awaitable` and :term:`asynchronous iterator` objects." +msgstr "" + +msgid "" +"The returned object must be an :term:`iterator`, i.e. :c:func:`PyIter_Check` " +"must return ``1`` for it." +msgstr "" + +msgid "" +"This slot may be set to ``NULL`` if an object is not an :term:`awaitable`." +msgstr "" + +msgid "" +"Must return an :term:`asynchronous iterator` object. See :meth:`~object." +"__anext__` for details." +msgstr "" + +msgid "" +"This slot may be set to ``NULL`` if an object does not implement " +"asynchronous iteration protocol." +msgstr "" + +msgid "" +"Must return an :term:`awaitable` object. See :meth:`~object.__anext__` for " +"details. This slot may be set to ``NULL``." +msgstr "" + +msgid "" +"See :c:func:`PyIter_Send` for details. This slot may be set to ``NULL``." +msgstr "" + +msgid "Slot Type typedefs" +msgstr "" + +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`." +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`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_free`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_new`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_init`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_repr`." +msgstr "" + +msgid "Return the value of the named attribute for the object." +msgstr "" + +msgid "" +"Set the value of the named attribute for the object. The value argument is " +"set to ``NULL`` to delete the attribute." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_getattro`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_setattro`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_descr_get`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_descr_set`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_hash`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_richcompare`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_iter`." +msgstr "" + +msgid "See :c:member:`~PyTypeObject.tp_iternext`." +msgstr "" + +msgid "See :c:member:`~PyAsyncMethods.am_send`." +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid "" +"The following are simple examples of Python type definitions. They include " +"common usage you may encounter. Some demonstrate tricky corner cases. For " +"more examples, practical info, and a tutorial, see :ref:`defining-new-types` " +"and :ref:`new-types-topics`." +msgstr "" + +msgid "A basic :ref:`static type `::" +msgstr "" + +msgid "" +"You may also find older code (especially in the CPython code base) with a " +"more verbose initializer::" +msgstr "" + +msgid "A type that supports weakrefs, instance dicts, and hashing::" +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::" +msgstr "" + +msgid "" +"The simplest :ref:`static type ` with fixed-length instances::" +msgstr "" + +msgid "" +"The simplest :ref:`static type ` with variable-length " +"instances::" +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "repr" +msgstr "" + +msgid "hash" +msgstr "" diff --git a/c-api/unicode.po b/c-api/unicode.po new file mode 100644 index 0000000000..06fb9bbe46 --- /dev/null +++ b/c-api/unicode.po @@ -0,0 +1,1514 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:09+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Unicode Objects and Codecs" +msgstr "" + +msgid "Unicode Objects" +msgstr "" + +msgid "" +"Since the implementation of :pep:`393` in Python 3.3, Unicode objects " +"internally use a variety of representations, in order to allow handling the " +"complete range of Unicode characters while staying memory efficient. There " +"are special cases for strings where all code points are below 128, 256, or " +"65536; otherwise, code points must be below 1114112 (which is the full " +"Unicode range)." +msgstr "" + +msgid "" +":c:expr:`Py_UNICODE*` and UTF-8 representations are created on demand and " +"cached in the Unicode object. The :c:expr:`Py_UNICODE*` representation is " +"deprecated and inefficient." +msgstr "" + +msgid "" +"Due to the transition between the old APIs and the new APIs, Unicode objects " +"can internally be in two states depending on how they were created:" +msgstr "" + +msgid "" +"\"canonical\" Unicode objects are all objects created by a non-deprecated " +"Unicode API. They use the most efficient representation allowed by the " +"implementation." +msgstr "" + +msgid "" +"\"legacy\" Unicode objects have been created through one of the deprecated " +"APIs (typically :c:func:`PyUnicode_FromUnicode`) and only bear the :c:expr:" +"`Py_UNICODE*` representation; you will have to call :c:func:" +"`PyUnicode_READY` on them before calling any other API." +msgstr "" + +msgid "" +"The \"legacy\" Unicode object will be removed in Python 3.12 with deprecated " +"APIs. All Unicode objects will be \"canonical\" since then. See :pep:`623` " +"for more information." +msgstr "" + +msgid "Unicode Type" +msgstr "" + +msgid "" +"These are the basic Unicode object types used for the Unicode implementation " +"in Python:" +msgstr "" + +msgid "" +"These types are typedefs for unsigned integer types wide enough to contain " +"characters of 32 bits, 16 bits and 8 bits, respectively. When dealing with " +"single Unicode characters, use :c:type:`Py_UCS4`." +msgstr "" + +msgid "" +"This is a typedef of :c:type:`wchar_t`, which is a 16-bit type or 32-bit " +"type depending on the platform." +msgstr "" + +msgid "" +"In previous versions, this was a 16-bit type or a 32-bit type depending on " +"whether you selected a \"narrow\" or \"wide\" Unicode version of Python at " +"build time." +msgstr "" + +msgid "" +"These subtypes of :c:type:`PyObject` represent a Python Unicode object. In " +"almost all cases, they shouldn't be used directly, since all API functions " +"that deal with Unicode objects take and return :c:type:`PyObject` pointers." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python Unicode type. " +"It is exposed to Python code as ``str``." +msgstr "" + +msgid "" +"The following APIs are C macros and static inlined functions for fast checks " +"and access to internal read-only data of Unicode objects:" +msgstr "" + +msgid "" +"Return true if the object *obj* is a Unicode object or an instance of a " +"Unicode subtype. This function always succeeds." +msgstr "" + +msgid "" +"Return true if the object *obj* is a Unicode object, but not an instance of " +"a subtype. This function always succeeds." +msgstr "" + +msgid "" +"Ensure the string object *o* is in the \"canonical\" representation. This " +"is required before using any of the access macros described below." +msgstr "" + +msgid "" +"Returns ``0`` on success and ``-1`` with an exception set on failure, which " +"in particular happens if memory allocation fails." +msgstr "" + +msgid "This API will be removed with :c:func:`PyUnicode_FromUnicode`." +msgstr "" + +msgid "" +"Return the length of the Unicode string, in code points. *unicode* has to " +"be a Unicode object in the \"canonical\" representation (not checked)." +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 macro. Make sure :c:func:" +"`PyUnicode_READY` has been called before accessing this." +msgstr "" + +msgid "Return values of the :c:func:`PyUnicode_KIND` macro." +msgstr "" + +msgid "``PyUnicode_WCHAR_KIND`` is deprecated." +msgstr "" + +msgid "" +"Return one of the PyUnicode kind constants (see above) that indicate how " +"many bytes per character this Unicode object uses to store its data. " +"*unicode* has to be a Unicode object in the \"canonical\" representation " +"(not checked)." +msgstr "" + +msgid "" +"Return a void pointer to the raw Unicode buffer. *unicode* has to be a " +"Unicode object in the \"canonical\" representation (not checked)." +msgstr "" + +msgid "" +"Write into a canonical representation *data* (as obtained with :c:func:" +"`PyUnicode_DATA`). This function performs no sanity checks, and is intended " +"for usage in loops. The caller should cache the *kind* value and *data* " +"pointer as obtained from other calls. *index* is the index in the string " +"(starts at 0) and *value* is the new code point value which should be " +"written to that location." +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." +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." +msgstr "" + +msgid "" +"Return the maximum code point that is suitable for creating another string " +"based on *unicode*, which must be in the \"canonical\" representation. This " +"is always an approximation but more efficient than iterating over the string." +msgstr "" + +msgid "" +"Return the size of the deprecated :c:type:`Py_UNICODE` representation, in " +"code units (this includes surrogate pairs as 2 units). *unicode* has to be " +"a Unicode object (not checked)." +msgstr "" + +msgid "" +"Part of the old-style Unicode API, please migrate to using :c:func:" +"`PyUnicode_GET_LENGTH`." +msgstr "" + +msgid "" +"Return the size of the deprecated :c:type:`Py_UNICODE` representation in " +"bytes. *unicode* has to be a Unicode object (not checked)." +msgstr "" + +msgid "" +"Return a pointer to a :c:type:`Py_UNICODE` representation of the object. " +"The returned buffer is always terminated with an extra null code point. It " +"may also contain embedded null code points, which would cause the string to " +"be truncated when used in most C functions. The ``AS_DATA`` form casts the " +"pointer to :c:expr:`const char *`. The *unicode* argument has to be a " +"Unicode object (not checked)." +msgstr "" + +msgid "" +"This function is now inefficient -- because in many cases the :c:type:" +"`Py_UNICODE` representation does not exist and needs to be created -- and " +"can fail (return ``NULL`` with an exception set). Try to port the code to " +"use the new :c:func:`PyUnicode_nBYTE_DATA` macros or use :c:func:" +"`PyUnicode_WRITE` or :c:func:`PyUnicode_READ`." +msgstr "" + +msgid "" +"Part of the old-style Unicode API, please migrate to using the :c:func:" +"`PyUnicode_nBYTE_DATA` family of macros." +msgstr "" + +msgid "" +"Return ``1`` if the string is a valid identifier according to the language " +"definition, section :ref:`identifiers`. Return ``0`` otherwise." +msgstr "" + +msgid "" +"The function does not call :c:func:`Py_FatalError` anymore if the string is " +"not ready." +msgstr "" + +msgid "Unicode Character Properties" +msgstr "" + +msgid "" +"Unicode provides many different character properties. The most often needed " +"ones are available through these macros which are mapped to C functions " +"depending on the Python configuration." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is a whitespace character." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is a lowercase character." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is an uppercase character." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is a titlecase character." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is a linebreak character." +msgstr "" + +msgid "Return ``1`` or ``0`` depending on whether *ch* is a decimal character." +msgstr "" + +msgid "Return ``1`` or ``0`` depending on whether *ch* is a digit character." +msgstr "" + +msgid "Return ``1`` or ``0`` depending on whether *ch* is a numeric character." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is an alphabetic character." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is an alphanumeric character." +msgstr "" + +msgid "" +"Return ``1`` or ``0`` depending on whether *ch* is a printable character. " +"Nonprintable characters are those characters defined in the Unicode " +"character database as \"Other\" or \"Separator\", excepting the ASCII space " +"(0x20) which is considered printable. (Note that printable characters in " +"this context are those which should not be escaped when :func:`repr` is " +"invoked on a string. It has no bearing on the handling of strings written " +"to :data:`sys.stdout` or :data:`sys.stderr`.)" +msgstr "" + +msgid "These APIs can be used for fast direct character conversions:" +msgstr "" + +msgid "Return the character *ch* converted to lower case." +msgstr "" + +msgid "This function uses simple case mappings." +msgstr "" + +msgid "Return the character *ch* converted to upper case." +msgstr "" + +msgid "Return the character *ch* converted to title case." +msgstr "" + +msgid "" +"Return the character *ch* converted to a decimal positive integer. Return " +"``-1`` if this is not possible. This macro does not raise exceptions." +msgstr "" + +msgid "" +"Return the character *ch* converted to a single digit integer. Return ``-1`` " +"if this is not possible. This macro does not raise exceptions." +msgstr "" + +msgid "" +"Return the character *ch* converted to a double. Return ``-1.0`` if this is " +"not possible. This macro does not raise exceptions." +msgstr "" + +msgid "These APIs can be used to work with surrogates:" +msgstr "" + +msgid "Check if *ch* is a surrogate (``0xD800 <= ch <= 0xDFFF``)." +msgstr "" + +msgid "Check if *ch* is a high surrogate (``0xD800 <= ch <= 0xDBFF``)." +msgstr "" + +msgid "Check if *ch* is a low surrogate (``0xDC00 <= ch <= 0xDFFF``)." +msgstr "" + +msgid "" +"Join two surrogate characters and return a single Py_UCS4 value. *high* and " +"*low* are respectively the leading and trailing surrogates in a surrogate " +"pair." +msgstr "" + +msgid "Creating and accessing Unicode strings" +msgstr "" + +msgid "" +"To create Unicode objects and access their basic sequence properties, use " +"these APIs:" +msgstr "" + +msgid "" +"Create a new Unicode object. *maxchar* should be the true maximum code " +"point to be placed in the string. As an approximation, it can be rounded up " +"to the nearest value in the sequence 127, 255, 65535, 1114111." +msgstr "" + +msgid "" +"This is the recommended way to allocate a new Unicode object. Objects " +"created using this function are not resizable." +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." +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`)." +msgstr "" + +msgid "" +"Create a Unicode object from the char buffer *str*. The bytes will be " +"interpreted as being UTF-8 encoded. The buffer is copied into the new " +"object. If the buffer is not ``NULL``, the return value might be a shared " +"object, i.e. modification of the data is not allowed." +msgstr "" + +msgid "" +"If *str* is ``NULL``, this function behaves like :c:func:" +"`PyUnicode_FromUnicode` with the buffer set to ``NULL``. This usage is " +"deprecated in favor of :c:func:`PyUnicode_New`, and will be removed in " +"Python 3.12." +msgstr "" + +msgid "" +"Create a Unicode object from a UTF-8 encoded null-terminated char buffer " +"*str*." +msgstr "" + +msgid "" +"Take a C :c:func:`printf`\\ -style *format* string and a variable number of " +"arguments, calculate the size of the resulting Python Unicode string and " +"return a string with the values formatted into it. The variable arguments " +"must be C types and must correspond exactly to the format characters in the " +"*format* ASCII-encoded string. The following format characters are allowed:" +msgstr "" + +msgid "Format Characters" +msgstr "" + +msgid "Type" +msgstr "Typ" + +msgid "Comment" +msgstr "komentarz" + +msgid ":attr:`%%`" +msgstr "" + +msgid "*n/a*" +msgstr "*n/a*" + +msgid "The literal % character." +msgstr "" + +msgid ":attr:`%c`" +msgstr "" + +msgid "int" +msgstr "int" + +msgid "A single character, represented as a C int." +msgstr "" + +msgid ":attr:`%d`" +msgstr "" + +msgid "Equivalent to ``printf(\"%d\")``. [1]_" +msgstr "" + +msgid ":attr:`%u`" +msgstr "" + +msgid "unsigned int" +msgstr "nieoznaczony typ int" + +msgid "Equivalent to ``printf(\"%u\")``. [1]_" +msgstr "" + +msgid ":attr:`%ld`" +msgstr "" + +msgid "long" +msgstr "" + +msgid "Equivalent to ``printf(\"%ld\")``. [1]_" +msgstr "" + +msgid ":attr:`%li`" +msgstr "" + +msgid "Equivalent to ``printf(\"%li\")``. [1]_" +msgstr "" + +msgid ":attr:`%lu`" +msgstr "" + +msgid "unsigned long" +msgstr "nieoznaczony typ długi" + +msgid "Equivalent to ``printf(\"%lu\")``. [1]_" +msgstr "" + +msgid ":attr:`%lld`" +msgstr "" + +msgid "long long" +msgstr "" + +msgid "Equivalent to ``printf(\"%lld\")``. [1]_" +msgstr "" + +msgid ":attr:`%lli`" +msgstr "" + +msgid "Equivalent to ``printf(\"%lli\")``. [1]_" +msgstr "" + +msgid ":attr:`%llu`" +msgstr "" + +msgid "unsigned long long" +msgstr "" + +msgid "Equivalent to ``printf(\"%llu\")``. [1]_" +msgstr "" + +msgid ":attr:`%zd`" +msgstr "" + +msgid ":c:type:`\\ Py_ssize_t`" +msgstr "" + +msgid "Equivalent to ``printf(\"%zd\")``. [1]_" +msgstr "" + +msgid ":attr:`%zi`" +msgstr "" + +msgid "Equivalent to ``printf(\"%zi\")``. [1]_" +msgstr "" + +msgid ":attr:`%zu`" +msgstr "" + +msgid "size_t" +msgstr "size_t" + +msgid "Equivalent to ``printf(\"%zu\")``. [1]_" +msgstr "" + +msgid ":attr:`%i`" +msgstr "" + +msgid "Equivalent to ``printf(\"%i\")``. [1]_" +msgstr "" + +msgid ":attr:`%x`" +msgstr "" + +msgid "Equivalent to ``printf(\"%x\")``. [1]_" +msgstr "" + +msgid ":attr:`%s`" +msgstr "" + +msgid "const char\\*" +msgstr "" + +msgid "A null-terminated C character array." +msgstr "" + +msgid ":attr:`%p`" +msgstr "" + +msgid "const void\\*" +msgstr "" + +msgid "" +"The hex representation of a C pointer. Mostly equivalent to " +"``printf(\"%p\")`` except that it is guaranteed to start with the literal " +"``0x`` regardless of what the platform's ``printf`` yields." +msgstr "" + +msgid ":attr:`%A`" +msgstr "" + +msgid "PyObject\\*" +msgstr "" + +msgid "The result of calling :func:`ascii`." +msgstr "" + +msgid ":attr:`%U`" +msgstr "" + +msgid "A Unicode object." +msgstr "" + +msgid ":attr:`%V`" +msgstr "" + +msgid "PyObject\\*, const char\\*" +msgstr "" + +msgid "" +"A Unicode object (which may be ``NULL``) and a null-terminated C character " +"array as a second parameter (which will be used, if the first parameter is " +"``NULL``)." +msgstr "" + +msgid ":attr:`%S`" +msgstr "" + +msgid "The result of calling :c:func:`PyObject_Str`." +msgstr "" + +msgid ":attr:`%R`" +msgstr "" + +msgid "The result of calling :c:func:`PyObject_Repr`." +msgstr "" + +msgid "" +"An unrecognized format character causes all the rest of the format string to " +"be copied as-is to the result string, and any extra arguments discarded." +msgstr "" + +msgid "" +"The width formatter unit is number of characters rather than bytes. The " +"precision formatter unit is number of bytes for ``\"%s\"`` and ``\"%V\"`` " +"(if the ``PyObject*`` argument is ``NULL``), and a number of characters for " +"``\"%A\"``, ``\"%U\"``, ``\"%S\"``, ``\"%R\"`` and ``\"%V\"`` (if the " +"``PyObject*`` argument is not ``NULL``)." +msgstr "" + +msgid "" +"For integer specifiers (d, u, ld, li, lu, lld, lli, llu, zd, zi, zu, i, x): " +"the 0-conversion flag has effect even when a precision is given." +msgstr "" + +msgid "Support for ``\"%lld\"`` and ``\"%llu\"`` added." +msgstr "" + +msgid "Support for ``\"%li\"``, ``\"%lli\"`` and ``\"%zi\"`` added." +msgstr "" + +msgid "" +"Support width and precision formatter for ``\"%s\"``, ``\"%A\"``, " +"``\"%U\"``, ``\"%V\"``, ``\"%S\"``, ``\"%R\"`` added." +msgstr "" + +msgid "" +"Identical to :c:func:`PyUnicode_FromFormat` except that it takes exactly two " +"arguments." +msgstr "" + +msgid "" +"Copy an instance of a Unicode subtype to a new true Unicode object if " +"necessary. If *obj* is already a true Unicode object (not a subtype), return " +"a new :term:`strong reference` to the object." +msgstr "" + +msgid "" +"Objects other than Unicode or its subtypes will cause a :exc:`TypeError`." +msgstr "" + +msgid "Decode an encoded object *obj* to a Unicode object." +msgstr "" + +msgid "" +":class:`bytes`, :class:`bytearray` and other :term:`bytes-like objects " +"` are decoded according to the given *encoding* and using " +"the error handling defined by *errors*. Both can be ``NULL`` to have the " +"interface use the default values (see :ref:`builtincodecs` for details)." +msgstr "" + +msgid "" +"All other objects, including Unicode objects, cause a :exc:`TypeError` to be " +"set." +msgstr "" + +msgid "" +"The API returns ``NULL`` if there was an error. The caller is responsible " +"for decref'ing the returned objects." +msgstr "" + +msgid "Return the length of the Unicode object, in code points." +msgstr "" + +msgid "" +"Copy characters from one Unicode object into another. This function " +"performs character conversion when necessary and falls back to :c:func:`!" +"memcpy` if possible. Returns ``-1`` and sets an exception on error, " +"otherwise returns the number of copied characters." +msgstr "" + +msgid "" +"Fill a string with a character: write *fill_char* into ``unicode[start:" +"start+length]``." +msgstr "" + +msgid "" +"Fail if *fill_char* is bigger than the string maximum character, or if the " +"string has more than 1 reference." +msgstr "" + +msgid "" +"Return the number of written character, or return ``-1`` and raise an " +"exception on error." +msgstr "" + +msgid "" +"Write a character to a string. The string must have been created through :c:" +"func:`PyUnicode_New`. Since Unicode strings are supposed to be immutable, " +"the string must not be shared, or have been hashed yet." +msgstr "" + +msgid "" +"This function checks that *unicode* is a Unicode object, that the index is " +"not out of bounds, and that the object can be modified safely (i.e. that it " +"its reference count is one)." +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." +msgstr "" + +msgid "" +"Return a substring of *unicode*, from character index *start* (included) to " +"character index *end* (excluded). Negative indices are not supported." +msgstr "" + +msgid "" +"Copy the string *unicode* into a UCS4 buffer, including a null character, if " +"*copy_null* is set. Returns ``NULL`` and sets an exception on error (in " +"particular, a :exc:`SystemError` if *buflen* is smaller than the length of " +"*unicode*). *buffer* is returned on success." +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." +msgstr "" + +msgid "Deprecated Py_UNICODE APIs" +msgstr "" + +msgid "" +"These API functions are deprecated with the implementation of :pep:`393`. " +"Extension modules can continue using them, as they will not be removed in " +"Python 3.x, but need to be aware that their use can now cause performance " +"and memory hits." +msgstr "" + +msgid "" +"Create a Unicode object from the Py_UNICODE buffer *u* of the given size. " +"*u* may be ``NULL`` which causes the contents to be undefined. It is the " +"user's responsibility to fill in the needed data. The buffer is copied into " +"the new object." +msgstr "" + +msgid "" +"If the buffer is not ``NULL``, the return value might be a shared object. " +"Therefore, modification of the resulting Unicode object is only allowed when " +"*u* is ``NULL``." +msgstr "" + +msgid "" +"If the buffer is ``NULL``, :c:func:`PyUnicode_READY` must be called once the " +"string content has been filled before using any of the access macros such " +"as :c:func:`PyUnicode_KIND`." +msgstr "" + +msgid "" +"Part of the old-style Unicode API, please migrate to using :c:func:" +"`PyUnicode_FromKindAndData`, :c:func:`PyUnicode_FromWideChar`, or :c:func:" +"`PyUnicode_New`." +msgstr "" + +msgid "" +"Return a read-only pointer to the Unicode object's internal :c:type:" +"`Py_UNICODE` buffer, or ``NULL`` on error. This will create the :c:expr:" +"`Py_UNICODE*` representation of the object if it is not yet available. The " +"buffer is always terminated with an extra null code point. Note that the " +"resulting :c:type:`Py_UNICODE` string may also contain embedded null code " +"points, which would cause the string to be truncated when used in most C " +"functions." +msgstr "" + +msgid "" +"Part of the old-style Unicode API, please migrate to using :c:func:" +"`PyUnicode_AsUCS4`, :c:func:`PyUnicode_AsWideChar`, :c:func:" +"`PyUnicode_ReadChar` or similar new APIs." +msgstr "" + +msgid "" +"Like :c:func:`PyUnicode_AsUnicode`, but also saves the :c:func:`Py_UNICODE` " +"array length (excluding the extra null terminator) in *size*. Note that the " +"resulting :c:expr:`Py_UNICODE*` string may contain embedded null code " +"points, which would cause the string to be truncated when used in most C " +"functions." +msgstr "" + +msgid "" +"Return the size of the deprecated :c:type:`Py_UNICODE` representation, in " +"code units (this includes surrogate pairs as 2 units)." +msgstr "" + +msgid "Locale Encoding" +msgstr "" + +msgid "" +"The current locale encoding can be used to decode text from the operating " +"system." +msgstr "" + +msgid "" +"Decode a string from UTF-8 on Android and VxWorks, or from the current " +"locale encoding on other platforms. The supported error handlers are " +"``\"strict\"`` and ``\"surrogateescape\"`` (:pep:`383`). The decoder uses " +"``\"strict\"`` error handler if *errors* is ``NULL``. *str* must end with a " +"null character but cannot contain embedded null characters." +msgstr "" + +msgid "" +"Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` to decode a string from :c:" +"data:`Py_FileSystemDefaultEncoding` (the locale encoding read at Python " +"startup)." +msgstr "" + +msgid "This function ignores the :ref:`Python UTF-8 Mode `." +msgstr "" + +msgid "The :c:func:`Py_DecodeLocale` function." +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``." +msgstr "" + +msgid "" +"Similar to :c:func:`PyUnicode_DecodeLocaleAndSize`, but compute the string " +"length using :c:func:`!strlen`." +msgstr "" + +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." +msgstr "" + +msgid "" +"Use :c:func:`PyUnicode_EncodeFSDefault` to encode a string to :c:data:" +"`Py_FileSystemDefaultEncoding` (the locale encoding read at Python startup)." +msgstr "" + +msgid "The :c:func:`Py_EncodeLocale` function." +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``." +msgstr "" + +msgid "File System Encoding" +msgstr "" + +msgid "" +"To encode and decode file names and other environment strings, :c:data:" +"`Py_FileSystemDefaultEncoding` should be used as the encoding, and :c:data:" +"`Py_FileSystemDefaultEncodeErrors` should be used as the error handler (:pep:" +"`383` and :pep:`529`). To encode file names to :class:`bytes` during " +"argument parsing, the ``\"O&\"`` converter should be used, passing :c:func:" +"`PyUnicode_FSConverter` as the conversion function:" +msgstr "" + +msgid "" +"ParseTuple converter: encode :class:`str` objects -- 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 a :c:expr:`PyBytesObject*` which must be released when it " +"is no longer used." +msgstr "" + +msgid "Accepts a :term:`path-like object`." +msgstr "" + +msgid "" +"To decode file names to :class:`str` during argument parsing, the ``\"O&\"`` " +"converter should be used, passing :c:func:`PyUnicode_FSDecoder` as the " +"conversion function:" +msgstr "" + +msgid "" +"ParseTuple 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 a :c:expr:`PyUnicodeObject*` " +"which must be released when it is no longer used." +msgstr "" + +msgid "Decode a string from the :term:`filesystem encoding and error handler`." +msgstr "" + +msgid "" +"If :c:data:`Py_FileSystemDefaultEncoding` is not set, fall back to the " +"locale encoding." +msgstr "" + +msgid "" +":c:data:`Py_FileSystemDefaultEncoding` is initialized at startup from the " +"locale encoding and cannot be modified later. If you need to decode a string " +"from the current locale encoding, use :c:func:" +"`PyUnicode_DecodeLocaleAndSize`." +msgstr "" + +msgid "Use :c:data:`Py_FileSystemDefaultEncodeErrors` error handler." +msgstr "" + +msgid "" +"Decode a null-terminated string from the :term:`filesystem encoding and " +"error handler`." +msgstr "" + +msgid "" +"Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` if you know the string length." +msgstr "" + +msgid "" +"Encode a Unicode object to :c:data:`Py_FileSystemDefaultEncoding` with the :" +"c:data:`Py_FileSystemDefaultEncodeErrors` error handler, and return :class:" +"`bytes`. Note that the resulting :class:`bytes` object may contain null " +"bytes." +msgstr "" + +msgid "" +":c:data:`Py_FileSystemDefaultEncoding` is initialized at startup from the " +"locale encoding and cannot be modified later. If you need to encode a string " +"to the current locale encoding, use :c:func:`PyUnicode_EncodeLocale`." +msgstr "" + +msgid "wchar_t Support" +msgstr "" + +msgid ":c:type:`wchar_t` support for platforms which support it:" +msgstr "" + +msgid "" +"Create a Unicode object from the :c:type:`wchar_t` buffer *wstr* of the " +"given *size*. Passing ``-1`` as the *size* indicates that the function must " +"itself compute the length, using :c:func:`!wcslen`. Return ``NULL`` on " +"failure." +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." +msgstr "" + +msgid "" +"When *wstr* is ``NULL``, instead return the *size* that would be required to " +"store all of *unicode* including a terminating null." +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 " +"null characters, which would cause the string to be truncated when used with " +"most C functions." +msgstr "" + +msgid "" +"Convert the Unicode object to a wide character string. The output string " +"always ends with a null character. If *size* is not ``NULL``, write the " +"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." +msgstr "" + +msgid "" +"Returns a buffer allocated by :c:macro:`PyMem_New` (use :c:func:`PyMem_Free` " +"to free it) on success. On error, returns ``NULL`` and *\\*size* is " +"undefined. Raises a :exc:`MemoryError` if memory allocation is failed." +msgstr "" + +msgid "" +"Raises a :exc:`ValueError` if *size* is ``NULL`` and the :c:expr:`wchar_t*` " +"string contains null characters." +msgstr "" + +msgid "Built-in Codecs" +msgstr "" + +msgid "" +"Python provides a set of built-in codecs which are written in C for speed. " +"All of these codecs are directly usable via the following functions." +msgstr "" + +msgid "" +"Many of the following APIs take two arguments encoding and errors, and they " +"have the same semantics as the ones of the built-in :func:`str` string " +"object constructor." +msgstr "" + +msgid "" +"Setting encoding to ``NULL`` causes the default encoding to be used which is " +"UTF-8. The file system calls should use :c:func:`PyUnicode_FSConverter` for " +"encoding file names. This uses the variable :c:data:" +"`Py_FileSystemDefaultEncoding` internally. This variable should be treated " +"as read-only: on some systems, it will be a pointer to a static string, on " +"others, it will change at run-time (such as when the application invokes " +"setlocale)." +msgstr "" + +msgid "" +"Error handling is set by errors which may also be set to ``NULL`` meaning to " +"use the default handling defined for the codec. Default error handling for " +"all built-in codecs is \"strict\" (:exc:`ValueError` is raised)." +msgstr "" + +msgid "" +"The codecs all use a similar interface. Only deviations from the following " +"generic ones are documented for simplicity." +msgstr "" + +msgid "Generic Codecs" +msgstr "" + +msgid "These are the generic codec APIs:" +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the encoded string " +"*str*. *encoding* and *errors* have the same meaning as the parameters of " +"the same name in the :func:`str` built-in function. The codec to be used is " +"looked up using the Python codec registry. Return ``NULL`` if an exception " +"was raised by the codec." +msgstr "" + +msgid "" +"Encode a Unicode object and return the result as Python bytes object. " +"*encoding* and *errors* have the same meaning as the parameters of the same " +"name in the Unicode :meth:`~str.encode` method. The codec to be used is " +"looked up using the Python codec registry. Return ``NULL`` if an exception " +"was raised by the codec." +msgstr "" + +msgid "UTF-8 Codecs" +msgstr "" + +msgid "These are the UTF-8 codec APIs:" +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the UTF-8 encoded string " +"*str*. Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "" +"If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF8`. If " +"*consumed* is not ``NULL``, trailing incomplete UTF-8 byte sequences will " +"not be treated as an error. Those bytes will not be decoded and the number " +"of bytes that have been decoded will be stored in *consumed*." +msgstr "" + +msgid "" +"Encode a Unicode object using UTF-8 and return the result as Python bytes " +"object. Error handling is \"strict\". Return ``NULL`` if an exception was " +"raised by the codec." +msgstr "" + +msgid "" +"Return a pointer to the UTF-8 encoding of the Unicode object, and store the " +"size of the encoded representation (in bytes) in *size*. The *size* " +"argument can be ``NULL``; in this case no size will be stored. The returned " +"buffer always has an extra null byte appended (not included in *size*), " +"regardless of whether there are any other null code points." +msgstr "" + +msgid "" +"In the case of an error, ``NULL`` is returned with an exception set and no " +"*size* is stored." +msgstr "" + +msgid "" +"This caches the UTF-8 representation of the string in the Unicode object, " +"and subsequent calls will return a pointer to the same buffer. The caller " +"is not responsible for deallocating the buffer. The buffer is deallocated " +"and pointers to it become invalid when the Unicode object is garbage " +"collected." +msgstr "" + +msgid "The return type is now ``const char *`` rather of ``char *``." +msgstr "" + +msgid "This function is a part of the :ref:`limited API `." +msgstr "" + +msgid "As :c:func:`PyUnicode_AsUTF8AndSize`, but does not store the size." +msgstr "" + +msgid "UTF-32 Codecs" +msgstr "" + +msgid "These are the UTF-32 codec APIs:" +msgstr "" + +msgid "" +"Decode *size* bytes from a UTF-32 encoded buffer string and return the " +"corresponding Unicode object. *errors* (if non-``NULL``) defines the error " +"handling. It defaults to \"strict\"." +msgstr "" + +msgid "" +"If *byteorder* is non-``NULL``, the decoder starts decoding using the given " +"byte order::" +msgstr "" + +msgid "" +"If ``*byteorder`` is zero, and the first four bytes of the input data are a " +"byte order mark (BOM), the decoder switches to this byte order and the BOM " +"is not copied into the resulting Unicode string. If ``*byteorder`` is " +"``-1`` or ``1``, any byte order mark is copied to the output." +msgstr "" + +msgid "" +"After completion, *\\*byteorder* is set to the current byte order at the end " +"of input data." +msgstr "" + +msgid "If *byteorder* is ``NULL``, the codec starts in native order mode." +msgstr "" + +msgid "Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "" +"If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF32`. If " +"*consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeUTF32Stateful` will not " +"treat trailing incomplete UTF-32 byte sequences (such as a number of bytes " +"not divisible by four) as an error. Those bytes will not be decoded and the " +"number of bytes that have been decoded will be stored in *consumed*." +msgstr "" + +msgid "" +"Return a Python byte string using the UTF-32 encoding in native byte order. " +"The string always starts with a BOM mark. Error handling is \"strict\". " +"Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "UTF-16 Codecs" +msgstr "" + +msgid "These are the UTF-16 codec APIs:" +msgstr "" + +msgid "" +"Decode *size* bytes from a UTF-16 encoded buffer string and return the " +"corresponding Unicode object. *errors* (if non-``NULL``) defines the error " +"handling. It defaults to \"strict\"." +msgstr "" + +msgid "" +"If ``*byteorder`` is zero, and the first two bytes of the input data are a " +"byte order mark (BOM), the decoder switches to this byte order and the BOM " +"is not copied into the resulting Unicode string. If ``*byteorder`` is " +"``-1`` or ``1``, any byte order mark is copied to the output (where it will " +"result in either a ``\\ufeff`` or a ``\\ufffe`` character)." +msgstr "" + +msgid "" +"After completion, ``*byteorder`` is set to the current byte order at the end " +"of input data." +msgstr "" + +msgid "" +"If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF16`. If " +"*consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeUTF16Stateful` will not " +"treat trailing incomplete UTF-16 byte sequences (such as an odd number of " +"bytes or a split surrogate pair) as an error. Those bytes will not be " +"decoded and the number of bytes that have been decoded will be stored in " +"*consumed*." +msgstr "" + +msgid "" +"Return a Python byte string using the UTF-16 encoding in native byte order. " +"The string always starts with a BOM mark. Error handling is \"strict\". " +"Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "UTF-7 Codecs" +msgstr "" + +msgid "These are the UTF-7 codec APIs:" +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the UTF-7 encoded string " +"*str*. Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "" +"If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeUTF7`. If " +"*consumed* is not ``NULL``, trailing incomplete UTF-7 base-64 sections will " +"not be treated as an error. Those bytes will not be decoded and the number " +"of bytes that have been decoded will be stored in *consumed*." +msgstr "" + +msgid "Unicode-Escape Codecs" +msgstr "" + +msgid "These are the \"Unicode Escape\" codec APIs:" +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the Unicode-Escape " +"encoded string *str*. Return ``NULL`` if an exception was raised by the " +"codec." +msgstr "" + +msgid "" +"Encode a Unicode object using Unicode-Escape and return the result as a " +"bytes object. Error handling is \"strict\". Return ``NULL`` if an " +"exception was raised by the codec." +msgstr "" + +msgid "Raw-Unicode-Escape Codecs" +msgstr "" + +msgid "These are the \"Raw Unicode Escape\" codec APIs:" +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the Raw-Unicode-Escape " +"encoded string *str*. Return ``NULL`` if an exception was raised by the " +"codec." +msgstr "" + +msgid "" +"Encode a Unicode object using Raw-Unicode-Escape and return the result as a " +"bytes object. Error handling is \"strict\". Return ``NULL`` if an " +"exception was raised by the codec." +msgstr "" + +msgid "Latin-1 Codecs" +msgstr "" + +msgid "" +"These are the Latin-1 codec APIs: Latin-1 corresponds to the first 256 " +"Unicode ordinals and only these are accepted by the codecs during encoding." +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the Latin-1 encoded " +"string *str*. Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "" +"Encode a Unicode object using Latin-1 and return the result as Python bytes " +"object. Error handling is \"strict\". Return ``NULL`` if an exception was " +"raised by the codec." +msgstr "" + +msgid "ASCII Codecs" +msgstr "" + +msgid "" +"These are the ASCII codec APIs. Only 7-bit ASCII data is accepted. All " +"other codes generate errors." +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the ASCII encoded string " +"*str*. Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "" +"Encode a Unicode object using ASCII and return the result as Python bytes " +"object. Error handling is \"strict\". Return ``NULL`` if an exception was " +"raised by the codec." +msgstr "" + +msgid "Character Map Codecs" +msgstr "" + +msgid "" +"This codec is special in that it can be used to implement many different " +"codecs (and this is in fact what was done to obtain most of the standard " +"codecs included in the :mod:`!encodings` package). The codec uses mappings " +"to encode and decode characters. The mapping objects provided must support " +"the :meth:`~object.__getitem__` mapping interface; dictionaries and " +"sequences work well." +msgstr "" + +msgid "These are the mapping codec APIs:" +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the encoded string *str* " +"using the given *mapping* object. Return ``NULL`` if an exception was " +"raised by the codec." +msgstr "" + +msgid "" +"If *mapping* is ``NULL``, Latin-1 decoding will be applied. Else *mapping* " +"must map bytes ordinals (integers in the range from 0 to 255) to Unicode " +"strings, integers (which are then interpreted as Unicode ordinals) or " +"``None``. Unmapped data bytes -- ones which cause a :exc:`LookupError`, as " +"well as ones which get mapped to ``None``, ``0xFFFE`` or ``'\\ufffe'``, are " +"treated as undefined mappings and cause an error." +msgstr "" + +msgid "" +"Encode a Unicode object using the given *mapping* object and return the " +"result as a bytes object. Error handling is \"strict\". Return ``NULL`` if " +"an exception was raised by the codec." +msgstr "" + +msgid "" +"The *mapping* object must map Unicode ordinal integers to bytes objects, " +"integers in the range from 0 to 255 or ``None``. Unmapped character " +"ordinals (ones which cause a :exc:`LookupError`) as well as mapped to " +"``None`` are treated as \"undefined mapping\" and cause an error." +msgstr "" + +msgid "The following codec API is special in that maps Unicode to Unicode." +msgstr "" + +msgid "" +"Translate a string by applying a character mapping table to it and return " +"the resulting Unicode object. Return ``NULL`` if an exception was raised by " +"the codec." +msgstr "" + +msgid "" +"The mapping table must map Unicode ordinal integers to Unicode ordinal " +"integers or ``None`` (causing deletion of the character)." +msgstr "" + +msgid "" +"Mapping tables need only provide the :meth:`~object.__getitem__` interface; " +"dictionaries and sequences work well. Unmapped character ordinals (ones " +"which cause a :exc:`LookupError`) are left untouched and are copied as-is." +msgstr "" + +msgid "" +"*errors* has the usual meaning for codecs. It may be ``NULL`` which " +"indicates to use the default error handling." +msgstr "" + +msgid "MBCS codecs for Windows" +msgstr "" + +msgid "" +"These are the MBCS codec APIs. They are currently only available on Windows " +"and use the Win32 MBCS converters to implement the conversions. Note that " +"MBCS (or DBCS) is a class of encodings, not just one. The target encoding " +"is defined by the user settings on the machine running the codec." +msgstr "" + +msgid "" +"Create a Unicode object by decoding *size* bytes of the MBCS encoded string " +"*str*. Return ``NULL`` if an exception was raised by the codec." +msgstr "" + +msgid "" +"If *consumed* is ``NULL``, behave like :c:func:`PyUnicode_DecodeMBCS`. If " +"*consumed* is not ``NULL``, :c:func:`PyUnicode_DecodeMBCSStateful` will not " +"decode trailing lead byte and the number of bytes that have been decoded " +"will be stored in *consumed*." +msgstr "" + +msgid "" +"Encode a Unicode object using MBCS and return the result as Python bytes " +"object. Error handling is \"strict\". Return ``NULL`` if an exception was " +"raised by the codec." +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." +msgstr "" + +msgid "Methods & Slots" +msgstr "" + +msgid "Methods and Slot Functions" +msgstr "" + +msgid "" +"The following APIs are capable of handling Unicode objects and strings on " +"input (we refer to them as strings in the descriptions) and return Unicode " +"objects or integers as appropriate." +msgstr "" + +msgid "They all return ``NULL`` or ``-1`` if an exception occurs." +msgstr "" + +msgid "Concat two strings giving a new Unicode string." +msgstr "" + +msgid "" +"Split a string giving a list of Unicode strings. If *sep* is ``NULL``, " +"splitting will be done at all whitespace substrings. Otherwise, splits " +"occur at the given separator. At most *maxsplit* splits will be done. If " +"negative, no limit is set. Separators are not included in the resulting " +"list." +msgstr "" + +msgid "" +"Split a Unicode string at line breaks, returning a list of Unicode strings. " +"CRLF is considered to be one line break. If *keepends* is ``0``, the Line " +"break characters are not included in the resulting strings." +msgstr "" + +msgid "" +"Join a sequence of strings using the given *separator* and return the " +"resulting Unicode string." +msgstr "" + +msgid "" +"Return ``1`` if *substr* matches ``unicode[start:end]`` at the given tail " +"end (*direction* == ``-1`` means to do a prefix match, *direction* == ``1`` " +"a suffix match), ``0`` otherwise. Return ``-1`` if an error occurred." +msgstr "" + +msgid "" +"Return the first position of *substr* in ``unicode[start:end]`` using the " +"given *direction* (*direction* == ``1`` means to do a forward search, " +"*direction* == ``-1`` a backward search). The return value is the index of " +"the first match; a value of ``-1`` indicates that no match was found, and " +"``-2`` indicates that an error occurred and an exception has been set." +msgstr "" + +msgid "" +"Return the first position of the character *ch* in ``unicode[start:end]`` " +"using the given *direction* (*direction* == ``1`` means to do a forward " +"search, *direction* == ``-1`` a backward search). The return value is the " +"index of the first match; a value of ``-1`` indicates that no match was " +"found, and ``-2`` indicates that an error occurred and an exception has been " +"set." +msgstr "" + +msgid "" +"*start* and *end* are now adjusted to behave like ``unicode[start:end]``." +msgstr "" + +msgid "" +"Return the number of non-overlapping occurrences of *substr* in " +"``unicode[start:end]``. Return ``-1`` if an error occurred." +msgstr "" + +msgid "" +"Replace at most *maxcount* occurrences of *substr* in *unicode* with " +"*replstr* and return the resulting Unicode object. *maxcount* == ``-1`` " +"means replace all occurrences." +msgstr "" + +msgid "" +"Compare two strings and return ``-1``, ``0``, ``1`` for less than, equal, " +"and greater than, respectively." +msgstr "" + +msgid "" +"This function returns ``-1`` upon failure, so one should call :c:func:" +"`PyErr_Occurred` to check for errors." +msgstr "" + +msgid "" +"Compare a Unicode object, *unicode*, with *string* and return ``-1``, ``0``, " +"``1`` for less than, equal, and greater than, respectively. It is best to " +"pass only ASCII-encoded strings, but the function interprets the input " +"string as ISO-8859-1 if it contains non-ASCII characters." +msgstr "" + +msgid "This function does not raise exceptions." +msgstr "" + +msgid "Rich compare two Unicode strings and return one of the following:" +msgstr "" + +msgid "``NULL`` in case an exception was raised" +msgstr "" + +msgid ":c:data:`Py_True` or :c:data:`Py_False` for successful comparisons" +msgstr "" + +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`." +msgstr "" + +msgid "" +"Return a new string object from *format* and *args*; this is analogous to " +"``format % args``." +msgstr "" + +msgid "" +"Check whether *substr* is contained in *unicode* and return true or false " +"accordingly." +msgstr "" + +msgid "" +"*substr* has to coerce to a one element Unicode string. ``-1`` is returned " +"if there was an error." +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 (creating a new :term:`strong reference`). (Clarification: even " +"though there is a lot of talk about references, think of this function as " +"reference-neutral; you own the object after the call if and only if you " +"owned it before the call.)" +msgstr "" + +msgid "" +"A combination of :c:func:`PyUnicode_FromString` and :c:func:" +"`PyUnicode_InternInPlace`, returning either a new Unicode string object that " +"has been interned, or a new (\"owned\") reference to an earlier interned " +"string object with the same value." +msgstr "" diff --git a/contents.po b/contents.po index b6a3a75581..90df5f85c6 100644 --- a/contents.po +++ b/contents.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/copyright.po b/copyright.po index 025e60d782..919b556d7f 100644 --- a/copyright.po +++ b/copyright.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distributing/index.po b/distributing/index.po index 2bf79c24af..9347838dfd 100644 --- a/distributing/index.po +++ b/distributing/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Krzysztof Wierzbicki , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Krzysztof Wierzbicki , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,223 +26,11 @@ msgstr "" msgid "Distributing Python Modules" msgstr "Dystrybucja modułów Pythona" -msgid "Email" -msgstr "Email" - -msgid "distutils-sig@python.org" -msgstr "distutils-sig@python.org" - -msgid "" -"As a popular open source development project, Python has an active " -"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 " -"from the solutions others have already created to common (and sometimes even " -"rare!) problems, as well as potentially contributing their own solutions to " -"the common pool." -msgstr "" -"Dzięki temu użytkownicy Pythona mogą efektywnie korzystać się i " -"współpracować korzystając z rozwiązań stworzonych wcześniej w odpowiedzi na " -"popularne problemy (a czasami bardzo rzadkie!), oraz udostępniać własne " -"rozwiązania całej społeczności." - -msgid "" -"This guide covers the distribution part of the process. For a guide to " -"installing other Python projects, refer to the :ref:`installation guide " -"`." -msgstr "" -"Ta część przewodnika dotyczy procesu dystrybucji. O instalowaniu innych " -"projektów Pythona przeczytasz więcej w :ref:`przewodniku instalacji " -"`." - -msgid "" -"For corporate and other institutional users, be aware that many " -"organisations have their own policies around using and contributing to open " -"source software. Please take such policies into account when making use of " -"the distribution and installation tools provided with Python." -msgstr "" -"Użytkownicy związani z korporacjami i innymi instytucjami powinni zwrócić " -"uwagę, że wiele organizacji ma własne zasady dotyczące korzystania z " -"oprogramowania i udziału w projektach open source. Należy brać takie zasady " -"pod uwagę korzystając z narzędzi instalacyjnych i dystrybucyjnych Pythona." - -msgid "Key terms" -msgstr "Główne pojęcia" - -msgid "" -"the `Python Package Index `__ is a public repository of " -"open source licensed packages made available for use by other Python users" -msgstr "" - -msgid "" -"the `Python Packaging Authority `__ are the group of " -"developers and documentation authors responsible for the maintenance and " -"evolution of the standard packaging tools and the associated metadata and " -"file format standards. They maintain a variety of tools, documentation and " -"issue trackers on both `GitHub `__ and `Bitbucket " -"`__." -msgstr "" - -msgid "" -":mod:`distutils` is the original build and distribution system first added " -"to the Python standard library in 1998. While direct use of :mod:`distutils` " -"is being phased out, it still laid the foundation for the current packaging " -"and distribution infrastructure, and it not only remains part of the " -"standard library, but its name lives on in other ways (such as the name of " -"the mailing list used to coordinate Python packaging standards development)." -msgstr "" - -msgid "" -"`setuptools`_ is a (largely) drop-in replacement for :mod:`distutils` first " -"published in 2004. Its most notable addition over the unmodified :mod:" -"`distutils` tools was the ability to declare dependencies on other packages. " -"It is currently recommended as a more regularly updated alternative to :mod:" -"`distutils` that offers consistent support for more recent packaging " -"standards across a wide range of Python versions." -msgstr "" - -msgid "" -"`wheel`_ (in this context) is a project that adds the ``bdist_wheel`` " -"command to :mod:`distutils`/`setuptools`_. This produces a cross platform " -"binary packaging format (called \"wheels\" or \"wheel files\" and defined " -"in :pep:`427`) that allows Python libraries, even those including binary " -"extensions, to be installed on a system without needing to be built locally." -msgstr "" - -msgid "Open source licensing and collaboration" -msgstr "" - -msgid "" -"In most parts of the world, software is automatically covered by copyright. " -"This means that other developers require explicit permission to copy, use, " -"modify and redistribute the software." -msgstr "" - -msgid "" -"Open source licensing is a way of explicitly granting such permission in a " -"relatively consistent way, allowing developers to share and collaborate " -"efficiently by making common solutions to various problems freely available. " -"This leaves many developers free to spend more time focusing on the problems " -"that are relatively unique to their specific situation." -msgstr "" - -msgid "" -"The distribution tools provided with Python are designed to make it " -"reasonably straightforward for developers to make their own contributions " -"back to that common pool of software if they choose to do so." -msgstr "" - -msgid "" -"The same distribution tools can also be used to distribute software within " -"an organisation, regardless of whether that software is published as open " -"source software or not." -msgstr "" - -msgid "Installing the tools" -msgstr "" - -msgid "" -"The standard library does not include build tools that support modern Python " -"packaging standards, as the core development team has found that it is " -"important to have standard tools that work consistently, even on older " -"versions of Python." -msgstr "" - -msgid "" -"The currently recommended build and distribution tools can be installed by " -"invoking the ``pip`` module at the command line::" -msgstr "" - msgid "" -"For POSIX users (including macOS and Linux users), these instructions assume " -"the use of a :term:`virtual environment`." -msgstr "" - -msgid "" -"For Windows users, these instructions assume that the option to adjust the " -"system PATH environment variable was selected when installing Python." -msgstr "" - -msgid "" -"The Python Packaging User Guide includes more details on the `currently " -"recommended tools`_." -msgstr "" - -msgid "Reading the Python Packaging User Guide" -msgstr "" - -msgid "" -"The Python Packaging User Guide covers the various key steps and elements " -"involved in creating and publishing a project:" -msgstr "" - -msgid "`Project structure`_" -msgstr "" - -msgid "`Building and packaging the project`_" -msgstr "" - -msgid "`Uploading the project to the Python Package Index`_" -msgstr "" - -msgid "`The .pypirc file`_" -msgstr "" - -msgid "How do I...?" -msgstr "" - -msgid "These are quick answers or links for some common tasks." -msgstr "" - -msgid "... choose a name for my project?" -msgstr "" - -msgid "This isn't an easy topic, but here are a few tips:" -msgstr "" - -msgid "check the Python Package Index to see if the name is already in use" -msgstr "" - -msgid "" -"check popular hosting sites like GitHub, Bitbucket, etc to see if there is " -"already a project with that name" -msgstr "" - -msgid "check what comes up in a web search for the name you're considering" -msgstr "" - -msgid "" -"avoid particularly common words, especially ones with multiple meanings, as " -"they can make it difficult for users to find your software when searching " -"for it" -msgstr "" - -msgid "... create and distribute binary extensions?" -msgstr "" - -msgid "" -"This is actually quite a complex topic, with a variety of alternatives " -"available depending on exactly what you're aiming to achieve. See the Python " -"Packaging User Guide for more information and recommendations." -msgstr "" - -msgid "" -"`Python Packaging User Guide: Binary Extensions `__" -msgstr "" - -msgid "Python Package Index (PyPI)" -msgstr "" - -msgid "PyPI" -msgstr "" - -msgid "(see Python Package Index (PyPI))" +"Information and guidance on distributing Python modules and packages has " +"been moved to the `Python Packaging User Guide`_, and the tutorial on " +"`packaging Python projects`_." msgstr "" +"Informacje i wskazówki dotyczące dystrybucji moduł Pythona i pakietów " +"zostały przeniesione do `Python Packaging User Guide`_, oraz samouczka " +"`packaging Python projects`_." diff --git a/distutils/_setuptools_disclaimer.po b/distutils/_setuptools_disclaimer.po index b9c6afff56..81f36fe75e 100644 --- a/distutils/_setuptools_disclaimer.po +++ b/distutils/_setuptools_disclaimer.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/builtdist.po b/distutils/builtdist.po index f7a4e691fe..646dc0ef9f 100644 --- a/distutils/builtdist.po +++ b/distutils/builtdist.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/commandref.po b/distutils/commandref.po index 77bbe19914..115f3df6f9 100644 --- a/distutils/commandref.po +++ b/distutils/commandref.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/configfile.po b/distutils/configfile.po index efb92720d9..2ea1cb84e2 100644 --- a/distutils/configfile.po +++ b/distutils/configfile.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/examples.po b/distutils/examples.po index 462adf81c1..5b798394ba 100644 --- a/distutils/examples.po +++ b/distutils/examples.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/extending.po b/distutils/extending.po index 1bc939089e..493af8302b 100644 --- a/distutils/extending.po +++ b/distutils/extending.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/index.po b/distutils/index.po index 296fa51183..28a6550410 100644 --- a/distutils/index.po +++ b/distutils/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Wierzbicki , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/introduction.po b/distutils/introduction.po index d403846e0d..25188eb82b 100644 --- a/distutils/introduction.po +++ b/distutils/introduction.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -297,7 +296,7 @@ msgstr "" "pytonowskiego.)" msgid "package" -msgstr "" +msgstr "pakiet" msgid "" "a module that contains other modules; typically contained in a directory in " diff --git a/distutils/setupscript.po b/distutils/setupscript.po index ada217a049..e38ef01d6e 100644 --- a/distutils/setupscript.po +++ b/distutils/setupscript.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/distutils/sourcedist.po b/distutils/sourcedist.po index f8668a1f7b..97d82f2e13 100644 --- a/distutils/sourcedist.po +++ b/distutils/sourcedist.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/extending/extending.po b/extending/extending.po index f64fa9fd43..a3bee74419 100644 --- a/extending/extending.po +++ b/extending/extending.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -274,7 +274,7 @@ msgid "" "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_IOError`). If something's wrong with the argument list, the :c:func:" +"`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." @@ -289,35 +289,35 @@ msgstr "" "początku pliku::" msgid "" -"and initialize it in your module's initialization function (:c:func:" -"`PyInit_spam`) with an exception object::" +"and initialize it in your module's initialization function (:c:func:`!" +"PyInit_spam`) with an exception object::" msgstr "" msgid "" -"Note that the Python name for the exception object is :exc:`spam.error`. " +"Note that the Python name for the exception object is :exc:`!spam.error`. " "The :c:func:`PyErr_NewException` function may create a class with the base " "class being :exc:`Exception` (unless another class is passed in instead of " "``NULL``), described in :ref:`bltin-exceptions`." msgstr "" msgid "" -"Note also that the :c:data:`SpamError` variable retains a reference to the " +"Note also that the :c:data:`!SpamError` variable retains a reference to the " "newly created exception class; this is intentional! Since the exception " "could be removed from the module by external code, an owned reference to the " -"class is needed to ensure that it will not be discarded, causing :c:data:" -"`SpamError` to become a dangling pointer. Should it become a dangling " +"class is needed to ensure that it will not be discarded, causing :c:data:`!" +"SpamError` to become a dangling pointer. Should it become a dangling " "pointer, C code which raises the exception could cause a core dump or other " "unintended side effects." msgstr "" msgid "" -"We discuss the use of ``PyMODINIT_FUNC`` as a function return type later in " -"this sample." +"We discuss the use of :c:macro:`PyMODINIT_FUNC` as a function return type " +"later in this sample." msgstr "" msgid "" -"The :exc:`spam.error` exception can be raised in your extension module using " -"a call to :c:func:`PyErr_SetString` as shown below::" +"The :exc:`!spam.error` exception can be raised in your extension module " +"using a call to :c:func:`PyErr_SetString` as shown below::" msgstr "" msgid "Back to the Example" @@ -334,9 +334,9 @@ msgid "" "It returns ``NULL`` (the error indicator for functions returning object " "pointers) if an error is detected in the argument list, relying on the " "exception set by :c:func:`PyArg_ParseTuple`. Otherwise the string value of " -"the argument has been copied to the local variable :c:data:`command`. This " +"the argument has been copied to the local variable :c:data:`!command`. This " "is a pointer assignment and you are not supposed to modify the string to " -"which it points (so in Standard C, the variable :c:data:`command` should " +"which it points (so in Standard C, the variable :c:data:`!command` should " "properly be declared as ``const char *command``)." msgstr "" @@ -346,8 +346,9 @@ msgid "" 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`. ::" +"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`. ::" msgstr "" msgid "" @@ -374,8 +375,8 @@ msgid "The Module's Method Table and Initialization Function" msgstr "Zadanie zainicjowania i tabela sposobów postępowania modułu." msgid "" -"I promised to show how :c:func:`spam_system` is called from Python programs. " -"First, we need to list its name and address in a \"method table\"::" +"I promised to show how :c:func:`!spam_system` is called from Python " +"programs. First, we need to list its name and address in a \"method table\"::" msgstr "" msgid "" @@ -393,7 +394,7 @@ msgid "" msgstr "" msgid "" -"The :const:`METH_KEYWORDS` bit may be set in the third field if keyword " +"The :c:macro:`METH_KEYWORDS` bit may be set in the third field if keyword " "arguments should be passed to the function. In this case, the C function " "should accept a third ``PyObject *`` parameter which will be a dictionary of " "keywords. Use :c:func:`PyArg_ParseTupleAndKeywords` to parse the arguments " @@ -409,22 +410,19 @@ 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 " +"`!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 "" -"Note that PyMODINIT_FUNC declares the function as ``PyObject *`` return " -"type, declares any special linkage declarations required by the platform, " -"and for C++ declares the function as ``extern \"C\"``." +"Note that :c:macro:`PyMODINIT_FUNC` declares the function as ``PyObject *`` " +"return type, declares any special linkage declarations required by the " +"platform, and for C++ declares the function as ``extern \"C\"``." msgstr "" -"Zauważ że PyMODINIT_FUNC deklaruje zadanie jako zwrotny typ ``PyObject *``, " -"deklaruje wszelkie specjalne deklaracje połączeń wymagane przez maszynę/" -"środowisko, i dla C++ deklaruje zadanie jako ``extern \"C\"``." msgid "" -"When the Python program imports module :mod:`spam` for the first time, :c:" -"func:`PyInit_spam` is called. (See below for comments about embedding " +"When the Python program imports module :mod:`!spam` for the first time, :c:" +"func:`!PyInit_spam` is called. (See below for comments about embedding " "Python.) It calls :c:func:`PyModule_Create`, which returns a module object, " "and inserts built-in function objects into the newly created module based " "upon the table (an array of :c:type:`PyMethodDef` structures) found in the " @@ -436,7 +434,7 @@ msgid "" msgstr "" msgid "" -"When embedding Python, the :c:func:`PyInit_spam` function is not called " +"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::" @@ -560,7 +558,7 @@ msgid "" msgstr "" msgid "" -"This function must be registered with the interpreter using the :const:" +"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`." @@ -1006,15 +1004,15 @@ msgid "" "references to all its items, so when item 1 is replaced, it has to dispose " "of the original item 1. Now let's suppose the original item 1 was an " "instance of a user-defined class, and let's further suppose that the class " -"defined a :meth:`__del__` method. If this class instance has a reference " -"count of 1, disposing of it will call its :meth:`__del__` method." +"defined a :meth:`!__del__` method. If this class instance has a reference " +"count of 1, disposing of it will call its :meth:`!__del__` method." msgstr "" msgid "" -"Since it is written in Python, the :meth:`__del__` method can execute " +"Since it is written in Python, the :meth:`!__del__` method can execute " "arbitrary Python code. Could it perhaps do something to invalidate the " -"reference to ``item`` in :c:func:`bug`? You bet! Assuming that the list " -"passed into :c:func:`bug` is accessible to the :meth:`__del__` method, it " +"reference to ``item`` in :c:func:`!bug`? You bet! Assuming that the list " +"passed into :c:func:`!bug` is accessible to the :meth:`!__del__` method, it " "could execute a statement to the effect of ``del list[0]``, and assuming " "this was the last reference to that object, it would free the memory " "associated with it, thereby invalidating ``item``." @@ -1030,11 +1028,8 @@ msgstr "" msgid "" "This is a true story. An older version of Python contained variants of this " "bug and someone spent a considerable amount of time in a C debugger to " -"figure out why his :meth:`__del__` methods would fail..." +"figure out why his :meth:`!__del__` methods would fail..." msgstr "" -"To jest prawdziwa historia. Starsza wersja języka pytonowskiego zawierała " -"warianty tego błędu i ktoś spędził zdrowy kawałek czasu w debugerze C aby " -"dowiedzieć się czemu jegosposoby postępowania :meth:`__del__` zawodziły..." msgid "" "The second case of problems with a borrowed reference is a variant involving " @@ -1250,20 +1245,21 @@ msgid "" msgstr "" msgid "" -"The exporting module is a modification of the :mod:`spam` module from " -"section :ref:`extending-simpleexample`. The function :func:`spam.system` " +"The exporting module is a modification of the :mod:`!spam` module from " +"section :ref:`extending-simpleexample`. The function :func:`!spam.system` " "does not call the C library function :c:func:`system` directly, but a " -"function :c:func:`PySpam_System`, which would of course do something more " +"function :c:func:`!PySpam_System`, which would of course do something more " "complicated in reality (such as adding \"spam\" to every command). This " -"function :c:func:`PySpam_System` is also exported to other extension modules." +"function :c:func:`!PySpam_System` is also exported to other extension " +"modules." msgstr "" msgid "" -"The function :c:func:`PySpam_System` is a plain C function, declared " +"The function :c:func:`!PySpam_System` is a plain C function, declared " "``static`` like everything else::" msgstr "" -msgid "The function :c:func:`spam_system` is modified in a trivial way::" +msgid "The function :c:func:`!spam_system` is modified in a trivial way::" msgstr "" msgid "In the beginning of the module, right after the line ::" @@ -1285,10 +1281,8 @@ msgstr "" msgid "" "Note that ``PySpam_API`` is declared ``static``; otherwise the pointer array " -"would disappear when :func:`PyInit_spam` terminates!" +"would disappear when :c:func:`!PyInit_spam` terminates!" msgstr "" -"Zauważ, że ``PySpam_API`` jest zadeklarowane ``statycznie``; w innym " -"przypadku tabela wskaźników zniknęłaby gdy :func:`PyInit_spam` się zakończy!" msgid "" "The bulk of the work is in the header file :file:`spammodule.h`, which looks " @@ -1299,8 +1293,8 @@ 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 initialization function::" +"func:`!PySpam_System` is to call the function (or rather macro) :c:func:`!" +"import_spam` in its initialization function::" msgstr "" msgid "" @@ -1361,13 +1355,13 @@ msgstr "" "Te gwarancje nie są w mocy gdy używasz \"starego\" sposobu wywoływania --- " "to jest wciąż znajdowane w dużej części istniejącego kodu." -msgid "PyObject_CallObject()" +msgid "PyObject_CallObject (C function)" msgstr "" -msgid "PyArg_ParseTuple()" +msgid "PyArg_ParseTuple (C function)" msgstr "" -msgid "PyArg_ParseTupleAndKeywords()" +msgid "PyArg_ParseTupleAndKeywords (C function)" msgstr "" msgid "Philbrick, Geoff" diff --git a/extending/index.po b/extending/index.po index 5a2948dfd9..ffc5ab7fda 100644 --- a/extending/index.po +++ b/extending/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,6 +73,12 @@ msgid "" "swig.org>`_ and `Numba `_ offer both simpler and " "more sophisticated approaches to creating C and C++ extensions for Python." msgstr "" +"Ten przewodnik obejmuje jedynie podstawowe narzędzia do tworzenia rozszerzeń " +"w ramach tej wersji CPythona. Narzędzia innych firm, takie jak `Cython " +"`_, `cffi `_, `SWIG " +"`_ i `Numba `_ oferują " +"zarówno prostsze, jak i bardziej wyrafinowane podejścia do tworzenia " +"rozszerzeń C i C++ dla Python." msgid "" "`Python Packaging User Guide: Binary Extensions , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -254,8 +255,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 :" -"attr:`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 "" @@ -272,19 +273,12 @@ msgstr "" msgid "" "For each entry in the table, a :term:`descriptor` will be constructed and " "added to the type which will be able to extract a value from the instance " -"structure. The :attr:`type` field should contain one of the type codes " -"defined in the :file:`structmember.h` header; the value will be used to " -"determine how to convert Python values to and from C values. The :attr:" -"`flags` field is used to store flags which control how the attribute can be " -"accessed." +"structure. The :c:member:`~PyMemberDef.type` field should contain one of " +"the type codes defined in the :file:`structmember.h` header; 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." msgstr "" -"Dla każdego wpisu w tabeli zostanie skonstruowany :term:`descriptor` i " -"dodany do typu, który będzie mógł wydobyć wartość ze struktury przykładu. " -"Pole :attr:`type` powinno zawierać jeden z kodów typu określonych w " -"nagłówku :file:`structmember.h`; wartość będzie użyta do określenia jak " -"zamienić wartości Pythona z i na wartości C. Pole :attr:`flags` jest używane " -"do przechowywania flag które kontrolują, jak można uzyskać dostęp do " -"właściwości." msgid "" "The following flag constants are defined in :file:`structmember.h`; they may " @@ -314,10 +308,10 @@ msgid "" msgstr "" msgid "" -":const:`RESTRICTED`, :const:`READ_RESTRICTED` and :const:`WRITE_RESTRICTED` " -"are deprecated. However, :const:`READ_RESTRICTED` is an alias for :const:" -"`PY_AUDIT_READ`, so fields that specify either :const:`RESTRICTED` or :const:" -"`READ_RESTRICTED` will also raise an audit event." +":c:macro:`RESTRICTED`, :c:macro:`READ_RESTRICTED` and :c:macro:" +"`WRITE_RESTRICTED` are deprecated. However, :c:macro:`READ_RESTRICTED` is an " +"alias for :c:macro:`PY_AUDIT_READ`, so fields that specify either :c:macro:" +"`RESTRICTED` or :c:macro:`READ_RESTRICTED` will also raise an audit event." msgstr "" msgid "" @@ -326,12 +320,12 @@ msgid "" "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:" -"`__doc__` attribute." +"`!__doc__` attribute." msgstr "" msgid "" "As with the :c:member:`~PyTypeObject.tp_methods` table, a sentinel entry " -"with a :attr:`name` value of ``NULL`` is required." +"with a :c:member:`~PyMethodDef.ml_name` value of ``NULL`` is required." msgstr "" msgid "Type-specific Attribute Management" @@ -350,7 +344,7 @@ msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_getattr` handler is called when the object " "requires an attribute look-up. It is called in the same situations where " -"the :meth:`__getattr__` method of a class would be called." +"the :meth:`~object.__getattr__` method of a class would be called." msgstr "" msgid "Here is an example::" @@ -358,11 +352,11 @@ msgstr "Tu jest przykład::" msgid "" "The :c:member:`~PyTypeObject.tp_setattr` handler is called when the :meth:" -"`__setattr__` or :meth:`__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``. ::" +"`~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 "Object Comparison" @@ -371,7 +365,7 @@ msgstr "Porównywanie przedmiotów" 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:" +"methods `, like :meth:`!__lt__`, and also called by :c:func:" "`PyObject_RichCompare` and :c:func:`PyObject_RichCompareBool`." msgstr "" @@ -432,7 +426,7 @@ msgid "" msgstr "" msgid "" -":c:type:`Py_hash_t` is a signed integer type with a platform-varying width. " +":c:type:`!Py_hash_t` is a signed integer type with a platform-varying width. " "Returning ``-1`` from :c:member:`~PyTypeObject.tp_hash` indicates an error, " "which is why you should be careful to avoid returning it when hash " "computation is successful, as seen above." @@ -474,7 +468,7 @@ 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:`__iter__` method, while :c:member:" +"corresponds to the Python :meth:`~object.__iter__` method, while :c:member:" "`~PyTypeObject.tp_iternext` corresponds to the Python :meth:`~iterator." "__next__` method." msgstr "" @@ -577,17 +571,17 @@ msgid "Download CPython source releases." msgstr "" msgid "https://www.python.org/downloads/source/" -msgstr "" +msgstr "https://www.python.org/downloads/source/" msgid "" "The CPython project on GitHub, where the CPython source code is developed." msgstr "" msgid "https://github.com/python/cpython" -msgstr "" +msgstr "https://github.com/python/cpython" msgid "object" -msgstr "" +msgstr "obiekt" msgid "deallocation" msgstr "" @@ -601,20 +595,20 @@ msgstr "" msgid "finalization, of objects" msgstr "" -msgid "PyErr_Fetch()" +msgid "PyErr_Fetch (C function)" msgstr "" -msgid "PyErr_Restore()" +msgid "PyErr_Restore (C function)" msgstr "" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "object representation" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "repr" msgstr "" diff --git a/extending/windows.po b/extending/windows.po index ecf9327488..0296879f48 100644 --- a/extending/windows.po +++ b/extending/windows.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -169,5 +169,5 @@ msgid "" "Developer Studio will throw in a lot of import libraries that you do not " "really need, adding about 100K to your executable. To get rid of them, use " "the Project Settings dialog, Link tab, to specify *ignore default " -"libraries*. Add the correct :file:`msvcrtxx.lib` to the list of libraries." +"libraries*. Add the correct :file:`msvcrt{xx}.lib` to the list of libraries." msgstr "" diff --git a/faq/design.po b/faq/design.po index 42461a51a5..88c861cdf6 100644 --- a/faq/design.po +++ b/faq/design.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Anna Prochasek, 2022 -# Maciej Olko , 2022 +# Stefan Ocetkiewicz , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -247,18 +246,20 @@ msgid "" msgstr "" msgid "Why can't I use an assignment in an expression?" -msgstr "" +msgstr "Dlaczego nie mogę użyć przypisania w wyrażeniu?" msgid "Starting in Python 3.8, you can!" -msgstr "" +msgstr "Począwszy od Pythona 3.8 możesz!" msgid "" "Assignment expressions using the walrus operator ``:=`` assign a variable in " "an expression::" msgstr "" +"Przypisanie w wyrażeniu realizujesz poprzez walrus operator ``:=`` " +"przypisując zmienną w wyrażeniu::" msgid "See :pep:`572` for more information." -msgstr "" +msgstr "Zobacz :pep:`572` aby uzyskać więcej informacji." msgid "" "Why does Python use methods for some functionality (e.g. list.index()) but " @@ -289,6 +290,7 @@ msgstr "" msgid "https://mail.python.org/pipermail/python-3000/2006-November/004643.html" msgstr "" +"https://mail.python.org/pipermail/python-3000/2006-November/004643.html" msgid "Why is join() a string method instead of a list or tuple method?" msgstr "" @@ -359,9 +361,11 @@ msgid "Why isn't there a switch or case statement in Python?" msgstr "" msgid "" -"You can do this easily enough with a sequence of ``if... elif... elif... " -"else``. For literal values, or constants within a namespace, you can also " -"use a ``match ... case`` statement." +"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``." msgstr "" msgid "" @@ -382,6 +386,11 @@ msgid "" "your object." msgstr "" +msgid "" +"Imitating switch with fallthrough, as with C's switch-case-default, is " +"possible, much harder, and less needed." +msgstr "" + msgid "" "Can't you emulate threads in the interpreter instead of relying on an OS-" "specific thread implementation?" @@ -575,8 +584,8 @@ msgid "" "bit, could hash to 1142331976. The hash code is then used to calculate a " "location in an internal array where the value will be stored. Assuming that " "you're storing keys that all have different hash values, this means that " -"dictionaries take constant time -- O(1), in Big-O notation -- to retrieve a " -"key." +"dictionaries take constant time -- *O*\\ (1), in Big-O notation -- to " +"retrieve a key." msgstr "" msgid "Why must dictionary keys be immutable?" @@ -726,10 +735,11 @@ msgid "" "An appropriate testing discipline can help build large complex applications " "in Python as well as having interface specifications would. In fact, it can " "be better because an interface specification cannot test certain properties " -"of a program. For example, the :meth:`append` method is expected to add new " -"elements to the end of some internal list; an interface specification cannot " -"test that your :meth:`append` implementation will actually do this " -"correctly, but it's trivial to check this property in a test suite." +"of a program. For example, the :meth:`!list.append` method is expected to " +"add new elements to the end of some internal list; an interface " +"specification cannot test that your :meth:`!list.append` implementation will " +"actually do this correctly, but it's trivial to check this property in a " +"test suite." msgstr "" msgid "" diff --git a/faq/extending.po b/faq/extending.po index c049bc78ac..2b2232889a 100644 --- a/faq/extending.po +++ b/faq/extending.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:10+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -71,10 +71,10 @@ msgid "" "If you need to interface to some C or C++ library for which no Python " "extension currently exists, you can try wrapping the library's data types " "and functions with a tool such as `SWIG `_. `SIP " -"`__, `CXX `_ `Boost `_, or `Weave `_ are also alternatives " -"for wrapping C++ libraries." +"`__, `CXX `_ `Boost `_, or `Weave " +"`_ are also alternatives for wrapping C++ " +"libraries." msgstr "" msgid "How can I execute arbitrary Python statements from C?" @@ -104,15 +104,15 @@ 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:`PyListSize` and :c:" +"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." +"Note that Python bytes objects may contain null bytes so C's :c:func:`!" +"strlen` should not be used." msgstr "" msgid "" diff --git a/faq/general.po b/faq/general.po index 32ee7a678a..3fcaf67b25 100644 --- a/faq/general.po +++ b/faq/general.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Krzysztof Abramowicz, 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -191,17 +190,14 @@ msgid "" "*C* is the micro version number -- it is incremented for each bugfix release." msgstr "" -msgid "See :pep:`6` for more information about bugfix releases." -msgstr "" - msgid "" -"Not all releases are bugfix releases. In the run-up to a new major release, " -"a series of development releases are made, denoted as alpha, beta, or " -"release candidate. Alphas are early releases in which interfaces aren't yet " -"finalized; it's not unexpected to see an interface change between two alpha " -"releases. Betas are more stable, preserving existing interfaces but possibly " -"adding new modules, and release candidates are frozen, making no changes " -"except as needed to fix critical bugs." +"Not all releases are bugfix releases. In the run-up to a new feature " +"release, a series of development releases are made, denoted as alpha, beta, " +"or release candidate. Alphas are early releases in which interfaces aren't " +"yet finalized; it's not unexpected to see an interface change between two " +"alpha releases. Betas are more stable, preserving existing interfaces but " +"possibly adding new modules, and release candidates are frozen, making no " +"changes except as needed to fix critical bugs." msgstr "" msgid "Alpha, beta and release candidate versions have an additional suffix:" @@ -232,6 +228,9 @@ msgid "" msgstr "" msgid "" +"See the `Developer's Guide `__ for more information about the development cycle, " +"and :pep:`387` to learn more about Python's backward compatibility policy. " "See also the documentation for :data:`sys.version`, :data:`sys.hexversion`, " "and :data:`sys.version_info`." msgstr "" @@ -405,13 +404,13 @@ msgstr "" msgid "" "Very stable. New, stable releases have been coming out roughly every 6 to " "18 months since 1991, and this seems likely to continue. As of version 3.9, " -"Python will have a major new release every 12 months (:pep:`602`)." +"Python will have a new feature release every 12 months (:pep:`602`)." msgstr "" msgid "" -"The developers issue \"bugfix\" releases of older versions, so the stability " -"of existing releases gradually improves. Bugfix releases, indicated by a " -"third component of the version number (e.g. 3.5.3, 3.6.2), are managed for " +"The developers issue bugfix releases of older versions, so the stability of " +"existing releases gradually improves. Bugfix releases, indicated by a third " +"component of the version number (e.g. 3.5.3, 3.6.2), are managed for " "stability; only fixes for known problems are included in a bugfix release, " "and it's guaranteed that interfaces will remain the same throughout a series " "of bugfix releases." diff --git a/faq/gui.po b/faq/gui.po index 2b5c0e9d9a..eff68c86f4 100644 --- a/faq/gui.po +++ b/faq/gui.po @@ -1,20 +1,21 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# rmaster1211 , 2021 +# Rafael Fontenelle , 2023 +# Waldemar Stoczkowski, 2023 +# Maciej Olko , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: rmaster1211 , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Maciej Olko , 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" @@ -34,7 +35,7 @@ msgid "General GUI Questions" msgstr "Pytania ogólne o GUI" msgid "What GUI toolkits exist for Python?" -msgstr "" +msgstr "Jakie zestawy narzędzi GUI istnieją dla Pythona?" msgid "" "Standard builds of Python include an object-oriented interface to the Tcl/Tk " @@ -44,6 +45,13 @@ msgid "" "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 " +"najłatwiejszy do zainstalowania (ponieważ jest dołączony do większości " +"`binarnych dystrybucji `_ Pythona) i " +"używania. Więcej informacji o Tk, w tym wskazówki do źródeł, można znaleźć " +"na `stronie domowej Tcl/Tk `_. Tcl/Tk jest w pełni " +"przenośny na platformy macOS, Windows i Unix." msgid "" "Depending on what platform(s) you are aiming at, there are also several " @@ -54,7 +62,7 @@ msgid "" msgstr "" msgid "Tkinter questions" -msgstr "" +msgstr "Pytania dotyczące Tkinter" msgid "How do I freeze Tkinter applications?" msgstr "" @@ -67,8 +75,8 @@ msgstr "" msgid "" "One solution is to ship the application with the Tcl and Tk libraries, and " -"point to them at run-time using the :envvar:`TCL_LIBRARY` and :envvar:" -"`TK_LIBRARY` environment variables." +"point to them at run-time using the :envvar:`!TCL_LIBRARY` and :envvar:`!" +"TK_LIBRARY` environment variables." msgstr "" msgid "" @@ -77,6 +85,10 @@ msgid "" "is SAM (stand-alone modules), which is part of the Tix distribution (https://" "tix.sourceforge.net/)." msgstr "" +"Aby uzyskać prawdziwie samodzielne aplikacje, skrypty Tcl tworzące " +"bibliotekę muszą być również zintegrowane z aplikacją. Jednym z narzędzi " +"wspierających ten proces jest SAM (stand-alone modules), który jest częścią " +"dystrybucji Tix (https://tix.sourceforge.net/)." msgid "" "Build Tix with SAM enabled, perform the appropriate call to :c:func:" @@ -90,7 +102,7 @@ msgstr "" msgid "" "On platforms other than Windows, yes, and you don't even need threads! But " "you'll have to restructure your I/O code a bit. Tk has the equivalent of " -"Xt's :c:func:`XtAddInput()` call, which allows you to register a callback " +"Xt's :c:func:`!XtAddInput` call, which allows you to register a callback " "function which will be called from the Tk mainloop when I/O is possible on a " "file descriptor. See :ref:`tkinter-file-handlers`." msgstr "" @@ -99,9 +111,9 @@ msgid "I can't get key bindings to work in Tkinter: why?" msgstr "" msgid "" -"An often-heard complaint is that event handlers bound to events with the :" -"meth:`bind` method don't get handled even when the appropriate key is " -"pressed." +"An often-heard complaint is that event handlers :ref:`bound ` to events with the :meth:`!bind` method don't get handled even when " +"the appropriate key is pressed." msgstr "" msgid "" diff --git a/faq/index.po b/faq/index.po index 69d6364fc2..153ccd393c 100644 --- a/faq/index.po +++ b/faq/index.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/faq/installed.po b/faq/installed.po index b670a664e7..293e1b5cdf 100644 --- a/faq/installed.po +++ b/faq/installed.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/faq/library.po b/faq/library.po index 95b5f5cdd6..456df1304e 100644 --- a/faq/library.po +++ b/faq/library.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -148,7 +146,7 @@ msgstr "" msgid "" "The :mod:`atexit` module provides a register function that is similar to " -"C's :c:func:`onexit`." +"C's :c:func:`!onexit`." msgstr "" msgid "Why don't my signal handlers work?" @@ -334,9 +332,9 @@ msgstr "" msgid "" "Operations that replace other objects may invoke those other objects' :meth:" -"`__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!" +"`~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?" @@ -506,7 +504,7 @@ msgid "For Unix, see a Usenet post by Mitch Chapman:" msgstr "" msgid "https://groups.google.com/groups?selm=34A04430.CF9@ohioee.com" -msgstr "" +msgstr "https://groups.google.com/groups?selm=34A04430.CF9@ohioee.com" msgid "Why doesn't closing sys.stdout (stdin, stderr) really close it?" msgstr "" @@ -619,19 +617,20 @@ msgstr "" msgid "" "To prevent the TCP connect from blocking, you can set the socket to non-" -"blocking mode. Then when you do the :meth:`socket.connect`, you will either " -"connect immediately (unlikely) or get an exception that contains the error " -"number as ``.errno``. ``errno.EINPROGRESS`` indicates that the connection is " -"in progress, but hasn't finished yet. Different OSes will return different " -"values, so you're going to have to check what's returned on your system." +"blocking mode. Then when you do the :meth:`~socket.socket.connect`, you " +"will either connect immediately (unlikely) or get an exception that contains " +"the error number as ``.errno``. ``errno.EINPROGRESS`` indicates that the " +"connection is in progress, but hasn't finished yet. Different OSes will " +"return different values, so you're going to have to check what's returned on " +"your system." msgstr "" msgid "" -"You can use the :meth:`socket.connect_ex` method to avoid creating an " -"exception. It will just return the errno value. To poll, you can call :" -"meth:`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." +"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." msgstr "" msgid "" diff --git a/faq/programming.po b/faq/programming.po index 0ce5f917bc..688dd2daf4 100644 --- a/faq/programming.po +++ b/faq/programming.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2022 -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2022 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -96,10 +95,10 @@ msgid "`Wing IDE `_" msgstr "" msgid "`Komodo IDE `_" -msgstr "" +msgstr "`Komodo IDE `_" msgid "`PyCharm `_" -msgstr "" +msgstr "`PyCharm `_" msgid "Are there tools to help find bugs or perform static analysis?" msgstr "" @@ -494,9 +493,9 @@ msgid "" msgstr "" msgid "" -"After the call to :meth:`~list.append`, the content of the mutable object " -"has changed from ``[]`` to ``[10]``. Since both the variables refer to the " -"same object, using either name accesses the modified value ``[10]``." +"After the call to :meth:`!append`, the content of the mutable object has " +"changed from ``[]`` to ``[10]``. Since both the variables refer to the same " +"object, using either name accesses the modified value ``[10]``." msgstr "" msgid "If we instead assign an immutable object to ``x``::" @@ -1140,7 +1139,7 @@ msgid "See the Python Cookbook for a long discussion of many ways to do this:" msgstr "" msgid "https://code.activestate.com/recipes/52560/" -msgstr "" +msgstr "https://code.activestate.com/recipes/52560/" msgid "" "If you don't mind reordering the list, sort it and then scan from the end of " @@ -1297,9 +1296,8 @@ msgid "" "an :meth:`~object.__iadd__` magic method, it gets called when the ``+=`` " "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:`~list.extend` on the list and returning the list. That's " -"why we say that for lists, ``+=`` is a \"shorthand\" for :meth:`!list." -"extend`::" +"to calling :meth:`!extend` on the list and returning the list. That's why " +"we say that for lists, ``+=`` is a \"shorthand\" for :meth:`!list.extend`::" msgstr "" msgid "This is equivalent to::" @@ -1716,7 +1714,7 @@ msgid "" msgstr "" msgid "" -"For example, here is the implementation of :meth:`collections.abc.Sequence." +"For example, here is the implementation of :meth:`!collections.abc.Sequence." "__contains__`::" msgstr "" @@ -1871,10 +1869,10 @@ msgid "Suppose you have the following modules:" msgstr "" msgid ":file:`foo.py`::" -msgstr "" +msgstr ":file:`foo.py`::" msgid ":file:`bar.py`::" -msgstr "" +msgstr ":file:`bar.py`::" msgid "The problem is that the interpreter will perform the following steps:" msgstr "" @@ -1996,7 +1994,7 @@ msgid "" msgstr "" msgid "argument" -msgstr "" +msgstr "argument" msgid "difference from parameter" msgstr "" diff --git a/faq/windows.po b/faq/windows.po index 0886db520b..8d8eee315a 100644 --- a/faq/windows.po +++ b/faq/windows.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/glossary.po b/glossary.po index a1142db301..d5c7dc31fd 100644 --- a/glossary.po +++ b/glossary.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -25,7 +25,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Glossary" -msgstr "Słownik" +msgstr "Glosariusz" msgid "``>>>``" msgstr "``>>>``" @@ -74,7 +74,7 @@ msgid "" msgstr "" msgid "abstract base class" -msgstr "" +msgstr "abstrakcyjna klasa bazowa" msgid "" "Abstract base classes complement :term:`duck-typing` by providing a way to " @@ -90,12 +90,14 @@ msgid "" msgstr "" msgid "annotation" -msgstr "" +msgstr "adnotacja" msgid "" "A label associated with a variable, a class attribute or a function " "parameter or return value, used by convention as a :term:`type hint`." msgstr "" +"Etykieta powiązana ze zmienną, atrybutem klasy lub parametrem funkcji lub " +"wartością zwracaną, używana zgodnie z konwencją jako :term:`type hint`." msgid "" "Annotations of local variables cannot be accessed at runtime, but " @@ -111,7 +113,7 @@ msgid "" msgstr "" msgid "argument" -msgstr "" +msgstr "argument" msgid "" "A value passed to a :term:`function` (or :term:`method`) when calling the " @@ -150,8 +152,8 @@ msgstr "" msgid "" "An object which controls the environment seen in an :keyword:`async with` " -"statement by defining :meth:`__aenter__` and :meth:`__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" @@ -183,17 +185,17 @@ msgstr "" msgid "" "This is an :term:`asynchronous iterator` which when called using the :meth:" -"`__anext__` method returns an awaitable object which will execute the body " -"of the asynchronous generator function until the next :keyword:`yield` " -"expression." +"`~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 "" "Each :keyword:`yield` temporarily suspends processing, remembering the " "location execution state (including local variables and pending try-" "statements). When the *asynchronous generator iterator* effectively resumes " -"with another awaitable returned by :meth:`__anext__`, it picks up where it " -"left off. See :pep:`492` and :pep:`525`." +"with another awaitable returned by :meth:`~object.__anext__`, it picks up " +"where it left off. See :pep:`492` and :pep:`525`." msgstr "" msgid "asynchronous iterable" @@ -201,19 +203,19 @@ msgstr "" msgid "" "An object, that can be used in an :keyword:`async for` statement. Must " -"return an :term:`asynchronous iterator` from its :meth:`__aiter__` method. " -"Introduced by :pep:`492`." +"return an :term:`asynchronous iterator` from its :meth:`~object.__aiter__` " +"method. Introduced by :pep:`492`." msgstr "" msgid "asynchronous iterator" msgstr "" msgid "" -"An object that implements the :meth:`__aiter__` and :meth:`__anext__` " -"methods. ``__anext__`` must return an :term:`awaitable` object. :keyword:" -"`async for` resolves the awaitables returned by an asynchronous iterator's :" -"meth:`__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 "attribute" @@ -238,12 +240,12 @@ msgstr "" msgid "" "An object that can be used in an :keyword:`await` expression. Can be a :" -"term:`coroutine` or an object with an :meth:`__await__` method. See also :" -"pep:`492`." +"term:`coroutine` or an object with an :meth:`~object.__await__` method. See " +"also :pep:`492`." msgstr "" msgid "BDFL" -msgstr "" +msgstr "BDFL" msgid "" "Benevolent Dictator For Life, a.k.a. `Guido van Rossum `. 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 "" @@ -270,10 +272,10 @@ msgid "borrowed reference" msgstr "" msgid "" -"In Python's C API, a borrowed reference is a reference to an object. It does " -"not modify the object reference count. It becomes a dangling pointer if the " -"object is destroyed. For example, a garbage collection can remove the last :" -"term:`strong reference` to the object and so destroy it." +"In Python's C API, a borrowed reference is a reference to an object, where " +"the code using the object does not own the reference. It becomes a dangling " +"pointer if the object is destroyed. For example, a garbage collection can " +"remove the last :term:`strong reference` to the object and so destroy it." msgstr "" msgid "" @@ -347,7 +349,7 @@ msgid "" msgstr "" msgid "class" -msgstr "" +msgstr "klasa" msgid "" "A template for creating user-defined objects. Class definitions normally " @@ -363,7 +365,7 @@ msgid "" msgstr "" msgid "complex number" -msgstr "" +msgstr "liczba zespolona" msgid "" "An extension of the familiar real number system in which all numbers are " @@ -382,7 +384,8 @@ msgstr "" msgid "" "An object which controls the environment seen in a :keyword:`with` statement " -"by defining :meth:`__enter__` and :meth:`__exit__` methods. See :pep:`343`." +"by defining :meth:`~object.__enter__` and :meth:`~object.__exit__` methods. " +"See :pep:`343`." msgstr "" msgid "context variable" @@ -431,7 +434,7 @@ msgid "" msgstr "" msgid "CPython" -msgstr "" +msgstr "CPython" msgid "" "The canonical implementation of the Python programming language, as " @@ -441,7 +444,7 @@ msgid "" msgstr "" msgid "decorator" -msgstr "" +msgstr "dekorator" msgid "" "A function returning another function, usually applied as a function " @@ -461,18 +464,18 @@ msgid "" msgstr "" msgid "descriptor" -msgstr "" +msgstr "deskryptor" msgid "" -"Any object which defines the methods :meth:`__get__`, :meth:`__set__`, or :" -"meth:`__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 "" @@ -481,12 +484,12 @@ msgid "" msgstr "" msgid "dictionary" -msgstr "" +msgstr "słownik" msgid "" "An associative array, where arbitrary keys are mapped to values. The keys " -"can be any object with :meth:`__hash__` and :meth:`__eq__` methods. Called a " -"hash in Perl." +"can be any object with :meth:`~object.__hash__` and :meth:`~object.__eq__` " +"methods. Called a hash in Perl." msgstr "" msgid "dictionary comprehension" @@ -511,12 +514,12 @@ msgid "" msgstr "" msgid "docstring" -msgstr "" +msgstr "docstring" msgid "" "A string literal which appears as the first expression in a class, function " "or module. While ignored when the suite is executed, it is recognized by " -"the compiler and put into the :attr:`__doc__` attribute of the enclosing " +"the compiler and put into the :attr:`!__doc__` attribute of the enclosing " "class, function or module. Since it is available via introspection, it is " "the canonical place for documentation of the object." msgstr "" @@ -537,7 +540,7 @@ msgid "" msgstr "" msgid "EAFP" -msgstr "" +msgstr "EAFP" msgid "" "Easier to ask for forgiveness than permission. This common Python coding " @@ -549,7 +552,7 @@ msgid "" msgstr "" msgid "expression" -msgstr "" +msgstr "wyrażenie" msgid "" "A piece of syntax which can be evaluated to some value. In other words, an " @@ -570,7 +573,7 @@ msgid "" msgstr "" msgid "f-string" -msgstr "" +msgstr "f-string" msgid "" "String literals prefixed with ``'f'`` or ``'F'`` are commonly called \"f-" @@ -579,11 +582,11 @@ msgid "" msgstr "" msgid "file object" -msgstr "" +msgstr "obiekt plik" msgid "" -"An object exposing a file-oriented API (with methods such as :meth:`read()` " -"or :meth:`write()`) to an underlying resource. Depending on the way it was " +"An object exposing a file-oriented API (with methods such as :meth:`!read` " +"or :meth:`!write`) to an underlying resource. Depending on the way it was " "created, a file object can mediate access to a real on-disk file or to " "another type of storage or communication device (for example standard input/" "output, in-memory buffers, sockets, pipes, etc.). File objects are also " @@ -635,7 +638,7 @@ msgid "See also the :term:`locale encoding`." msgstr "" msgid "finder" -msgstr "" +msgstr "wyszukiwarka" msgid "" "An object that tries to find the :term:`loader` for a module that is being " @@ -694,7 +697,7 @@ msgid "" msgstr "" msgid "__future__" -msgstr "" +msgstr "__future__" msgid "" "A :ref:`future statement `, ``from __future__ import ``, " @@ -707,7 +710,7 @@ msgid "" msgstr "" msgid "garbage collection" -msgstr "" +msgstr "zbieranie śmieci" msgid "" "The process of freeing memory when it is not used anymore. Python performs " @@ -717,7 +720,7 @@ msgid "" msgstr "" msgid "generator" -msgstr "" +msgstr "generator" msgid "" "A function which returns a :term:`generator iterator`. It looks like a " @@ -784,7 +787,7 @@ msgid "" msgstr "" msgid "GIL" -msgstr "" +msgstr "GIL" msgid "See :term:`global interpreter lock`." msgstr "" @@ -831,9 +834,9 @@ msgstr "" msgid "" "An object is *hashable* if it has a hash value which never changes during " -"its lifetime (it needs a :meth:`__hash__` method), and can be compared to " -"other objects (it needs an :meth:`__eq__` method). Hashable objects which " -"compare equal must have the same hash value." +"its lifetime (it needs a :meth:`~object.__hash__` method), and can be " +"compared to other objects (it needs an :meth:`~object.__eq__` method). " +"Hashable objects which compare equal must have the same hash value." msgstr "" msgid "" @@ -851,7 +854,7 @@ msgid "" msgstr "" msgid "IDLE" -msgstr "" +msgstr "IDLE" msgid "" "An Integrated Development and Learning Environment for Python. :ref:`idle` " @@ -881,7 +884,7 @@ msgid "" msgstr "" msgid "importing" -msgstr "" +msgstr "import" msgid "" "The process by which Python code in one module is made available to Python " @@ -889,7 +892,7 @@ msgid "" msgstr "" msgid "importer" -msgstr "" +msgstr "importer" msgid "" "An object that both finds and loads a module; both a :term:`finder` and :" @@ -897,7 +900,7 @@ msgid "" msgstr "" msgid "interactive" -msgstr "" +msgstr "interaktywne" msgid "" "Python has an interactive interpreter which means you can enter statements " @@ -908,7 +911,7 @@ msgid "" msgstr "" msgid "interpreted" -msgstr "" +msgstr "zinterpretowane" msgid "" "Python is an interpreted language, as opposed to a compiled one, though the " @@ -946,8 +949,8 @@ msgid "" "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:`__iter__` method or with a :meth:`__getitem__` method that implements :" -"term:`sequence` semantics." +"meth:`~iterator.__iter__` method or with a :meth:`~object.__getitem__` " +"method that implements :term:`sequence` semantics." msgstr "" msgid "" @@ -956,30 +959,30 @@ msgid "" "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 " -"``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`." +"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 "" +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:`__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." +"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." msgstr "" msgid "More information can be found in :ref:`typeiter`." @@ -987,7 +990,7 @@ msgstr "" msgid "" "CPython does not consistently apply the requirement that an iterator define :" -"meth:`__iter__`." +"meth:`~iterator.__iter__`." msgstr "" msgid "key function" @@ -1020,10 +1023,10 @@ msgid "keyword argument" msgstr "" msgid "See :term:`argument`." -msgstr "" +msgstr "Zobacz :term:`argument`." msgid "lambda" -msgstr "" +msgstr "lambda" msgid "" "An anonymous inline function consisting of a single :term:`expression` which " @@ -1032,7 +1035,7 @@ msgid "" msgstr "" msgid "LBYL" -msgstr "" +msgstr "LBYL" msgid "" "Look before you leap. This coding style explicitly tests for pre-conditions " @@ -1049,34 +1052,13 @@ msgid "" "This issue can be solved with locks or by using the EAFP approach." msgstr "" -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) `." -msgstr "" - -msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)." -msgstr "" - -msgid "" -"On Android and VxWorks, Python uses ``\"utf-8\"`` as the locale encoding." -msgstr "" - -msgid "``locale.getencoding()`` can be used to get the locale encoding." -msgstr "" - -msgid "See also the :term:`filesystem encoding and error handler`." -msgstr "" - msgid "list" -msgstr "" +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)." msgstr "" msgid "list comprehension" @@ -1091,7 +1073,7 @@ msgid "" msgstr "" msgid "loader" -msgstr "" +msgstr "ładowarka" msgid "" "An object that loads a module. It must define a method named :meth:" @@ -1100,9 +1082,30 @@ msgid "" "base class`." msgstr "" -msgid "magic method" +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) `." +msgstr "" + +msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)." +msgstr "" + +msgid "" +"On Android and VxWorks, Python uses ``\"utf-8\"`` as the locale encoding." +msgstr "" + +msgid ":func:`locale.getencoding` can be used to get the locale encoding." +msgstr "" + +msgid "See also the :term:`filesystem encoding and error handler`." msgstr "" +msgid "magic method" +msgstr "metoda magiczna" + msgid "An informal synonym for :term:`special method`." msgstr "" @@ -1133,7 +1136,7 @@ msgid "" msgstr "" msgid "metaclass" -msgstr "" +msgstr "metaklasa" msgid "" "The class of a class. Class definitions create a class name, a class " @@ -1151,7 +1154,7 @@ msgid "More information can be found in :ref:`metaclasses`." msgstr "" msgid "method" -msgstr "" +msgstr "metoda" msgid "" "A function which is defined inside a class body. If called as an attribute " @@ -1191,7 +1194,7 @@ msgid "" msgstr "" msgid "MRO" -msgstr "" +msgstr "MRO" msgid "See :term:`method resolution order`." msgstr "" @@ -1205,7 +1208,7 @@ msgid "" msgstr "" msgid "named tuple" -msgstr "" +msgstr "nazwana krotka" msgid "" "The term \"named tuple\" applies to any type or class that inherits from " @@ -1223,9 +1226,10 @@ 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 with the factory function :" -"func:`collections.namedtuple`. The latter technique also adds 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" @@ -1275,11 +1279,11 @@ 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:`__getattribute__`, class methods, and static methods." +"meth:`~object.__getattribute__`, class methods, and static methods." msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "" "Any data with state (attributes or value) and defined behavior (methods). " @@ -1287,7 +1291,7 @@ msgid "" msgstr "" msgid "package" -msgstr "" +msgstr "pakiet" msgid "" "A Python :term:`module` which can contain submodules or recursively, " @@ -1382,7 +1386,7 @@ msgid "path entry hook" msgstr "" msgid "" -"A callable on the :data:`sys.path_hook` list which returns a :term:`path " +"A callable on the :data:`sys.path_hooks` list which returns a :term:`path " "entry finder` if it knows how to find modules on a specific :term:`path " "entry`." msgstr "" @@ -1410,7 +1414,7 @@ msgid "" msgstr "" msgid "PEP" -msgstr "" +msgstr "PEP" msgid "" "Python Enhancement Proposal. A PEP is a design document providing " @@ -1428,10 +1432,10 @@ msgid "" msgstr "" msgid "See :pep:`1`." -msgstr "" +msgstr "Zob. :pep:`1`." msgid "portion" -msgstr "" +msgstr "część" msgid "" "A set of files in a single directory (possibly stored in a zip file) that " @@ -1473,7 +1477,7 @@ msgid "See :term:`provisional API`." msgstr "" msgid "Python 3000" -msgstr "" +msgstr "Python 3000" msgid "" "Nickname for the Python 3.x release line (coined long ago when the release " @@ -1482,7 +1486,7 @@ msgid "" msgstr "" msgid "Pythonic" -msgstr "" +msgstr "Pythoniczny" msgid "" "An idea or piece of code which closely follows the most common idioms of the " @@ -1535,7 +1539,7 @@ msgid "See also :term:`namespace package`." msgstr "" msgid "__slots__" -msgstr "" +msgstr "__slots__" msgid "" "A declaration inside a class that saves memory by pre-declaring space for " @@ -1546,24 +1550,27 @@ msgid "" msgstr "" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "" "An :term:`iterable` which supports efficient element access using integer " -"indices via the :meth:`__getitem__` special method and defines a :meth:" -"`__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:`__getitem__` and :meth:" -"`__len__`, but is considered a mapping rather than a sequence because the " -"lookups use arbitrary :term:`immutable` 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:`immutable` keys rather " +"than integers." msgstr "" msgid "" "The :class:`collections.abc.Sequence` abstract base class defines a much " -"richer interface that goes beyond just :meth:`__getitem__` and :meth:" -"`__len__`, adding :meth:`count`, :meth:`index`, :meth:`__contains__`, and :" -"meth:`__reversed__`. Types that implement this expanded interface can be " -"registered explicitly using :func:`~abc.ABCMeta.register`." +"richer interface that goes beyond just :meth:`~object.__getitem__` and :meth:" +"`~object.__len__`, adding :meth:`!count`, :meth:`!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" @@ -1613,13 +1620,23 @@ msgid "" "keyword:`if`, :keyword:`while` or :keyword:`for`." msgstr "" +msgid "static type checker" +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." +msgstr "" + msgid "strong reference" msgstr "" msgid "" -"In Python's C API, a strong reference is a reference to an object which " -"increments the object's reference count when it is created and decrements " -"the object's reference count when it is deleted." +"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." msgstr "" msgid "" @@ -1633,7 +1650,7 @@ msgid "See also :term:`borrowed reference`." msgstr "" msgid "text encoding" -msgstr "" +msgstr "kodowanie tekstu" msgid "" "A string in Python is a sequence of Unicode code points (in range " @@ -1650,9 +1667,11 @@ msgid "" "There are a variety of different text serialization :ref:`codecs `, which are collectively referred to as \"text encodings\"." msgstr "" +"Istnieje wiele różnych serializacji tekstu :ref:`codecs `, które są zbiorczo określane jako \"kodowanie tekstu\"." msgid "text file" -msgstr "" +msgstr "plik tekstowy" msgid "" "A :term:`file object` able to read and write :class:`str` objects. Often, a " @@ -1661,6 +1680,12 @@ msgid "" "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`." msgid "" "See also :term:`binary file` for a file object able to read and write :term:" @@ -1681,7 +1706,7 @@ msgid "" msgstr "" msgid "type" -msgstr "" +msgstr "typ" msgid "" "The type of a Python object determines what kind of object it is; every " @@ -1716,8 +1741,8 @@ msgstr "" msgid "" "Type hints are optional and are not enforced by Python but they are useful " -"to static type analysis tools, and aid IDEs with code completion and " -"refactoring." +"to :term:`static type checkers `. They can also aid " +"IDEs with code completion and refactoring." msgstr "" msgid "" @@ -1726,7 +1751,7 @@ msgid "" msgstr "" msgid "universal newlines" -msgstr "" +msgstr "uniwersalne nowe linie" msgid "" "A manner of interpreting text streams in which all of the following are " @@ -1797,7 +1822,7 @@ msgid "Fortran contiguous" msgstr "" msgid "magic" -msgstr "" +msgstr "magia" msgid "special" -msgstr "" +msgstr "specjalne" diff --git a/howto/annotations.po b/howto/annotations.po index 793a415694..479f1afd69 100644 --- a/howto/annotations.po +++ b/howto/annotations.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -25,13 +25,13 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Annotations Best Practices" -msgstr "" +msgstr "Najlepsze praktyki dotyczące adnotacji" msgid "author" msgstr "autor" msgid "Larry Hastings" -msgstr "" +msgstr "Larry Hastings" msgid "Abstract" msgstr "Streszczenie" @@ -190,8 +190,8 @@ msgid "" msgstr "" msgid "" -"If ``o`` is a callable (but not a class), use ``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 "" @@ -246,7 +246,7 @@ msgid "" msgstr "" msgid "``__annotations__`` Quirks" -msgstr "" +msgstr "``__annotations__`` Quirks" msgid "" "In all versions of Python 3, function objects lazy-create an annotations " diff --git a/howto/argparse.po b/howto/argparse.po index 3da9524b74..1a85ab3a46 100644 --- a/howto/argparse.po +++ b/howto/argparse.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -116,7 +116,7 @@ msgid "Introducing Positional arguments" msgstr "" msgid "An example::" -msgstr "" +msgstr "Przykład::" msgid "And running the code:" msgstr "" @@ -340,7 +340,7 @@ msgid "" msgstr "" msgid "And:" -msgstr "" +msgstr "I:" msgid "" "You can go quite far just with what we've learned so far, and we have only " @@ -399,6 +399,52 @@ msgid "" "time:" msgstr "" +msgid "How to translate the argparse output" +msgstr "" + +msgid "" +"The output of the :mod:`argparse` module such as its help text and error " +"messages are all made translatable using the :mod:`gettext` module. This " +"allows applications to easily localize messages produced by :mod:`argparse`. " +"See also :ref:`i18n-howto`." +msgstr "" + +msgid "For instance, in this :mod:`argparse` output:" +msgstr "" + +msgid "" +"The strings ``usage:``, ``positional arguments:``, ``options:`` and ``show " +"this help message and exit`` are all translatable." +msgstr "" + +msgid "" +"In order to translate these strings, they must first be extracted into a ``." +"po`` file. For example, using `Babel `__, run this " +"command:" +msgstr "" + +msgid "" +"This command will extract all translatable strings from the :mod:`argparse` " +"module and output them into a file named ``messages.po``. This command " +"assumes that your Python installation is in ``/usr/lib``." +msgstr "" + +msgid "" +"You can find out the location of the :mod:`argparse` module on your system " +"using this script::" +msgstr "" + +msgid "" +"Once the messages in the ``.po`` file are translated and the translations " +"are installed using :mod:`gettext`, :mod:`argparse` will be able to display " +"the translated messages." +msgstr "" + +msgid "" +"To translate your own strings in the :mod:`argparse` output, use :mod:" +"`gettext`." +msgstr "" + msgid "Conclusion" msgstr "" diff --git a/howto/clinic.po b/howto/clinic.po index f53f0f7e3b..1c060eadb7 100644 --- a/howto/clinic.po +++ b/howto/clinic.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Maciej Olko , 2021 -# Stefan Ocetkiewicz , 2023 +# Waldemar Stoczkowski, 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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" @@ -26,2058 +24,9 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Argument Clinic How-To" -msgstr "" - -msgid "author" -msgstr "autor" - -msgid "Larry Hastings" -msgstr "" - -msgid "Abstract" -msgstr "Streszczenie" - -msgid "" -"Argument Clinic is a preprocessor for CPython C files. Its purpose is to " -"automate all the boilerplate involved with writing argument parsing code for " -"\"builtins\". This document shows you how to convert your first C function " -"to work with Argument Clinic, and then introduces some advanced topics on " -"Argument Clinic usage." -msgstr "" - -msgid "" -"Currently Argument Clinic is considered internal-only for CPython. Its use " -"is not supported for files outside CPython, and no guarantees are made " -"regarding backwards compatibility for future versions. In other words: if " -"you maintain an external C extension for CPython, you're welcome to " -"experiment with Argument Clinic in your own code. But the version of " -"Argument Clinic that ships with the next version of CPython *could* be " -"totally incompatible and break all your code." -msgstr "" - -msgid "The Goals Of Argument Clinic" -msgstr "" - -msgid "" -"Argument Clinic's primary goal is to take over responsibility for all " -"argument parsing code inside CPython. This means that, when you convert a " -"function to work with Argument Clinic, that function should no longer do any " -"of its own argument parsing—the code generated by Argument Clinic should be " -"a \"black box\" to you, where CPython calls in at the top, and your code " -"gets called at the bottom, with ``PyObject *args`` (and maybe ``PyObject " -"*kwargs``) magically converted into the C variables and types you need." -msgstr "" - -msgid "" -"In order for Argument Clinic to accomplish its primary goal, it must be easy " -"to use. Currently, working with CPython's argument parsing library is a " -"chore, requiring maintaining redundant information in a surprising number of " -"places. When you use Argument Clinic, you don't have to repeat yourself." -msgstr "" - -msgid "" -"Obviously, no one would want to use Argument Clinic unless it's solving " -"their problem—and without creating new problems of its own. So it's " -"paramount that Argument Clinic generate correct code. It'd be nice if the " -"code was faster, too, but at the very least it should not introduce a major " -"speed regression. (Eventually Argument Clinic *should* make a major speedup " -"possible—we could rewrite its code generator to produce tailor-made argument " -"parsing code, rather than calling the general-purpose CPython argument " -"parsing library. That would make for the fastest argument parsing possible!)" -msgstr "" - -msgid "" -"Additionally, Argument Clinic must be flexible enough to work with any " -"approach to argument parsing. Python has some functions with some very " -"strange parsing behaviors; Argument Clinic's goal is to support all of them." -msgstr "" - -msgid "" -"Finally, the original motivation for Argument Clinic was to provide " -"introspection \"signatures\" for CPython builtins. It used to be, the " -"introspection query functions would throw an exception if you passed in a " -"builtin. With Argument Clinic, that's a thing of the past!" -msgstr "" - -msgid "" -"One idea you should keep in mind, as you work with Argument Clinic: the more " -"information you give it, the better job it'll be able to do. Argument Clinic " -"is admittedly relatively simple right now. But as it evolves it will get " -"more sophisticated, and it should be able to do many interesting and smart " -"things with all the information you give it." -msgstr "" - -msgid "Basic Concepts And Usage" -msgstr "" - -msgid "" -"Argument Clinic ships with CPython; you'll find it in ``Tools/clinic/clinic." -"py``. If you run that script, specifying a C file as an argument:" -msgstr "" - -msgid "" -"Argument Clinic will scan over the file looking for lines that look exactly " -"like this:" -msgstr "" - -msgid "" -"When it finds one, it reads everything up to a line that looks exactly like " -"this:" -msgstr "" - -msgid "" -"Everything in between these two lines is input for Argument Clinic. All of " -"these lines, including the beginning and ending comment lines, are " -"collectively called an Argument Clinic \"block\"." -msgstr "" - -msgid "" -"When Argument Clinic parses one of these blocks, it generates output. This " -"output is rewritten into the C file immediately after the block, followed by " -"a comment containing a checksum. The Argument Clinic block now looks like " -"this:" -msgstr "" - -msgid "" -"If you run Argument Clinic on the same file a second time, Argument Clinic " -"will discard the old output and write out the new output with a fresh " -"checksum line. However, if the input hasn't changed, the output won't " -"change either." -msgstr "" - -msgid "" -"You should never modify the output portion of an Argument Clinic block. " -"Instead, change the input until it produces the output you want. (That's " -"the purpose of the checksum—to detect if someone changed the output, as " -"these edits would be lost the next time Argument Clinic writes out fresh " -"output.)" -msgstr "" - -msgid "" -"For the sake of clarity, here's the terminology we'll use with Argument " -"Clinic:" -msgstr "" - -msgid "" -"The first line of the comment (``/*[clinic input]``) is the *start line*." -msgstr "" - -msgid "" -"The last line of the initial comment (``[clinic start generated code]*/``) " -"is the *end line*." -msgstr "" - -msgid "" -"The last line (``/*[clinic end generated code: checksum=...]*/``) is the " -"*checksum line*." -msgstr "" - -msgid "In between the start line and the end line is the *input*." -msgstr "" - -msgid "In between the end line and the checksum line is the *output*." -msgstr "" - -msgid "" -"All the text collectively, from the start line to the checksum line " -"inclusively, is the *block*. (A block that hasn't been successfully " -"processed by Argument Clinic yet doesn't have output or a checksum line, but " -"it's still considered a block.)" -msgstr "" - -msgid "Converting Your First Function" -msgstr "" - -msgid "" -"The best way to get a sense of how Argument Clinic works is to convert a " -"function to work with it. Here, then, are the bare minimum steps you'd need " -"to follow to convert a function to work with Argument Clinic. Note that for " -"code you plan to check in to CPython, you really should take the conversion " -"farther, using some of the advanced concepts you'll see later on in the " -"document (like \"return converters\" and \"self converters\"). But we'll " -"keep it simple for this walkthrough so you can learn." -msgstr "" - -msgid "Let's dive in!" -msgstr "" - -msgid "" -"Make sure you're working with a freshly updated checkout of the CPython " -"trunk." -msgstr "" - -msgid "" -"Find a Python builtin that calls either :c:func:`PyArg_ParseTuple` or :c:" -"func:`PyArg_ParseTupleAndKeywords`, and hasn't been converted to work with " -"Argument Clinic yet. For my example I'm using ``_pickle.Pickler.dump()``." -msgstr "" - -msgid "" -"If the call to the ``PyArg_Parse`` function uses any of the following format " -"units:" -msgstr "" - -msgid "" -"or if it has multiple calls to :c:func:`PyArg_ParseTuple`, you should choose " -"a different function. Argument Clinic *does* support all of these " -"scenarios. But these are advanced topics—let's do something simpler for " -"your first function." -msgstr "" - -msgid "" -"Also, if the function has multiple calls to :c:func:`PyArg_ParseTuple` or :c:" -"func:`PyArg_ParseTupleAndKeywords` where it supports different types for the " -"same argument, or if the function uses something besides PyArg_Parse " -"functions to parse its arguments, it probably isn't suitable for conversion " -"to Argument Clinic. Argument Clinic doesn't support generic functions or " -"polymorphic parameters." -msgstr "" - -msgid "Add the following boilerplate above the function, creating our block::" -msgstr "" - -msgid "" -"Cut the docstring and paste it in between the ``[clinic]`` lines, removing " -"all the junk that makes it a properly quoted C string. When you're done you " -"should have just the text, based at the left margin, with no line wider than " -"80 characters. (Argument Clinic will preserve indents inside the docstring.)" -msgstr "" - -msgid "" -"If the old docstring had a first line that looked like a function signature, " -"throw that line away. (The docstring doesn't need it anymore—when you use " -"``help()`` on your builtin in the future, the first line will be built " -"automatically based on the function's signature.)" -msgstr "" - -msgid "Sample::" -msgstr "" - -msgid "" -"If your docstring doesn't have a \"summary\" line, Argument Clinic will " -"complain. So let's make sure it has one. The \"summary\" line should be a " -"paragraph consisting of a single 80-column line at the beginning of the " -"docstring." -msgstr "" - -msgid "" -"(Our example docstring consists solely of a summary line, so the sample code " -"doesn't have to change for this step.)" -msgstr "" - -msgid "" -"Above the docstring, enter the name of the function, followed by a blank " -"line. This should be the Python name of the function, and should be the " -"full dotted path to the function—it should start with the name of the " -"module, include any sub-modules, and if the function is a method on a class " -"it should include the class name too." -msgstr "" - -msgid "" -"If this is the first time that module or class has been used with Argument " -"Clinic in this C file, you must declare the module and/or class. Proper " -"Argument Clinic hygiene prefers declaring these in a separate block " -"somewhere near the top of the C file, in the same way that include files and " -"statics go at the top. (In our sample code we'll just show the two blocks " -"next to each other.)" -msgstr "" - -msgid "" -"The name of the class and module should be the same as the one seen by " -"Python. Check the name defined in the :c:type:`PyModuleDef` or :c:type:" -"`PyTypeObject` as appropriate." -msgstr "" - -msgid "" -"When you declare a class, you must also specify two aspects of its type in " -"C: the type declaration you'd use for a pointer to an instance of this " -"class, and a pointer to the :c:type:`PyTypeObject` for this class." -msgstr "" - -msgid "" -"Declare each of the parameters to the function. Each parameter should get " -"its own line. All the parameter lines should be indented from the function " -"name and the docstring." -msgstr "" - -msgid "The general form of these parameter lines is as follows:" -msgstr "" - -msgid "If the parameter has a default value, add that after the converter:" -msgstr "" - -msgid "" -"Argument Clinic's support for \"default values\" is quite sophisticated; " -"please see :ref:`the section below on default values ` for " -"more information." -msgstr "" - -msgid "Add a blank line below the parameters." -msgstr "" - -msgid "" -"What's a \"converter\"? It establishes both the type of the variable used " -"in C, and the method to convert the Python value into a C value at runtime. " -"For now you're going to use what's called a \"legacy converter\"—a " -"convenience syntax intended to make porting old code into Argument Clinic " -"easier." -msgstr "" - -msgid "" -"For each parameter, copy the \"format unit\" for that parameter from the " -"``PyArg_Parse()`` format argument and specify *that* as its converter, as a " -"quoted string. (\"format unit\" is the formal name for the one-to-three " -"character substring of the ``format`` parameter that tells the argument " -"parsing function what the type of the variable is and how to convert it. " -"For more on format units please see :ref:`arg-parsing`.)" -msgstr "" - -msgid "" -"For multicharacter format units like ``z#``, use the entire two-or-three " -"character string." -msgstr "" - -msgid "" -"If your function has ``|`` in the format string, meaning some parameters " -"have default values, you can ignore it. Argument Clinic infers which " -"parameters are optional based on whether or not they have default values." -msgstr "" - -msgid "" -"If your function has ``$`` in the format string, meaning it takes keyword-" -"only arguments, specify ``*`` on a line by itself before the first keyword-" -"only argument, indented the same as the parameter lines." -msgstr "" - -msgid "(``_pickle.Pickler.dump`` has neither, so our sample is unchanged.)" -msgstr "" - -msgid "" -"If the existing C function calls :c:func:`PyArg_ParseTuple` (as opposed to :" -"c:func:`PyArg_ParseTupleAndKeywords`), then all its arguments are positional-" -"only." -msgstr "" - -msgid "" -"To mark all parameters as positional-only in Argument Clinic, add a ``/`` on " -"a line by itself after the last parameter, indented the same as the " -"parameter lines." -msgstr "" - -msgid "" -"Currently this is all-or-nothing; either all parameters are positional-only, " -"or none of them are. (In the future Argument Clinic may relax this " -"restriction.)" -msgstr "" - -msgid "" -"It's helpful to write a per-parameter docstring for each parameter. But per-" -"parameter docstrings are optional; you can skip this step if you prefer." -msgstr "" - -msgid "" -"Here's how to add a per-parameter docstring. The first line of the per-" -"parameter docstring must be indented further than the parameter definition. " -"The left margin of this first line establishes the left margin for the whole " -"per-parameter docstring; all the text you write will be outdented by this " -"amount. You can write as much text as you like, across multiple lines if " -"you wish." -msgstr "" - -msgid "" -"Save and close the file, then run ``Tools/clinic/clinic.py`` on it. With " -"luck everything worked---your block now has output, and a ``.c.h`` file has " -"been generated! Reopen the file in your text editor to see::" -msgstr "" - -msgid "" -"Obviously, if Argument Clinic didn't produce any output, it's because it " -"found an error in your input. Keep fixing your errors and retrying until " -"Argument Clinic processes your file without complaint." -msgstr "" - -msgid "" -"For readability, most of the glue code has been generated to a ``.c.h`` " -"file. You'll need to include that in your original ``.c`` file, typically " -"right after the clinic module block::" -msgstr "" - -msgid "" -"Double-check that the argument-parsing code Argument Clinic generated looks " -"basically the same as the existing code." -msgstr "" - -msgid "" -"First, ensure both places use the same argument-parsing function. The " -"existing code must call either :c:func:`PyArg_ParseTuple` or :c:func:" -"`PyArg_ParseTupleAndKeywords`; ensure that the code generated by Argument " -"Clinic calls the *exact* same function." -msgstr "" - -msgid "" -"Second, the format string passed in to :c:func:`PyArg_ParseTuple` or :c:func:" -"`PyArg_ParseTupleAndKeywords` should be *exactly* the same as the hand-" -"written one in the existing function, up to the colon or semi-colon." -msgstr "" - -msgid "" -"(Argument Clinic always generates its format strings with a ``:`` followed " -"by the name of the function. If the existing code's format string ends with " -"``;``, to provide usage help, this change is harmless—don't worry about it.)" -msgstr "" - -msgid "" -"Third, for parameters whose format units require two arguments (like a " -"length variable, or an encoding string, or a pointer to a conversion " -"function), ensure that the second argument is *exactly* the same between the " -"two invocations." -msgstr "" - -msgid "" -"Fourth, inside the output portion of the block you'll find a preprocessor " -"macro defining the appropriate static :c:type:`PyMethodDef` structure for " -"this builtin::" -msgstr "" - -msgid "" -"This static structure should be *exactly* the same as the existing static :c:" -"type:`PyMethodDef` structure for this builtin." -msgstr "" - -msgid "" -"If any of these items differ in *any way*, adjust your Argument Clinic " -"function specification and rerun ``Tools/clinic/clinic.py`` until they *are* " -"the same." -msgstr "" - -msgid "" -"Notice that the last line of its output is the declaration of your \"impl\" " -"function. This is where the builtin's implementation goes. Delete the " -"existing prototype of the function you're modifying, but leave the opening " -"curly brace. Now delete its argument parsing code and the declarations of " -"all the variables it dumps the arguments into. Notice how the Python " -"arguments are now arguments to this impl function; if the implementation " -"used different names for these variables, fix it." -msgstr "" - -msgid "" -"Let's reiterate, just because it's kind of weird. Your code should now look " -"like this::" -msgstr "" - -msgid "" -"Argument Clinic generated the checksum line and the function prototype just " -"above it. You should write the opening (and closing) curly braces for the " -"function, and the implementation inside." -msgstr "" - -msgid "" -"Remember the macro with the :c:type:`PyMethodDef` structure for this " -"function? Find the existing :c:type:`PyMethodDef` structure for this " -"function and replace it with a reference to the macro. (If the builtin is " -"at module scope, this will probably be very near the end of the file; if the " -"builtin is a class method, this will probably be below but relatively near " -"to the implementation.)" -msgstr "" - -msgid "" -"Note that the body of the macro contains a trailing comma. So when you " -"replace the existing static :c:type:`PyMethodDef` structure with the macro, " -"*don't* add a comma to the end." -msgstr "" - -msgid "" -"Compile, then run the relevant portions of the regression-test suite. This " -"change should not introduce any new compile-time warnings or errors, and " -"there should be no externally visible change to Python's behavior." -msgstr "" - -msgid "" -"Well, except for one difference: ``inspect.signature()`` run on your " -"function should now provide a valid signature!" -msgstr "" - -msgid "" -"Congratulations, you've ported your first function to work with Argument " -"Clinic!" -msgstr "" - -msgid "Advanced Topics" -msgstr "" - -msgid "" -"Now that you've had some experience working with Argument Clinic, it's time " -"for some advanced topics." -msgstr "" - -msgid "Symbolic default values" -msgstr "" - -msgid "" -"The default value you provide for a parameter can't be any arbitrary " -"expression. Currently the following are explicitly supported:" -msgstr "" - -msgid "Numeric constants (integer and float)" -msgstr "" - -msgid "String constants" -msgstr "" - -msgid "``True``, ``False``, and ``None``" -msgstr "" - -msgid "" -"Simple symbolic constants like ``sys.maxsize``, which must start with the " -"name of the module" -msgstr "" - -msgid "" -"(In the future, this may need to get even more elaborate, to allow full " -"expressions like ``CONSTANT - 1``.)" -msgstr "" - -msgid "Renaming the C functions and variables generated by Argument Clinic" -msgstr "" - -msgid "" -"Argument Clinic automatically names the functions it generates for you. " -"Occasionally this may cause a problem, if the generated name collides with " -"the name of an existing C function. There's an easy solution: override the " -"names used for the C functions. Just add the keyword ``\"as\"`` to your " -"function declaration line, followed by the function name you wish to use. " -"Argument Clinic will use that function name for the base (generated) " -"function, then add ``\"_impl\"`` to the end and use that for the name of the " -"impl function." -msgstr "" - -msgid "" -"For example, if we wanted to rename the C function names generated for " -"``pickle.Pickler.dump``, it'd look like this::" -msgstr "" - -msgid "" -"The base function would now be named ``pickler_dumper()``, and the impl " -"function would now be named ``pickler_dumper_impl()``." -msgstr "" - -msgid "" -"Similarly, you may have a problem where you want to give a parameter a " -"specific Python name, but that name may be inconvenient in C. Argument " -"Clinic allows you to give a parameter different names in Python and in C, " -"using the same ``\"as\"`` syntax::" -msgstr "" - -msgid "" -"Here, the name used in Python (in the signature and the ``keywords`` array) " -"would be ``file``, but the C variable would be named ``file_obj``." -msgstr "" - -msgid "You can use this to rename the ``self`` parameter too!" -msgstr "" - -msgid "Converting functions using PyArg_UnpackTuple" -msgstr "" - -msgid "" -"To convert a function parsing its arguments with :c:func:" -"`PyArg_UnpackTuple`, simply write out all the arguments, specifying each as " -"an ``object``. You may specify the ``type`` argument to cast the type as " -"appropriate. All arguments should be marked positional-only (add a ``/`` on " -"a line by itself after the last argument)." -msgstr "" - -msgid "" -"Currently the generated code will use :c:func:`PyArg_ParseTuple`, but this " -"will change soon." -msgstr "" - -msgid "Optional Groups" -msgstr "" - -msgid "" -"Some legacy functions have a tricky approach to parsing their arguments: " -"they count the number of positional arguments, then use a ``switch`` " -"statement to call one of several different :c:func:`PyArg_ParseTuple` calls " -"depending on how many positional arguments there are. (These functions " -"cannot accept keyword-only arguments.) This approach was used to simulate " -"optional arguments back before :c:func:`PyArg_ParseTupleAndKeywords` was " -"created." -msgstr "" - -msgid "" -"While functions using this approach can often be converted to use :c:func:" -"`PyArg_ParseTupleAndKeywords`, optional arguments, and default values, it's " -"not always possible. Some of these legacy functions have behaviors :c:func:" -"`PyArg_ParseTupleAndKeywords` doesn't directly support. The most obvious " -"example is the builtin function ``range()``, which has an optional argument " -"on the *left* side of its required argument! Another example is ``curses." -"window.addch()``, which has a group of two arguments that must always be " -"specified together. (The arguments are called ``x`` and ``y``; if you call " -"the function passing in ``x``, you must also pass in ``y``—and if you don't " -"pass in ``x`` you may not pass in ``y`` either.)" -msgstr "" - -msgid "" -"In any case, the goal of Argument Clinic is to support argument parsing for " -"all existing CPython builtins without changing their semantics. Therefore " -"Argument Clinic supports this alternate approach to parsing, using what are " -"called *optional groups*. Optional groups are groups of arguments that must " -"all be passed in together. They can be to the left or the right of the " -"required arguments. They can *only* be used with positional-only parameters." -msgstr "" - -msgid "" -"Optional groups are *only* intended for use when converting functions that " -"make multiple calls to :c:func:`PyArg_ParseTuple`! Functions that use *any* " -"other approach for parsing arguments should *almost never* be converted to " -"Argument Clinic using optional groups. Functions using optional groups " -"currently cannot have accurate signatures in Python, because Python just " -"doesn't understand the concept. Please avoid using optional groups wherever " -"possible." -msgstr "" - -msgid "" -"To specify an optional group, add a ``[`` on a line by itself before the " -"parameters you wish to group together, and a ``]`` on a line by itself after " -"these parameters. As an example, here's how ``curses.window.addch`` uses " -"optional groups to make the first two parameters and the last parameter " -"optional::" -msgstr "" - -msgid "Notes:" -msgstr "Uwagi:" - -msgid "" -"For every optional group, one additional parameter will be passed into the " -"impl function representing the group. The parameter will be an int named " -"``group_{direction}_{number}``, where ``{direction}`` is either ``right`` or " -"``left`` depending on whether the group is before or after the required " -"parameters, and ``{number}`` is a monotonically increasing number (starting " -"at 1) indicating how far away the group is from the required parameters. " -"When the impl is called, this parameter will be set to zero if this group " -"was unused, and set to non-zero if this group was used. (By used or unused, " -"I mean whether or not the parameters received arguments in this invocation.)" -msgstr "" - -msgid "" -"If there are no required arguments, the optional groups will behave as if " -"they're to the right of the required arguments." -msgstr "" - -msgid "" -"In the case of ambiguity, the argument parsing code favors parameters on the " -"left (before the required parameters)." -msgstr "" - -msgid "Optional groups can only contain positional-only parameters." -msgstr "" - -msgid "" -"Optional groups are *only* intended for legacy code. Please do not use " -"optional groups for new code." -msgstr "" - -msgid "Using real Argument Clinic converters, instead of \"legacy converters\"" -msgstr "" - -msgid "" -"To save time, and to minimize how much you need to learn to achieve your " -"first port to Argument Clinic, the walkthrough above tells you to use " -"\"legacy converters\". \"Legacy converters\" are a convenience, designed " -"explicitly to make porting existing code to Argument Clinic easier. And to " -"be clear, their use is acceptable when porting code for Python 3.4." -msgstr "" - -msgid "" -"However, in the long term we probably want all our blocks to use Argument " -"Clinic's real syntax for converters. Why? A couple reasons:" -msgstr "" - -msgid "" -"The proper converters are far easier to read and clearer in their intent." -msgstr "" - -msgid "" -"There are some format units that are unsupported as \"legacy converters\", " -"because they require arguments, and the legacy converter syntax doesn't " -"support specifying arguments." -msgstr "" - -msgid "" -"In the future we may have a new argument parsing library that isn't " -"restricted to what :c:func:`PyArg_ParseTuple` supports; this flexibility " -"won't be available to parameters using legacy converters." -msgstr "" - -msgid "" -"Therefore, if you don't mind a little extra effort, please use the normal " -"converters instead of legacy converters." -msgstr "" - -msgid "" -"In a nutshell, the syntax for Argument Clinic (non-legacy) converters looks " -"like a Python function call. However, if there are no explicit arguments to " -"the function (all functions take their default values), you may omit the " -"parentheses. Thus ``bool`` and ``bool()`` are exactly the same converters." -msgstr "" - -msgid "" -"All arguments to Argument Clinic converters are keyword-only. All Argument " -"Clinic converters accept the following arguments:" -msgstr "" - -msgid "``c_default``" -msgstr "" - -msgid "" -"The default value for this parameter when defined in C. Specifically, this " -"will be the initializer for the variable declared in the \"parse " -"function\". See :ref:`the section on default values ` for " -"how to use this. Specified as a string." -msgstr "" - -msgid "``annotation``" -msgstr "" - -msgid "" -"The annotation value for this parameter. Not currently supported, because :" -"pep:`8` mandates that the Python library may not use annotations." -msgstr "" - -msgid "" -"In addition, some converters accept additional arguments. Here is a list of " -"these arguments, along with their meanings:" -msgstr "" - -msgid "``accept``" -msgstr "" - -msgid "" -"A set of Python types (and possibly pseudo-types); this restricts the " -"allowable Python argument to values of these types. (This is not a general-" -"purpose facility; as a rule it only supports specific lists of types as " -"shown in the legacy converter table.)" -msgstr "" - -msgid "To accept ``None``, add ``NoneType`` to this set." -msgstr "" - -msgid "``bitwise``" -msgstr "" - -msgid "" -"Only supported for unsigned integers. The native integer value of this " -"Python argument will be written to the parameter without any range checking, " -"even for negative values." -msgstr "" - -msgid "``converter``" -msgstr "" - -msgid "" -"Only supported by the ``object`` converter. Specifies the name of a :ref:`C " -"\"converter function\" ` to use to convert this object to a " -"native type." -msgstr "" - -msgid "``encoding``" -msgstr "" - -msgid "" -"Only supported for strings. Specifies the encoding to use when converting " -"this string from a Python str (Unicode) value into a C ``char *`` value." -msgstr "" - -msgid "``subclass_of``" -msgstr "" - -msgid "" -"Only supported for the ``object`` converter. Requires that the Python value " -"be a subclass of a Python type, as expressed in C." -msgstr "" - -msgid "``type``" -msgstr "" - -msgid "" -"Only supported for the ``object`` and ``self`` converters. Specifies the C " -"type that will be used to declare the variable. Default value is " -"``\"PyObject *\"``." -msgstr "" - -msgid "``zeroes``" -msgstr "" - -msgid "" -"Only supported for strings. If true, embedded NUL bytes (``'\\\\0'``) are " -"permitted inside the value. The length of the string will be passed in to " -"the impl function, just after the string parameter, as a parameter named " -"``_length``." -msgstr "" - -msgid "" -"Please note, not every possible combination of arguments will work. Usually " -"these arguments are implemented by specific ``PyArg_ParseTuple`` *format " -"units*, with specific behavior. For example, currently you cannot call " -"``unsigned_short`` without also specifying ``bitwise=True``. Although it's " -"perfectly reasonable to think this would work, these semantics don't map to " -"any existing format unit. So Argument Clinic doesn't support it. (Or, at " -"least, not yet.)" -msgstr "" - -msgid "" -"Below is a table showing the mapping of legacy converters into real Argument " -"Clinic converters. On the left is the legacy converter, on the right is the " -"text you'd replace it with." -msgstr "" - -msgid "``'B'``" -msgstr "``'B'``" - -msgid "``unsigned_char(bitwise=True)``" -msgstr "" - -msgid "``'b'``" -msgstr "``'b'``" - -msgid "``unsigned_char``" -msgstr "" - -msgid "``'c'``" -msgstr "" - -msgid "``char``" -msgstr "" - -msgid "``'C'``" -msgstr "" - -msgid "``int(accept={str})``" -msgstr "" - -msgid "``'d'``" -msgstr "``'d'``" - -msgid "``double``" -msgstr "" - -msgid "``'D'``" -msgstr "" - -msgid "``Py_complex``" -msgstr "" - -msgid "``'es'``" -msgstr "" - -msgid "``str(encoding='name_of_encoding')``" -msgstr "" - -msgid "``'es#'``" -msgstr "" - -msgid "``str(encoding='name_of_encoding', zeroes=True)``" -msgstr "" - -msgid "``'et'``" -msgstr "" - -msgid "``str(encoding='name_of_encoding', accept={bytes, bytearray, str})``" -msgstr "" - -msgid "``'et#'``" -msgstr "" - -msgid "" -"``str(encoding='name_of_encoding', accept={bytes, bytearray, str}, " -"zeroes=True)``" -msgstr "" - -msgid "``'f'``" -msgstr "``'f'``" - -msgid "``float``" -msgstr "" - -msgid "``'h'``" -msgstr "``'h'``" - -msgid "``short``" -msgstr "" - -msgid "``'H'``" -msgstr "``'H'``" - -msgid "``unsigned_short(bitwise=True)``" -msgstr "" - -msgid "``'i'``" -msgstr "``'i'``" - -msgid "``int``" -msgstr "" - -msgid "``'I'``" -msgstr "``'I'``" - -msgid "``unsigned_int(bitwise=True)``" -msgstr "" - -msgid "``'k'``" -msgstr "" - -msgid "``unsigned_long(bitwise=True)``" -msgstr "" - -msgid "``'K'``" -msgstr "" - -msgid "``unsigned_long_long(bitwise=True)``" -msgstr "" - -msgid "``'l'``" -msgstr "``'I'``" - -msgid "``long``" -msgstr "" - -msgid "``'L'``" -msgstr "``'L'``" - -msgid "``long long``" -msgstr "" - -msgid "``'n'``" -msgstr "" - -msgid "``Py_ssize_t``" -msgstr "" - -msgid "``'O'``" -msgstr "" - -msgid "``object``" -msgstr "" - -msgid "``'O!'``" -msgstr "" - -msgid "``object(subclass_of='&PySomething_Type')``" -msgstr "" - -msgid "``'O&'``" -msgstr "" - -msgid "``object(converter='name_of_c_function')``" -msgstr "" - -msgid "``'p'``" -msgstr "" - -msgid "``bool``" -msgstr "" - -msgid "``'S'``" -msgstr "" - -msgid "``PyBytesObject``" -msgstr "" - -msgid "``'s'``" -msgstr "" - -msgid "``str``" -msgstr "" - -msgid "``'s#'``" -msgstr "" - -msgid "``str(zeroes=True)``" -msgstr "" - -msgid "``'s*'``" -msgstr "" - -msgid "``Py_buffer(accept={buffer, str})``" -msgstr "" - -msgid "``'U'``" -msgstr "" - -msgid "``unicode``" -msgstr "" - -msgid "``'u'``" -msgstr "``'u'``" - -msgid "``Py_UNICODE``" -msgstr "" - -msgid "``'u#'``" -msgstr "" - -msgid "``Py_UNICODE(zeroes=True)``" -msgstr "" - -msgid "``'w*'``" -msgstr "" - -msgid "``Py_buffer(accept={rwbuffer})``" -msgstr "" - -msgid "``'Y'``" -msgstr "" - -msgid "``PyByteArrayObject``" -msgstr "" - -msgid "``'y'``" -msgstr "" - -msgid "``str(accept={bytes})``" -msgstr "" - -msgid "``'y#'``" -msgstr "" - -msgid "``str(accept={robuffer}, zeroes=True)``" -msgstr "" - -msgid "``'y*'``" -msgstr "" - -msgid "``Py_buffer``" -msgstr "" - -msgid "``'Z'``" -msgstr "" - -msgid "``Py_UNICODE(accept={str, NoneType})``" -msgstr "" - -msgid "``'Z#'``" -msgstr "" - -msgid "``Py_UNICODE(accept={str, NoneType}, zeroes=True)``" -msgstr "" - -msgid "``'z'``" -msgstr "" - -msgid "``str(accept={str, NoneType})``" -msgstr "" - -msgid "``'z#'``" -msgstr "" - -msgid "``str(accept={str, NoneType}, zeroes=True)``" -msgstr "" - -msgid "``'z*'``" -msgstr "" - -msgid "``Py_buffer(accept={buffer, str, NoneType})``" -msgstr "" - -msgid "" -"As an example, here's our sample ``pickle.Pickler.dump`` using the proper " -"converter::" -msgstr "" - -msgid "" -"One advantage of real converters is that they're more flexible than legacy " -"converters. For example, the ``unsigned_int`` converter (and all the " -"``unsigned_`` converters) can be specified without ``bitwise=True``. Their " -"default behavior performs range checking on the value, and they won't accept " -"negative numbers. You just can't do that with a legacy converter!" -msgstr "" - -msgid "" -"Argument Clinic will show you all the converters it has available. For each " -"converter it'll show you all the parameters it accepts, along with the " -"default value for each parameter. Just run ``Tools/clinic/clinic.py --" -"converters`` to see the full list." -msgstr "" - -msgid "Py_buffer" -msgstr "" - -msgid "" -"When using the ``Py_buffer`` converter (or the ``'s*'``, ``'w*'``, ``'*y'``, " -"or ``'z*'`` legacy converters), you *must* not call :c:func:" -"`PyBuffer_Release` on the provided buffer. Argument Clinic generates code " -"that does it for you (in the parsing function)." -msgstr "" - -msgid "Advanced converters" -msgstr "" - -msgid "" -"Remember those format units you skipped for your first time because they " -"were advanced? Here's how to handle those too." -msgstr "" - -msgid "" -"The trick is, all those format units take arguments—either conversion " -"functions, or types, or strings specifying an encoding. (But \"legacy " -"converters\" don't support arguments. That's why we skipped them for your " -"first function.) The argument you specified to the format unit is now an " -"argument to the converter; this argument is either ``converter`` (for " -"``O&``), ``subclass_of`` (for ``O!``), or ``encoding`` (for all the format " -"units that start with ``e``)." -msgstr "" - -msgid "" -"When using ``subclass_of``, you may also want to use the other custom " -"argument for ``object()``: ``type``, which lets you set the type actually " -"used for the parameter. For example, if you want to ensure that the object " -"is a subclass of ``PyUnicode_Type``, you probably want to use the converter " -"``object(type='PyUnicodeObject *', subclass_of='&PyUnicode_Type')``." -msgstr "" - -msgid "" -"One possible problem with using Argument Clinic: it takes away some possible " -"flexibility for the format units starting with ``e``. When writing a " -"``PyArg_Parse`` call by hand, you could theoretically decide at runtime what " -"encoding string to pass in to :c:func:`PyArg_ParseTuple`. But now this " -"string must be hard-coded at Argument-Clinic-preprocessing-time. This " -"limitation is deliberate; it made supporting this format unit much easier, " -"and may allow for future optimizations. This restriction doesn't seem " -"unreasonable; CPython itself always passes in static hard-coded encoding " -"strings for parameters whose format units start with ``e``." -msgstr "" - -msgid "Parameter default values" -msgstr "" - -msgid "" -"Default values for parameters can be any of a number of values. At their " -"simplest, they can be string, int, or float literals:" -msgstr "" - -msgid "They can also use any of Python's built-in constants:" -msgstr "" - -msgid "" -"There's also special support for a default value of ``NULL``, and for simple " -"expressions, documented in the following sections." -msgstr "" - -msgid "The ``NULL`` default value" -msgstr "" - -msgid "" -"For string and object parameters, you can set them to ``None`` to indicate " -"that there's no default. However, that means the C variable will be " -"initialized to ``Py_None``. For convenience's sakes, there's a special " -"value called ``NULL`` for just this reason: from Python's perspective it " -"behaves like a default value of ``None``, but the C variable is initialized " -"with ``NULL``." -msgstr "" - -msgid "Expressions specified as default values" -msgstr "" - -msgid "" -"The default value for a parameter can be more than just a literal value. It " -"can be an entire expression, using math operators and looking up attributes " -"on objects. However, this support isn't exactly simple, because of some non-" -"obvious semantics." -msgstr "" - -msgid "Consider the following example:" -msgstr "" - -msgid "" -"``sys.maxsize`` can have different values on different platforms. Therefore " -"Argument Clinic can't simply evaluate that expression locally and hard-code " -"it in C. So it stores the default in such a way that it will get evaluated " -"at runtime, when the user asks for the function's signature." -msgstr "" - -msgid "" -"What namespace is available when the expression is evaluated? It's " -"evaluated in the context of the module the builtin came from. So, if your " -"module has an attribute called \"``max_widgets``\", you may simply use it:" -msgstr "" - -msgid "" -"If the symbol isn't found in the current module, it fails over to looking in " -"``sys.modules``. That's how it can find ``sys.maxsize`` for example. " -"(Since you don't know in advance what modules the user will load into their " -"interpreter, it's best to restrict yourself to modules that are preloaded by " -"Python itself.)" -msgstr "" - -msgid "" -"Evaluating default values only at runtime means Argument Clinic can't " -"compute the correct equivalent C default value. So you need to tell it " -"explicitly. When you use an expression, you must also specify the equivalent " -"expression in C, using the ``c_default`` parameter to the converter:" -msgstr "" - -msgid "" -"Another complication: Argument Clinic can't know in advance whether or not " -"the expression you supply is valid. It parses it to make sure it looks " -"legal, but it can't *actually* know. You must be very careful when using " -"expressions to specify values that are guaranteed to be valid at runtime!" -msgstr "" - -msgid "" -"Finally, because expressions must be representable as static C values, there " -"are many restrictions on legal expressions. Here's a list of Python " -"features you're not permitted to use:" -msgstr "" - -msgid "Function calls." -msgstr "" - -msgid "Inline if statements (``3 if foo else 5``)." -msgstr "" - -msgid "Automatic sequence unpacking (``*[1, 2, 3]``)." -msgstr "" - -msgid "List/set/dict comprehensions and generator expressions." -msgstr "" - -msgid "Tuple/list/set/dict literals." -msgstr "" - -msgid "Using a return converter" -msgstr "" - -msgid "" -"By default, the impl function Argument Clinic generates for you returns :c:" -"type:`PyObject * `. But your C function often computes some C " -"type, then converts it into the :c:type:`!PyObject *` at the last moment. " -"Argument Clinic handles converting your inputs from Python types into native " -"C types—why not have it convert your return value from a native C type into " -"a Python type too?" -msgstr "" - -msgid "" -"That's what a \"return converter\" does. It changes your impl function to " -"return some C type, then adds code to the generated (non-impl) function to " -"handle converting that value into the appropriate :c:type:`!PyObject *`." -msgstr "" - -msgid "" -"The syntax for return converters is similar to that of parameter converters. " -"You specify the return converter like it was a return annotation on the " -"function itself, using ``->`` notation." -msgstr "" - -msgid "For example:" -msgstr "Na przykład::" - -msgid "" -"Return converters behave much the same as parameter converters; they take " -"arguments, the arguments are all keyword-only, and if you're not changing " -"any of the default arguments you can omit the parentheses." -msgstr "" - -msgid "" -"(If you use both ``\"as\"`` *and* a return converter for your function, the " -"``\"as\"`` should come before the return converter.)" -msgstr "" - -msgid "" -"There's one additional complication when using return converters: how do you " -"indicate an error has occurred? Normally, a function returns a valid (non-" -"``NULL``) pointer for success, and ``NULL`` for failure. But if you use an " -"integer return converter, all integers are valid. How can Argument Clinic " -"detect an error? Its solution: each return converter implicitly looks for a " -"special value that indicates an error. If you return that value, and an " -"error has been set (``PyErr_Occurred()`` returns a true value), then the " -"generated code will propagate the error. Otherwise it will encode the value " -"you return like normal." -msgstr "" - -msgid "Currently Argument Clinic supports only a few return converters:" -msgstr "" - -msgid "" -"None of these take parameters. For all of these, return ``-1`` to indicate " -"error." -msgstr "" - -msgid "" -"(There's also an experimental ``NoneType`` converter, which lets you return " -"``Py_None`` on success or ``NULL`` on failure, without having to increment " -"the reference count on ``Py_None``. I'm not sure it adds enough clarity to " -"be worth using.)" -msgstr "" - -msgid "" -"To see all the return converters Argument Clinic supports, along with their " -"parameters (if any), just run ``Tools/clinic/clinic.py --converters`` for " -"the full list." -msgstr "" - -msgid "Cloning existing functions" -msgstr "" - -msgid "" -"If you have a number of functions that look similar, you may be able to use " -"Clinic's \"clone\" feature. When you clone an existing function, you reuse:" -msgstr "" - -msgid "its parameters, including" -msgstr "" - -msgid "their names," -msgstr "" - -msgid "their converters, with all parameters," -msgstr "" - -msgid "their default values," -msgstr "" - -msgid "their per-parameter docstrings," -msgstr "" - -msgid "" -"their *kind* (whether they're positional only, positional or keyword, or " -"keyword only), and" -msgstr "" - -msgid "its return converter." -msgstr "" - -msgid "" -"The only thing not copied from the original function is its docstring; the " -"syntax allows you to specify a new docstring." -msgstr "" - -msgid "Here's the syntax for cloning a function::" -msgstr "" - -msgid "" -"(The functions can be in different modules or classes. I wrote ``module." -"class`` in the sample just to illustrate that you must use the full path to " -"*both* functions.)" -msgstr "" - -msgid "" -"Sorry, there's no syntax for partially cloning a function, or cloning a " -"function then modifying it. Cloning is an all-or nothing proposition." -msgstr "" - -msgid "" -"Also, the function you are cloning from must have been previously defined in " -"the current file." -msgstr "" - -msgid "Calling Python code" -msgstr "" - -msgid "" -"The rest of the advanced topics require you to write Python code which lives " -"inside your C file and modifies Argument Clinic's runtime state. This is " -"simple: you simply define a Python block." -msgstr "" - -msgid "" -"A Python block uses different delimiter lines than an Argument Clinic " -"function block. It looks like this::" -msgstr "" - -msgid "" -"All the code inside the Python block is executed at the time it's parsed. " -"All text written to stdout inside the block is redirected into the " -"\"output\" after the block." -msgstr "" - -msgid "" -"As an example, here's a Python block that adds a static integer variable to " -"the C code::" -msgstr "" - -msgid "Using a \"self converter\"" -msgstr "" - -msgid "" -"Argument Clinic automatically adds a \"self\" parameter for you using a " -"default converter. It automatically sets the ``type`` of this parameter to " -"the \"pointer to an instance\" you specified when you declared the type. " -"However, you can override Argument Clinic's converter and specify one " -"yourself. Just add your own ``self`` parameter as the first parameter in a " -"block, and ensure that its converter is an instance of ``self_converter`` or " -"a subclass thereof." -msgstr "" - -msgid "" -"What's the point? This lets you override the type of ``self``, or give it a " -"different default name." -msgstr "" - -msgid "" -"How do you specify the custom type you want to cast ``self`` to? If you only " -"have one or two functions with the same type for ``self``, you can directly " -"use Argument Clinic's existing ``self`` converter, passing in the type you " -"want to use as the ``type`` parameter::" -msgstr "" - -msgid "" -"On the other hand, if you have a lot of functions that will use the same " -"type for ``self``, it's best to create your own converter, subclassing " -"``self_converter`` but overwriting the ``type`` member::" -msgstr "" - -msgid "Using a \"defining class\" converter" -msgstr "" - -msgid "" -"Argument Clinic facilitates gaining access to the defining class of a " -"method. This is useful for :ref:`heap type ` methods that need " -"to fetch module level state. Use :c:func:`PyType_FromModuleAndSpec` to " -"associate a new heap type with a module. You can now use :c:func:" -"`PyType_GetModuleState` on the defining class to fetch the module state, for " -"example from a module method." -msgstr "" - -msgid "" -"Example from ``Modules/zlibmodule.c``. First, ``defining_class`` is added " -"to the clinic input::" -msgstr "" - -msgid "" -"After running the Argument Clinic tool, the following function signature is " -"generated::" -msgstr "" - -msgid "" -"The following code can now use ``PyType_GetModuleState(cls)`` to fetch the " -"module state::" -msgstr "" - -msgid "" -"Each method may only have one argument using this converter, and it must " -"appear after ``self``, or, if ``self`` is not used, as the first argument. " -"The argument will be of type ``PyTypeObject *``. The argument will not " -"appear in the ``__text_signature__``." -msgstr "" - -msgid "" -"The ``defining_class`` converter is not compatible with ``__init__`` and " -"``__new__`` methods, which cannot use the ``METH_METHOD`` convention." -msgstr "" - -msgid "" -"It is not possible to use ``defining_class`` with slot methods. In order to " -"fetch the module state from such methods, use :c:func:" -"`PyType_GetModuleByDef` to look up the module and then :c:func:" -"`PyModule_GetState` to fetch the module state. Example from the " -"``setattro`` slot method in ``Modules/_threadmodule.c``::" -msgstr "" - -msgid "See also :pep:`573`." -msgstr "" - -msgid "Writing a custom converter" -msgstr "" - -msgid "" -"As we hinted at in the previous section... you can write your own " -"converters! A converter is simply a Python class that inherits from " -"``CConverter``. The main purpose of a custom converter is if you have a " -"parameter using the ``O&`` format unit—parsing this parameter means calling " -"a :c:func:`PyArg_ParseTuple` \"converter function\"." -msgstr "" - -msgid "" -"Your converter class should be named ``*something*_converter``. If the name " -"follows this convention, then your converter class will be automatically " -"registered with Argument Clinic; its name will be the name of your class " -"with the ``_converter`` suffix stripped off. (This is accomplished with a " -"metaclass.)" -msgstr "" - -msgid "" -"You shouldn't subclass ``CConverter.__init__``. Instead, you should write a " -"``converter_init()`` function. ``converter_init()`` always accepts a " -"``self`` parameter; after that, all additional parameters *must* be keyword-" -"only. Any arguments passed in to the converter in Argument Clinic will be " -"passed along to your ``converter_init()``." -msgstr "" - -msgid "" -"There are some additional members of ``CConverter`` you may wish to specify " -"in your subclass. Here's the current list:" -msgstr "" - -msgid "" -"The C type to use for this variable. ``type`` should be a Python string " -"specifying the type, e.g. ``int``. If this is a pointer type, the type " -"string should end with ``' *'``." -msgstr "" - -msgid "``default``" -msgstr "" - -msgid "" -"The Python default value for this parameter, as a Python value. Or the magic " -"value ``unspecified`` if there is no default." -msgstr "" - -msgid "``py_default``" -msgstr "" - -msgid "" -"``default`` as it should appear in Python code, as a string. Or ``None`` if " -"there is no default." -msgstr "" - -msgid "" -"``default`` as it should appear in C code, as a string. Or ``None`` if there " -"is no default." -msgstr "" - -msgid "``c_ignored_default``" -msgstr "" - -msgid "" -"The default value used to initialize the C variable when there is no " -"default, but not specifying a default may result in an \"uninitialized " -"variable\" warning. This can easily happen when using option groups—" -"although properly written code will never actually use this value, the " -"variable does get passed in to the impl, and the C compiler will complain " -"about the \"use\" of the uninitialized value. This value should always be a " -"non-empty string." -msgstr "" - -msgid "The name of the C converter function, as a string." -msgstr "" - -msgid "``impl_by_reference``" -msgstr "" - -msgid "" -"A boolean value. If true, Argument Clinic will add a ``&`` in front of the " -"name of the variable when passing it into the impl function." -msgstr "" - -msgid "``parse_by_reference``" -msgstr "" - -msgid "" -"A boolean value. If true, Argument Clinic will add a ``&`` in front of the " -"name of the variable when passing it into :c:func:`PyArg_ParseTuple`." -msgstr "" - -msgid "" -"Here's the simplest example of a custom converter, from ``Modules/zlibmodule." -"c``::" -msgstr "" - -msgid "" -"This block adds a converter to Argument Clinic named ``ssize_t``. " -"Parameters declared as ``ssize_t`` will be declared as type :c:type:" -"`Py_ssize_t`, and will be parsed by the ``'O&'`` format unit, which will " -"call the ``ssize_t_converter`` converter function. ``ssize_t`` variables " -"automatically support default values." -msgstr "" - -msgid "" -"More sophisticated custom converters can insert custom C code to handle " -"initialization and cleanup. You can see more examples of custom converters " -"in the CPython source tree; grep the C files for the string ``CConverter``." -msgstr "" - -msgid "Writing a custom return converter" -msgstr "" - -msgid "" -"Writing a custom return converter is much like writing a custom converter. " -"Except it's somewhat simpler, because return converters are themselves much " -"simpler." -msgstr "" - -msgid "" -"Return converters must subclass ``CReturnConverter``. There are no examples " -"yet of custom return converters, because they are not widely used yet. If " -"you wish to write your own return converter, please read ``Tools/clinic/" -"clinic.py``, specifically the implementation of ``CReturnConverter`` and all " -"its subclasses." -msgstr "" - -msgid "METH_O and METH_NOARGS" -msgstr "" - -msgid "" -"To convert a function using ``METH_O``, make sure the function's single " -"argument is using the ``object`` converter, and mark the arguments as " -"positional-only::" -msgstr "" - -msgid "" -"To convert a function using ``METH_NOARGS``, just don't specify any " -"arguments." -msgstr "" - -msgid "" -"You can still use a self converter, a return converter, and specify a " -"``type`` argument to the object converter for ``METH_O``." -msgstr "" - -msgid "tp_new and tp_init functions" -msgstr "" - -msgid "" -"You can convert ``tp_new`` and ``tp_init`` functions. Just name them " -"``__new__`` or ``__init__`` as appropriate. Notes:" -msgstr "" - -msgid "" -"The function name generated for ``__new__`` doesn't end in ``__new__`` like " -"it would by default. It's just the name of the class, converted into a " -"valid C identifier." -msgstr "" - -msgid "No ``PyMethodDef`` ``#define`` is generated for these functions." -msgstr "" - -msgid "``__init__`` functions return ``int``, not ``PyObject *``." -msgstr "" - -msgid "Use the docstring as the class docstring." -msgstr "" - -msgid "" -"Although ``__new__`` and ``__init__`` functions must always accept both the " -"``args`` and ``kwargs`` objects, when converting you may specify any " -"signature for these functions that you like. (If your function doesn't " -"support keywords, the parsing function generated will throw an exception if " -"it receives any.)" -msgstr "" - -msgid "Changing and redirecting Clinic's output" -msgstr "" - -msgid "" -"It can be inconvenient to have Clinic's output interspersed with your " -"conventional hand-edited C code. Luckily, Clinic is configurable: you can " -"buffer up its output for printing later (or earlier!), or write its output " -"to a separate file. You can also add a prefix or suffix to every line of " -"Clinic's generated output." -msgstr "" - -msgid "" -"While changing Clinic's output in this manner can be a boon to readability, " -"it may result in Clinic code using types before they are defined, or your " -"code attempting to use Clinic-generated code before it is defined. These " -"problems can be easily solved by rearranging the declarations in your file, " -"or moving where Clinic's generated code goes. (This is why the default " -"behavior of Clinic is to output everything into the current block; while " -"many people consider this hampers readability, it will never require " -"rearranging your code to fix definition-before-use problems.)" -msgstr "" - -msgid "Let's start with defining some terminology:" -msgstr "" - -msgid "*field*" -msgstr "" - -msgid "" -"A field, in this context, is a subsection of Clinic's output. For example, " -"the ``#define`` for the ``PyMethodDef`` structure is a field, called " -"``methoddef_define``. Clinic has seven different fields it can output per " -"function definition:" -msgstr "" - -msgid "" -"All the names are of the form ``\"_\"``, where ``\"\"`` is the " -"semantic object represented (the parsing function, the impl function, the " -"docstring, or the methoddef structure) and ``\"\"`` represents what kind " -"of statement the field is. Field names that end in ``\"_prototype\"`` " -"represent forward declarations of that thing, without the actual body/data " -"of the thing; field names that end in ``\"_definition\"`` represent the " -"actual definition of the thing, with the body/data of the thing. " -"(``\"methoddef\"`` is special, it's the only one that ends with " -"``\"_define\"``, representing that it's a preprocessor #define.)" -msgstr "" - -msgid "*destination*" -msgstr "" - -msgid "" -"A destination is a place Clinic can write output to. There are five built-" -"in destinations:" -msgstr "" - -msgid "``block``" -msgstr "" - -msgid "" -"The default destination: printed in the output section of the current Clinic " -"block." -msgstr "" - -msgid "``buffer``" -msgstr "" - -msgid "" -"A text buffer where you can save text for later. Text sent here is appended " -"to the end of any existing text. It's an error to have any text left in the " -"buffer when Clinic finishes processing a file." -msgstr "" - -msgid "``file``" -msgstr "" - -msgid "" -"A separate \"clinic file\" that will be created automatically by Clinic. The " -"filename chosen for the file is ``{basename}.clinic{extension}``, where " -"``basename`` and ``extension`` were assigned the output from ``os.path." -"splitext()`` run on the current file. (Example: the ``file`` destination " -"for ``_pickle.c`` would be written to ``_pickle.clinic.c``.)" -msgstr "" - -msgid "" -"**Important: When using a** ``file`` **destination, you** *must check in* " -"**the generated file!**" -msgstr "" - -msgid "``two-pass``" -msgstr "" - -msgid "" -"A buffer like ``buffer``. However, a two-pass buffer can only be dumped " -"once, and it prints out all text sent to it during all processing, even from " -"Clinic blocks *after* the dumping point." -msgstr "" - -msgid "``suppress``" -msgstr "" - -msgid "The text is suppressed—thrown away." -msgstr "" - -msgid "Clinic defines five new directives that let you reconfigure its output." -msgstr "" - -msgid "The first new directive is ``dump``:" -msgstr "" - -msgid "" -"This dumps the current contents of the named destination into the output of " -"the current block, and empties it. This only works with ``buffer`` and " -"``two-pass`` destinations." -msgstr "" - -msgid "" -"The second new directive is ``output``. The most basic form of ``output`` " -"is like this:" -msgstr "" - -msgid "" -"This tells Clinic to output *field* to *destination*. ``output`` also " -"supports a special meta-destination, called ``everything``, which tells " -"Clinic to output *all* fields to that *destination*." -msgstr "" - -msgid "``output`` has a number of other functions:" -msgstr "" - -msgid "" -"``output push`` and ``output pop`` allow you to push and pop configurations " -"on an internal configuration stack, so that you can temporarily modify the " -"output configuration, then easily restore the previous configuration. " -"Simply push before your change to save the current configuration, then pop " -"when you wish to restore the previous configuration." -msgstr "" - -msgid "" -"``output preset`` sets Clinic's output to one of several built-in preset " -"configurations, as follows:" -msgstr "" - -msgid "" -"Clinic's original starting configuration. Writes everything immediately " -"after the input block." -msgstr "" - -msgid "" -"Suppress the ``parser_prototype`` and ``docstring_prototype``, write " -"everything else to ``block``." -msgstr "" - -msgid "" -"Designed to write everything to the \"clinic file\" that it can. You then " -"``#include`` this file near the top of your file. You may need to rearrange " -"your file to make this work, though usually this just means creating forward " -"declarations for various ``typedef`` and ``PyTypeObject`` definitions." -msgstr "" - -msgid "" -"Suppress the ``parser_prototype`` and ``docstring_prototype``, write the " -"``impl_definition`` to ``block``, and write everything else to ``file``." -msgstr "" - -msgid "The default filename is ``\"{dirname}/clinic/{basename}.h\"``." -msgstr "" - -msgid "" -"Save up most of the output from Clinic, to be written into your file near " -"the end. For Python files implementing modules or builtin types, it's " -"recommended that you dump the buffer just above the static structures for " -"your module or builtin type; these are normally very near the end. Using " -"``buffer`` may require even more editing than ``file``, if your file has " -"static ``PyMethodDef`` arrays defined in the middle of the file." -msgstr "" - -msgid "" -"Suppress the ``parser_prototype``, ``impl_prototype``, and " -"``docstring_prototype``, write the ``impl_definition`` to ``block``, and " -"write everything else to ``file``." -msgstr "" - -msgid "" -"Similar to the ``buffer`` preset, but writes forward declarations to the " -"``two-pass`` buffer, and definitions to the ``buffer``. This is similar to " -"the ``buffer`` preset, but may require less editing than ``buffer``. Dump " -"the ``two-pass`` buffer near the top of your file, and dump the ``buffer`` " -"near the end just like you would when using the ``buffer`` preset." -msgstr "" - -msgid "" -"Suppresses the ``impl_prototype``, write the ``impl_definition`` to " -"``block``, write ``docstring_prototype``, ``methoddef_define``, and " -"``parser_prototype`` to ``two-pass``, write everything else to ``buffer``." -msgstr "" - -msgid "``partial-buffer``" -msgstr "" - -msgid "" -"Similar to the ``buffer`` preset, but writes more things to ``block``, only " -"writing the really big chunks of generated code to ``buffer``. This avoids " -"the definition-before-use problem of ``buffer`` completely, at the small " -"cost of having slightly more stuff in the block's output. Dump the " -"``buffer`` near the end, just like you would when using the ``buffer`` " -"preset." -msgstr "" - -msgid "" -"Suppresses the ``impl_prototype``, write the ``docstring_definition`` and " -"``parser_definition`` to ``buffer``, write everything else to ``block``." -msgstr "" - -msgid "The third new directive is ``destination``:" -msgstr "" - -msgid "This performs an operation on the destination named ``name``." -msgstr "" - -msgid "There are two defined subcommands: ``new`` and ``clear``." -msgstr "" - -msgid "The ``new`` subcommand works like this:" -msgstr "" - -msgid "" -"This creates a new destination with name ```` and type ````." -msgstr "" - -msgid "There are five destination types:" -msgstr "" - -msgid "Throws the text away." -msgstr "" - -msgid "" -"Writes the text to the current block. This is what Clinic originally did." -msgstr "" - -msgid "A simple text buffer, like the \"buffer\" builtin destination above." -msgstr "" - -msgid "" -"A text file. The file destination takes an extra argument, a template to " -"use for building the filename, like so:" -msgstr "" - -msgid "destination new " -msgstr "" - -msgid "" -"The template can use three strings internally that will be replaced by bits " -"of the filename:" -msgstr "" - -msgid "{path}" -msgstr "" - -msgid "The full path to the file, including directory and full filename." -msgstr "" - -msgid "{dirname}" -msgstr "" - -msgid "The name of the directory the file is in." -msgstr "" - -msgid "{basename}" -msgstr "" - -msgid "Just the name of the file, not including the directory." -msgstr "" - -msgid "{basename_root}" -msgstr "" - -msgid "" -"Basename with the extension clipped off (everything up to but not including " -"the last '.')." -msgstr "" - -msgid "{basename_extension}" -msgstr "" - -msgid "" -"The last '.' and everything after it. If the basename does not contain a " -"period, this will be the empty string." -msgstr "" - -msgid "" -"If there are no periods in the filename, {basename} and {filename} are the " -"same, and {extension} is empty. \"{basename}{extension}\" is always exactly " -"the same as \"{filename}\".\"" -msgstr "" - -msgid "A two-pass buffer, like the \"two-pass\" builtin destination above." -msgstr "" - -msgid "The ``clear`` subcommand works like this:" -msgstr "" - -msgid "" -"It removes all the accumulated text up to this point in the destination. (I " -"don't know what you'd need this for, but I thought maybe it'd be useful " -"while someone's experimenting.)" -msgstr "" - -msgid "The fourth new directive is ``set``:" -msgstr "" - -msgid "" -"``set`` lets you set two internal variables in Clinic. ``line_prefix`` is a " -"string that will be prepended to every line of Clinic's output; " -"``line_suffix`` is a string that will be appended to every line of Clinic's " -"output." -msgstr "" - -msgid "Both of these support two format strings:" -msgstr "" - -msgid "``{block comment start}``" -msgstr "" - -msgid "" -"Turns into the string ``/*``, the start-comment text sequence for C files." -msgstr "" - -msgid "``{block comment end}``" -msgstr "" - -msgid "" -"Turns into the string ``*/``, the end-comment text sequence for C files." -msgstr "" - -msgid "" -"The final new directive is one you shouldn't need to use directly, called " -"``preserve``:" -msgstr "" - -msgid "" -"This tells Clinic that the current contents of the output should be kept, " -"unmodified. This is used internally by Clinic when dumping output into " -"``file`` files; wrapping it in a Clinic block lets Clinic use its existing " -"checksum functionality to ensure the file was not modified by hand before it " -"gets overwritten." -msgstr "" - -msgid "The #ifdef trick" -msgstr "" - -msgid "" -"If you're converting a function that isn't available on all platforms, " -"there's a trick you can use to make life a little easier. The existing code " -"probably looks like this::" -msgstr "" - -msgid "" -"And then in the ``PyMethodDef`` structure at the bottom the existing code " -"will have:" -msgstr "" - -msgid "" -"In this scenario, you should enclose the body of your impl function inside " -"the ``#ifdef``, like so::" -msgstr "" - -msgid "" -"Then, remove those three lines from the ``PyMethodDef`` structure, replacing " -"them with the macro Argument Clinic generated:" -msgstr "" - -msgid "" -"(You can find the real name for this macro inside the generated code. Or you " -"can calculate it yourself: it's the name of your function as defined on the " -"first line of your block, but with periods changed to underscores, " -"uppercased, and ``\"_METHODDEF\"`` added to the end.)" -msgstr "" - -msgid "" -"Perhaps you're wondering: what if ``HAVE_FUNCTIONNAME`` isn't defined? The " -"``MODULE_FUNCTIONNAME_METHODDEF`` macro won't be defined either!" -msgstr "" - -msgid "" -"Here's where Argument Clinic gets very clever. It actually detects that the " -"Argument Clinic block might be deactivated by the ``#ifdef``. When that " -"happens, it generates a little extra code that looks like this::" -msgstr "" - -msgid "" -"That means the macro always works. If the function is defined, this turns " -"into the correct structure, including the trailing comma. If the function " -"is undefined, this turns into nothing." -msgstr "" - -msgid "" -"However, this causes one ticklish problem: where should Argument Clinic put " -"this extra code when using the \"block\" output preset? It can't go in the " -"output block, because that could be deactivated by the ``#ifdef``. (That's " -"the whole point!)" -msgstr "" - -msgid "" -"In this situation, Argument Clinic writes the extra code to the \"buffer\" " -"destination. This may mean that you get a complaint from Argument Clinic:" -msgstr "" - -msgid "" -"When this happens, just open your file, find the ``dump buffer`` block that " -"Argument Clinic added to your file (it'll be at the very bottom), then move " -"it above the ``PyMethodDef`` structure where that macro is used." -msgstr "" - -msgid "Using Argument Clinic in Python files" -msgstr "" - -msgid "" -"It's actually possible to use Argument Clinic to preprocess Python files. " -"There's no point to using Argument Clinic blocks, of course, as the output " -"wouldn't make any sense to the Python interpreter. But using Argument " -"Clinic to run Python blocks lets you use Python as a Python preprocessor!" -msgstr "" +msgstr "Argument Clinic - jak to zrobić" msgid "" -"Since Python comments are different from C comments, Argument Clinic blocks " -"embedded in Python files look slightly different. They look like this:" +"The Argument Clinic How-TO has been moved to the `Python Developer's Guide " +"`__." msgstr "" diff --git a/howto/curses.po b/howto/curses.po index a20b9d764e..0dc3d05b67 100644 --- a/howto/curses.po +++ b/howto/curses.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +36,7 @@ msgid "Release" msgstr "wydanie" msgid "2.04" -msgstr "" +msgstr "2.04" msgid "Abstract" msgstr "Streszczenie" @@ -404,40 +403,40 @@ msgid "" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid ":const:`A_BLINK`" -msgstr "" +msgstr ":const:`A_BLINK`" msgid "Blinking text" msgstr "" msgid ":const:`A_BOLD`" -msgstr "" +msgstr ":const:`A_BOLD`" msgid "Extra bright or bold text" msgstr "" msgid ":const:`A_DIM`" -msgstr "" +msgstr ":const:`A_DIM`" msgid "Half bright text" msgstr "" msgid ":const:`A_REVERSE`" -msgstr "" +msgstr ":const:`A_REVERSE`" msgid "Reverse-video text" msgstr "" msgid ":const:`A_STANDOUT`" -msgstr "" +msgstr ":const:`A_STANDOUT`" msgid "The best highlighting mode available" msgstr "" msgid ":const:`A_UNDERLINE`" -msgstr "" +msgstr ":const:`A_UNDERLINE`" msgid "Underlined text" msgstr "" @@ -603,7 +602,7 @@ msgid "" "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 :" -"const:`ACS_\\*` characters available to you." +"ref:`ACS_\\* ` characters available to you." msgstr "" msgid "" diff --git a/howto/descriptor.po b/howto/descriptor.po index e232b56cdd..af251060a4 100644 --- a/howto/descriptor.po +++ b/howto/descriptor.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Seweryn Piórkowski , 2021 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -357,14 +355,14 @@ msgstr "" msgid "Descriptor protocol" msgstr "" -msgid "``descr.__get__(self, obj, type=None) -> value``" +msgid "``descr.__get__(self, obj, type=None)``" msgstr "" -msgid "``descr.__set__(self, obj, value) -> None``" +msgid "``descr.__set__(self, obj, value)``" msgstr "" -msgid "``descr.__delete__(self, obj) -> None``" -msgstr "" +msgid "``descr.__delete__(self, obj)``" +msgstr "``descr.__delete__(self, obj)``" msgid "" "That is all there is to it. Define any of these methods and an object is " @@ -466,8 +464,8 @@ 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" @@ -486,7 +484,7 @@ msgid "" msgstr "" msgid "" -"The full C implementation can be found in :c:func:`super_getattro()` 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 `_." @@ -542,8 +540,8 @@ msgid "" msgstr "" msgid "" -"The implementation details are in :c:func:`type_new()` and :c:func:" -"`set_names()` in :source:`Objects/typeobject.c`." +"The implementation details are in :c:func:`!type_new` and :c:func:`!" +"set_names` in :source:`Objects/typeobject.c`." msgstr "" msgid "" @@ -724,7 +722,7 @@ msgid "f(obj, \\*args)" msgstr "" msgid "f(\\*args)" -msgstr "" +msgstr "f(\\*args)" msgid "staticmethod" msgstr "" @@ -778,8 +776,9 @@ msgstr "" 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: " -"``__name__``, ``__qualname__``, ``__doc__``, and ``__annotations__``." +"attributes necessary to make the wrapper look like the wrapped function: :" +"attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function." +"__doc__`, and :attr:`~function.__annotations__`." msgstr "" msgid "Class methods" @@ -818,8 +817,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: ``__name__``, ``__qualname__``, ``__doc__``, and " -"``__annotations__``." +"wrapped function: :attr:`~function.__name__`, :attr:`~function." +"__qualname__`, :attr:`~function.__doc__`, and :attr:`~function." +"__annotations__`." msgstr "" msgid "Member objects and __slots__" diff --git a/howto/enum.po b/howto/enum.po new file mode 100644 index 0000000000..f88383d0ec --- /dev/null +++ b/howto/enum.po @@ -0,0 +1,1028 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Enum HOWTO" +msgstr "" + +msgid "" +"An :class:`Enum` is a set of symbolic names bound to unique values. They " +"are similar to global variables, but they offer a more useful :func:" +"`repr()`, grouping, type-safety, and a few other features." +msgstr "" + +msgid "" +"They are most useful when you have a variable that can take one of a limited " +"selection of values. For example, the days of the week::" +msgstr "" + +msgid "Or perhaps the RGB primary colors::" +msgstr "" + +msgid "" +"As you can see, creating an :class:`Enum` is as simple as writing a class " +"that inherits from :class:`Enum` itself." +msgstr "" + +msgid "Case of Enum Members" +msgstr "Wielkość liter literałów wyliczeniowych" + +msgid "" +"Because Enums are used to represent constants we recommend using UPPER_CASE " +"names for members, and will be using that style in our examples." +msgstr "" + +msgid "" +"Depending on the nature of the enum a member's value may or may not be " +"important, but either way that value can be used to get the corresponding " +"member::" +msgstr "" + +msgid "" +"As you can see, the ``repr()`` of a member shows the enum name, the member " +"name, and the value. The ``str()`` of a member shows only the enum name and " +"member name::" +msgstr "" + +msgid "The *type* of an enumeration member is the enum it belongs to::" +msgstr "" + +msgid "Enum members have an attribute that contains just their :attr:`name`::" +msgstr "" + +msgid "Likewise, they have an attribute for their :attr:`value`::" +msgstr "" + +msgid "" +"Unlike many languages that treat enumerations solely as name/value pairs, " +"Python Enums can have behavior added. For example, :class:`datetime.date` " +"has two methods for returning the weekday: :meth:`weekday` and :meth:" +"`isoweekday`. The difference is that one of them counts from 0-6 and the " +"other from 1-7. Rather than keep track of that ourselves we can add a method " +"to the :class:`Weekday` enum to extract the day from the :class:`date` " +"instance and return the matching enum member::" +msgstr "" + +msgid "The complete :class:`Weekday` enum now looks like this::" +msgstr "" + +msgid "Now we can find out what today is! Observe::" +msgstr "" + +msgid "" +"Of course, if you're reading this on some other day, you'll see that day " +"instead." +msgstr "" + +msgid "" +"This :class:`Weekday` enum is great if our variable only needs one day, but " +"what if we need several? Maybe we're writing a function to plot chores " +"during a week, and don't want to use a :class:`list` -- we could use a " +"different type of :class:`Enum`::" +msgstr "" + +msgid "" +"We've changed two things: we're inherited from :class:`Flag`, and the values " +"are all powers of 2." +msgstr "" + +msgid "" +"Just like the original :class:`Weekday` enum above, we can have a single " +"selection::" +msgstr "" + +msgid "" +"But :class:`Flag` also allows us to combine several members into a single " +"variable::" +msgstr "" + +msgid "You can even iterate over a :class:`Flag` variable::" +msgstr "" + +msgid "Okay, let's get some chores set up::" +msgstr "" + +msgid "And a function to display the chores for a given day::" +msgstr "" + +msgid "" +"In cases where the actual values of the members do not matter, you can save " +"yourself some work and use :func:`auto()` for the values::" +msgstr "" + +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 " +"known at program-writing time). ``Enum`` allows such access::" +msgstr "" + +msgid "If you want to access enum members by *name*, use item access::" +msgstr "" + +msgid "If you have an enum member and need its :attr:`name` or :attr:`value`::" +msgstr "" + +msgid "Duplicating enum members and values" +msgstr "" + +msgid "Having two enum members with the same name is invalid::" +msgstr "" + +msgid "" +"However, an enum member can have other names associated with it. Given two " +"entries ``A`` and ``B`` with the same value (and ``A`` defined first), ``B`` " +"is an alias for the member ``A``. By-value lookup of the value of ``A`` " +"will return the member ``A``. By-name lookup of ``A`` will return the " +"member ``A``. By-name lookup of ``B`` will also return the member ``A``::" +msgstr "" + +msgid "" +"Attempting to create a member with the same name as an already defined " +"attribute (another member, a method, etc.) or attempting to create an " +"attribute with the same name as a member is not allowed." +msgstr "" + +msgid "Ensuring unique enumeration values" +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::" +msgstr "" + +msgid "Using automatic values" +msgstr "" + +msgid "If the exact value is unimportant you can use :class:`auto`::" +msgstr "" + +msgid "" +"The values are chosen by :func:`_generate_next_value_`, which can be " +"overridden::" +msgstr "" + +msgid "" +"The :meth:`_generate_next_value_` method must be defined before any members." +msgstr "" + +msgid "Iteration" +msgstr "Iteracja" + +msgid "Iterating over the members of an enum does not provide the aliases::" +msgstr "" + +msgid "" +"Note that the aliases ``Shape.ALIAS_FOR_SQUARE`` and ``Weekday.WEEKEND`` " +"aren't shown." +msgstr "" + +msgid "" +"The special attribute ``__members__`` is a read-only ordered mapping of " +"names to members. It includes all names defined in the enumeration, " +"including the aliases::" +msgstr "" + +msgid "" +"The ``__members__`` attribute can be used for detailed programmatic access " +"to the enumeration members. For example, finding all the aliases::" +msgstr "" + +msgid "" +"Aliases for flags include values with multiple flags set, such as ``3``, and " +"no flags set, i.e. ``0``." +msgstr "" + +msgid "Comparisons" +msgstr "" + +msgid "Enumeration members are compared by identity::" +msgstr "" + +msgid "" +"Ordered comparisons between enumeration values are *not* supported. Enum " +"members are not integers (but see `IntEnum`_ below)::" +msgstr "" + +msgid "Equality comparisons are defined though::" +msgstr "" + +msgid "" +"Comparisons against non-enumeration values will always compare not equal " +"(again, :class:`IntEnum` was explicitly designed to behave differently, see " +"below)::" +msgstr "" + +msgid "" +"It is possible to reload modules -- if a reloaded module contains enums, " +"they will be recreated, and the new members may not compare identical/equal " +"to the original members." +msgstr "" + +msgid "Allowed members and attributes of enumerations" +msgstr "" + +msgid "" +"Most of the examples above use integers for enumeration values. Using " +"integers is short and handy (and provided by default by the `Functional " +"API`_), but not strictly enforced. In the vast majority of use-cases, one " +"doesn't care what the actual value of an enumeration is. But if the value " +"*is* important, enumerations can have arbitrary values." +msgstr "" + +msgid "" +"Enumerations are Python classes, and can have methods and special methods as " +"usual. If we have this enumeration::" +msgstr "" + +msgid "Then::" +msgstr "" + +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:`__str__`, :meth:" +"`__add__`, etc.), descriptors (methods are also descriptors), and variable " +"names listed in :attr:`_ignore_`." +msgstr "" + +msgid "" +"Note: if your enumeration defines :meth:`__new__` and/or :meth:`__init__`, " +"any value(s) given to the enum member will be passed into those methods. See " +"`Planet`_ for an example." +msgstr "" + +msgid "" +"The :meth:`__new__` method, if defined, is used during creation of the Enum " +"members; it is then replaced by Enum's :meth:`__new__` which is used after " +"class creation for lookup of existing members. See :ref:`new-vs-init` for " +"more details." +msgstr "" + +msgid "Restricted Enum subclassing" +msgstr "" + +msgid "" +"A new :class:`Enum` class must have one base enum class, up to one concrete " +"data type, and as many :class:`object`-based mixin classes as needed. The " +"order of these base classes is::" +msgstr "" + +msgid "" +"Also, subclassing an enumeration is allowed only if the enumeration does not " +"define any members. So this is forbidden::" +msgstr "" + +msgid "But this is allowed::" +msgstr "" + +msgid "" +"Allowing subclassing of enums that define members would lead to a violation " +"of some important invariants of types and instances. On the other hand, it " +"makes sense to allow sharing some common behavior between a group of " +"enumerations. (See `OrderedEnum`_ for an example.)" +msgstr "" + +msgid "Pickling" +msgstr "" + +msgid "Enumerations can be pickled and unpickled::" +msgstr "" + +msgid "" +"The usual restrictions for pickling apply: picklable enums must be defined " +"in the top level of a module, since unpickling requires them to be " +"importable from that module." +msgstr "" + +msgid "" +"With pickle protocol version 4 it is possible to easily pickle enums nested " +"in other classes." +msgstr "" + +msgid "" +"It is possible to modify how enum members are pickled/unpickled by defining :" +"meth:`__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 "" +"Using by-name for flags is not recommended, as unnamed aliases will not " +"unpickle." +msgstr "" + +msgid "Functional API" +msgstr "" + +msgid "" +"The :class:`Enum` class is callable, providing the following functional API::" +msgstr "" + +msgid "" +"The semantics of this API resemble :class:`~collections.namedtuple`. The " +"first argument of the call to :class:`Enum` is the name of the enumeration." +msgstr "" + +msgid "" +"The second argument is the *source* of enumeration member names. It can be " +"a whitespace-separated string of names, a sequence of names, a sequence of 2-" +"tuples with key/value pairs, or a mapping (e.g. dictionary) of names to " +"values. The last two options enable assigning arbitrary values to " +"enumerations; the others auto-assign increasing integers starting with 1 " +"(use the ``start`` parameter to specify a different starting value). A new " +"class derived from :class:`Enum` is returned. In other words, the above " +"assignment to :class:`Animal` is equivalent to::" +msgstr "" + +msgid "" +"The reason for defaulting to ``1`` as the starting number and not ``0`` is " +"that ``0`` is ``False`` in a boolean sense, but by default enum members all " +"evaluate to ``True``." +msgstr "" + +msgid "" +"Pickling enums created with the functional API can be tricky as frame stack " +"implementation details are used to try and figure out which module the " +"enumeration is being created in (e.g. it will fail if you use a utility " +"function in a separate module, and also may not work on IronPython or " +"Jython). The solution is to specify the module name explicitly as follows::" +msgstr "" + +msgid "" +"If ``module`` is not supplied, and Enum cannot determine what it is, the new " +"Enum members will not be unpicklable; to keep errors closer to the source, " +"pickling will be disabled." +msgstr "" + +msgid "" +"The new pickle protocol 4 also, in some circumstances, relies on :attr:" +"`~definition.__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 "The complete signature is::" +msgstr "" + +msgid "*value*: What the new enum class will record as its name." +msgstr "" + +msgid "" +"*names*: The enum members. This can be a whitespace- or comma-separated " +"string (values will start at 1 unless otherwise specified)::" +msgstr "" + +msgid "or an iterator of names::" +msgstr "" + +msgid "or an iterator of (name, value) pairs::" +msgstr "" + +msgid "or a mapping::" +msgstr "" + +msgid "*module*: name of module where new enum class can be found." +msgstr "" + +msgid "*qualname*: where in module new enum class can be found." +msgstr "" + +msgid "*type*: type to mix in to new enum class." +msgstr "" + +msgid "*start*: number to start counting at if only names are passed in." +msgstr "" + +msgid "The *start* parameter was added." +msgstr "" + +msgid "Derived Enumerations" +msgstr "" + +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::" +msgstr "" + +msgid "" +"However, they still can't be compared to standard :class:`Enum` " +"enumerations::" +msgstr "" + +msgid "" +":class:`IntEnum` values behave like integers in other ways you'd expect::" +msgstr "" + +msgid "StrEnum" +msgstr "StrEnum" + +msgid "" +"The second variation of :class:`Enum` that is provided is also a subclass " +"of :class:`str`. Members of a :class:`StrEnum` can be compared to strings; " +"by extension, string enumerations of different types can also be compared to " +"each other." +msgstr "" + +msgid "IntFlag" +msgstr "IntFlag" + +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." +msgstr "" + +msgid "" +"Any operation on an :class:`IntFlag` member besides the bit-wise operations " +"will lose the :class:`IntFlag` membership." +msgstr "" + +msgid "" +"Bit-wise operations that result in invalid :class:`IntFlag` values will lose " +"the :class:`IntFlag` membership. See :class:`FlagBoundary` for details." +msgstr "" + +msgid "Sample :class:`IntFlag` class::" +msgstr "" + +msgid "It is also possible to name the combinations::" +msgstr "" + +msgid "" +"Named combinations are considered aliases. Aliases do not show up during " +"iteration, but can be returned from by-value lookups." +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`::" +msgstr "" + +msgid "" +"Because :class:`IntFlag` members are also subclasses of :class:`int` they " +"can be combined with them (but may lose :class:`IntFlag` membership::" +msgstr "" + +msgid "" +"The negation operator, ``~``, always returns an :class:`IntFlag` member with " +"a positive value::" +msgstr "" + +msgid ":class:`IntFlag` members can also be iterated over::" +msgstr "" + +msgid "Flag" +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 " +"value and let :class:`Flag` select an appropriate value." +msgstr "" + +msgid "" +"Like :class:`IntFlag`, if a combination of :class:`Flag` members results in " +"no flags being set, the boolean evaluation is :data:`False`::" +msgstr "" + +msgid "" +"Individual flags should have values that are powers of two (1, 2, 4, " +"8, ...), while combinations of flags will not::" +msgstr "" + +msgid "" +"Giving a name to the \"no flags set\" condition does not change its boolean " +"value::" +msgstr "" + +msgid ":class:`Flag` members can also be iterated over::" +msgstr "" + +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." +msgstr "" + +msgid "Others" +msgstr "Inne" + +msgid "" +"While :class:`IntEnum` is part of the :mod:`enum` module, it would be very " +"simple to implement independently::" +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`." +msgstr "" + +msgid "Some rules:" +msgstr "" + +msgid "" +"When subclassing :class:`Enum`, mix-in types must appear before :class:" +"`Enum` 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." +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." +msgstr "" + +msgid "" +"When another data type is mixed in, the :attr:`value` attribute is *not the " +"same* as the enum member itself, although it is equivalent and will compare " +"equal." +msgstr "" + +msgid "A ``data type`` is a mixin that defines :meth:`__new__`." +msgstr "" + +msgid "" +"%-style formatting: ``%s`` and ``%r`` call the :class:`Enum` class's :meth:" +"`__str__` and :meth:`__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:`__str__` method." +msgstr "" + +msgid "" +"Because :class:`IntEnum`, :class:`IntFlag`, and :class:`StrEnum` are " +"designed to be drop-in replacements for existing constants, their :meth:" +"`__str__` method has been reset to their data types' :meth:`__str__` method." +msgstr "" + +msgid "When to use :meth:`__new__` vs. :meth:`__init__`" +msgstr "" + +msgid "" +":meth:`__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:" +"`__new__` or :meth:`__init__`, with :meth:`__init__` being preferred." +msgstr "" + +msgid "" +"For example, if you want to pass several items to the constructor, but only " +"want one of them to be the value::" +msgstr "" + +msgid "" +"*Do not* call ``super().__new__()``, as the lookup-only ``__new__`` is the " +"one that is found; instead, use the data type directly." +msgstr "" + +msgid "Finer Points" +msgstr "" + +msgid "Supported ``__dunder__`` names" +msgstr "" + +msgid "" +":attr:`__members__` is a read-only ordered mapping of ``member_name``:" +"``member`` items. It is only available on the class." +msgstr "" + +msgid "" +":meth:`__new__`, if specified, must create and return the enum members; it " +"is also a very good idea to set the member's :attr:`_value_` appropriately. " +"Once all the members are created it is no longer used." +msgstr "" + +msgid "Supported ``_sunder_`` names" +msgstr "" + +msgid "``_name_`` -- name of the member" +msgstr "" + +msgid "" +"``_value_`` -- value of the member; can be set / modified in ``__new__``" +msgstr "" + +msgid "" +"``_missing_`` -- a lookup function used when a value is not found; may be " +"overridden" +msgstr "" + +msgid "" +"``_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 "" +"``_order_`` -- used in Python 2/3 code to ensure member order is consistent " +"(class attribute, removed during class creation)" +msgstr "" + +msgid "" +"``_generate_next_value_`` -- used by the `Functional API`_ and by :class:" +"`auto` to get an appropriate value for an enum member; may be overridden" +msgstr "" + +msgid "" +"For standard :class:`Enum` classes the next value chosen is the last value " +"seen incremented by one." +msgstr "" + +msgid "" +"For :class:`Flag` classes the next value chosen will be the next highest " +"power-of-two, regardless of the last value seen." +msgstr "" + +msgid "``_missing_``, ``_order_``, ``_generate_next_value_``" +msgstr "``_missing_``, ``_order_``, ``_generate_next_value_``" + +msgid "``_ignore_``" +msgstr "``_ignore_``" + +msgid "" +"To help keep Python 2 / Python 3 code in sync an :attr:`_order_` attribute " +"can be provided. It will be checked against the actual order of the " +"enumeration and raise an error if the two do not match::" +msgstr "" + +msgid "" +"In Python 2 code the :attr:`_order_` attribute is necessary as definition " +"order is lost before it can be recorded." +msgstr "" + +msgid "_Private__names" +msgstr "_Private__names" + +msgid "" +":ref:`Private names ` are not converted to enum " +"members, but remain normal attributes." +msgstr "" + +msgid "``Enum`` member type" +msgstr "" + +msgid "" +"Enum members are instances of their enum class, and are normally accessed as " +"``EnumClass.member``. In certain situations, such as writing custom enum " +"behavior, being able to access one member directly from another is useful, " +"and is supported." +msgstr "" + +msgid "Creating members that are mixed with other data types" +msgstr "" + +msgid "" +"When subclassing other data types, such as :class:`int` or :class:`str`, " +"with an :class:`Enum`, all values after the ``=`` are passed to that data " +"type's constructor. For example::" +msgstr "" + +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::" +msgstr "" + +msgid "Plain :class:`Enum` classes always evaluate as :data:`True`." +msgstr "" + +msgid "``Enum`` classes with methods" +msgstr "" + +msgid "" +"If you give your enum subclass extra methods, like the `Planet`_ class " +"below, those methods will show up in a :func:`dir` of the member, but not of " +"the class::" +msgstr "" + +msgid "Combining members of ``Flag``" +msgstr "" + +msgid "" +"Iterating over a combination of :class:`Flag` members will only return the " +"members that are comprised of a single bit::" +msgstr "" + +msgid "``Flag`` and ``IntFlag`` minutia" +msgstr "" + +msgid "Using the following snippet for our examples::" +msgstr "" + +msgid "the following are true:" +msgstr "" + +msgid "single-bit flags are canonical" +msgstr "" + +msgid "multi-bit and zero-bit flags are aliases" +msgstr "" + +msgid "only canonical flags are returned during iteration::" +msgstr "" + +msgid "" +"negating a flag or flag set returns a new flag/flag set with the " +"corresponding positive integer value::" +msgstr "" + +msgid "names of pseudo-flags are constructed from their members' names::" +msgstr "" + +msgid "multi-bit flags, aka aliases, can be returned from operations::" +msgstr "" + +msgid "" +"membership / containment checking: zero-valued flags are always considered " +"to be contained::" +msgstr "" + +msgid "" +"otherwise, only if all bits of one flag are in the other flag will True be " +"returned::" +msgstr "" + +msgid "" +"There is a new boundary mechanism that controls how out-of-range / invalid " +"bits are handled: ``STRICT``, ``CONFORM``, ``EJECT``, and ``KEEP``:" +msgstr "" + +msgid "STRICT --> raises an exception when presented with invalid values" +msgstr "" + +msgid "CONFORM --> discards any invalid bits" +msgstr "" + +msgid "EJECT --> lose Flag status and become a normal int with the given value" +msgstr "" + +msgid "KEEP --> keep the extra bits" +msgstr "" + +msgid "keeps Flag status and extra bits" +msgstr "" + +msgid "extra bits do not show up in iteration" +msgstr "" + +msgid "extra bits do show up in repr() and str()" +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)." +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)." +msgstr "" + +msgid "Enum Classes" +msgstr "" + +msgid "" +"The :class:`EnumType` metaclass is responsible for providing the :meth:" +"`__contains__`, :meth:`__dir__`, :meth:`__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:`__new__`, :meth:" +"`__getnewargs__`, :meth:`__str__` and :meth:`__repr__`)." +msgstr "" + +msgid "Flag Classes" +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 " +"considered an alias." +msgstr "" + +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:`__new__` in place to ensure that no " +"new ones are ever instantiated by returning only the existing member " +"instances." +msgstr "" + +msgid "Flag Members" +msgstr "" + +msgid "" +"Flag members can be iterated over just like the :class:`Flag` class, and " +"only the canonical members will be returned. For example::" +msgstr "" + +msgid "(Note that ``BLACK``, ``PURPLE``, and ``WHITE`` do not show up.)" +msgstr "" + +msgid "" +"Inverting a flag member returns the corresponding positive value, rather " +"than a negative value --- for example::" +msgstr "" + +msgid "" +"Flag members have a length corresponding to the number of power-of-two " +"values they contain. For example::" +msgstr "" + +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." +msgstr "" + +msgid "Omitting values" +msgstr "" + +msgid "" +"In many use-cases, one doesn't care what the actual value of an enumeration " +"is. There are several ways to define this type of simple enumeration:" +msgstr "" + +msgid "use instances of :class:`auto` for the value" +msgstr "" + +msgid "use instances of :class:`object` as the value" +msgstr "" + +msgid "use a descriptive string as the value" +msgstr "" + +msgid "" +"use a tuple as the value and a custom :meth:`__new__` to replace the tuple " +"with an :class:`int` value" +msgstr "" + +msgid "" +"Using any of these methods signifies to the user that these values are not " +"important, and also enables one to add, remove, or reorder members without " +"having to renumber the remaining members." +msgstr "" + +msgid "Using :class:`auto`" +msgstr "" + +msgid "Using :class:`auto` would look like::" +msgstr "" + +msgid "Using :class:`object`" +msgstr "" + +msgid "Using :class:`object` would look like::" +msgstr "" + +msgid "" +"This is also a good example of why you might want to write your own :meth:" +"`__repr__`::" +msgstr "" + +msgid "Using a descriptive string" +msgstr "" + +msgid "Using a string as the value would look like::" +msgstr "" + +msgid "Using a custom :meth:`__new__`" +msgstr "" + +msgid "Using an auto-numbering :meth:`__new__` would look like::" +msgstr "" + +msgid "" +"To make a more general purpose ``AutoNumber``, add ``*args`` to the " +"signature::" +msgstr "" + +msgid "" +"Then when you inherit from ``AutoNumber`` you can write your own " +"``__init__`` to handle any extra arguments::" +msgstr "" + +msgid "" +"The :meth:`__new__` method, if defined, is used during creation of the Enum " +"members; it is then replaced by Enum's :meth:`__new__` which is used after " +"class creation for lookup of existing members." +msgstr "" + +msgid "" +"*Do not* call ``super().__new__()``, as the lookup-only ``__new__`` is the " +"one that is found; instead, use the data type directly -- e.g.::" +msgstr "" + +msgid "OrderedEnum" +msgstr "" + +msgid "" +"An ordered enumeration that is not based on :class:`IntEnum` and so " +"maintains the normal :class:`Enum` invariants (such as not being comparable " +"to other enumerations)::" +msgstr "" + +msgid "DuplicateFreeEnum" +msgstr "DuplicateFreeEnum" + +msgid "" +"Raises an error if a duplicate member value is found instead of creating an " +"alias::" +msgstr "" + +msgid "" +"This is a useful example for subclassing Enum to add or change other " +"behaviors as well as disallowing aliases. If the only desired change is " +"disallowing aliases, the :func:`unique` decorator can be used instead." +msgstr "" + +msgid "Planet" +msgstr "" + +msgid "" +"If :meth:`__new__` or :meth:`__init__` is defined, the value of the enum " +"member will be passed to those methods::" +msgstr "" + +msgid "TimePeriod" +msgstr "" + +msgid "An example to show the :attr:`_ignore_` attribute in use::" +msgstr "" + +msgid "Subclassing EnumType" +msgstr "" + +msgid "" +"While most enum needs can be met by customizing :class:`Enum` subclasses, " +"either with class decorators or custom functions, :class:`EnumType` can be " +"subclassed to provide a different Enum experience." +msgstr "" diff --git a/howto/functional.po b/howto/functional.po index 21c8ab0c1b..238f4dbc05 100644 --- a/howto/functional.po +++ b/howto/functional.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +36,7 @@ msgid "Release" msgstr "wydanie" msgid "0.32" -msgstr "" +msgstr "0.32" msgid "" "In this document, we'll take a tour of Python's features suitable for " @@ -258,7 +257,7 @@ msgid "" msgstr "" msgid "Iterators" -msgstr "" +msgstr "Iteratory" msgid "" "I'll start by looking at a Python language feature that's an important " @@ -451,7 +450,7 @@ msgid "" msgstr "" msgid "Generators" -msgstr "" +msgstr "Generatory" msgid "" "Generators are a special class of functions that simplify the task of " @@ -956,8 +955,8 @@ 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:`accumulate` returns an iterator " -"that also yields each partial result::" +"of returning only the final result, :func:`~itertools.accumulate` returns an " +"iterator that also yields each partial result::" msgstr "" msgid "The operator module" diff --git a/howto/gdb_helpers.po b/howto/gdb_helpers.po new file mode 100644 index 0000000000..2b00bcec9b --- /dev/null +++ b/howto/gdb_helpers.po @@ -0,0 +1,320 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2024-02-23 16:46+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Debugging C API extensions and CPython Internals with GDB" +msgstr "" + +msgid "" +"This document explains how the Python GDB extension, ``python-gdb.py``, can " +"be used with the GDB debugger to debug CPython extensions and the CPython " +"interpreter itself." +msgstr "" + +msgid "" +"When debugging low-level problems such as crashes or deadlocks, a low-level " +"debugger, such as GDB, is useful to diagnose and correct the issue. By " +"default, GDB (or any of its front-ends) doesn't support high-level " +"information specific to the CPython interpreter." +msgstr "" + +msgid "" +"The ``python-gdb.py`` extension adds CPython interpreter information to GDB. " +"The extension helps introspect the stack of currently executing Python " +"functions. Given a Python object represented by a :c:expr:`PyObject *` " +"pointer, the extension surfaces the type and value of the object." +msgstr "" + +msgid "" +"Developers who are working on CPython extensions or tinkering with parts of " +"CPython that are written in C can use this document to learn how to use the " +"``python-gdb.py`` extension with GDB." +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 `_." +msgstr "" + +msgid "Prerequisites" +msgstr "" + +msgid "You need to have:" +msgstr "" + +msgid "" +"GDB 7 or later. (For earlier versions of GDB, see ``Misc/gdbinit`` in the " +"CPython sources. Note that this file will be removed in Python 3.12.)" +msgstr "" + +msgid "" +"GDB-compatible debugging information for Python and any extension you are " +"debugging." +msgstr "" + +msgid "The ``python-gdb.py`` extension." +msgstr "" + +msgid "" +"The extension is built with Python, but might be distributed separately or " +"not at all. Below, we include tips for a few common systems as examples. " +"Note that even if the instructions match your system, they might be outdated." +msgstr "" + +msgid "Setup with Python built from source" +msgstr "" + +msgid "" +"When you build CPython from source, debugging information should be " +"available, and the build should add a ``python-gdb.py`` file to the root " +"directory of your repository." +msgstr "" + +msgid "" +"To activate support, you must add the directory containing ``python-gdb.py`` " +"to GDB's \"auto-load-safe-path\". If you haven't done this, recent versions " +"of GDB will print out a warning with instructions on how to do this." +msgstr "" + +msgid "" +"If you do not see instructions for your version of GDB, put this in your " +"configuration file (``~/.gdbinit`` or ``~/.config/gdb/gdbinit``)::" +msgstr "" + +msgid "You can also add multiple paths, separated by ``:``." +msgstr "" + +msgid "Setup for Python from a Linux distro" +msgstr "" + +msgid "" +"Most Linux systems provide debug information for the system Python in a " +"package called ``python-debuginfo``, ``python-dbg`` or similar. For example:" +msgstr "" + +msgid "Fedora:" +msgstr "Fedora:" + +msgid "Ubuntu:" +msgstr "Ubuntu:" + +msgid "" +"On several recent Linux systems, GDB can download debugging symbols " +"automatically using *debuginfod*. However, this will not install the " +"``python-gdb.py`` extension; you generally do need to install the debug info " +"package separately." +msgstr "" + +msgid "Using the Debug build and Development mode" +msgstr "" + +msgid "For easier debugging, you might want to:" +msgstr "" + +msgid "" +"Use a :ref:`debug build ` of Python. (When building from " +"source, use ``configure --with-pydebug``. On Linux distros, install and run " +"a package like ``python-debug`` or ``python-dbg``, if available.)" +msgstr "" + +msgid "Use the runtime :ref:`development mode ` (``-X dev``)." +msgstr "" + +msgid "" +"Both enable extra assertions and disable some optimizations. Sometimes this " +"hides the bug you are trying to find, but in most cases they make the " +"process easier." +msgstr "" + +msgid "Using the ``python-gdb`` extension" +msgstr "" + +msgid "" +"When the extension is loaded, it provides two main features: pretty printers " +"for Python values, and additional commands." +msgstr "" + +msgid "Pretty-printers" +msgstr "" + +msgid "" +"This is what a GDB backtrace looks like (truncated) when this extension is " +"enabled::" +msgstr "" + +msgid "" +"Notice how the dictionary argument to ``PyDict_GetItemString`` is displayed " +"as its ``repr()``, rather than an opaque ``PyObject *`` pointer." +msgstr "" + +msgid "" +"The extension works by supplying a custom printing routine for values of " +"type ``PyObject *``. If you need to access lower-level details of an " +"object, then cast the value to a pointer of the appropriate type. For " +"example::" +msgstr "" + +msgid "" +"Note that the pretty-printers do not actually call ``repr()``. For basic " +"types, they try to match its result closely." +msgstr "" + +msgid "" +"An area that can be confusing is that the custom printer for some types look " +"a lot like GDB's built-in printer for standard types. For example, the " +"pretty-printer for a Python ``int`` (:c:expr:`PyLongObject *`) gives a " +"representation that is not distinguishable from one of a regular machine-" +"level integer::" +msgstr "" + +msgid "" +"The internal structure can be revealed with a cast to :c:expr:`PyLongObject " +"*`:" +msgstr "" + +msgid "" +"(gdb) p *(PyLongObject*)some_python_integer $5 = {ob_base = {ob_base = " +"{ob_refcnt = 8, ob_type = 0x3dad39f5e0}, ob_size = 1}, ob_digit = {42}}" +msgstr "" + +msgid "" +"A similar confusion can arise with the ``str`` type, where the output looks " +"a lot like gdb's built-in printer for ``char *``::" +msgstr "" + +msgid "" +"The pretty-printer for ``str`` instances defaults to using single-quotes (as " +"does Python's ``repr`` for strings) whereas the standard printer for ``char " +"*`` values uses double-quotes and contains a hexadecimal address::" +msgstr "" + +msgid "" +"Again, the implementation details can be revealed with a cast to :c:expr:" +"`PyUnicodeObject *`::" +msgstr "" + +msgid "``py-list``" +msgstr "``py-list``" + +msgid "" +"The extension adds a ``py-list`` command, which lists the Python source code " +"(if any) for the current frame in the selected thread. The current line is " +"marked with a \">\"::" +msgstr "" + +msgid "" +"Use ``py-list START`` to list at a different line number within the Python " +"source, and ``py-list START,END`` to list a specific range of lines within " +"the Python source." +msgstr "" + +msgid "``py-up`` and ``py-down``" +msgstr "" + +msgid "" +"The ``py-up`` and ``py-down`` commands are analogous to GDB's regular ``up`` " +"and ``down`` commands, but try to move at the level of CPython frames, " +"rather than C frames." +msgstr "" + +msgid "" +"GDB is not always able to read the relevant frame information, depending on " +"the optimization level with which CPython was compiled. Internally, the " +"commands look for C frames that are executing the default frame evaluation " +"function (that is, the core bytecode interpreter loop within CPython) and " +"look up the value of the related ``PyFrameObject *``." +msgstr "" + +msgid "They emit the frame number (at the C level) within the thread." +msgstr "" + +msgid "For example::" +msgstr "Dla przykładu::" + +msgid "so we're at the top of the Python stack." +msgstr "" + +msgid "" +"The frame numbers correspond to those displayed by GDB's standard " +"``backtrace`` command. The command skips C frames which are not executing " +"Python code." +msgstr "" + +msgid "Going back down::" +msgstr "" + +msgid "and we're at the bottom of the Python stack." +msgstr "" + +msgid "``py-bt``" +msgstr "``py-bt``" + +msgid "" +"The ``py-bt`` command attempts to display a Python-level backtrace of the " +"current thread." +msgstr "" + +msgid "" +"The frame numbers correspond to those displayed by GDB's standard " +"``backtrace`` command." +msgstr "" + +msgid "``py-print``" +msgstr "``py-print``" + +msgid "" +"The ``py-print`` command looks up a Python name and tries to print it. It " +"looks in locals within the current thread, then globals, then finally " +"builtins::" +msgstr "" + +msgid "``py-locals``" +msgstr "``py-locals``" + +msgid "" +"The ``py-locals`` command looks up all Python locals within the current " +"Python frame in the selected thread, and prints their representations::" +msgstr "" + +msgid "Use with GDB commands" +msgstr "" + +msgid "" +"The extension commands complement GDB's built-in commands. For example, you " +"can use a frame numbers shown by ``py-bt`` with the ``frame`` command to go " +"a specific frame within the selected thread, like this::" +msgstr "" + +msgid "" +"The ``info threads`` command will give you a list of the threads within the " +"process, and you can use the ``thread`` command to select a different one::" +msgstr "" + +msgid "" +"You can use ``thread apply all COMMAND`` or (``t a a COMMAND`` for short) to " +"run a command on all threads. With ``py-bt``, this lets you see what every " +"thread is doing at the Python level::" +msgstr "" diff --git a/howto/index.po b/howto/index.po index 0856355a25..8c2b491429 100644 --- a/howto/index.po +++ b/howto/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/howto/instrumentation.po b/howto/instrumentation.po index db013d65da..cb08fa298c 100644 --- a/howto/instrumentation.po +++ b/howto/instrumentation.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -193,15 +192,15 @@ msgid "" msgstr "" msgid "``$arg3`` : ``int`` line number" -msgstr "" +msgstr "``$arg3`` : ``int`` line number" msgid "" -"This marker is the converse of :c:func:`function__entry`, and indicates that " -"execution of a Python function has ended (either via ``return``, or via an " -"exception). It is only triggered for pure-Python (bytecode) functions." +"This marker is the converse of :c:func:`!function__entry`, and indicates " +"that execution of a Python function has ended (either via ``return``, or via " +"an exception). It is only triggered for pure-Python (bytecode) functions." msgstr "" -msgid "The arguments are the same as for :c:func:`function__entry`" +msgid "The arguments are the same as for :c:func:`!function__entry`" msgstr "" msgid "" @@ -210,7 +209,7 @@ msgid "" "triggered within C functions." msgstr "" -msgid "The arguments are the same as for :c:func:`function__entry`." +msgid "The arguments are the same as for :c:func:`!function__entry`." msgstr "" msgid "" diff --git a/howto/ipaddress.po b/howto/ipaddress.po index 948195886c..58e274b407 100644 --- a/howto/ipaddress.po +++ b/howto/ipaddress.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index b71350eb4b..95cdc3b8ed 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2022-11-05 19:48+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -332,13 +332,13 @@ msgstr "" msgid "" "Unlike static types, heap type objects are mutable by default. Use the :c:" -"data:`Py_TPFLAGS_IMMUTABLETYPE` flag to prevent mutability." +"macro:`Py_TPFLAGS_IMMUTABLETYPE` flag to prevent mutability." msgstr "" msgid "" "Heap types inherit :c:member:`~PyTypeObject.tp_new` by default, so it may " "become possible to instantiate them from Python code. You can prevent this " -"with the :c:data:`Py_TPFLAGS_DISALLOW_INSTANTIATION` flag." +"with the :c:macro:`Py_TPFLAGS_DISALLOW_INSTANTIATION` flag." msgstr "" msgid "Defining Heap Types" @@ -375,24 +375,55 @@ msgid "" "collection protocol. That is, heap types should:" msgstr "" -msgid "Have the :c:data:`Py_TPFLAGS_HAVE_GC` flag." +msgid "Have the :c:macro:`Py_TPFLAGS_HAVE_GC` flag." msgstr "" msgid "" "Define a traverse function using ``Py_tp_traverse``, which visits the type " -"(e.g. using :c:expr:`Py_VISIT(Py_TYPE(self))`)." +"(e.g. using ``Py_VISIT(Py_TYPE(self))``)." msgstr "" msgid "" -"Please refer to the :ref:`the documentation ` of :c:data:" -"`Py_TPFLAGS_HAVE_GC` and :c:member:`~PyTypeObject.tp_traverse` for " -"additional considerations." +"Please refer to the the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` and :" +"c:member:`~PyTypeObject.tp_traverse` for additional considerations." msgstr "" msgid "" -"If your traverse function delegates to the ``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``." +"The API for defining heap types grew organically, leaving it somewhat " +"awkward to use in its current state. The following sections will guide you " +"through common issues." +msgstr "" + +msgid "``tp_traverse`` in Python 3.8 and lower" +msgstr "" + +msgid "" +"The requirement to visit the type from ``tp_traverse`` was added in Python " +"3.9. If you support Python 3.8 and lower, the traverse function must *not* " +"visit the type, so it must be more complicated::" +msgstr "" + +msgid "" +"Unfortunately, :c:data:`Py_Version` was only added in Python 3.11. As a " +"replacement, use:" +msgstr "" + +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`)." +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``." msgstr "" msgid "For example, if your traverse function includes::" @@ -402,8 +433,65 @@ msgid "...and ``base`` may be a static type, then it should also include::" msgstr "" msgid "" -"It is not necessary to handle the type's reference count in ``tp_new`` and " -"``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``" +msgstr "" + +msgid "" +"If your type has a custom :c:member:`~PyTypeObject.tp_dealloc` function, it " +"needs to:" +msgstr "" + +msgid "" +"call :c:func:`PyObject_GC_UnTrack` before any fields are invalidated, and" +msgstr "" + +msgid "decrement the reference count of the type." +msgstr "" + +msgid "" +"To keep the type valid while ``tp_free`` is called, the type's refcount " +"needs to be decremented *after* the instance is deallocated. For example::" +msgstr "" + +msgid "" +"The default ``tp_dealloc`` function does this, so if your type does *not* " +"override ``tp_dealloc`` you don't need to add it." +msgstr "" + +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." +msgstr "" + +msgid "Avoiding ``PyObject_New``" +msgstr "" + +msgid "GC-tracked objects need to be allocated using GC-aware functions." +msgstr "" + +msgid "If you use use :c:func:`PyObject_New` or :c:func:`PyObject_NewVar`:" +msgstr "" + +msgid "" +"Get and call type's :c:member:`~PyTypeObject.tp_alloc` slot, if possible. " +"That is, replace ``TYPE *o = PyObject_New(TYPE, typeobj)`` with::" +msgstr "" + +msgid "" +"Replace ``o = PyObject_NewVar(TYPE, typeobj, size)`` with the same, but use " +"size instead of the 0." +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`::" msgstr "" msgid "Module State Access from Classes" @@ -437,9 +525,9 @@ msgid "" msgstr "" msgid "" -"Do not confuse the defining class with :c:expr:`Py_TYPE(self)`. If the " -"method is called on a *subclass* of your type, ``Py_TYPE(self)`` will refer " -"to that subclass, which may be defined in different module than yours." +"Do not confuse the defining class with ``Py_TYPE(self)``. If the method is " +"called on a *subclass* of your type, ``Py_TYPE(self)`` will refer to that " +"subclass, which may be defined in different module than yours." msgstr "" msgid "" @@ -448,9 +536,10 @@ msgid "" msgstr "" msgid "" -"For a method to get its \"defining class\", it must use the :data:" -"`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 "" @@ -470,9 +559,10 @@ 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:" -"`~PyType.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`." +"`~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 "" @@ -482,16 +572,16 @@ msgid "" msgstr "" msgid "" -"``PyType_GetModuleByDef`` works by searching the :term:`method resolution " -"order` (i.e. all superclasses) for the first superclass that has a " -"corresponding module." +":c:func:`!PyType_GetModuleByDef` works by searching the :term:`method " +"resolution order` (i.e. all superclasses) for the first superclass that has " +"a corresponding module." msgstr "" msgid "" "In very exotic cases (inheritance chains spanning multiple modules created " -"from the same definition), ``PyType_GetModuleByDef`` might not return the " -"module of the true defining class. However, it will always return a module " -"with the same definition, ensuring a compatible C memory layout." +"from the same definition), :c:func:`!PyType_GetModuleByDef` might not return " +"the module of the true defining class. However, it will always return a " +"module with the same definition, ensuring a compatible C memory layout." msgstr "" msgid "Lifetime of the Module State" diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po new file mode 100644 index 0000000000..bf09d99eb5 --- /dev/null +++ b/howto/logging-cookbook.po @@ -0,0 +1,1795 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Logging Cookbook" +msgstr "" + +msgid "Author" +msgstr "Autor" + +msgid "Vinay Sajip " +msgstr "" + +msgid "" +"This page contains a number of recipes related to logging, which have been " +"found useful in the past. For links to tutorial and reference information, " +"please see :ref:`cookbook-ref-links`." +msgstr "" + +msgid "Using logging in multiple modules" +msgstr "" + +msgid "" +"Multiple calls to ``logging.getLogger('someLogger')`` return a reference to " +"the same logger object. This is true not only within the same module, but " +"also across modules as long as it is in the same Python interpreter " +"process. It is true for references to the same object; additionally, " +"application code can define and configure a parent logger in one module and " +"create (but not configure) a child logger in a separate module, and all " +"logger calls to the child will pass up to the parent. Here is a main " +"module::" +msgstr "" + +msgid "Here is the auxiliary module::" +msgstr "" + +msgid "The output looks like this:" +msgstr "Wynik wygląda tak:" + +msgid "Logging from multiple threads" +msgstr "" + +msgid "" +"Logging from multiple threads requires no special effort. The following " +"example shows logging from the main (initial) thread and another thread::" +msgstr "" + +msgid "When run, the script should print something like the following:" +msgstr "" + +msgid "" +"This shows the logging output interspersed as one might expect. This " +"approach works for more threads than shown here, of course." +msgstr "" + +msgid "Multiple handlers and formatters" +msgstr "" + +msgid "" +"Loggers are plain Python objects. The :meth:`~Logger.addHandler` method has " +"no minimum or maximum quota for the number of handlers you may add. " +"Sometimes it will be beneficial for an application to log all messages of " +"all severities to a text file while simultaneously logging errors or above " +"to the console. To set this up, simply configure the appropriate handlers. " +"The logging calls in the application code will remain unchanged. Here is a " +"slight modification to the previous simple module-based configuration " +"example::" +msgstr "" + +msgid "" +"Notice that the 'application' code does not care about multiple handlers. " +"All that changed was the addition and configuration of a new handler named " +"*fh*." +msgstr "" + +msgid "" +"The ability to create new handlers with higher- or lower-severity filters " +"can be very helpful when writing and testing an application. Instead of " +"using many ``print`` statements for debugging, use ``logger.debug``: Unlike " +"the print statements, which you will have to delete or comment out later, " +"the logger.debug statements can remain intact in the source code and remain " +"dormant until you need them again. At that time, the only change that needs " +"to happen is to modify the severity level of the logger and/or handler to " +"debug." +msgstr "" + +msgid "Logging to multiple destinations" +msgstr "" + +msgid "" +"Let's say you want to log to console and file with different message formats " +"and in differing circumstances. Say you want to log messages with levels of " +"DEBUG and higher to file, and those messages at level INFO and higher to the " +"console. Let's also assume that the file should contain timestamps, but the " +"console messages should not. Here's how you can achieve this::" +msgstr "" + +msgid "When you run this, on the console you will see" +msgstr "" + +msgid "and in the file you will see something like" +msgstr "" + +msgid "" +"As you can see, the DEBUG message only shows up in the file. The other " +"messages are sent to both destinations." +msgstr "" + +msgid "" +"This example uses console and file handlers, but you can use any number and " +"combination of handlers you choose." +msgstr "" + +msgid "" +"Note that the above choice of log filename ``/tmp/myapp.log`` implies use of " +"a standard location for temporary files on POSIX systems. On Windows, you " +"may need to choose a different directory name for the log - just ensure that " +"the directory exists and that you have the permissions to create and update " +"files in it." +msgstr "" + +msgid "Custom handling of levels" +msgstr "" + +msgid "" +"Sometimes, you might want to do something slightly different from the " +"standard handling of levels in handlers, where all levels above a threshold " +"get processed by a handler. To do this, you need to use filters. Let's look " +"at a scenario where you want to arrange things as follows:" +msgstr "" + +msgid "Send messages of severity ``INFO`` and ``WARNING`` to ``sys.stdout``" +msgstr "" + +msgid "Send messages of severity ``ERROR`` and above to ``sys.stderr``" +msgstr "" + +msgid "Send messages of severity ``DEBUG`` and above to file ``app.log``" +msgstr "" + +msgid "Suppose you configure logging with the following JSON:" +msgstr "" + +msgid "" +"This configuration does *almost* what we want, except that ``sys.stdout`` " +"would show messages of severity ``ERROR`` and above as well as ``INFO`` and " +"``WARNING`` messages. To prevent this, we can set up a filter which excludes " +"those messages and add it to the relevant handler. This can be configured by " +"adding a ``filters`` section parallel to ``formatters`` and ``handlers``:" +msgstr "" + +msgid "and changing the section on the ``stdout`` handler to add it:" +msgstr "" + +msgid "" +"A filter is just a function, so we can define the ``filter_maker`` (a " +"factory function) as follows:" +msgstr "" + +msgid "" +"This converts the string argument passed in to a numeric level, and returns " +"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." +msgstr "" + +msgid "With the filter added, we can run ``main.py``, which in full is:" +msgstr "" + +msgid "And after running it like this:" +msgstr "" + +msgid "We can see the results are as expected:" +msgstr "" + +msgid "Configuration server example" +msgstr "" + +msgid "Here is an example of a module using the logging configuration server::" +msgstr "" + +msgid "" +"And here is a script that takes a filename and sends that file to the " +"server, properly preceded with the binary-encoded length, as the new logging " +"configuration::" +msgstr "" + +msgid "Dealing with handlers that block" +msgstr "" + +msgid "" +"Sometimes you have to get your logging handlers to do their work without " +"blocking the thread you're logging from. This is common in web applications, " +"though of course it also occurs in other scenarios." +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)." +msgstr "" + +msgid "" +"One solution is to use a two-part approach. For the first part, attach only " +"a :class:`QueueHandler` to those loggers which are accessed from performance-" +"critical threads. They simply write to their queue, which can be sized to a " +"large enough capacity or initialized with no upper bound to their size. The " +"write to the queue will typically be accepted quickly, though you will " +"probably need to catch the :exc:`queue.Full` exception as a precaution in " +"your code. If you are a library developer who has performance-critical " +"threads in their code, be sure to document this (together with a suggestion " +"to attach only ``QueueHandlers`` to your loggers) for the benefit of other " +"developers who will use your code." +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." +msgstr "" + +msgid "" +"The advantage of having a separate :class:`QueueListener` class is that you " +"can use the same instance to service multiple ``QueueHandlers``. This is " +"more resource-friendly than, say, having threaded versions of the existing " +"handler classes, which would eat up one thread per handler for no particular " +"benefit." +msgstr "" + +msgid "An example of using these two classes follows (imports omitted)::" +msgstr "" + +msgid "which, when run, will produce:" +msgstr "" + +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." +msgstr "" + +msgid "" +"Prior to Python 3.5, the :class:`QueueListener` always passed every message " +"received from the queue to every handler it was initialized with. (This was " +"because it was assumed that level filtering was all done on the other side, " +"where the queue is filled.) From 3.5 onwards, this behaviour can be changed " +"by passing a keyword argument ``respect_handler_level=True`` to the " +"listener's constructor. When this is done, the listener compares the level " +"of each message with the handler's level, and only passes a message to a " +"handler if it's appropriate to do so." +msgstr "" + +msgid "Sending and receiving logging events across a network" +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::" +msgstr "" + +msgid "" +"At the receiving end, you can set up a receiver using the :mod:" +"`socketserver` module. Here is a basic working example::" +msgstr "" + +msgid "" +"First run the server, and then the client. On the client side, nothing is " +"printed on the console; on the server side, you should see something like:" +msgstr "" + +msgid "" +"Note that there are some security issues with pickle in some scenarios. If " +"these affect you, you can use an alternative serialization scheme by " +"overriding the :meth:`~SocketHandler.makePickle` method and implementing " +"your alternative there, as well as adapting the above script to use your " +"alternative serialization." +msgstr "" + +msgid "Running a logging socket listener in production" +msgstr "" + +msgid "" +"To run a logging listener in production, you may need to use a process-" +"management tool such as `Supervisor `_. `Here is a " +"Gist `__ which provides the bare-bones files to run " +"the above functionality using Supervisor. It consists of the following files:" +msgstr "" + +msgid "File" +msgstr "" + +msgid "Purpose" +msgstr "" + +msgid ":file:`prepare.sh`" +msgstr ":file:`prepare.sh`" + +msgid "A Bash script to prepare the environment for testing" +msgstr "" + +msgid ":file:`supervisor.conf`" +msgstr ":file:`supervisor.conf`" + +msgid "" +"The Supervisor configuration file, which has entries for the listener and a " +"multi-process web application" +msgstr "" + +msgid ":file:`ensure_app.sh`" +msgstr ":file:`ensure_app.sh`" + +msgid "" +"A Bash script to ensure that Supervisor is running with the above " +"configuration" +msgstr "" + +msgid ":file:`log_listener.py`" +msgstr ":file:`log_listener.py`" + +msgid "" +"The socket listener program which receives log events and records them to a " +"file" +msgstr "" + +msgid ":file:`main.py`" +msgstr ":file:`main.py`" + +msgid "" +"A simple web application which performs logging via a socket connected to " +"the listener" +msgstr "" + +msgid ":file:`webapp.json`" +msgstr ":file:`webapp.json`" + +msgid "A JSON configuration file for the web application" +msgstr "" + +msgid ":file:`client.py`" +msgstr ":file:`client.py`" + +msgid "A Python script to exercise the web application" +msgstr "" + +msgid "" +"The web application uses `Gunicorn `_, which is a " +"popular web application server that starts multiple worker processes to " +"handle requests. This example setup shows how the workers can write to the " +"same log file without conflicting with one another --- they all go through " +"the socket listener." +msgstr "" + +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." +msgstr "" + +msgid "Unzip the above files from the archive into a scratch directory." +msgstr "" + +msgid "" +"In the scratch directory, run ``bash prepare.sh`` to get things ready. This " +"creates a :file:`run` subdirectory to contain Supervisor-related and log " +"files, and a :file:`venv` subdirectory to contain a virtual environment into " +"which ``bottle``, ``gunicorn`` and ``supervisor`` are installed." +msgstr "" + +msgid "" +"Run ``bash ensure_app.sh`` to ensure that Supervisor is running with the " +"above configuration." +msgstr "" + +msgid "" +"Run ``venv/bin/python client.py`` to exercise the web application, which " +"will lead to records being written to the log." +msgstr "" + +msgid "" +"Inspect the log files in the :file:`run` subdirectory. You should see the " +"most recent log lines in files matching the pattern :file:`app.log*`. They " +"won't be in any particular order, since they have been handled concurrently " +"by different worker processes in a non-deterministic way." +msgstr "" + +msgid "" +"You can shut down the listener and the web application by running ``venv/bin/" +"supervisorctl -c supervisor.conf shutdown``." +msgstr "" + +msgid "" +"You may need to tweak the configuration files in the unlikely event that the " +"configured ports clash with something else in your test environment." +msgstr "" + +msgid "Adding contextual information to your logging output" +msgstr "" + +msgid "" +"Sometimes you want logging output to contain contextual information in " +"addition to the parameters passed to the logging call. For example, in a " +"networked application, it may be desirable to log client-specific " +"information in the log (e.g. remote client's username, or IP address). " +"Although you could use the *extra* parameter to achieve this, it's not " +"always convenient to pass the information in this way. While it might be " +"tempting to create :class:`Logger` instances on a per-connection basis, this " +"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." +msgstr "" + +msgid "Using LoggerAdapters to impart contextual information" +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." +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`::" +msgstr "" + +msgid "" +"The :meth:`~LoggerAdapter.process` method of :class:`LoggerAdapter` is where " +"the contextual information is added to the logging output. It's passed the " +"message and keyword arguments of the logging call, and it passes back " +"(potentially) modified versions of these to use in the call to the " +"underlying logger. The default implementation of this method leaves the " +"message alone, but inserts an 'extra' key in the keyword argument whose " +"value is the dict-like object passed to the constructor. Of course, if you " +"had passed an 'extra' keyword argument in the call to the adapter, it will " +"be silently overwritten." +msgstr "" + +msgid "" +"The advantage of using 'extra' is that the values in the dict-like object " +"are merged into the :class:`LogRecord` instance's __dict__, allowing you to " +"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::" +msgstr "" + +msgid "which you can use like this::" +msgstr "" + +msgid "" +"Then any events that you log to the adapter will have the value of " +"``some_conn_id`` prepended to the log messages." +msgstr "" + +msgid "Using objects other than dicts to pass contextual information" +msgstr "" + +msgid "" +"You don't need to pass an actual dict to a :class:`LoggerAdapter` - you " +"could pass an instance of a class which implements ``__getitem__`` and " +"``__iter__`` so that it looks like a dict to logging. This would be useful " +"if you want to generate values dynamically (whereas the values in a dict " +"would be constant)." +msgstr "" + +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 " +"``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`." +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::" +msgstr "" + +msgid "which, when run, produces something like:" +msgstr "" + +msgid "Use of ``contextvars``" +msgstr "" + +msgid "" +"Since Python 3.7, the :mod:`contextvars` module has provided context-local " +"storage which works for both :mod:`threading` and :mod:`asyncio` processing " +"needs. This type of storage may thus be generally preferable to thread-" +"locals. The following example shows how, in a multi-threaded environment, " +"logs can populated with contextual information such as, for example, request " +"attributes handled by web applications." +msgstr "" + +msgid "" +"For the purposes of illustration, say that you have different web " +"applications, each independent of the other but running in the same Python " +"process and using a library common to them. How can each of these " +"applications have their own log, where all logging messages from the library " +"(and other request processing code) are directed to the appropriate " +"application's log file, while including in the log additional contextual " +"information such as client IP, HTTP request method and client username?" +msgstr "" + +msgid "Let's assume that the library can be simulated by the following code:" +msgstr "" + +msgid "" +"We can simulate the multiple web applications by means of two simple " +"classes, ``Request`` and ``WebApp``. These simulate how real threaded web " +"applications work - each request is handled by a thread:" +msgstr "" + +msgid "" +"If you run the above, you should find that roughly half the requests go " +"into :file:`app1.log` and the rest into :file:`app2.log`, and the all the " +"requests are logged to :file:`app.log`. Each webapp-specific log will " +"contain only log entries for only that webapp, and the request information " +"will be displayed consistently in the log (i.e. the information in each " +"dummy request will always appear together in a log line). This is " +"illustrated by the following shell output:" +msgstr "" + +msgid "Imparting contextual information in handlers" +msgstr "" + +msgid "" +"Each :class:`~Handler` has its own chain of filters. If you want to add " +"contextual information to a :class:`LogRecord` without leaking it to other " +"handlers, you can use a filter that returns a new :class:`~LogRecord` " +"instead of modifying it in-place, as shown in the following script::" +msgstr "" + +msgid "Logging to a single file from multiple processes" +msgstr "" + +msgid "" +"Although logging is thread-safe, and logging to a single file from multiple " +"threads in a single process *is* supported, logging to a single file from " +"*multiple processes* is *not* supported, because there is no standard way to " +"serialize access to a single file across multiple processes in Python. If " +"you need to log to a single file from multiple processes, one way of doing " +"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." +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 existing :class:" +"`FileHandler` and subclasses do not make use of :mod:`multiprocessing` at " +"present, though they may do so in the future. Note that at present, the :mod:" +"`multiprocessing` module does not provide working lock functionality on all " +"platforms (see https://bugs.python.org/issue3770)." +msgstr "" + +msgid "" +"Alternatively, you can use a ``Queue`` and a :class:`QueueHandler` to send " +"all logging events to one of the processes in your multi-process " +"application. The following example script demonstrates how you can do this; " +"in the example a separate listener process listens for events sent by other " +"processes and logs them according to its own logging configuration. Although " +"the example only demonstrates one way of doing it (for example, you may want " +"to use a listener thread rather than a separate listener process -- the " +"implementation would be analogous) it does allow for completely different " +"logging configurations for the listener and the other processes in your " +"application, and can be used as the basis for code meeting your own specific " +"requirements::" +msgstr "" + +msgid "" +"A variant of the above script keeps the logging in the main process, in a " +"separate thread::" +msgstr "" + +msgid "" +"This variant shows how you can e.g. apply configuration for particular " +"loggers - e.g. the ``foo`` logger has a special handler which stores all " +"events in the ``foo`` subsystem in a file ``mplog-foo.log``. This will be " +"used by the logging machinery in the main process (even though the logging " +"events are generated in the worker processes) to direct the messages to the " +"appropriate destinations." +msgstr "" + +msgid "Using concurrent.futures.ProcessPoolExecutor" +msgstr "" + +msgid "" +"If you want to use :class:`concurrent.futures.ProcessPoolExecutor` to start " +"your worker processes, you need to create the queue slightly differently. " +"Instead of" +msgstr "" + +msgid "you should use" +msgstr "" + +msgid "and you can then replace the worker creation from this::" +msgstr "" + +msgid "to this (remembering to first import :mod:`concurrent.futures`)::" +msgstr "" + +msgid "Deploying Web applications using Gunicorn and uWSGI" +msgstr "" + +msgid "" +"When deploying Web applications using `Gunicorn `_ or " +"`uWSGI `_ (or similar), " +"multiple worker processes are created to handle client requests. In such " +"environments, avoid creating file-based handlers directly in your web " +"application. Instead, use a :class:`SocketHandler` to log from the web " +"application to a listener in a separate process. This can be set up using a " +"process management tool such as Supervisor - see `Running a logging socket " +"listener in production`_ for more details." +msgstr "" + +msgid "Using file rotation" +msgstr "" + +msgid "" +"Sometimes you want to let a log file grow to a certain size, then open a new " +"file and log to that. You may want to keep a certain number of these files, " +"and when that many files have been created, rotate the files so that the " +"number of files and the size of the files both remain bounded. For this " +"usage pattern, the logging package provides a :class:`RotatingFileHandler`::" +msgstr "" + +msgid "" +"The result should be 6 separate files, each with part of the log history for " +"the application:" +msgstr "" + +msgid "" +"The most current file is always :file:`logging_rotatingfile_example.out`, " +"and each time it reaches the size limit it is renamed with the suffix " +"``.1``. Each of the existing backup files is renamed to increment the suffix " +"(``.1`` becomes ``.2``, etc.) and the ``.6`` file is erased." +msgstr "" + +msgid "" +"Obviously this example sets the log length much too small as an extreme " +"example. You would want to set *maxBytes* to an appropriate value." +msgstr "" + +msgid "Use of alternative formatting styles" +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)." +msgstr "" + +msgid "" +"Logging (as of 3.2) provides improved support for these two additional " +"formatting styles. The :class:`Formatter` class been enhanced to take an " +"additional, optional keyword parameter named ``style``. This defaults to " +"``'%'``, 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:" +msgstr "" + +msgid "" +"Note that the formatting of logging messages for final output to logs is " +"completely independent of how an individual logging message is constructed. " +"That can still use %-formatting, as shown here::" +msgstr "" + +msgid "" +"Logging calls (``logger.debug()``, ``logger.info()`` etc.) only take " +"positional parameters for the actual logging message itself, with keyword " +"parameters used only for determining options for how to handle the actual " +"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." +msgstr "" + +msgid "" +"There is, however, a way that you can use {}- and $- formatting to construct " +"your individual log messages. Recall that for a message you can use an " +"arbitrary object as a message format string, and that the logging package " +"will call ``str()`` on that object to get the actual format string. Consider " +"the following two classes::" +msgstr "" + +msgid "" +"Either of these can be used in place of a format string, to allow {}- or $-" +"formatting to be used to build the actual \"message\" part which appears in " +"the formatted log output in place of \"%(message)s\" or \"{message}\" or " +"\"$message\". It's a little unwieldy to use the class names whenever you " +"want to log something, but it's quite palatable if you use an alias such as " +"__ (double underscore --- not to be confused with _, the single underscore " +"used as a synonym/alias for :func:`gettext.gettext` or its brethren)." +msgstr "" + +msgid "" +"The above classes are not included in Python, though they're easy enough to " +"copy and paste into your own code. They can be used as follows (assuming " +"that they're declared in a module called ``wherever``):" +msgstr "" + +msgid "" +"While the above examples use ``print()`` to show how the formatting works, " +"you would of course use ``logger.debug()`` or similar to actually log using " +"this approach." +msgstr "" + +msgid "" +"One thing to note is that you pay no significant performance penalty with " +"this approach: the actual formatting happens not when you make the logging " +"call, but when (and if) the logged message is actually about to be output to " +"a log by a handler. So the only slightly unusual thing which might trip you " +"up is that the parentheses go around the format string and the arguments, " +"not just the format string. That's because the __ notation is just syntax " +"sugar for a constructor call to one of the :samp:`{XXX}Message` classes." +msgstr "" + +msgid "" +"If you prefer, you can use a :class:`LoggerAdapter` to achieve a similar " +"effect to the above, as in the following example::" +msgstr "" + +msgid "" +"The above script should log the message ``Hello, world!`` when run with " +"Python 3.8 or later." +msgstr "" + +msgid "Customizing ``LogRecord``" +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 " +"disabled). Before Python 3.2, there were only two places where this creation " +"was done:" +msgstr "" + +msgid "" +":meth:`Logger.makeRecord`, which is called in the normal process of logging " +"an event. This invoked :class:`LogRecord` directly to create an instance." +msgstr "" + +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`)." +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." +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." +msgstr "" + +msgid "" +"Add a :class:`Filter` to a logger or handler, which does the necessary " +"special manipulation you need when its :meth:`~Filter.filter` method is " +"called." +msgstr "" + +msgid "" +"The first approach would be a little unwieldy in the scenario where (say) " +"several different libraries wanted to do different things. Each would " +"attempt to set its own :class:`Logger` subclass, and the one which did this " +"last would win." +msgstr "" + +msgid "" +"The second approach works reasonably well for many cases, but does not allow " +"you to e.g. use a specialized subclass of :class:`LogRecord`. Library " +"developers can set a suitable filter on their loggers, but they would have " +"to remember to do this every time they introduced a new logger (which they " +"would do simply by adding new packages or modules and doing ::" +msgstr "" + +msgid "" +"at module level). It's probably one too many things to think about. " +"Developers could also add the filter to a :class:`~logging.NullHandler` " +"attached to their top-level logger, but this would not be invoked if an " +"application developer attached a handler to a lower-level library logger --- " +"so output from that handler would not reflect the intentions of the library " +"developer." +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." +msgstr "" + +msgid "" +"This approach allows a custom factory to control all aspects of LogRecord " +"creation. For example, you could return a subclass, or just add some " +"additional attributes to the record once created, using a pattern similar to " +"this::" +msgstr "" + +msgid "" +"This pattern allows different libraries to chain factories together, and as " +"long as they don't overwrite each other's attributes or unintentionally " +"overwrite the attributes provided as standard, there should be no surprises. " +"However, it should be borne in mind that each link in the chain adds run-" +"time overhead to all logging operations, and the technique should only be " +"used when the use of a :class:`Filter` does not provide the desired result." +msgstr "" + +msgid "Subclassing QueueHandler and QueueListener- a ZeroMQ example" +msgstr "" + +msgid "Subclass ``QueueHandler``" +msgstr "" + +msgid "" +"You can use a :class:`QueueHandler` subclass to send messages to other kinds " +"of queues, for example a ZeroMQ 'publish' socket. In the example below,the " +"socket is created separately and passed to the handler (as its 'queue')::" +msgstr "" + +msgid "" +"Of course there are other ways of organizing this, for example passing in " +"the data needed by the handler to create the socket::" +msgstr "" + +msgid "Subclass ``QueueListener``" +msgstr "" + +msgid "" +"You can also subclass :class:`QueueListener` to get messages from other " +"kinds of queues, for example a ZeroMQ 'subscribe' socket. Here's an example::" +msgstr "" + +msgid "Subclassing QueueHandler and QueueListener- a ``pynng`` example" +msgstr "" + +msgid "" +"In a similar way to the above section, we can implement a listener and " +"handler using `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. Juat for variety, we " +"present the listener first." +msgstr "" + +msgid "You can run the above two snippets in separate command shells." +msgstr "" + +msgid "An example dictionary-based configuration" +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::" +msgstr "" + +msgid "" +"For more information about this configuration, you can see the `relevant " +"section `_ of the Django documentation." +msgstr "" + +msgid "Using a rotator and namer to customize log rotation processing" +msgstr "" + +msgid "" +"An example of how you can define a namer and rotator is given in the " +"following runnable script, which shows gzip compression of the log file::" +msgstr "" + +msgid "" +"After running this, you will see six new files, five of which are compressed:" +msgstr "" + +msgid "A more elaborate multiprocessing example" +msgstr "" + +msgid "" +"The following working example shows how logging can be used with " +"multiprocessing using configuration files. The configurations are fairly " +"simple, but serve to illustrate how more complex ones could be implemented " +"in a real multiprocessing scenario." +msgstr "" + +msgid "" +"In the example, the main process spawns a listener process and some worker " +"processes. Each of the main process, the listener and the workers have three " +"separate configurations (the workers all share the same configuration). We " +"can see logging in the main process, how the workers log to a QueueHandler " +"and how the listener implements a QueueListener and a more complex logging " +"configuration, and arranges to dispatch events received via the queue to the " +"handlers specified in the configuration. Note that these configurations are " +"purely illustrative, but you should be able to adapt this example to your " +"own scenario." +msgstr "" + +msgid "" +"Here's the script - the docstrings and the comments hopefully explain how it " +"works::" +msgstr "" + +msgid "Inserting a BOM into messages sent to a SysLogHandler" +msgstr "" + +msgid "" +":rfc:`5424` requires that a Unicode message be sent to a syslog daemon as a " +"set of bytes which have the following structure: an optional pure-ASCII " +"component, followed by a UTF-8 Byte Order Mark (BOM), followed by Unicode " +"encoded using UTF-8. (See the :rfc:`relevant section of the specification " +"<5424#section-6>`.)" +msgstr "" + +msgid "" +"In Python 3.1, code was added to :class:`~logging.handlers.SysLogHandler` to " +"insert a BOM into the message, but unfortunately, it was implemented " +"incorrectly, with the BOM appearing at the beginning of the message and " +"hence not allowing any pure-ASCII component to appear before it." +msgstr "" + +msgid "" +"As this behaviour is broken, the incorrect BOM insertion code is being " +"removed from Python 3.2.4 and later. However, it is not being replaced, and " +"if you want to produce :rfc:`5424`-compliant messages which include a BOM, " +"an optional pure-ASCII sequence before it and arbitrary Unicode after it, " +"encoded using UTF-8, then you need to do the following:" +msgstr "" + +msgid "" +"Attach a :class:`~logging.Formatter` instance to your :class:`~logging." +"handlers.SysLogHandler` instance, with a format string such as::" +msgstr "" + +msgid "" +"The Unicode code point U+FEFF, when encoded using UTF-8, will be encoded as " +"a UTF-8 BOM -- the byte-string ``b'\\xef\\xbb\\xbf'``." +msgstr "" + +msgid "" +"Replace the ASCII section with whatever placeholders you like, but make sure " +"that the data that appears in there after substitution is always ASCII (that " +"way, it will remain unchanged after UTF-8 encoding)." +msgstr "" + +msgid "" +"Replace the Unicode section with whatever placeholders you like; if the data " +"which appears there after substitution contains characters outside the ASCII " +"range, that's fine -- it will be encoded using UTF-8." +msgstr "" + +msgid "" +"The formatted message *will* be encoded using UTF-8 encoding by " +"``SysLogHandler``. If you follow the above rules, you should be able to " +"produce :rfc:`5424`-compliant messages. If you don't, logging may not " +"complain, but your messages will not be RFC 5424-compliant, and your syslog " +"daemon may complain." +msgstr "" + +msgid "Implementing structured logging" +msgstr "" + +msgid "" +"Although most logging messages are intended for reading by humans, and thus " +"not readily machine-parseable, there might be circumstances where you want " +"to output messages in a structured format which *is* capable of being parsed " +"by a program (without needing complex regular expressions to parse the log " +"message). This is straightforward to achieve using the logging package. " +"There are a number of ways in which this could be achieved, but the " +"following is a simple approach which uses JSON to serialise the event in a " +"machine-parseable manner::" +msgstr "" + +msgid "If the above script is run, it prints:" +msgstr "" + +msgid "" +"Note that the order of items might be different according to the version of " +"Python used." +msgstr "" + +msgid "" +"If you need more specialised processing, you can use a custom JSON encoder, " +"as in the following complete example::" +msgstr "" + +msgid "When the above script is run, it prints:" +msgstr "" + +msgid "Customizing handlers with :func:`dictConfig`" +msgstr "" + +msgid "" +"There are times when you want to customize logging handlers in particular " +"ways, and if you use :func:`dictConfig` you may be able to do this without " +"subclassing. As an example, consider that you may want to set the ownership " +"of a log file. On POSIX, this is easily done using :func:`shutil.chown`, but " +"the file handlers in the stdlib don't offer built-in support. You can " +"customize handler creation using a plain function such as::" +msgstr "" + +msgid "" +"You can then specify, in a logging configuration passed to :func:" +"`dictConfig`, that a logging handler be created by calling this function::" +msgstr "" + +msgid "" +"In this example I am setting the ownership using the ``pulse`` user and " +"group, just for the purposes of illustration. Putting it together into a " +"working script, ``chowntest.py``::" +msgstr "" + +msgid "To run this, you will probably need to run as ``root``:" +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`." +msgstr "" + +msgid "" +"In practice, the handler-creating function may be in a utility module " +"somewhere in your project. Instead of the line in the configuration::" +msgstr "" + +msgid "you could use e.g.::" +msgstr "" + +msgid "" +"where ``project.util`` can be replaced with the actual name of the package " +"where the function resides. In the above working script, using ``'ext://" +"__main__.owned_file_handler'`` should work. Here, the actual callable is " +"resolved by :func:`dictConfig` from the ``ext://`` specification." +msgstr "" + +msgid "" +"This example hopefully also points the way to how you could implement other " +"types of file change - e.g. setting specific POSIX permission bits - in the " +"same way, using :func:`os.chmod`." +msgstr "" + +msgid "" +"Of course, the approach could also be extended to types of handler other " +"than a :class:`~logging.FileHandler` - for example, one of the rotating file " +"handlers, or a different type of handler altogether." +msgstr "" + +msgid "Using particular formatting styles throughout your application" +msgstr "" + +msgid "" +"In Python 3.2, the :class:`~logging.Formatter` gained a ``style`` keyword " +"parameter which, while defaulting to ``%`` for backward compatibility, " +"allowed the specification of ``{`` or ``$`` to support the formatting " +"approaches supported by :meth:`str.format` and :class:`string.Template`. " +"Note that this governs the formatting of logging messages for final output " +"to logs, and is completely orthogonal to how an individual logging message " +"is constructed." +msgstr "" + +msgid "" +"Logging calls (:meth:`~Logger.debug`, :meth:`~Logger.info` etc.) only take " +"positional parameters for the actual logging message itself, with keyword " +"parameters used only for determining options for how to handle the 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." +msgstr "" + +msgid "" +"There have been suggestions to associate format styles with specific " +"loggers, but that approach also runs into backward compatibility problems " +"because any existing code could be using a given logger name and using %-" +"formatting." +msgstr "" + +msgid "" +"For logging to work interoperably between any third-party libraries and your " +"code, decisions about formatting need to be made at the level of the " +"individual logging call. This opens up a couple of ways in which alternative " +"formatting styles can be accommodated." +msgstr "" + +msgid "Using LogRecord factories" +msgstr "" + +msgid "" +"In Python 3.2, along with the :class:`~logging.Formatter` changes mentioned " +"above, the logging package gained the ability to allow users to set their " +"own :class:`LogRecord` subclasses, using the :func:`setLogRecordFactory` " +"function. You can use this to set your own subclass of :class:`LogRecord`, " +"which does the Right Thing by overriding the :meth:`~LogRecord.getMessage` " +"method. The base class implementation of this method is where the ``msg % " +"args`` formatting happens, and where you can substitute your alternate " +"formatting; however, you should be careful to support all formatting styles " +"and allow %-formatting as the default, to ensure interoperability with other " +"code. Care should also be taken to call ``str(self.msg)``, just as the base " +"implementation does." +msgstr "" + +msgid "" +"Refer to the reference documentation on :func:`setLogRecordFactory` and :" +"class:`LogRecord` for more information." +msgstr "" + +msgid "Using custom message objects" +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::" +msgstr "" + +msgid "" +"Either of these can be used in place of a format string, to allow {}- or $-" +"formatting to be used to build the actual \"message\" part which appears in " +"the formatted log output in place of “%(message)s” or “{message}” or " +"“$message”. If you find it a little unwieldy to use the class names whenever " +"you want to log something, you can make it more palatable if you use an " +"alias such as ``M`` or ``_`` for the message (or perhaps ``__``, if you are " +"using ``_`` for localization)." +msgstr "" + +msgid "" +"Examples of this approach are given below. Firstly, formatting with :meth:" +"`str.format`::" +msgstr "" + +msgid "Secondly, formatting with :class:`string.Template`::" +msgstr "" + +msgid "" +"One thing to note is that you pay no significant performance penalty with " +"this approach: the actual formatting happens not when you make the logging " +"call, but when (and if) the logged message is actually about to be output to " +"a log by a handler. So the only slightly unusual thing which might trip you " +"up is that the parentheses go around the format string and the arguments, " +"not just the format string. That’s because the __ notation is just syntax " +"sugar for a constructor call to one of the :samp:`{XXX}Message` classes " +"shown above." +msgstr "" + +msgid "Configuring filters with :func:`dictConfig`" +msgstr "" + +msgid "" +"You *can* configure filters using :func:`~logging.config.dictConfig`, though " +"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::" +msgstr "" + +msgid "" +"This example shows how you can pass configuration data to the callable which " +"constructs the instance, in the form of keyword parameters. When run, the " +"above script will print:" +msgstr "" + +msgid "which shows that the filter is working as configured." +msgstr "" + +msgid "A couple of extra points to note:" +msgstr "" + +msgid "" +"If you can't refer to the callable directly in the configuration (e.g. if it " +"lives in a different module, and you can't import it directly where the " +"configuration dictionary is), you can use the form ``ext://...`` as " +"described in :ref:`logging-config-dict-externalobj`. For example, you could " +"have used the text ``'ext://__main__.MyFilter'`` instead of ``MyFilter`` in " +"the above example." +msgstr "" + +msgid "" +"As well as for filters, this technique can also be used to configure custom " +"handlers and formatters. See :ref:`logging-config-dict-userdef` for more " +"information on how logging supports using user-defined objects in its " +"configuration, and see the other cookbook recipe :ref:`custom-handlers` " +"above." +msgstr "" + +msgid "Customized exception formatting" +msgstr "" + +msgid "" +"There might be times when you want to do customized exception formatting - " +"for argument's sake, let's say you want exactly one line per logged event, " +"even when exception information is present. You can do this with a custom " +"formatter class, as shown in the following example::" +msgstr "" + +msgid "When run, this produces a file with exactly two lines:" +msgstr "" + +msgid "" +"While the above treatment is simplistic, it points the way to how exception " +"information can be formatted to your liking. The :mod:`traceback` module may " +"be helpful for more specialized needs." +msgstr "" + +msgid "Speaking logging messages" +msgstr "" + +msgid "" +"There might be situations when it is desirable to have logging messages " +"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 " +"approach, which assumes that the ``espeak`` TTS package is available::" +msgstr "" + +msgid "" +"When run, this script should say \"Hello\" and then \"Goodbye\" in a female " +"voice." +msgstr "" + +msgid "" +"The above approach can, of course, be adapted to other TTS systems and even " +"other systems altogether which can process messages via external programs " +"run from a command line." +msgstr "" + +msgid "Buffering logging messages and outputting them conditionally" +msgstr "" + +msgid "" +"There might be situations where you want to log messages in a temporary area " +"and only output them if a certain condition occurs. For example, you may " +"want to start logging debug events in a function, and if the function " +"completes without errors, you don't want to clutter the log with the " +"collected debug information, but if there is an error, you want all the " +"debug information to be output as well as the error." +msgstr "" + +msgid "" +"Here is an example which shows how you could do this using a decorator for " +"your functions where you want logging to behave this way. It makes use of " +"the :class:`logging.handlers.MemoryHandler`, which allows buffering of " +"logged events until some condition occurs, at which point the buffered " +"events are ``flushed`` - passed to another handler (the ``target`` handler) " +"for processing. By default, the ``MemoryHandler`` flushed when its buffer " +"gets filled up or an event whose level is greater than or equal to a " +"specified threshold is seen. You can use this recipe with a more specialised " +"subclass of ``MemoryHandler`` if you want custom flushing behavior." +msgstr "" + +msgid "" +"The example script has a simple function, ``foo``, which just cycles through " +"all the logging levels, writing to ``sys.stderr`` to say what level it's " +"about to log at, and then actually logging a message at that level. You can " +"pass a parameter to ``foo`` which, if true, will log at ERROR and CRITICAL " +"levels - otherwise, it only logs at DEBUG, INFO and WARNING levels." +msgstr "" + +msgid "" +"The script just arranges to decorate ``foo`` with a decorator which will do " +"the conditional logging that's required. The decorator takes a logger as a " +"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." +msgstr "" + +msgid "Here's the script::" +msgstr "" + +msgid "When this script is run, the following output should be observed:" +msgstr "" + +msgid "" +"As you can see, actual logging output only occurs when an event is logged " +"whose severity is ERROR or greater, but in that case, any previous events at " +"lower severities are also logged." +msgstr "" + +msgid "You can of course use the conventional means of decoration::" +msgstr "" + +msgid "Sending logging messages to email, with buffering" +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.)" +msgstr "" + +msgid "" +"If you run this script and your SMTP server is correctly set up, you should " +"find that it sends eleven emails to the addressee you specify. The first ten " +"emails will each have ten log messages, and the eleventh will have two " +"messages. That makes up 102 messages as specified in the script." +msgstr "" + +msgid "Formatting times using UTC (GMT) via configuration" +msgstr "" + +msgid "" +"Sometimes you want to format times using UTC, which can be done using a " +"class such as ``UTCFormatter``, shown below::" +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::" +msgstr "" + +msgid "When this script is run, it should print something like:" +msgstr "" + +msgid "" +"showing how the time is formatted both as local time and UTC, one for each " +"handler." +msgstr "" + +msgid "Using a context manager for selective logging" +msgstr "" + +msgid "" +"There are times when it would be useful to temporarily change the logging " +"configuration and revert it back after doing something. For this, a context " +"manager is the most obvious way of saving and restoring the logging context. " +"Here is a simple example of such a context manager, which allows you to " +"optionally change the logging level and add a logging handler purely in the " +"scope of the context manager::" +msgstr "" + +msgid "" +"If you specify a level value, the logger's level is set to that value in the " +"scope of the with block covered by the context manager. If you specify a " +"handler, it is added to the logger on entry to the block and removed on exit " +"from the block. You can also ask the manager to close the handler for you on " +"block exit - you could do this if you don't need the handler any more." +msgstr "" + +msgid "" +"To illustrate how it works, we can add the following block of code to the " +"above::" +msgstr "" + +msgid "" +"We initially set the logger's level to ``INFO``, so message #1 appears and " +"message #2 doesn't. We then change the level to ``DEBUG`` temporarily in the " +"following ``with`` block, and so message #3 appears. After the block exits, " +"the logger's level is restored to ``INFO`` and so message #4 doesn't appear. " +"In the next ``with`` block, we set the level to ``DEBUG`` again but also add " +"a handler writing to ``sys.stdout``. Thus, message #5 appears twice on the " +"console (once via ``stderr`` and once via ``stdout``). After the ``with`` " +"statement's completion, the status is as it was before so message #6 appears " +"(like message #1) whereas message #7 doesn't (just like message #2)." +msgstr "" + +msgid "If we run the resulting script, the result is as follows:" +msgstr "" + +msgid "" +"If we run it again, but pipe ``stderr`` to ``/dev/null``, we see the " +"following, which is the only message written to ``stdout``:" +msgstr "" + +msgid "Once again, but piping ``stdout`` to ``/dev/null``, we get:" +msgstr "" + +msgid "" +"In this case, the message #5 printed to ``stdout`` doesn't appear, as " +"expected." +msgstr "" + +msgid "" +"Of course, the approach described here can be generalised, for example to " +"attach logging filters temporarily. Note that the above code works in Python " +"2 as well as Python 3." +msgstr "" + +msgid "A CLI application starter template" +msgstr "" + +msgid "Here's an example which shows how you can:" +msgstr "" + +msgid "Use a logging level based on command-line arguments" +msgstr "" + +msgid "" +"Dispatch to multiple subcommands in separate files, all logging at the same " +"level in a consistent way" +msgstr "" + +msgid "Make use of simple, minimal configuration" +msgstr "" + +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 " +"verbosity of the application via a command-line argument, defaulting to " +"``logging.INFO``. Here's one way that ``app.py`` could be written::" +msgstr "" + +msgid "" +"And the ``start``, ``stop`` and ``restart`` commands can be implemented in " +"separate modules, like so for starting::" +msgstr "" + +msgid "and thus for stopping::" +msgstr "" + +msgid "and similarly for restarting::" +msgstr "" + +msgid "" +"If we run this application with the default log level, we get output like " +"this:" +msgstr "" + +msgid "" +"The first word is the logging level, and the second word is the module or " +"package name of the place where the event was logged." +msgstr "" + +msgid "" +"If we change the logging level, then we can change the information sent to " +"the log. For example, if we want more information:" +msgstr "" + +msgid "And if we want less:" +msgstr "" + +msgid "" +"In this case, the commands don't print anything to the console, since " +"nothing at ``WARNING`` level or above is logged by them." +msgstr "" + +msgid "A Qt GUI for logging" +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 `PySide2 `_ or `PyQt5 `_ libraries." +msgstr "" + +msgid "" +"The following example shows how to log to a Qt GUI. This introduces a simple " +"``QtHandler`` class which takes a callable, which should be a slot in the " +"main thread that does GUI updates. A worker thread is also created to show " +"how you can log to the GUI from both the UI itself (via a button for manual " +"logging) as well as a worker thread doing work in the background (here, just " +"logging messages at random levels with random short delays in between)." +msgstr "" + +msgid "" +"The worker thread is implemented using Qt's ``QThread`` class rather than " +"the :mod:`threading` module, as there are circumstances where one has to use " +"``QThread``, which offers better integration with other ``Qt`` components." +msgstr "" + +msgid "" +"The code should work with recent releases of any of ``PySide6``, ``PyQt6``, " +"``PySide2`` or ``PyQt5``. You should be able to adapt the approach to " +"earlier versions of Qt. Please refer to the comments in the code snippet for " +"more detailed information." +msgstr "" + +msgid "Logging to syslog with RFC5424 support" +msgstr "" + +msgid "" +"Although :rfc:`5424` dates from 2009, most syslog servers are configured by " +"detault 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 RFC5424 came out, as there has not " +"been widespread deployment of it in syslog servers, the :class:`~logging." +"handlers.SysLogHandler` functionality has not been updated." +msgstr "" + +msgid "" +"RFC 5424 contains some useful features such as support for structured data, " +"and if you need to be able to log to a syslog server with support for it, " +"you can do so with a subclassed handler which looks something like this::" +msgstr "" + +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 " +"using something like this::" +msgstr "" + +msgid "How to treat a logger like an output stream" +msgstr "" + +msgid "" +"Sometimes, you need to interface to a third-party API which expects a file-" +"like object to write to, but you want to direct the API's output to a " +"logger. You can do this using a class which wraps a logger with a file-like " +"API. Here's a short script illustrating such a class:" +msgstr "" + +msgid "When this script is run, it prints" +msgstr "" + +msgid "" +"You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and ``sys." +"stderr`` by doing something like this:" +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:" +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." +msgstr "" + +msgid "" +"Note that with the above scheme, you are somewhat at the mercy of buffering " +"and the sequence of write calls which you are intercepting. For example, " +"with the definition of ``LoggerWriter`` above, if you have the snippet" +msgstr "" + +msgid "then running the script results in" +msgstr "" + +msgid "" +"As you can see, this output isn't ideal. That's because the underlying code " +"which writes to ``sys.stderr`` makes mutiple writes, each of which results " +"in a separate logged line (for example, the last three lines above). To get " +"around this problem, you need to buffer things and only output log lines " +"when newlines are seen. Let's use a slghtly better implementation of " +"``LoggerWriter``:" +msgstr "" + +msgid "" +"This just buffers up stuff until a newline is seen, and then logs complete " +"lines. With this approach, you get better output:" +msgstr "" + +msgid "Patterns to avoid" +msgstr "" + +msgid "" +"Although the preceding sections have described ways of doing things you " +"might need to do or deal with, it is worth mentioning some usage patterns " +"which are *unhelpful*, and which should therefore be avoided in most cases. " +"The following sections are in no particular order." +msgstr "" + +msgid "Opening the same log file multiple times" +msgstr "" + +msgid "" +"On Windows, you will generally not be able to open the same file multiple " +"times as this will lead to a \"file is in use by another process\" error. " +"However, on POSIX platforms you'll not get any errors if you open the same " +"file multiple times. This could be done accidentally, for example by:" +msgstr "" + +msgid "" +"Adding a file handler more than once which references the same file (e.g. by " +"a copy/paste/forget-to-change error)." +msgstr "" + +msgid "" +"Opening two files that look different, as they have different names, but are " +"the same because one is a symbolic link to the other." +msgstr "" + +msgid "" +"Forking a process, following which both parent and child have a reference to " +"the same file. This might be through use of the :mod:`multiprocessing` " +"module, for example." +msgstr "" + +msgid "" +"Opening a file multiple times might *appear* to work most of the time, but " +"can lead to a number of problems in practice:" +msgstr "" + +msgid "" +"Logging output can be garbled because multiple threads or processes try to " +"write to the same file. Although logging guards against concurrent use of " +"the same handler instance by multiple threads, there is no such protection " +"if concurrent writes are attempted by two different threads using two " +"different handler instances which happen to point to the same file." +msgstr "" + +msgid "" +"An attempt to delete a file (e.g. during file rotation) silently fails, " +"because there is another reference pointing to it. This can lead to " +"confusion and wasted debugging time - log entries end up in unexpected " +"places, or are lost altogether. Or a file that was supposed to be moved " +"remains in place, and grows in size unexpectedly despite size-based rotation " +"being supposedly in place." +msgstr "" + +msgid "" +"Use the techniques outlined in :ref:`multiple-processes` to circumvent such " +"issues." +msgstr "" + +msgid "Using loggers as attributes in a class or passing them as parameters" +msgstr "" + +msgid "" +"While there might be unusual cases where you'll need to do this, in general " +"there is no point because loggers are singletons. Code can always access a " +"given logger instance by name using ``logging.getLogger(name)``, so passing " +"instances around and holding them as instance attributes is pointless. Note " +"that in other languages such as Java and C#, loggers are often static class " +"attributes. However, this pattern doesn't make sense in Python, where the " +"module (and not the class) is the unit of software decomposition." +msgstr "" + +msgid "" +"Adding handlers other than :class:`~logging.NullHandler` to a logger in a " +"library" +msgstr "" + +msgid "" +"Configuring logging by adding handlers, formatters and filters is the " +"responsibility of the application developer, not the library developer. If " +"you are maintaining a library, ensure that you don't add handlers to any of " +"your loggers other than a :class:`~logging.NullHandler` instance." +msgstr "" + +msgid "Creating a lot of loggers" +msgstr "" + +msgid "" +"Loggers are singletons that are never freed during a script execution, and " +"so creating lots of loggers will use up memory which can't then be freed. " +"Rather than create a logger per e.g. file processed or network connection " +"made, use the :ref:`existing mechanisms ` for passing " +"contextual information into your logs and restrict the loggers created to " +"those describing areas within your application (generally modules, but " +"occasionally slightly more fine-grained than that)." +msgstr "" + +msgid "Other resources" +msgstr "Inne zasoby" + +msgid "Module :mod:`logging`" +msgstr "" + +msgid "API reference for the logging module." +msgstr "" + +msgid "Module :mod:`logging.config`" +msgstr "" + +msgid "Configuration API for the logging module." +msgstr "" + +msgid "Module :mod:`logging.handlers`" +msgstr "" + +msgid "Useful handlers included with the logging module." +msgstr "" + +msgid ":ref:`Basic Tutorial `" +msgstr "" + +msgid ":ref:`Advanced Tutorial `" +msgstr "" diff --git a/howto/logging.po b/howto/logging.po index ff39c20825..b519b5712f 100644 --- a/howto/logging.po +++ b/howto/logging.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +49,12 @@ msgid "When to use logging" msgstr "" msgid "" -"Logging provides a set of convenience functions for simple logging usage. " -"These are :func:`debug`, :func:`info`, :func:`warning`, :func:`error` and :" -"func:`critical`. To determine when to use logging, see the table below, " -"which states, for each of a set of common tasks, the best tool to use for it." +"You can access logging functionality by creating a logger via ``logger = " +"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." msgstr "" msgid "Task you want to perform" @@ -75,8 +76,8 @@ msgid "" msgstr "" msgid "" -":func:`logging.info` (or :func:`logging.debug` for very detailed output for " -"diagnostic purposes)" +"A logger's :meth:`~Logger.info` (or :meth:`~Logger.debug` method for very " +"detailed output for diagnostic purposes)" msgstr "" msgid "Issue a warning regarding a particular runtime event" @@ -88,8 +89,8 @@ msgid "" msgstr "" msgid "" -":func:`logging.warning` if there is nothing the client application can do " -"about the situation, but the event should still be noted" +"A logger's :meth:`~Logger.warning` method if there is nothing the client " +"application can do about the situation, but the event should still be noted" msgstr "" msgid "Report an error regarding a particular runtime event" @@ -104,14 +105,15 @@ msgid "" msgstr "" msgid "" -":func:`logging.error`, :func:`logging.exception` or :func:`logging.critical` " -"as appropriate for the specific error and application domain" +"A logger's :meth:`~Logger.error`, :meth:`~Logger.exception` or :meth:" +"`~Logger.critical` method as appropriate for the specific error and " +"application domain" msgstr "" msgid "" -"The logging functions are named after the level or severity of the events " -"they are used to track. The standard levels and their applicability are " -"described below (in increasing order of severity):" +"The logger methods are named after the level or severity of the events they " +"are used to track. The standard levels and their applicability are described " +"below (in increasing order of severity):" msgstr "" msgid "Level" @@ -121,20 +123,20 @@ msgid "When it's used" msgstr "" msgid "``DEBUG``" -msgstr "" +msgstr "``DEBUG``" msgid "" "Detailed information, typically of interest only when diagnosing problems." msgstr "" msgid "``INFO``" -msgstr "" +msgstr "``INFO``" msgid "Confirmation that things are working as expected." msgstr "" msgid "``WARNING``" -msgstr "" +msgstr "``WARNING``" msgid "" "An indication that something unexpected happened, or indicative of some " @@ -143,7 +145,7 @@ msgid "" msgstr "" msgid "``ERROR``" -msgstr "" +msgstr "``ERROR``" msgid "" "Due to a more serious problem, the software has not been able to perform " @@ -151,7 +153,7 @@ msgid "" msgstr "" msgid "``CRITICAL``" -msgstr "" +msgstr "``CRITICAL``" msgid "" "A serious error, indicating that the program itself may be unable to " @@ -183,11 +185,21 @@ 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!'. Don't worry about the 'root' part for now: it will be " -"explained later. The actual output can be formatted quite flexibly if you " +"e. 'Watch out!'. The actual output can be formatted quite flexibly if you " "need that; formatting options will also be explained later." msgstr "" +msgid "" +"Notice that in this example, we use functions directly on the ``logging`` " +"module, like ``logging.debug``, rather than creating a logger and calling " +"functions on it. These functions operation on the root logger, but can be " +"useful as they will call :func:`~logging.basicConfig` for you if it has not " +"been called yet, like in this example. In larger programs you'll usually " +"want to control the logging configuration explicitly however - so for that " +"reason as well as others, it's better to create loggers and call their " +"methods." +msgstr "" + msgid "Logging to a file" msgstr "" @@ -233,11 +245,9 @@ msgid "" msgstr "" msgid "" -"The call to :func:`basicConfig` should come *before* any calls to :func:" -"`debug`, :func:`info`, etc. Otherwise, those functions will call :func:" -"`basicConfig` for you with the default options. As it's intended as a one-" -"off simple configuration facility, only the first call will actually do " -"anything: subsequent calls are effectively no-ops." +"The call to :func:`basicConfig` should come *before* any calls to a logger's " +"methods such as :meth:`~Logger.debug`, :meth:`~Logger.info`, etc. Otherwise, " +"that logging event may not be handled in the desired manner." msgstr "" msgid "" @@ -252,27 +262,6 @@ msgid "" "appended to, so the messages from earlier runs are lost." msgstr "" -msgid "Logging from multiple modules" -msgstr "" - -msgid "" -"If your program consists of multiple modules, here's an example of how you " -"could organize logging in it::" -msgstr "" - -msgid "If you run *myapp.py*, you should see this in *myapp.log*:" -msgstr "" - -msgid "" -"which is hopefully what you were expecting to see. You can generalize this " -"to multiple modules, using the pattern in *mylib.py*. Note that for this " -"simple usage pattern, you won't know, by looking in the log file, *where* in " -"your application your messages came from, apart from looking at the event " -"description. If you want to track the location of your messages, you'll need " -"to refer to the documentation beyond the tutorial level -- see :ref:`logging-" -"advanced-tutorial`." -msgstr "" - msgid "Logging variable data" msgstr "" @@ -594,10 +583,10 @@ msgstr "" msgid "" "The :meth:`~Handler.setLevel` method, just as in logger objects, specifies " "the lowest severity that will be dispatched to the appropriate destination. " -"Why are there two :func:`setLevel` methods? The level set in the logger " -"determines which severity of messages it will pass to its handlers. The " -"level set in each handler determines which messages that handler will send " -"on." +"Why are there two :meth:`~Handler.setLevel` methods? The level set in the " +"logger determines which severity of messages it will pass to its handlers. " +"The level set in each handler determines which messages that handler will " +"send on." msgstr "" msgid "" @@ -776,40 +765,35 @@ msgstr "" msgid "" "If no logging configuration is provided, it is possible to have a situation " "where a logging event needs to be output, but no handlers can be found to " -"output the event. The behaviour of the logging package in these " -"circumstances is dependent on the Python version." +"output the event." +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 " +"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 " +"severities will be output." msgstr "" msgid "For versions of Python prior to 3.2, the behaviour is as follows:" msgstr "" msgid "" -"If *logging.raiseExceptions* is ``False`` (production mode), the event is " +"If :data:`raiseExceptions` is ``False`` (production mode), the event is " "silently dropped." msgstr "" msgid "" -"If *logging.raiseExceptions* is ``True`` (development mode), a message 'No " +"If :data:`raiseExceptions` is ``True`` (development mode), a message 'No " "handlers could be found for logger X.Y.Z' is printed once." msgstr "" -msgid "In Python 3.2 and later, the behaviour is as follows:" -msgstr "" - -msgid "" -"The event is output using a 'handler of last resort', stored in ``logging." -"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 " -"severities will be output." -msgstr "" - msgid "" -"To obtain the pre-3.2 behaviour, ``logging.lastResort`` can be set to " -"``None``." +"To obtain the pre-3.2 behaviour, :data:`lastResort` can be set to ``None``." msgstr "" msgid "Configuring Logging for a Library" @@ -886,22 +870,22 @@ msgid "Numeric value" msgstr "" msgid "50" -msgstr "" +msgstr "50" msgid "40" -msgstr "" +msgstr "40" msgid "30" -msgstr "" +msgstr "30" msgid "20" -msgstr "" +msgstr "20" msgid "10" -msgstr "" +msgstr "10" msgid "``NOTSET``" -msgstr "" +msgstr "``NOTSET``" msgid "0" msgstr "0" @@ -1044,7 +1028,7 @@ msgstr "" msgid "" ":class:`NullHandler` instances do nothing with error messages. They are used " "by library developers who want to use logging, but want to avoid the 'No " -"handlers could be found for logger XXX' message which can be displayed if " +"handlers could be found for logger *XXX*' message which can be displayed if " "the library user has not configured logging. See :ref:`library-config` for " "more information." msgstr "" @@ -1069,8 +1053,8 @@ msgid "" msgstr "" msgid "" -"For formatting multiple messages in a batch, instances of :class:`~handlers." -"BufferingFormatter` can be used. In addition to the format string (which is " +"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 "" @@ -1149,8 +1133,8 @@ msgid "" msgstr "" msgid "" -"so that if the logger's threshold is set above ``DEBUG``, the calls to :func:" -"`expensive_func1` and :func:`expensive_func2` are never made." +"so that if the logger's threshold is set above ``DEBUG``, the calls to " +"``expensive_func1`` and ``expensive_func2`` are never made." msgstr "" msgid "" diff --git a/howto/pyporting.po b/howto/pyporting.po index 812d4a588a..af2fc0139c 100644 --- a/howto/pyporting.po +++ b/howto/pyporting.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 -# Krzysztof Abramowicz, 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -25,8 +23,8 @@ 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 "Porting Python 2 Code to Python 3" -msgstr "Przeportowywanie kodu Python 2 do Python 3" +msgid "How to port Python 2 Code to Python 3" +msgstr "" msgid "author" msgstr "autor" @@ -34,14 +32,11 @@ msgstr "autor" msgid "Brett Cannon" msgstr "" -msgid "Abstract" -msgstr "Streszczenie" - msgid "" -"With Python 3 being the future of Python while Python 2 is still in active " -"use, it is good to have your project available for both major releases of " -"Python. This guide is meant to help you figure out how best to support both " -"Python 2 & 3 simultaneously." +"Python 2 reached its official end-of-life at the start of 2020. This means " +"that no new bug reports, fixes, or changes will be made to Python 2 - it's " +"no longer supported: see :pep:`373` and `status of Python versions `_." msgstr "" msgid "" @@ -50,520 +45,33 @@ msgid "" msgstr "" msgid "" -"If you would like to read one core Python developer's take on why Python 3 " -"came into existence, you can read Nick Coghlan's `Python 3 Q & A`_ or Brett " -"Cannon's `Why Python 3 exists`_." -msgstr "" - -msgid "" -"For help with porting, you can view the archived python-porting_ mailing " -"list." -msgstr "" - -msgid "The Short Explanation" -msgstr "" - -msgid "" -"To make your project be single-source Python 2/3 compatible, the basic steps " -"are:" -msgstr "" - -msgid "Only worry about supporting Python 2.7" -msgstr "Jedyne, o co można się martwić to wsparcie dla Python 2.7" - -msgid "" -"Make sure you have good test coverage (coverage.py_ can help; ``python -m " -"pip install coverage``)" -msgstr "" - -msgid "Learn the differences between Python 2 & 3" -msgstr "" - -msgid "" -"Use Futurize_ (or Modernize_) to update your code (e.g. ``python -m pip " -"install future``)" -msgstr "" -"Użyj Futurize_ lub Modernize_ do aktualizacji twojego kodu źródłowego " -"``python -m pip install future``" - -msgid "" -"Use Pylint_ to help make sure you don't regress on your Python 3 support " -"(``python -m pip install pylint``)" -msgstr "" - -msgid "" -"Use caniusepython3_ to find out which of your dependencies are blocking your " -"use of Python 3 (``python -m pip install caniusepython3``)" -msgstr "" - -msgid "" -"Once your dependencies are no longer blocking you, use continuous " -"integration to make sure you stay compatible with Python 2 & 3 (tox_ can " -"help test against multiple versions of Python; ``python -m pip install tox``)" -msgstr "" - -msgid "" -"Consider using optional static type checking to make sure your type usage " -"works in both Python 2 & 3 (e.g. use mypy_ to check your typing under both " -"Python 2 & Python 3; ``python -m pip install mypy``)." -msgstr "" - -msgid "" -"Note: Using ``python -m pip install`` guarantees that the ``pip`` you invoke " -"is the one installed for the Python currently in use, whether it be a system-" -"wide ``pip`` or one installed within a :ref:`virtual environment `." -msgstr "" - -msgid "Details" -msgstr "Szczegóły" - -msgid "" -"A key point about supporting Python 2 & 3 simultaneously is that you can " -"start **today**! Even if your dependencies are not supporting Python 3 yet " -"that does not mean you can't modernize your code **now** to support Python " -"3. Most changes required to support Python 3 lead to cleaner code using " -"newer practices even in Python 2 code." -msgstr "" - -msgid "" -"Another key point is that modernizing your Python 2 code to also support " -"Python 3 is largely automated for you. While you might have to make some API " -"decisions thanks to Python 3 clarifying text data versus binary data, the " -"lower-level work is now mostly done for you and thus can at least benefit " -"from the automated changes immediately." -msgstr "" - -msgid "" -"Keep those key points in mind while you read on about the details of porting " -"your code to support Python 2 & 3 simultaneously." -msgstr "" - -msgid "Drop support for Python 2.6 and older" -msgstr "Porzucone wsparcie dla Python 2.6 i jego starszych wersji." - -msgid "" -"While you can make Python 2.5 work with Python 3, it is **much** easier if " -"you only have to work with Python 2.7. If dropping Python 2.5 is not an " -"option then the six_ project can help you support Python 2.5 & 3 " -"simultaneously (``python -m pip install six``). Do realize, though, that " -"nearly all the projects listed in this HOWTO will not be available to you." -msgstr "" - -msgid "" -"If you are able to skip Python 2.5 and older, then the required changes to " -"your code should continue to look and feel like idiomatic Python code. At " -"worst you will have to use a function instead of a method in some instances " -"or have to import a function instead of using a built-in one, but otherwise " -"the overall transformation should not feel foreign to you." -msgstr "" - -msgid "" -"But you should aim for only supporting Python 2.7. Python 2.6 is no longer " -"freely supported and thus is not receiving bugfixes. This means **you** will " -"have to work around any issues you come across with Python 2.6. There are " -"also some tools mentioned in this HOWTO which do not support Python 2.6 (e." -"g., Pylint_), and this will become more commonplace as time goes on. It will " -"simply be easier for you if you only support the versions of Python that you " -"have to support." -msgstr "" - -msgid "" -"Make sure you specify the proper version support in your ``setup.py`` file" -msgstr "" -"Upewnij się, że określiłeś odpowiednią wersję pythona w pliku ``setup.py``" - -msgid "" -"In your ``setup.py`` file you should have the proper `trove classifier`_ " -"specifying what versions of Python you support. As your project does not " -"support Python 3 yet you should at least have ``Programming Language :: " -"Python :: 2 :: Only`` specified. Ideally you should also specify each major/" -"minor version of Python that you do support, e.g. ``Programming Language :: " -"Python :: 2.7``." -msgstr "" - -msgid "Have good test coverage" -msgstr "" - -msgid "" -"Once you have your code supporting the oldest version of Python 2 you want " -"it to, you will want to make sure your test suite has good coverage. A good " -"rule of thumb is that if you want to be confident enough in your test suite " -"that any failures that appear after having tools rewrite your code are " -"actual bugs in the tools and not in your code. If you want a number to aim " -"for, try to get over 80% coverage (and don't feel bad if you find it hard to " -"get better than 90% coverage). If you don't already have a tool to measure " -"test coverage then coverage.py_ is recommended." -msgstr "" - -msgid "" -"Once you have your code well-tested you are ready to begin porting your code " -"to Python 3! But to fully understand how your code is going to change and " -"what you want to look out for while you code, you will want to learn what " -"changes Python 3 makes in terms of Python 2. Typically the two best ways of " -"doing that is reading the :ref:`\"What's New\" ` doc for " -"each release of Python 3 and the `Porting to Python 3`_ book (which is free " -"online). There is also a handy `cheat sheet`_ from the Python-Future project." -msgstr "" - -msgid "Update your code" -msgstr "Zaktualizuj swój kod źródłowy" - -msgid "" -"Once you feel like you know what is different in Python 3 compared to Python " -"2, it's time to update your code! You have a choice between two tools in " -"porting your code automatically: Futurize_ and Modernize_. Which tool you " -"choose will depend on how much like Python 3 you want your code to be. " -"Futurize_ does its best to make Python 3 idioms and practices exist in " -"Python 2, e.g. backporting the ``bytes`` type from Python 3 so that you have " -"semantic parity between the major versions of Python. Modernize_, on the " -"other hand, is more conservative and targets a Python 2/3 subset of Python, " -"directly relying on six_ to help provide compatibility. As Python 3 is the " -"future, it might be best to consider Futurize to begin adjusting to any new " -"practices that Python 3 introduces which you are not accustomed to yet." -msgstr "" - -msgid "" -"Regardless of which tool you choose, they will update your code to run under " -"Python 3 while staying compatible with the version of Python 2 you started " -"with. Depending on how conservative you want to be, you may want to run the " -"tool over your test suite first and visually inspect the diff to make sure " -"the transformation is accurate. After you have transformed your test suite " -"and verified that all the tests still pass as expected, then you can " -"transform your application code knowing that any tests which fail is a " -"translation failure." -msgstr "" - -msgid "" -"Unfortunately the tools can't automate everything to make your code work " -"under Python 3 and so there are a handful of things you will need to update " -"manually to get full Python 3 support (which of these steps are necessary " -"vary between the tools). Read the documentation for the tool you choose to " -"use to see what it fixes by default and what it can do optionally to know " -"what will (not) be fixed for you and what you may have to fix on your own (e." -"g. using ``io.open()`` over the built-in ``open()`` function is off by " -"default in Modernize). Luckily, though, there are only a couple of things to " -"watch out for which can be considered large issues that may be hard to debug " -"if not watched for." -msgstr "" - -msgid "Division" -msgstr "" - -msgid "" -"In Python 3, ``5 / 2 == 2.5`` and not ``2``; all division between ``int`` " -"values result in a ``float``. This change has actually been planned since " -"Python 2.2 which was released in 2002. Since then users have been encouraged " -"to add ``from __future__ import division`` to any and all files which use " -"the ``/`` and ``//`` operators or to be running the interpreter with the ``-" -"Q`` flag. If you have not been doing this then you will need to go through " -"your code and do two things:" -msgstr "" - -msgid "Add ``from __future__ import division`` to your files" +"The archived python-porting_ mailing list may contain some useful guidance." msgstr "" msgid "" -"Update any division operator as necessary to either use ``//`` to use floor " -"division or continue using ``/`` and expect a float" +"Since Python 3.13 the original porting guide was discontinued. You can find " +"the old guide in the `archive `_." msgstr "" -msgid "" -"The reason that ``/`` isn't simply translated to ``//`` automatically is " -"that if an object defines a ``__truediv__`` method but not ``__floordiv__`` " -"then your code would begin to fail (e.g. a user-defined class that uses ``/" -"`` to signify some operation but not ``//`` for the same thing or at all)." +msgid "Third-party guides" msgstr "" -msgid "Text versus binary data" +msgid "There are also multiple third-party guides that might be useful:" msgstr "" -msgid "" -"In Python 2 you could use the ``str`` type for both text and binary data. " -"Unfortunately this confluence of two different concepts could lead to " -"brittle code which sometimes worked for either kind of data, sometimes not. " -"It also could lead to confusing APIs if people didn't explicitly state that " -"something that accepted ``str`` accepted either text or binary data instead " -"of one specific type. This complicated the situation especially for anyone " -"supporting multiple languages as APIs wouldn't bother explicitly supporting " -"``unicode`` when they claimed text data support." +msgid "`Guide by Fedora `_" msgstr "" -msgid "" -"To make the distinction between text and binary data clearer and more " -"pronounced, Python 3 did what most languages created in the age of the " -"internet have done and made text and binary data distinct types that cannot " -"blindly be mixed together (Python predates widespread access to the " -"internet). For any code that deals only with text or only binary data, this " -"separation doesn't pose an issue. But for code that has to deal with both, " -"it does mean you might have to now care about when you are using text " -"compared to binary data, which is why this cannot be entirely automated." +msgid "`PyCon 2020 tutorial `_" msgstr "" msgid "" -"To start, you will need to decide which APIs take text and which take binary " -"(it is **highly** recommended you don't design APIs that can take both due " -"to the difficulty of keeping the code working; as stated earlier it is " -"difficult to do well). In Python 2 this means making sure the APIs that take " -"text can work with ``unicode`` and those that work with binary data work " -"with the ``bytes`` type from Python 3 (which is a subset of ``str`` in " -"Python 2 and acts as an alias for ``bytes`` type in Python 2). Usually the " -"biggest issue is realizing which methods exist on which types in Python 2 & " -"3 simultaneously (for text that's ``unicode`` in Python 2 and ``str`` in " -"Python 3, for binary that's ``str``/``bytes`` in Python 2 and ``bytes`` in " -"Python 3). The following table lists the **unique** methods of each data " -"type across Python 2 & 3 (e.g., the ``decode()`` method is usable on the " -"equivalent binary data type in either Python 2 or 3, but it can't be used by " -"the textual data type consistently between Python 2 and 3 because ``str`` in " -"Python 3 doesn't have the method). Do note that as of Python 3.5 the " -"``__mod__`` method was added to the bytes type." -msgstr "" - -msgid "**Text data**" -msgstr "" - -msgid "**Binary data**" -msgstr "" - -msgid "\\" -msgstr "" - -msgid "decode" -msgstr "" - -msgid "encode" -msgstr "" - -msgid "format" -msgstr "" - -msgid "isdecimal" -msgstr "" - -msgid "isnumeric" -msgstr "" - -msgid "" -"Making the distinction easier to handle can be accomplished by encoding and " -"decoding between binary data and text at the edge of your code. This means " -"that when you receive text in binary data, you should immediately decode it. " -"And if your code needs to send text as binary data then encode it as late as " -"possible. This allows your code to work with only text internally and thus " -"eliminates having to keep track of what type of data you are working with." -msgstr "" - -msgid "" -"The next issue is making sure you know whether the string literals in your " -"code represent text or binary data. You should add a ``b`` prefix to any " -"literal that presents binary data. For text you should add a ``u`` prefix to " -"the text literal. (there is a :mod:`__future__` import to force all " -"unspecified literals to be Unicode, but usage has shown it isn't as " -"effective as adding a ``b`` or ``u`` prefix to all literals explicitly)" -msgstr "" - -msgid "" -"As part of this dichotomy you also need to be careful about opening files. " -"Unless you have been working on Windows, there is a chance you have not " -"always bothered to add the ``b`` mode when opening a binary file (e.g., " -"``rb`` for binary reading). Under Python 3, binary files and text files are " -"clearly distinct and mutually incompatible; see the :mod:`io` module for " -"details. Therefore, you **must** make a decision of whether a file will be " -"used for binary access (allowing binary data to be read and/or written) or " -"textual access (allowing text data to be read and/or written). You should " -"also use :func:`io.open` for opening files instead of the built-in :func:" -"`open` function as the :mod:`io` module is consistent from Python 2 to 3 " -"while the built-in :func:`open` function is not (in Python 3 it's actually :" -"func:`io.open`). Do not bother with the outdated practice of using :func:" -"`codecs.open` as that's only necessary for keeping compatibility with Python " -"2.5." -msgstr "" - -msgid "" -"The constructors of both ``str`` and ``bytes`` have different semantics for " -"the same arguments between Python 2 & 3. Passing an integer to ``bytes`` in " -"Python 2 will give you the string representation of the integer: ``bytes(3) " -"== '3'``. But in Python 3, an integer argument to ``bytes`` will give you a " -"bytes object as long as the integer specified, filled with null bytes: " -"``bytes(3) == b'\\x00\\x00\\x00'``. A similar worry is necessary when " -"passing a bytes object to ``str``. In Python 2 you just get the bytes object " -"back: ``str(b'3') == b'3'``. But in Python 3 you get the string " -"representation of the bytes object: ``str(b'3') == \"b'3'\"``." -msgstr "" - -msgid "" -"Finally, the indexing of binary data requires careful handling (slicing does " -"**not** require any special handling). In Python 2, ``b'123'[1] == b'2'`` " -"while in Python 3 ``b'123'[1] == 50``. Because binary data is simply a " -"collection of binary numbers, Python 3 returns the integer value for the " -"byte you index on. But in Python 2 because ``bytes == str``, indexing " -"returns a one-item slice of bytes. The six_ project has a function named " -"``six.indexbytes()`` which will return an integer like in Python 3: ``six." -"indexbytes(b'123', 1)``." -msgstr "" - -msgid "To summarize:" -msgstr "" - -msgid "Decide which of your APIs take text and which take binary data" -msgstr "" - -msgid "" -"Make sure that your code that works with text also works with ``unicode`` " -"and code for binary data works with ``bytes`` in Python 2 (see the table " -"above for what methods you cannot use for each type)" -msgstr "" - -msgid "" -"Mark all binary literals with a ``b`` prefix, textual literals with a ``u`` " -"prefix" -msgstr "" - -msgid "" -"Decode binary data to text as soon as possible, encode text as binary data " -"as late as possible" -msgstr "" - -msgid "" -"Open files using :func:`io.open` and make sure to specify the ``b`` mode " -"when appropriate" -msgstr "" - -msgid "Be careful when indexing into binary data" -msgstr "" - -msgid "Use feature detection instead of version detection" -msgstr "" - -msgid "" -"Inevitably you will have code that has to choose what to do based on what " -"version of Python is running. The best way to do this is with feature " -"detection of whether the version of Python you're running under supports " -"what you need. If for some reason that doesn't work then you should make the " -"version check be against Python 2 and not Python 3. To help explain this, " -"let's look at an example." -msgstr "" - -msgid "" -"Let's pretend that you need access to a feature of :mod:`importlib` that is " -"available in Python's standard library since Python 3.3 and available for " -"Python 2 through importlib2_ on PyPI. You might be tempted to write code to " -"access e.g. the :mod:`importlib.abc` module by doing the following::" -msgstr "" - -msgid "" -"The problem with this code is what happens when Python 4 comes out? It would " -"be better to treat Python 2 as the exceptional case instead of Python 3 and " -"assume that future Python versions will be more compatible with Python 3 " -"than Python 2::" -msgstr "" - -msgid "" -"The best solution, though, is to do no version detection at all and instead " -"rely on feature detection. That avoids any potential issues of getting the " -"version detection wrong and helps keep you future-compatible::" -msgstr "" - -msgid "Prevent compatibility regressions" -msgstr "" - -msgid "" -"Once you have fully translated your code to be compatible with Python 3, you " -"will want to make sure your code doesn't regress and stop working under " -"Python 3. This is especially true if you have a dependency which is blocking " -"you from actually running under Python 3 at the moment." -msgstr "" - -msgid "" -"To help with staying compatible, any new modules you create should have at " -"least the following block of code at the top of it::" -msgstr "" - -msgid "" -"You can also run Python 2 with the ``-3`` flag to be warned about various " -"compatibility issues your code triggers during execution. If you turn " -"warnings into errors with ``-Werror`` then you can make sure that you don't " -"accidentally miss a warning." -msgstr "" - -msgid "" -"You can also use the Pylint_ project and its ``--py3k`` flag to lint your " -"code to receive warnings when your code begins to deviate from Python 3 " -"compatibility. This also prevents you from having to run Modernize_ or " -"Futurize_ over your code regularly to catch compatibility regressions. This " -"does require you only support Python 2.7 and Python 3.4 or newer as that is " -"Pylint's minimum Python version support." -msgstr "" - -msgid "Check which dependencies block your transition" -msgstr "" - -msgid "" -"**After** you have made your code compatible with Python 3 you should begin " -"to care about whether your dependencies have also been ported. The " -"caniusepython3_ project was created to help you determine which projects -- " -"directly or indirectly -- are blocking you from supporting Python 3. There " -"is both a command-line tool as well as a web interface at https://" -"caniusepython3.com." -msgstr "" - -msgid "" -"The project also provides code which you can integrate into your test suite " -"so that you will have a failing test when you no longer have dependencies " -"blocking you from using Python 3. This allows you to avoid having to " -"manually check your dependencies and to be notified quickly when you can " -"start running on Python 3." -msgstr "" - -msgid "Update your ``setup.py`` file to denote Python 3 compatibility" -msgstr "" - -msgid "" -"Once your code works under Python 3, you should update the classifiers in " -"your ``setup.py`` to contain ``Programming Language :: Python :: 3`` and to " -"not specify sole Python 2 support. This will tell anyone using your code " -"that you support Python 2 **and** 3. Ideally you will also want to add " -"classifiers for each major/minor version of Python you now support." -msgstr "" - -msgid "Use continuous integration to stay compatible" -msgstr "" - -msgid "" -"Once you are able to fully run under Python 3 you will want to make sure " -"your code always works under both Python 2 & 3. Probably the best tool for " -"running your tests under multiple Python interpreters is tox_. You can then " -"integrate tox with your continuous integration system so that you never " -"accidentally break Python 2 or 3 support." -msgstr "" - -msgid "" -"You may also want to use the ``-bb`` flag with the Python 3 interpreter to " -"trigger an exception when you are comparing bytes to strings or bytes to an " -"int (the latter is available starting in Python 3.5). By default type-" -"differing comparisons simply return ``False``, but if you made a mistake in " -"your separation of text/binary data handling or indexing on bytes you " -"wouldn't easily find the mistake. This flag will raise an exception when " -"these kinds of comparisons occur, making the mistake much easier to track " -"down." -msgstr "" - -msgid "" -"And that's mostly it! At this point your code base is compatible with both " -"Python 2 and 3 simultaneously. Your testing will also be set up so that you " -"don't accidentally break Python 2 or 3 compatibility regardless of which " -"version you typically run your tests under while developing." -msgstr "" - -msgid "Consider using optional static type checking" +"`Guide by DigitalOcean `_" msgstr "" msgid "" -"Another way to help port your code is to use a static type checker like " -"mypy_ or pytype_ on your code. These tools can be used to analyze your code " -"as if it's being run under Python 2, then you can run the tool a second time " -"as if your code is running under Python 3. By running a static type checker " -"twice like this you can discover if you're e.g. misusing binary data type in " -"one version of Python compared to another. If you add optional type hints to " -"your code you can also explicitly state whether your APIs use textual or " -"binary data, helping to make sure everything functions as expected in both " -"versions of Python." +"`Guide by ActiveState `_" msgstr "" diff --git a/howto/regex.po b/howto/regex.po index 9e92f38896..077f726753 100644 --- a/howto/regex.po +++ b/howto/regex.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 -# Krzysztof Abramowicz, 2022 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -178,13 +177,13 @@ msgid "" msgstr "" msgid "``\\d``" -msgstr "" +msgstr "``\\d``" msgid "Matches any decimal digit; this is equivalent to the class ``[0-9]``." msgstr "" msgid "``\\D``" -msgstr "" +msgstr "``\\D``" msgid "" "Matches any non-digit character; this is equivalent to the class ``[^0-9]``." @@ -192,7 +191,7 @@ msgstr "" "Wyszukuje każdy nieliczbowy ciąg znaków , jest to zamiennik klasy ``[^0-9]``" msgid "``\\s``" -msgstr "" +msgstr "``\\s``" msgid "" "Matches any whitespace character; this is equivalent to the class " @@ -200,7 +199,7 @@ msgid "" msgstr "" msgid "``\\S``" -msgstr "" +msgstr "``\\S``" msgid "" "Matches any non-whitespace character; this is equivalent to the class ``[^ " @@ -208,7 +207,7 @@ msgid "" msgstr "" msgid "``\\w``" -msgstr "" +msgstr "``\\w``" msgid "" "Matches any alphanumeric character; this is equivalent to the class ``[a-zA-" @@ -216,7 +215,7 @@ msgid "" msgstr "" msgid "``\\W``" -msgstr "" +msgstr "``\\W``" msgid "" "Matches any non-alphanumeric character; this is equivalent to the class " @@ -286,7 +285,7 @@ msgid "1" msgstr "1" msgid "``a``" -msgstr "" +msgstr "``a``" msgid "The ``a`` in the RE matches." msgstr "" @@ -295,7 +294,7 @@ msgid "2" msgstr "2" msgid "``abcbd``" -msgstr "" +msgstr "``abcbd``" msgid "" "The engine matches ``[bcd]*``, going as far as it can, which is to the end " @@ -303,7 +302,7 @@ msgid "" msgstr "" msgid "3" -msgstr "" +msgstr "3" msgid "*Failure*" msgstr "" @@ -317,13 +316,13 @@ msgid "4" msgstr "4" msgid "``abcb``" -msgstr "" +msgstr "``abcb``" msgid "Back up, so that ``[bcd]*`` matches one less character." msgstr "" msgid "5" -msgstr "" +msgstr "5" msgid "" "Try ``b`` again, but the current position is at the last character, which is " @@ -331,10 +330,10 @@ msgid "" msgstr "" msgid "6" -msgstr "" +msgstr "6" msgid "``abc``" -msgstr "" +msgstr "``abc``" msgid "Back up again, so that ``[bcd]*`` is only matching ``bc``." msgstr "" @@ -383,6 +382,11 @@ msgid "" "while omitting *n* results in an upper bound of infinity." msgstr "" +msgid "" +"The simplest case ``{m}`` matches the preceding item exactly *m* times. For " +"example, ``a/{2}b`` will only match ``'a//b'``." +msgstr "" + msgid "" "Readers of a reductionist bent may notice that the three other quantifiers " "can all be expressed using this notation. ``{0,}`` is the same as ``*``, " @@ -459,19 +463,19 @@ msgid "Stage" msgstr "" msgid "``\\section``" -msgstr "" +msgstr "``\\section``" msgid "Text string to be matched" msgstr "" msgid "``\\\\section``" -msgstr "" +msgstr "``\\\\section``" msgid "Escaped backslash for :func:`re.compile`" msgstr "" msgid "``\"\\\\\\\\section\"``" -msgstr "" +msgstr "``\"\\\\\\\\section\"``" msgid "Escaped backslashes for a string literal" msgstr "" @@ -508,19 +512,19 @@ msgid "Raw string" msgstr "" msgid "``\"ab*\"``" -msgstr "" +msgstr "``\"ab*\"``" msgid "``r\"ab*\"``" -msgstr "" +msgstr "``r\"ab*\"``" msgid "``r\"\\\\section\"``" -msgstr "" +msgstr "``r\"\\\\section\"``" msgid "``\"\\\\w+\\\\s+\\\\1\"``" -msgstr "" +msgstr "``\"\\\\w+\\\\s+\\\\1\"``" msgid "``r\"\\w+\\s+\\1\"``" -msgstr "" +msgstr "``r\"\\w+\\s+\\1\"``" msgid "Performing Matches" msgstr "" @@ -533,31 +537,31 @@ msgid "" msgstr "" msgid "Method/Attribute" -msgstr "" +msgstr "Metoda/atrybut" msgid "Purpose" msgstr "" msgid "``match()``" -msgstr "" +msgstr "``match()``" msgid "Determine if the RE matches at the beginning of the string." msgstr "" msgid "``search()``" -msgstr "" +msgstr "``search()``" msgid "Scan through a string, looking for any location where this RE matches." msgstr "" msgid "``findall()``" -msgstr "" +msgstr "``findall()``" msgid "Find all substrings where the RE matches, and returns them as a list." msgstr "" msgid "``finditer()``" -msgstr "" +msgstr "``finditer()``" msgid "" "Find all substrings where the RE matches, and returns them as an :term:" @@ -606,25 +610,25 @@ msgid "" msgstr "" msgid "``group()``" -msgstr "" +msgstr "``group()``" msgid "Return the string matched by the RE" msgstr "" msgid "``start()``" -msgstr "" +msgstr "``start()``" msgid "Return the starting position of the match" msgstr "" msgid "``end()``" -msgstr "" +msgstr "``end()``" msgid "Return the ending position of the match" msgstr "" msgid "``span()``" -msgstr "" +msgstr "``span()``" msgid "Return a tuple containing the (start, end) positions of the match" msgstr "" @@ -721,7 +725,7 @@ msgid "Meaning" msgstr "Znaczenie" msgid ":const:`ASCII`, :const:`A`" -msgstr "" +msgstr ":const:`ASCII`, :const:`A`" msgid "" "Makes several escapes like ``\\w``, ``\\b``, ``\\s`` and ``\\d`` match only " @@ -729,28 +733,28 @@ msgid "" msgstr "" msgid ":const:`DOTALL`, :const:`S`" -msgstr "" +msgstr ":const:`DOTALL`, :const:`S`" msgid "Make ``.`` match any character, including newlines." msgstr "" msgid ":const:`IGNORECASE`, :const:`I`" -msgstr "" +msgstr ":const:`IGNORECASE`, :const:`I`" msgid "Do case-insensitive matches." msgstr "" msgid ":const:`LOCALE`, :const:`L`" -msgstr "" +msgstr ":const:`LOCALE`, :const:`L`" msgid "Do a locale-aware match." msgstr "" msgid ":const:`MULTILINE`, :const:`M`" -msgstr "" +msgstr ":const:`MULTILINE`, :const:`M`" msgid "Multi-line matching, affecting ``^`` and ``$``." -msgstr "" +msgstr "Multi-line matching, affecting ``^`` and ``$``." msgid ":const:`VERBOSE`, :const:`X` (for 'extended')" msgstr "" @@ -877,7 +881,7 @@ msgid "" msgstr "" msgid "``|``" -msgstr "" +msgstr "``|``" msgid "" "Alternation, or the \"or\" operator. If *A* and *B* are regular " @@ -894,7 +898,7 @@ msgid "" msgstr "" msgid "``^``" -msgstr "" +msgstr "``^``" msgid "" "Matches at the beginning of lines. Unless the :const:`MULTILINE` flag has " @@ -912,7 +916,7 @@ msgid "To match a literal ``'^'``, use ``\\^``." msgstr "" msgid "``$``" -msgstr "" +msgstr "``$``" msgid "" "Matches at the end of a line, which is defined as either the end of the " @@ -925,7 +929,7 @@ msgid "" msgstr "" msgid "``\\A``" -msgstr "" +msgstr "``\\A``" msgid "" "Matches only at the start of the string. When not in :const:`MULTILINE` " @@ -936,13 +940,13 @@ msgid "" msgstr "" msgid "``\\Z``" -msgstr "" +msgstr "``\\Z``" msgid "Matches only at the end of the string." msgstr "" msgid "``\\b``" -msgstr "" +msgstr "``\\b``" msgid "" "Word boundary. This is a zero-width assertion that matches only at the " @@ -973,7 +977,7 @@ msgid "" msgstr "" msgid "``\\B``" -msgstr "" +msgstr "``\\B``" msgid "" "Another zero-width assertion, this is the opposite of ``\\b``, only matching " @@ -1167,7 +1171,7 @@ msgid "" msgstr "" msgid "``(?=...)``" -msgstr "" +msgstr "``(?=...)``" msgid "" "Positive lookahead assertion. This succeeds if the contained regular " @@ -1197,7 +1201,7 @@ msgid "The pattern to match this is quite simple:" msgstr "" msgid "``.*[.].*$``" -msgstr "" +msgstr "``.*[.].*$``" msgid "" "Notice that the ``.`` needs to be treated specially because it's a " @@ -1220,7 +1224,7 @@ msgid "" msgstr "" msgid "``.*[.]([^b]..|.[^a].|..[^t])$``" -msgstr "" +msgstr "``.*[.]([^b]..|.[^a].|..[^t])$``" msgid "" "The expression gets messier when you try to patch up the first solution by " @@ -1233,7 +1237,7 @@ msgid "" msgstr "" msgid "``.*[.]([^b].?.?|.[^a]?.?|..?[^t]?)$``" -msgstr "" +msgstr "``.*[.]([^b].?.?|.[^a]?.?|..?[^t]?)$``" msgid "" "In the third attempt, the second and third letters are all made optional in " @@ -1267,7 +1271,7 @@ msgid "" msgstr "" msgid "``.*[.](?!bat$|exe$)[^.]*$``" -msgstr "" +msgstr "``.*[.](?!bat$|exe$)[^.]*$``" msgid "Modifying Strings" msgstr "" diff --git a/howto/sockets.po b/howto/sockets.po index 4c2f09c2f8..78ff931550 100644 --- a/howto/sockets.po +++ b/howto/sockets.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +69,7 @@ msgid "" msgstr "" msgid "History" -msgstr "" +msgstr "Historia" msgid "" "Of the various forms of :abbr:`IPC (Inter Process Communication)`, sockets " @@ -149,7 +148,7 @@ msgid "" msgstr "" msgid "IPC" -msgstr "" +msgstr "IPC" msgid "" "If you need fast IPC between two processes on one machine, you should look " diff --git a/howto/sorting.po b/howto/sorting.po index da01d75a54..d3ca676463 100644 --- a/howto/sorting.po +++ b/howto/sorting.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 -# Krzysztof Abramowicz, 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -246,7 +244,7 @@ msgid "" msgstr "" msgid "Odds and Ends" -msgstr "" +msgstr "Przypadki losowe" msgid "" "For locale aware sorting, use :func:`locale.strxfrm` for a key function or :" @@ -265,12 +263,12 @@ 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:" -"`__lt__` method:" +"`~object.__lt__` method:" msgstr "" msgid "" -"However, note that ``<`` can fall back to using :meth:`__gt__` if :meth:" -"`__lt__` is not implemented (see :func:`object.__lt__`)." +"However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :" +"meth:`~object.__lt__` is not implemented (see :func:`object.__lt__`)." msgstr "" msgid "" diff --git a/howto/unicode.po b/howto/unicode.po new file mode 100644 index 0000000000..839225b8f7 --- /dev/null +++ b/howto/unicode.po @@ -0,0 +1,756 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Unicode HOWTO" +msgstr "" + +msgid "Release" +msgstr "wydanie" + +msgid "1.12" +msgstr "1.12" + +msgid "" +"This HOWTO discusses Python's support for the Unicode specification for " +"representing textual data, and explains various problems that people " +"commonly encounter when trying to work with Unicode." +msgstr "" + +msgid "Introduction to Unicode" +msgstr "" + +msgid "Definitions" +msgstr "" + +msgid "" +"Today's programs need to be able to handle a wide variety of characters. " +"Applications are often internationalized to display messages and output in a " +"variety of user-selectable languages; the same program might need to output " +"an error message in English, French, Japanese, Hebrew, or Russian. Web " +"content can be written in any of these languages and can also include a " +"variety of emoji symbols. Python's string type uses the Unicode Standard for " +"representing characters, which lets Python programs work with all these " +"different possible characters." +msgstr "" + +msgid "" +"Unicode (https://www.unicode.org/) is a specification that aims to list " +"every character used by human languages and give each character its own " +"unique code. The Unicode specifications are continually revised and updated " +"to add new languages and symbols." +msgstr "" + +msgid "" +"A **character** is the smallest possible component of a text. 'A', 'B', " +"'C', etc., are all different characters. So are 'È' and 'Í'. Characters " +"vary depending on the language or context you're talking about. For " +"example, there's a character for \"Roman Numeral One\", 'Ⅰ', that's separate " +"from the uppercase letter 'I'. They'll usually look the same, but these are " +"two different characters that have different meanings." +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)." +msgstr "" + +msgid "" +"The Unicode standard contains a lot of tables listing characters and their " +"corresponding code points:" +msgstr "" + +msgid "" +"Strictly, these definitions imply that it's meaningless to say 'this is " +"character ``U+265E``'. ``U+265E`` is a code point, which represents some " +"particular character; in this case, it represents the character 'BLACK CHESS " +"KNIGHT', '♞'. In informal contexts, this distinction between code points " +"and characters will sometimes be forgotten." +msgstr "" + +msgid "" +"A character is represented on a screen or on paper by a set of graphical " +"elements that's called a **glyph**. The glyph for an uppercase A, for " +"example, is two diagonal strokes and a horizontal stroke, though the exact " +"details will depend on the font being used. Most Python code doesn't need " +"to worry about glyphs; figuring out the correct glyph to display is " +"generally the job of a GUI toolkit or a terminal's font renderer." +msgstr "" + +msgid "Encodings" +msgstr "" + +msgid "" +"To summarize the previous section: a Unicode string is a sequence of code " +"points, which are numbers from 0 through ``0x10FFFF`` (1,114,111 decimal). " +"This sequence of code points needs to be represented in memory as a set of " +"**code units**, and **code units** are then mapped to 8-bit bytes. The " +"rules for translating a Unicode string into a sequence of bytes are called a " +"**character encoding**, or just an **encoding**." +msgstr "" + +msgid "" +"The first encoding you might think of is using 32-bit integers as the code " +"unit, and then using the CPU's representation of 32-bit integers. In this " +"representation, the string \"Python\" might look like this:" +msgstr "" + +msgid "" +"This representation is straightforward but using it presents a number of " +"problems." +msgstr "" + +msgid "It's not portable; different processors order the bytes differently." +msgstr "" + +msgid "" +"It's very wasteful of space. In most texts, the majority of the code points " +"are less than 127, or less than 255, so a lot of space is occupied by " +"``0x00`` bytes. The above string takes 24 bytes compared to the 6 bytes " +"needed for an ASCII representation. Increased RAM usage doesn't matter too " +"much (desktop computers have gigabytes of RAM, and strings aren't usually " +"that large), but expanding our usage of disk and network bandwidth by a " +"factor of 4 is intolerable." +msgstr "" + +msgid "" +"It's not compatible with existing C functions such as ``strlen()``, so a new " +"family of wide string functions would need to be used." +msgstr "" + +msgid "" +"Therefore this encoding isn't used very much, and people instead choose " +"other encodings that are more efficient and convenient, such as UTF-8." +msgstr "" + +msgid "" +"UTF-8 is one of the most commonly used encodings, and Python often defaults " +"to using it. UTF stands for \"Unicode Transformation Format\", and the '8' " +"means that 8-bit values are used in the encoding. (There are also UTF-16 " +"and UTF-32 encodings, but they are less frequently used than UTF-8.) UTF-8 " +"uses the following rules:" +msgstr "" + +msgid "" +"If the code point is < 128, it's represented by the corresponding byte value." +msgstr "" + +msgid "" +"If the code point is >= 128, it's turned into a sequence of two, three, or " +"four bytes, where each byte of the sequence is between 128 and 255." +msgstr "" + +msgid "UTF-8 has several convenient properties:" +msgstr "" + +msgid "It can handle any Unicode code point." +msgstr "" + +msgid "" +"A Unicode string is turned into a sequence of bytes that contains embedded " +"zero bytes only where they represent the null character (U+0000). This means " +"that UTF-8 strings can be processed by C functions such as ``strcpy()`` and " +"sent through protocols that can't handle zero bytes for anything other than " +"end-of-string markers." +msgstr "" + +msgid "A string of ASCII text is also valid UTF-8 text." +msgstr "" + +msgid "" +"UTF-8 is fairly compact; the majority of commonly used characters can be " +"represented with one or two bytes." +msgstr "" + +msgid "" +"If bytes are corrupted or lost, it's possible to determine the start of the " +"next UTF-8-encoded code point and resynchronize. It's also unlikely that " +"random 8-bit data will look like valid UTF-8." +msgstr "" + +msgid "" +"UTF-8 is a byte oriented encoding. The encoding specifies that each " +"character is represented by a specific sequence of one or more bytes. This " +"avoids the byte-ordering issues that can occur with integer and word " +"oriented encodings, like UTF-16 and UTF-32, where the sequence of bytes " +"varies depending on the hardware on which the string was encoded." +msgstr "" + +msgid "References" +msgstr "" + +msgid "" +"The `Unicode Consortium site `_ has character " +"charts, a glossary, and PDF versions of the Unicode specification. Be " +"prepared for some difficult reading. `A chronology `_ of the origin and development of Unicode is also available on " +"the site." +msgstr "" + +msgid "" +"On the Computerphile Youtube channel, Tom Scott briefly `discusses the " +"history of Unicode and UTF-8 `_ " +"(9 minutes 36 seconds)." +msgstr "" + +msgid "" +"To help understand the standard, Jukka Korpela has written `an introductory " +"guide `_ to reading the Unicode " +"character tables." +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." +msgstr "" + +msgid "" +"Wikipedia entries are often helpful; see the entries for \"`character " +"encoding `_\" and `UTF-8 " +"`_, for example." +msgstr "" + +msgid "Python's Unicode Support" +msgstr "" + +msgid "" +"Now that you've learned the rudiments of Unicode, we can look at Python's " +"Unicode features." +msgstr "" + +msgid "The String Type" +msgstr "" + +msgid "" +"Since Python 3.0, the language's :class:`str` type contains Unicode " +"characters, meaning any string created using ``\"unicode rocks!\"``, " +"``'unicode rocks!'``, or the triple-quoted string syntax is stored as " +"Unicode." +msgstr "" + +msgid "" +"The default encoding for Python source code is UTF-8, so you can simply " +"include a Unicode character in a string literal::" +msgstr "" + +msgid "" +"Side note: Python 3 also supports using Unicode characters in identifiers::" +msgstr "" + +msgid "" +"If you can't enter a particular character in your editor or want to keep the " +"source code ASCII-only for some reason, you can also use escape sequences in " +"string literals. (Depending on your system, you may see the actual capital-" +"delta glyph instead of a \\u escape.) ::" +msgstr "" + +msgid "" +"In addition, one can create a string using the :func:`~bytes.decode` method " +"of :class:`bytes`. This method takes an *encoding* argument, such as " +"``UTF-8``, and optionally an *errors* argument." +msgstr "" + +msgid "" +"The *errors* argument specifies the response when the input string can't be " +"converted according to the encoding's rules. Legal values for this argument " +"are ``'strict'`` (raise a :exc:`UnicodeDecodeError` exception), " +"``'replace'`` (use ``U+FFFD``, ``REPLACEMENT CHARACTER``), ``'ignore'`` " +"(just leave the character out of the Unicode result), or " +"``'backslashreplace'`` (inserts a ``\\xNN`` escape sequence). The following " +"examples show the differences::" +msgstr "" + +msgid "" +"Encodings are specified as strings containing the encoding's name. Python " +"comes with roughly 100 different encodings; see the Python Library Reference " +"at :ref:`standard-encodings` for a list. Some encodings have multiple " +"names; for example, ``'latin-1'``, ``'iso_8859_1'`` and ``'8859``' are all " +"synonyms for the same encoding." +msgstr "" + +msgid "" +"One-character Unicode strings can also be created with the :func:`chr` built-" +"in function, which takes integers and returns a Unicode string of length 1 " +"that contains the corresponding code point. The reverse operation is the " +"built-in :func:`ord` function that takes a one-character Unicode string and " +"returns the code point value::" +msgstr "" + +msgid "Converting to Bytes" +msgstr "" + +msgid "" +"The opposite method of :meth:`bytes.decode` is :meth:`str.encode`, which " +"returns a :class:`bytes` representation of the Unicode string, encoded in " +"the requested *encoding*." +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 " +"``'xmlcharrefreplace'`` (inserts an XML character reference), " +"``backslashreplace`` (inserts a ``\\uNNNN`` escape sequence) and " +"``namereplace`` (inserts a ``\\N{...}`` escape sequence)." +msgstr "" + +msgid "The following example shows the different results::" +msgstr "" + +msgid "" +"The low-level routines for registering and accessing the available encodings " +"are found in the :mod:`codecs` module. Implementing new encodings also " +"requires understanding the :mod:`codecs` module. However, the encoding and " +"decoding functions returned by this module are usually more low-level than " +"is comfortable, and writing new encodings is a specialized task, so the " +"module won't be covered in this HOWTO." +msgstr "" + +msgid "Unicode Literals in Python Source Code" +msgstr "" + +msgid "" +"In Python source code, specific Unicode code points can be written using the " +"``\\u`` escape sequence, which is followed by four hex digits giving the " +"code point. The ``\\U`` escape sequence is similar, but expects eight hex " +"digits, not four::" +msgstr "" + +msgid "" +"Using escape sequences for code points greater than 127 is fine in small " +"doses, but becomes an annoyance if you're using many accented characters, as " +"you would in a program with messages in French or some other accent-using " +"language. You can also assemble strings using the :func:`chr` built-in " +"function, but this is even more tedious." +msgstr "" + +msgid "" +"Ideally, you'd want to be able to write literals in your language's natural " +"encoding. You could then edit Python source code with your favorite editor " +"which would display the accented characters naturally, and have the right " +"characters used at runtime." +msgstr "" + +msgid "" +"Python supports writing source code in UTF-8 by default, but you can use " +"almost any encoding if you declare the encoding being used. This is done by " +"including a special comment as either the first or second line of the source " +"file::" +msgstr "" + +msgid "" +"The syntax is inspired by Emacs's notation for specifying variables local to " +"a file. Emacs supports many different variables, but Python only supports " +"'coding'. The ``-*-`` symbols indicate to Emacs that the comment is " +"special; they have no significance to Python but are a convention. Python " +"looks for ``coding: name`` or ``coding=name`` in the comment." +msgstr "" + +msgid "" +"If you don't include such a comment, the default encoding used will be UTF-8 " +"as already mentioned. See also :pep:`263` for more information." +msgstr "" + +msgid "Unicode Properties" +msgstr "" + +msgid "" +"The Unicode specification includes a database of information about code " +"points. For each defined code point, the information includes the " +"character's name, its category, the numeric value if applicable (for " +"characters representing numeric concepts such as the Roman numerals, " +"fractions such as one-third and four-fifths, etc.). There are also display-" +"related properties, such as how to use the code point in bidirectional text." +msgstr "" + +msgid "" +"The following program displays some information about several characters, " +"and prints the numeric value of one particular character::" +msgstr "" + +msgid "When run, this prints:" +msgstr "" + +msgid "" +"The category codes are abbreviations describing the nature of the character. " +"These are grouped into categories such as \"Letter\", \"Number\", " +"\"Punctuation\", or \"Symbol\", which in turn are broken up into " +"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." +msgstr "" + +msgid "Comparing Strings" +msgstr "" + +msgid "" +"Unicode adds some complication to comparing strings, because the same set of " +"characters can be represented by different sequences of code points. For " +"example, a letter like 'ê' can be represented as a single code point U+00EA, " +"or as U+0065 U+0302, which is the code point for 'e' followed by a code " +"point for 'COMBINING CIRCUMFLEX ACCENT'. These will produce the same output " +"when printed, but one is a string of length 1 and the other is of length 2." +msgstr "" + +msgid "" +"One tool for a case-insensitive comparison is the :meth:`~str.casefold` " +"string method that converts a string to a case-insensitive form following an " +"algorithm described by the Unicode Standard. This algorithm has special " +"handling for characters such as the German letter 'ß' (code point U+00DF), " +"which becomes the pair of lowercase letters 'ss'." +msgstr "" + +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:" +msgstr "" + +msgid "When run, this outputs:" +msgstr "" + +msgid "" +"The first argument to the :func:`~unicodedata.normalize` function is a " +"string giving the desired normalization form, which can be one of 'NFC', " +"'NFKC', 'NFD', and 'NFKD'." +msgstr "" + +msgid "The Unicode Standard also specifies how to do caseless comparisons::" +msgstr "" + +msgid "" +"This will print ``True``. (Why is :func:`!NFD` invoked twice? Because " +"there are a few characters that make :meth:`~str.casefold` return a non-" +"normalized string, so the result needs to be normalized again. See section " +"3.13 of the Unicode Standard for a discussion and an example.)" +msgstr "" + +msgid "Unicode Regular Expressions" +msgstr "" + +msgid "" +"The regular expressions supported by the :mod:`re` module can be provided " +"either as bytes or strings. Some of the special character sequences such as " +"``\\d`` and ``\\w`` have different meanings depending on whether the pattern " +"is supplied as bytes or a string. For example, ``\\d`` will match the " +"characters ``[0-9]`` in bytes but in strings will match any character that's " +"in the ``'Nd'`` category." +msgstr "" + +msgid "" +"The string in this example has the number 57 written in both Thai and Arabic " +"numerals::" +msgstr "" + +msgid "" +"When executed, ``\\d+`` will match the Thai numerals and print them out. If " +"you supply the :const:`re.ASCII` flag to :func:`~re.compile`, ``\\d+`` will " +"match the substring \"57\" instead." +msgstr "" + +msgid "" +"Similarly, ``\\w`` matches a wide variety of Unicode characters but only " +"``[a-zA-Z0-9_]`` in bytes or if :const:`re.ASCII` is supplied, and ``\\s`` " +"will match either Unicode whitespace characters or ``[ \\t\\n\\r\\f\\v]``." +msgstr "" + +msgid "Some good alternative discussions of Python's Unicode support are:" +msgstr "" + +msgid "" +"`Processing Text Files in Python 3 `_, by Nick Coghlan." +msgstr "" + +msgid "" +"`Pragmatic Unicode `_, a PyCon " +"2012 presentation by Ned Batchelder." +msgstr "" + +msgid "" +"The :class:`str` type is described in the Python library reference at :ref:" +"`textseq`." +msgstr "" + +msgid "The documentation for the :mod:`unicodedata` module." +msgstr "" + +msgid "The documentation for the :mod:`codecs` module." +msgstr "" + +msgid "" +"Marc-André Lemburg gave `a presentation titled \"Python and Unicode\" (PDF " +"slides) `_ at " +"EuroPython 2002. The slides are an excellent overview of the design of " +"Python 2's Unicode features (where the Unicode string type is called " +"``unicode`` and literals start with ``u``)." +msgstr "" + +msgid "Reading and Writing Unicode Data" +msgstr "" + +msgid "" +"Once you've written some code that works with Unicode data, the next problem " +"is input/output. How do you get Unicode strings into your program, and how " +"do you convert Unicode into a form suitable for storage or transmission?" +msgstr "" + +msgid "" +"It's possible that you may not need to do anything depending on your input " +"sources and output destinations; you should check whether the libraries used " +"in your application support Unicode natively. XML parsers often return " +"Unicode data, for example. Many relational databases also support Unicode-" +"valued columns and can return Unicode values from an SQL query." +msgstr "" + +msgid "" +"Unicode data is usually converted to a particular encoding before it gets " +"written to disk or sent over a socket. It's possible to do all the work " +"yourself: open a file, read an 8-bit bytes object from it, and convert the " +"bytes with ``bytes.decode(encoding)``. However, the manual approach is not " +"recommended." +msgstr "" + +msgid "" +"One problem is the multi-byte nature of encodings; one Unicode character can " +"be represented by several bytes. If you want to read the file in arbitrary-" +"sized chunks (say, 1024 or 4096 bytes), you need to write error-handling " +"code to catch the case where only part of the bytes encoding a single " +"Unicode character are read at the end of a chunk. One solution would be to " +"read the entire file into memory and then perform the decoding, but that " +"prevents you from working with files that are extremely large; if you need " +"to read a 2 GiB file, you need 2 GiB of RAM. (More, really, since for at " +"least a moment you'd need to have both the encoded string and its Unicode " +"version in memory.)" +msgstr "" + +msgid "" +"The solution would be to use the low-level decoding interface to catch the " +"case of partial coding sequences. The work of implementing this has already " +"been done for you: the built-in :func:`open` function can return a file-like " +"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`." +msgstr "" + +msgid "Reading Unicode from a file is therefore simple::" +msgstr "" + +msgid "" +"It's also possible to open files in update mode, allowing both reading and " +"writing::" +msgstr "" + +msgid "" +"The Unicode character ``U+FEFF`` is used as a byte-order mark (BOM), and is " +"often written as the first character of a file in order to assist with " +"autodetection of the file's byte ordering. Some encodings, such as UTF-16, " +"expect a BOM to be present at the start of a file; when such an encoding is " +"used, the BOM will be automatically written as the first character and will " +"be silently dropped when the file is read. There are variants of these " +"encodings, such as 'utf-16-le' and 'utf-16-be' for little-endian and big-" +"endian encodings, that specify one particular byte ordering and don't skip " +"the BOM." +msgstr "" + +msgid "" +"In some areas, it is also convention to use a \"BOM\" at the start of UTF-8 " +"encoded files; the name is misleading since UTF-8 is not byte-order " +"dependent. The mark simply announces that the file is encoded in UTF-8. For " +"reading such files, use the 'utf-8-sig' codec to automatically skip the mark " +"if present." +msgstr "" + +msgid "Unicode filenames" +msgstr "" + +msgid "" +"Most of the operating systems in common use today support filenames that " +"contain arbitrary Unicode characters. Usually this is implemented by " +"converting the Unicode string into some encoding that varies depending on " +"the system. Today Python is converging on using UTF-8: Python on MacOS has " +"used UTF-8 for several versions, and Python 3.6 switched to using UTF-8 on " +"Windows as well. On Unix systems, there will only be a :term:`filesystem " +"encoding `. if you've set the " +"``LANG`` or ``LC_CTYPE`` environment variables; if you haven't, the default " +"encoding is again UTF-8." +msgstr "" + +msgid "" +"The :func:`sys.getfilesystemencoding` function returns the encoding to use " +"on your current system, in case you want to do the encoding manually, but " +"there's not much reason to bother. When opening a file for reading or " +"writing, you can usually just provide the Unicode string as the filename, " +"and it will be automatically converted to the right encoding for you::" +msgstr "" + +msgid "" +"Functions in the :mod:`os` module such as :func:`os.stat` will also accept " +"Unicode filenames." +msgstr "" + +msgid "" +"The :func:`os.listdir` function returns filenames, which raises an issue: " +"should it return the Unicode version of filenames, or should it return bytes " +"containing the encoded versions? :func:`os.listdir` can do both, depending " +"on whether you provided the directory path as bytes or a Unicode string. If " +"you pass a Unicode string as the path, filenames will be decoded using the " +"filesystem's encoding and a list of Unicode strings will be returned, while " +"passing a byte path will return the filenames as bytes. For example, " +"assuming the default :term:`filesystem encoding ` is UTF-8, running the following program::" +msgstr "" + +msgid "will produce the following output:" +msgstr "" + +msgid "" +"The first list contains UTF-8-encoded filenames, and the second list " +"contains the Unicode versions." +msgstr "" + +msgid "" +"Note that on most occasions, you should can just stick with using Unicode " +"with these APIs. The bytes APIs should only be used on systems where " +"undecodable file names can be present; that's pretty much only Unix systems " +"now." +msgstr "" + +msgid "Tips for Writing Unicode-aware Programs" +msgstr "" + +msgid "" +"This section provides some suggestions on writing software that deals with " +"Unicode." +msgstr "" + +msgid "The most important tip is:" +msgstr "" + +msgid "" +"Software should only work with Unicode strings internally, decoding the " +"input data as soon as possible and encoding the output only at the end." +msgstr "" + +msgid "" +"If you attempt to write processing functions that accept both Unicode and " +"byte strings, you will find your program vulnerable to bugs wherever you " +"combine the two different kinds of strings. There is no automatic encoding " +"or decoding: if you do e.g. ``str + bytes``, a :exc:`TypeError` will be " +"raised." +msgstr "" + +msgid "" +"When using data coming from a web browser or some other untrusted source, a " +"common technique is to check for illegal characters in a string before using " +"the string in a generated command line or storing it in a database. If " +"you're doing this, be careful to check the decoded string, not the encoded " +"bytes data; some encodings may have interesting properties, such as not " +"being bijective or not being fully ASCII-compatible. This is especially " +"true if the input data also specifies the encoding, since the attacker can " +"then choose a clever way to hide malicious text in the encoded bytestream." +msgstr "" + +msgid "Converting Between File Encodings" +msgstr "" + +msgid "" +"The :class:`~codecs.StreamRecoder` class can transparently convert between " +"encodings, taking a stream that returns data in encoding #1 and behaving " +"like a stream returning data in encoding #2." +msgstr "" + +msgid "" +"For example, if you have an input file *f* that's in Latin-1, you can wrap " +"it with a :class:`~codecs.StreamRecoder` to return bytes encoded in UTF-8::" +msgstr "" + +msgid "Files in an Unknown Encoding" +msgstr "" + +msgid "" +"What can you do if you need to make a change to a file, but don't know the " +"file's encoding? If you know the encoding is ASCII-compatible and only want " +"to examine or modify the ASCII parts, you can open the file with the " +"``surrogateescape`` error handler::" +msgstr "" + +msgid "" +"The ``surrogateescape`` error handler will decode any non-ASCII bytes as " +"code points in a special range running from U+DC80 to U+DCFF. These code " +"points will then turn back into the same bytes when the ``surrogateescape`` " +"error handler is used to encode the data and write it back out." +msgstr "" + +msgid "" +"One section of `Mastering Python 3 Input/Output `_, a PyCon 2010 talk by David " +"Beazley, discusses text processing and binary data handling." +msgstr "" + +msgid "" +"The `PDF slides for Marc-André Lemburg's presentation \"Writing Unicode-" +"aware Applications in Python\" `_ discuss questions of " +"character encodings as well as how to internationalize and localize an " +"application. These slides cover Python 2.x only." +msgstr "" + +msgid "" +"`The Guts of Unicode in Python `_ is a PyCon 2013 talk by Benjamin Peterson that " +"discusses the internal Unicode representation in Python 3.3." +msgstr "" + +msgid "Acknowledgements" +msgstr "" + +msgid "" +"The initial draft of this document was written by Andrew Kuchling. It has " +"since been revised further by Alexander Belopolsky, Georg Brandl, Andrew " +"Kuchling, and Ezio Melotti." +msgstr "" + +msgid "" +"Thanks to the following people who have noted errors or offered suggestions " +"on this article: Éric Araujo, Nicholas Bastin, Nick Coghlan, Marius " +"Gedminas, Kent Johnson, Ken Krugler, Marc-André Lemburg, Martin von Löwis, " +"Terry J. Reedy, Serhiy Storchaka, Eryk Sun, Chad Whitacre, Graham Wideman." +msgstr "" diff --git a/howto/urllib2.po b/howto/urllib2.po index 5bf73ec9ad..6bad151b53 100644 --- a/howto/urllib2.po +++ b/howto/urllib2.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:11+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,13 +32,6 @@ msgstr "Autor" msgid "`Michael Foord `_" msgstr "" -msgid "" -"There is a French translation of an earlier revision of this HOWTO, " -"available at `urllib2 - Le Manuel manquant `_." -msgstr "" - msgid "Introduction" msgstr "Wprowadzenie" @@ -128,7 +119,7 @@ msgid "" msgstr "" msgid "Data" -msgstr "" +msgstr "Dane" msgid "" "Sometimes you want to send data to a URL (often the URL will refer to a CGI " @@ -198,21 +189,21 @@ msgid "Handling Exceptions" msgstr "Obsługa wyjątków" msgid "" -"*urlopen* raises :exc:`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)." +"*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)." msgstr "" msgid "" -":exc:`HTTPError` is the subclass of :exc:`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." msgstr "" msgid "URLError" -msgstr "" +msgstr "URLError" msgid "" "Often, URLError is raised because there is no network connection (no route " @@ -225,7 +216,7 @@ msgid "e.g. ::" msgstr "" msgid "HTTPError" -msgstr "" +msgstr "HTTPError" msgid "" "Every HTTP response from the server contains a numeric \"status code\". " @@ -233,9 +224,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:`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 "" @@ -243,8 +234,8 @@ msgid "" msgstr "" msgid "" -"The :exc:`HTTPError` instance raised will have an integer 'code' attribute, " -"which corresponds to the error sent by the server." +"The :exc:`~urllib.error.HTTPError` instance raised will have an integer " +"'code' attribute, which corresponds to the error sent by the server." msgstr "" msgid "Error Codes" @@ -264,18 +255,19 @@ msgstr "" msgid "" "When an error is raised the server responds by returning an HTTP error code " -"*and* an error page. You can use the :exc:`HTTPError` instance as a response " -"on the page returned. This means that as well as the code attribute, it also " -"has read, geturl, and info, methods as returned by the ``urllib.response`` " -"module::" +"*and* an error page. You can use the :exc:`~urllib.error.HTTPError` instance " +"as a response on the page returned. This means that as well as the code " +"attribute, it also has read, geturl, and info, methods as returned by the " +"``urllib.response`` module::" msgstr "" msgid "Wrapping it Up" msgstr "" msgid "" -"So if you want to be prepared for :exc:`HTTPError` *or* :exc:`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" @@ -283,7 +275,7 @@ msgstr "" msgid "" "The ``except HTTPError`` *must* come first, otherwise ``except URLError`` " -"will *also* catch an :exc:`HTTPError`." +"will *also* catch an :exc:`~urllib.error.HTTPError`." msgstr "" msgid "Number 2" @@ -293,9 +285,9 @@ msgid "info and geturl" msgstr "" msgid "" -"The response returned by urlopen (or the :exc:`HTTPError` instance) has two " -"useful methods :meth:`info` and :meth:`geturl` and is defined in the module :" -"mod:`urllib.response`.." +"The response returned by urlopen (or the :exc:`~urllib.error.HTTPError` " +"instance) has two useful methods :meth:`!info` and :meth:`!geturl` and is " +"defined in the module :mod:`urllib.response`." msgstr "" msgid "" @@ -414,7 +406,7 @@ msgstr "" msgid "" "In the above example we only supplied our ``HTTPBasicAuthHandler`` to " "``build_opener``. By default openers have the handlers for normal situations " -"-- ``ProxyHandler`` (if a proxy setting such as an :envvar:`http_proxy` " +"-- ``ProxyHandler`` (if a proxy setting such as an :envvar:`!http_proxy` " "environment variable is set), ``UnknownHandler``, ``HTTPHandler``, " "``HTTPDefaultErrorHandler``, ``HTTPRedirectHandler``, ``FTPHandler``, " "``FileHandler``, ``DataHandler``, ``HTTPErrorProcessor``." diff --git a/install/index.po b/install/index.po index 48298656fb..28dbd80f80 100644 --- a/install/index.po +++ b/install/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +40,7 @@ msgid "" msgstr "" msgid ":ref:`installing-index`" -msgstr "" +msgstr ":ref:`installing-index`" msgid "" "The up to date module installation documentation. For regular Python usage, " @@ -246,7 +245,7 @@ msgid "" msgstr "" msgid "Platform" -msgstr "" +msgstr "Platforma" msgid "Standard installation location" msgstr "" @@ -276,7 +275,7 @@ msgid ":file:`{exec-prefix}/lib/python{X.Y}/site-packages`" msgstr "" msgid "Windows" -msgstr "" +msgstr "Windows" msgid ":file:`{prefix}\\\\Lib\\\\site-packages`" msgstr "" @@ -376,9 +375,9 @@ msgid "" msgstr "" msgid "" -"Files will be installed into subdirectories of :data:`site.USER_BASE` " +"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 :data:" +"modules and extension modules in the same location (also known as :const:" "`site.USER_SITE`). Here are the values for UNIX, including macOS:" msgstr "" @@ -462,8 +461,8 @@ msgstr "" msgid "" "To make Python find the distributions installed with this scheme, you may " -"have to :ref:`modify Python's search path ` or edit :mod:" -"`sitecustomize` (see :mod:`site`) to call :func:`site.addsitedir` or edit :" +"have to :ref:`modify Python's search path ` or edit :mod:`!" +"sitecustomize` (see :mod:`site`) to call :func:`site.addsitedir` or edit :" "data:`sys.path`." msgstr "" @@ -802,7 +801,7 @@ msgid "" msgstr "" msgid "" -"However, if you reinstall the same major version of Python (perhaps when " +"However, if you reinstall the same minor version of Python (perhaps when " "upgrading from 2.2 to 2.2.2, for example) :file:`site.py` will be " "overwritten by the stock version. You'd have to remember that it was " "modified and save a copy before doing the installation." @@ -907,9 +906,9 @@ msgstr "" msgid "" "On Unix, if the :envvar:`HOME` environment variable is not defined, the " -"user's home directory will be determined with the :func:`getpwuid` function " -"from the standard :mod:`pwd` module. This is done by the :func:`os.path." -"expanduser` function used by Distutils." +"user's home directory will be determined with the :func:`~pwd.getpwuid` " +"function from the standard :mod:`pwd` module. This is done by the :func:`os." +"path.expanduser` function used by Distutils." msgstr "" msgid "" diff --git a/installing/index.po b/installing/index.po index 674282118e..49f246c9ca 100644 --- a/installing/index.po +++ b/installing/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Krzysztof Wierzbicki , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Krzysztof Wierzbicki , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +55,12 @@ msgstr "" msgid "" "This guide covers the installation part of the process. For a guide to " -"creating and sharing your own Python projects, refer to the :ref:" -"`distribution guide `." +"creating and sharing your own Python projects, refer to the `Python " +"packaging user guide`_." msgstr "" -"Ta część przewodnika dotyczy procesu instalacji. O tworzeniu i dzieleniu się " -"własnymi projektami w Pythonie przeczytasz więcej w :ref:`Przewodniku " -"dystrybucji `." +"Ta część przewodnika dotyczy procesu instalacji. Przewodnik po tworzeniu i " +"udostępnianiu własnych projektów Python znajduje się w `Python packaging " +"user guide`_." msgid "" "For corporate and other institutional users, be aware that many " @@ -116,6 +115,9 @@ msgid "" "The `Python Package Index `__ is a public repository of " "open source licensed packages made available for use by other Python users." msgstr "" +"`Python Package Index `__ 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 " @@ -134,15 +136,26 @@ msgid "" "library, but its name lives on in other ways (such as the name of the " "mailing list used to coordinate Python packaging standards development)." msgstr "" +"``distutils`` to oryginalny system kompilacji i dystrybucji po raz pierwszy " +"dodany do biblioteki standardowej Pythona w 1998 roku. Podczas gdy " +"bezpośrednie korzystanie z ``distutils`` jest stopniowo wycofywane, nadal " +"stanowi podstawę dla obecnej infrastruktury pakowania i dystrybucji, i nie " +"tylko pozostaje częścią biblioteki standardowej, ale jego nazwa żyje na inne " +"sposoby (takie jak nazwa listy mailingowej używanej do koordynowania rozwoju " +"standardów pakowania Python)." msgid "" "The use of ``venv`` is now recommended for creating virtual environments." msgstr "" +"Korzystanie z ``venv`` jest obecnie zalecane do tworzenia środowisk " +"wirtualnych." msgid "" "`Python Packaging User Guide: Creating and using virtual environments " "`__" msgstr "" +"`Python Packaging User Guide: Creating and using virtual environments " +"`__" msgid "Basic usage" msgstr "" @@ -198,13 +211,14 @@ msgid "" msgstr "" msgid "How do I ...?" -msgstr "" +msgstr "Jak ...?" msgid "These are quick answers or links for some common tasks." -msgstr "" +msgstr "Są to szybkie odpowiedzi lub linki do niektórych typowych zadań." msgid "... install ``pip`` in versions of Python prior to Python 3.4?" msgstr "" +"... zainstalować ``pip`` w wersjach Python wcześniejszych niż Python 3.4?" msgid "" "Python only started bundling ``pip`` with Python 3.4. For earlier versions, " @@ -218,7 +232,7 @@ msgid "" msgstr "" msgid "... install packages just for the current user?" -msgstr "" +msgstr "... zainstalować pakiety tylko dla bieżącego użytkownika?" msgid "" "Passing the ``--user`` option to ``python -m pip install`` will install a " diff --git a/language-switcher-progress.svg b/language-switcher-progress.svg deleted file mode 100644 index bbbd0c9ae3..0000000000 --- a/language-switcher-progress.svg +++ /dev/null @@ -1,1637 +0,0 @@ - - - - - - - - 2023-04-25T07:56:06.960439 - image/svg+xml - - - Matplotlib v3.7.1, https://matplotlib.org/ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/library/__future__.po b/library/__future__.po index 0d3a0a11fe..e94268ccc7 100644 --- a/library/__future__.po +++ b/library/__future__.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,21 +27,28 @@ msgid ":mod:`__future__` --- Future statement definitions" msgstr "" msgid "**Source code:** :source:`Lib/__future__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/__future__.py`" -msgid ":mod:`__future__` is a real module, and serves three purposes:" +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." msgstr "" msgid "" -"To avoid confusing existing tools that analyze import statements and expect " -"to find the modules they're importing." +"While these future statements are given additional special meaning by the " +"Python compiler, they are still executed like any other import statement and " +"the :mod:`__future__` exists and is handled by the import system the same " +"way any other Python module would be. This design serves three purposes:" msgstr "" msgid "" -"To ensure that :ref:`future statements ` run under releases prior to " -"2.1 at least yield runtime exceptions (the import of :mod:`__future__` will " -"fail, because there was no module of that name prior to 2.1)." +"To avoid confusing existing tools that analyze import statements and expect " +"to find the modules they're importing." msgstr "" +"Aby uniknąć pomyłek z istniejącymi narzędziami, które analizują instrukcje " +"importowania i oczekują znalezienia modułów, które importują." msgid "" "To document when incompatible changes were introduced, and when they will be " @@ -50,47 +57,14 @@ msgid "" "examining its contents." msgstr "" -msgid "Each statement in :file:`__future__.py` is of the form::" -msgstr "" - msgid "" -"where, normally, *OptionalRelease* is less than *MandatoryRelease*, and both " -"are 5-tuples of the same form as :data:`sys.version_info`::" -msgstr "" - -msgid "" -"*OptionalRelease* records the first release in which the feature was " -"accepted." -msgstr "" - -msgid "" -"In the case of a *MandatoryRelease* that has not yet occurred, " -"*MandatoryRelease* predicts the release in which the feature will become " -"part of the language." -msgstr "" - -msgid "" -"Else *MandatoryRelease* records when the feature became part of the " -"language; in releases at or after that, modules no longer need a future " -"statement to use the feature in question, but may continue to use such " -"imports." -msgstr "" - -msgid "" -"*MandatoryRelease* may also be ``None``, meaning that a planned feature got " -"dropped." -msgstr "" - -msgid "" -"Instances of class :class:`_Feature` have two corresponding methods, :meth:" -"`getOptionalRelease` and :meth:`getMandatoryRelease`." +"To ensure that :ref:`future statements ` run under releases prior to " +"Python 2.1 at least yield runtime exceptions (the import of :mod:" +"`__future__` will fail, because there was no module of that name prior to " +"2.1)." 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:`compiler_flag` " -"attribute on :class:`_Feature` instances." +msgid "Module Contents" msgstr "" msgid "" @@ -100,110 +74,148 @@ msgid "" msgstr "" msgid "feature" -msgstr "" +msgstr "cecha" msgid "optional in" -msgstr "" +msgstr "opcjonalne w" msgid "mandatory in" -msgstr "" +msgstr "obowiązkowe w" msgid "effect" msgstr "" msgid "nested_scopes" -msgstr "" +msgstr "nested_scopes" msgid "2.1.0b1" -msgstr "" +msgstr "2.1.0b1" msgid "2.2" -msgstr "" +msgstr "2.2" msgid ":pep:`227`: *Statically Nested Scopes*" msgstr "" msgid "generators" -msgstr "" +msgstr "generatory" msgid "2.2.0a1" -msgstr "" +msgstr "2.2.0a1" msgid "2.3" -msgstr "" +msgstr "2.3" msgid ":pep:`255`: *Simple Generators*" msgstr "" msgid "division" -msgstr "" +msgstr "podział" msgid "2.2.0a2" -msgstr "" +msgstr "2.2.0a2" msgid "3.0" -msgstr "" +msgstr "3.0" msgid ":pep:`238`: *Changing the Division Operator*" -msgstr "" +msgstr ":pep:`238`: *Zmiana operatora podziału*" msgid "absolute_import" -msgstr "" +msgstr "absolute_import" msgid "2.5.0a1" -msgstr "" +msgstr "2.5.0a1" msgid ":pep:`328`: *Imports: Multi-Line and Absolute/Relative*" msgstr "" msgid "with_statement" -msgstr "" +msgstr "with_statement" msgid "2.6" -msgstr "" +msgstr "2.6" msgid ":pep:`343`: *The \"with\" Statement*" msgstr "" msgid "print_function" -msgstr "" +msgstr "print_function" msgid "2.6.0a2" -msgstr "" +msgstr "2.6.0a2" msgid ":pep:`3105`: *Make print a function*" msgstr "" msgid "unicode_literals" -msgstr "" +msgstr "unicode_literals" msgid ":pep:`3112`: *Bytes literals in Python 3000*" msgstr "" msgid "generator_stop" -msgstr "" +msgstr "generator_stop" msgid "3.5.0b1" -msgstr "" +msgstr "3.5.0b1" msgid "3.7" -msgstr "" +msgstr "3.7" msgid ":pep:`479`: *StopIteration handling inside generators*" msgstr "" msgid "annotations" -msgstr "anotacje" +msgstr "adnotacje typów" msgid "3.7.0b1" -msgstr "" +msgstr "3.7.0b1" msgid "TBD [1]_" -msgstr "" +msgstr "TBD [1]_" msgid ":pep:`563`: *Postponed evaluation of annotations*" msgstr "" +msgid "Each statement in :file:`__future__.py` is of the form::" +msgstr "" + +msgid "" +"where, normally, *OptionalRelease* is less than *MandatoryRelease*, and both " +"are 5-tuples of the same form as :data:`sys.version_info`::" +msgstr "" + +msgid "" +"*OptionalRelease* records the first release in which the feature was " +"accepted." +msgstr "" + +msgid "" +"In the case of a *MandatoryRelease* that has not yet occurred, " +"*MandatoryRelease* predicts the release in which the feature will become " +"part of the language." +msgstr "" + +msgid "" +"Else *MandatoryRelease* records when the feature became part of the " +"language; in releases at or after that, modules no longer need a future " +"statement to use the feature in question, but may continue to use such " +"imports." +msgstr "" + +msgid "" +"*MandatoryRelease* may also be ``None``, meaning that a planned feature got " +"dropped or that it is not yet decided." +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." +msgstr "" + msgid "" "``from __future__ import annotations`` was previously scheduled to become " "mandatory in Python 3.10, but the Python Steering Council twice decided to " @@ -215,7 +227,13 @@ msgid "" msgstr "" msgid ":ref:`future`" -msgstr "" +msgstr ":ref:`future`" msgid "How the compiler treats future imports." +msgstr "Jak kompilator traktuje przyszłe importy." + +msgid ":pep:`236` - Back to the __future__" +msgstr "" + +msgid "The original proposal for the __future__ mechanism." msgstr "" diff --git a/library/_thread.po b/library/_thread.po index 8376aaecbb..2bd3a49650 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -82,12 +82,12 @@ msgstr "" msgid "" "If given, *signum* is the number of the signal to simulate. If *signum* is " -"not given, :data:`signal.SIGINT` is simulated." +"not given, :const:`signal.SIGINT` is simulated." msgstr "" msgid "" -"If the given signal isn't handled by Python (it was set to :data:`signal." -"SIG_DFL` or :data:`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." @@ -154,9 +154,9 @@ msgid "Unix platforms with POSIX threads support." msgstr "" msgid "" -"The maximum value allowed for the *timeout* parameter of :meth:`Lock." -"acquire`. Specifying a timeout greater than this value will raise an :exc:" -"`OverflowError`." +"The maximum value allowed for the *timeout* parameter of :meth:`Lock.acquire " +"`. Specifying a timeout greater than this value will " +"raise an :exc:`OverflowError`." msgstr "" msgid "Lock objects have the following methods:" @@ -224,9 +224,9 @@ msgid "" msgstr "" msgid "" -"It is not possible to interrupt the :meth:`acquire` method on a lock --- " -"the :exc:`KeyboardInterrupt` exception will happen after the lock has been " -"acquired." +"It is not possible to interrupt the :meth:`~threading.Lock.acquire` method " +"on a lock --- the :exc:`KeyboardInterrupt` exception will happen after the " +"lock has been acquired." msgstr "" msgid "" @@ -260,7 +260,7 @@ msgid "threads" msgstr "" msgid "POSIX" -msgstr "" +msgstr "POSIX" msgid "module" msgstr "moduł" diff --git a/library/abc.po b/library/abc.po index 5a0230c2de..89b7fb0f27 100644 --- a/library/abc.po +++ b/library/abc.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid ":mod:`abc` --- Abstract Base Classes" msgstr ":mod:`abc` --- abstrakcyjne klasy bazowe" msgid "**Source code:** :source:`Lib/abc.py`" -msgstr "" +msgstr "**Kod źródłowy:**. :source:`Lib/abc.py`" msgid "" "This module provides the infrastructure for defining :term:`abstract base " @@ -41,7 +41,7 @@ msgid "" "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 mapping." +"term:`hashable` or if it is a :term:`mapping`." msgstr "" msgid "" @@ -51,16 +51,16 @@ msgstr "" msgid "" "A helper class that has :class:`ABCMeta` as its metaclass. With this class, " -"an abstract base class can be created by simply deriving from :class:`ABC` " +"an abstract base class can be created by simply deriving from :class:`!ABC` " "avoiding sometimes confusing metaclass usage, for example::" msgstr "" msgid "" -"Note that the type of :class:`ABC` is still :class:`ABCMeta`, therefore " -"inheriting from :class:`ABC` requires the usual precautions regarding " +"Note that the type of :class:`!ABC` is still :class:`ABCMeta`, therefore " +"inheriting from :class:`!ABC` requires the usual precautions regarding " "metaclass usage, as multiple inheritance may lead to metaclass conflicts. " "One may also define an abstract base class by passing the metaclass keyword " -"and using :class:`ABCMeta` directly, for example::" +"and using :class:`!ABCMeta` directly, for example::" msgstr "" msgid "Metaclass for defining Abstract Base Classes (ABCs)." @@ -93,11 +93,9 @@ msgstr "" "wywoływalne (nawet nie przez użycie :func:`super`). [#]_" msgid "" -"Classes created with a metaclass of :class:`ABCMeta` have the following " +"Classes created with a metaclass of :class:`!ABCMeta` have the following " "method:" msgstr "" -"Uogólnienia stworzone za pomocą pośredniego uogólnienia :class:`ABCMeta` " -"mają następujący sposób postępowania:" msgid "" "Register *subclass* as a \"virtual subclass\" of this ABC. For example::" @@ -109,8 +107,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:" @@ -123,34 +121,19 @@ msgstr "(Musi być określona jako sposób postępowania uogólnienia.)" msgid "" "Check whether *subclass* is considered a subclass of this ABC. This means " -"that you can customize the behavior of ``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:`__subclasscheck__` " -"method of the ABC.)" -msgstr "" -"Sprawdzi czy *podrzędne uogólnienie* jest uważane za podrzędne względem tego " -"abstrakcyjnego uogólnienia bazowego. To oznacza, że możesz dostosować " -"zachowanie ``issubclass``, dalej bez konieczności wzywania sposobu " -"postępowania :meth:`register` w każdym uogólnieniu które chcesz uważać za " -"podrzędne uogólnienie względem tego abstrakcyjnego uogólnienia podstawowego. " -"(Ten sposób postępowania uogólnienia jest wzywany ze sposobu postępowania :" -"meth:`__subclasscheck__` tego abstrakcyjnego uogólnienia podstawowego.)" - -msgid "" -"This method should return ``True``, ``False`` or ``NotImplemented``. If it " -"returns ``True``, the *subclass* is considered a subclass of this ABC. If it " -"returns ``False``, the *subclass* is not considered a subclass of this ABC, " -"even if it would normally be one. If it returns ``NotImplemented``, the " -"subclass check is continued with the usual mechanism." -msgstr "" -"Ten sposób postępowania powinien zwrócić ``Prawdę`` - z ang. - ``True``, " -"``Fałsz`` - z ang. - ``False`` lub ``niewypełnione`` - z ang. - " -"``NotImplemented``. Jeśli zwraca ``True``, *podrzędne uogólnienie* jest " -"uważanie za podrzędne względem tego abstrakcyjnego uogólnienia podstawowego. " -"Jeśli zwraca ``Fałsz``, *podrzędne uogólnienie* nie jest uważane za " -"podrzędne względem tego abstrakcyjnego uogólnienia podstawowego, nawet jeśli " -"zwykle byłoby takim. Jeśli zwraca ``NotImplemented``, sprawdzenie " -"podrzędnego uogólnienia jest kontynuowane z typowym mechanizmem." +"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:`~class." +"__subclasscheck__` method of the ABC.)" +msgstr "" + +msgid "" +"This method should return ``True``, ``False`` or :data:`NotImplemented`. If " +"it returns ``True``, the *subclass* is considered a subclass of this ABC. If " +"it returns ``False``, the *subclass* is not considered a subclass of this " +"ABC, even if it would normally be one. If it returns :data:`!" +"NotImplemented`, the subclass check is continued with the usual mechanism." +msgstr "" msgid "" "For a demonstration of these concepts, look at this example ABC definition::" @@ -161,7 +144,7 @@ msgstr "" msgid "" "The ABC ``MyIterable`` defines the standard iterable method, :meth:" "`~iterator.__iter__`, as an abstract method. The implementation given here " -"can still be called from subclasses. The :meth:`get_iterator` method is " +"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 "" @@ -176,12 +159,13 @@ msgstr "" msgid "" "Finally, the last line makes ``Foo`` a virtual subclass of ``MyIterable``, " "even though it does not define an :meth:`~iterator.__iter__` method (it uses " -"the old-style iterable protocol, defined in terms of :meth:`__len__` and :" -"meth:`__getitem__`). Note that this will not make ``get_iterator`` " -"available as a method of ``Foo``, so it is provided separately." +"the old-style iterable protocol, defined in terms of :meth:`~object.__len__` " +"and :meth:`~object.__getitem__`). Note that this will not make " +"``get_iterator`` available as a method of ``Foo``, so it is provided " +"separately." msgstr "" -msgid "The :mod:`abc` module also provides the following decorator:" +msgid "The :mod:`!abc` module also provides the following decorator:" msgstr "" msgid "A decorator indicating abstract methods." @@ -189,32 +173,32 @@ msgstr "Dekorator wskazujący abstrakcyjne sposoby postępowania." msgid "" "Using this decorator requires that the class's metaclass is :class:`ABCMeta` " -"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 " +"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. :func:`!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:" -"`abstractmethod` only affects subclasses derived using regular inheritance; " -"\"virtual subclasses\" registered with the ABC's :meth:`register` method are " -"not affected." +"supported using the :func:`update_abstractmethods` function. The :func:`!" +"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 :func:`!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 "" msgid "" "In order to correctly interoperate with the abstract base class machinery, " -"the descriptor must identify itself as abstract using :attr:" -"`__isabstractmethod__`. In general, this attribute should be ``True`` if any " +"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::" msgstr "" @@ -233,7 +217,7 @@ msgstr "" "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:" +msgid "The :mod:`!abc` module also supports the following legacy decorators:" msgstr "" msgid "" @@ -294,7 +278,7 @@ msgid "" "updated to create a concrete property in a subclass::" msgstr "" -msgid "The :mod:`abc` module also provides the following functions:" +msgid "The :mod:`!abc` module also provides the following functions:" msgstr "" msgid "Returns the current abstract base class cache token." diff --git a/library/argparse.po b/library/argparse.po index 7ceffd8f5d..0d34a4d29d 100644 --- a/library/argparse.po +++ b/library/argparse.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2023 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +29,7 @@ msgid "" msgstr "" msgid "**Source code:** :source:`Lib/argparse.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/argparse.py`" msgid "Tutorial" msgstr "Tutorial" @@ -167,7 +166,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "" "The following code is a Python program that takes a list of integers and " @@ -422,7 +421,7 @@ msgid "" msgstr "" msgid "formatter_class" -msgstr "" +msgstr "formatter_class" msgid "" ":class:`ArgumentParser` objects allow the help formatting to be customized " @@ -504,7 +503,7 @@ msgid "" msgstr "" msgid "argument_default" -msgstr "" +msgstr "argument_default" msgid "" "Generally, argument defaults are specified either by passing a default to :" @@ -884,7 +883,7 @@ msgid "" msgstr "" msgid "type" -msgstr "" +msgstr "typ" msgid "" "By default, the parser reads command-line arguments in as simple strings. " @@ -1001,7 +1000,7 @@ msgid "" msgstr "" msgid "help" -msgstr "" +msgstr "pomoc" msgid "" "The ``help`` value is a string containing a brief description of the " @@ -1406,7 +1405,7 @@ msgid "" "and :data:`sys.stdout` for writable :class:`FileType` objects::" msgstr "" -msgid "The *encodings* and *errors* keyword arguments." +msgid "Added the *encodings* and *errors* parameters." msgstr "" msgid "Argument groups" @@ -1724,7 +1723,7 @@ msgid "in argparse module" msgstr "" msgid "* (asterisk)" -msgstr "* (asterisk)" +msgstr "* (asterysk)" msgid "+ (plus)" msgstr "" diff --git a/library/array.po b/library/array.po index 9953231f58..b859c97ffe 100644 --- a/library/array.po +++ b/library/array.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +43,7 @@ msgstr "" "typów są określone:" msgid "Type code" -msgstr "Kod typu" +msgstr "kod typu" msgid "C Type" msgstr "typ języka C" @@ -52,7 +52,7 @@ msgid "Python Type" msgstr "typ Pythona" msgid "Minimum size in bytes" -msgstr "Minimalny rozmiar w bajtach" +msgstr "minimalny rozmiar w bajtach" msgid "Notes" msgstr "Notatki" @@ -130,7 +130,7 @@ msgid "unsigned long" msgstr "nieoznaczony typ długi" msgid "``'q'``" -msgstr "" +msgstr "``'q'``" msgid "signed long long" msgstr "" @@ -139,7 +139,7 @@ msgid "8" msgstr "8" msgid "``'Q'``" -msgstr "" +msgstr "``'Q'``" msgid "unsigned long long" msgstr "" @@ -163,9 +163,9 @@ msgid "It can be 16 bits or 32 bits depending on the platform." msgstr "" msgid "" -"``array('u')`` now uses ``wchar_t`` as C type instead of deprecated " +"``array('u')`` now uses :c:type:`wchar_t` as C type instead of deprecated " "``Py_UNICODE``. This change doesn't affect its behavior because " -"``Py_UNICODE`` is alias of ``wchar_t`` since Python 3.3." +"``Py_UNICODE`` is alias of :c:type:`wchar_t` since Python 3.3." msgstr "" msgid "" @@ -185,15 +185,17 @@ 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 list, a :term:`bytes-like " -"object`, 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 "" -"If given a list or string, the initializer is passed to the new array's :" -"meth:`fromlist`, :meth:`frombytes`, or :meth:`fromunicode` method (see " -"below) to add initial items to the array. Otherwise, the iterable " -"initializer is passed to the :meth:`extend` method." +"If given a :class:`bytes` or :class:`bytearray` object, the initializer is " +"passed to the new array's :meth:`frombytes` method; if given a Unicode " +"string, the initializer is passed to the :meth:`fromunicode` method; " +"otherwise, the initializer's iterator is passed to the :meth:`extend` method " +"to add initial items to the array." msgstr "" msgid "" @@ -252,11 +254,10 @@ msgid "" "`RuntimeError` is raised. It is useful when reading data from a file " "written on a machine with a different byte order." msgstr "" -"\"Zamień miejscami kęsy\" - z ang. - \"Byteswap\" wszystkie elementy " -"tablicy. To jest wspierane tylko dla wartości które są 1, 2, 4, lub 8 w " -"rozmiarze; dla innych typów wartości wyjątek :exc:`RuntimeError` jest " -"zgłaszany. Jest to użyteczne gdy wczytuje się dane z pliku zapisanym na " -"maszynie o odmiennym porządku bajtów." +"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 " +"zgłaszany jest wyjątek :exc:`RuntimeError`. Jest to użyteczne gdy wczytuje " +"się dane z pliku zapisanego na maszynie o odmiennym porządku bajtów." msgid "Return the number of occurrences of *x* in the array." msgstr "Zwróć liczbę wystąpień *x* w tablicy." @@ -274,13 +275,10 @@ msgstr "" "aby mogły być doklejone do tablicy." msgid "" -"Appends items from the string, interpreting the string as an array of " -"machine values (as if it had been read from a file using the :meth:" -"`fromfile` method)." +"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)." msgstr "" -"Dokleja elementy z ciągu znaków, interpretując ciąg jako tablicę wartości " -"maszynowych (tak jakby były one wszytane z pliku używając sposobu " -"postępowania :meth:`fromfile`)." msgid ":meth:`!fromstring` is renamed to :meth:`frombytes` for clarity." msgstr "" @@ -301,10 +299,10 @@ msgstr "" "niezmieniona." msgid "" -"Extends this array with data from the given unicode string. The array must " -"be a type ``'u'`` array; otherwise a :exc:`ValueError` is raised. Use " -"``array.frombytes(unicodestring.encode(enc))`` to append Unicode data to an " -"array of some other type." +"Extends this array with data from the given Unicode string. The array must " +"have type code ``'u'``; otherwise a :exc:`ValueError` is raised. Use ``array." +"frombytes(unicodestring.encode(enc))`` to append Unicode data to an array of " +"some other type." msgstr "" msgid "" @@ -355,19 +353,20 @@ msgid "Convert the array to an ordinary list with the same items." msgstr "Zamień tabelę na zwykłą listę o tych samych elementach." msgid "" -"Convert the array to a unicode string. The array must be a type ``'u'`` " -"array; otherwise a :exc:`ValueError` is raised. Use ``array.tobytes()." -"decode(enc)`` to obtain a unicode string from an array of some other type." +"Convert the array to a Unicode string. The array must have a type ``'u'``; " +"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 "" -"When an array object is printed or converted to a string, it is represented " -"as ``array(typecode, initializer)``. The *initializer* is omitted if the " -"array is empty, otherwise it is a string if the *typecode* is ``'u'``, " -"otherwise it is a list of numbers. The string is guaranteed to be able to " +"The string representation of array objects has the form ``array(typecode, " +"initializer)``. The *initializer* is omitted if the array is empty, " +"otherwise it is a Unicode string if the *typecode* is ``'u'``, otherwise it " +"is a list of numbers. The string representation is guaranteed to be able to " "be converted back to an array with the same type and value using :func:" "`eval`, so long as the :class:`~array.array` class has been imported using " -"``from array import array``. Examples::" +"``from array import array``. Variables ``inf`` and ``nan`` must also be " +"defined if it contains corresponding floating point values. Examples::" msgstr "" msgid "Module :mod:`struct`" @@ -388,7 +387,7 @@ msgstr "" "wywoływania procedur." msgid "`NumPy `_" -msgstr "" +msgstr "`NumPy `_" msgid "The NumPy package defines another array type." msgstr "" diff --git a/library/asynchat.po b/library/asynchat.po index 2df18af667..fcc139a7a5 100644 --- a/library/asynchat.po +++ b/library/asynchat.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/asyncio-api-index.po b/library/asyncio-api-index.po index 2645fa8f1e..71d1fdd249 100644 --- a/library/asyncio-api-index.po +++ b/library/asyncio-api-index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,25 +38,25 @@ msgid "" msgstr "" msgid ":func:`run`" -msgstr "" +msgstr ":func:`run`" msgid "Create event loop, run a coroutine, close the loop." msgstr "" msgid ":class:`Runner`" -msgstr "" +msgstr ":class:`Runner`" msgid "A context manager that simplifies multiple async function calls." msgstr "" msgid ":class:`Task`" -msgstr "" +msgstr ":class:`Task`" msgid "Task object." msgstr "" msgid ":class:`TaskGroup`" -msgstr "" +msgstr ":class:`TaskGroup`" msgid "" "A context manager that holds a group of tasks. Provides a convenient and " @@ -65,67 +64,67 @@ msgid "" msgstr "" msgid ":func:`create_task`" -msgstr "" +msgstr ":func:`create_task`" msgid "Start an asyncio Task, then returns it." msgstr "" msgid ":func:`current_task`" -msgstr "" +msgstr ":func:`current_task`" msgid "Return the current Task." msgstr "" msgid ":func:`all_tasks`" -msgstr "" +msgstr ":func:`all_tasks`" msgid "Return all tasks that are not yet finished for an event loop." msgstr "" msgid "``await`` :func:`sleep`" -msgstr "" +msgstr "``await`` :func:`sleep`" msgid "Sleep for a number of seconds." msgstr "" msgid "``await`` :func:`gather`" -msgstr "" +msgstr "``await`` :func:`gather`" msgid "Schedule and wait for things concurrently." msgstr "" msgid "``await`` :func:`wait_for`" -msgstr "" +msgstr "``await`` :func:`wait_for`" msgid "Run with a timeout." msgstr "" msgid "``await`` :func:`shield`" -msgstr "" +msgstr "``await`` :func:`shield`" msgid "Shield from cancellation." msgstr "" msgid "``await`` :func:`wait`" -msgstr "" +msgstr "``await`` :func:`wait`" msgid "Monitor for completion." msgstr "" msgid ":func:`timeout`" -msgstr "" +msgstr ":func:`timeout`" msgid "Run with a timeout. Useful in cases when ``wait_for`` is not suitable." msgstr "" msgid ":func:`to_thread`" -msgstr "" +msgstr ":func:`to_thread`" msgid "Asynchronously run a function in a separate OS thread." msgstr "" msgid ":func:`run_coroutine_threadsafe`" -msgstr "" +msgstr ":func:`run_coroutine_threadsafe`" msgid "Schedule a coroutine from another OS thread." msgstr "" @@ -167,19 +166,19 @@ msgid "" msgstr "" msgid ":class:`Queue`" -msgstr "" +msgstr ":class:`Queue`" msgid "A FIFO queue." msgstr "" msgid ":class:`PriorityQueue`" -msgstr "" +msgstr ":class:`PriorityQueue`" msgid "A priority queue." msgstr "" msgid ":class:`LifoQueue`" -msgstr "" +msgstr ":class:`LifoQueue`" msgid "A LIFO queue." msgstr "" @@ -199,13 +198,13 @@ msgid "Utilities to spawn subprocesses and run shell commands." msgstr "" msgid "``await`` :func:`create_subprocess_exec`" -msgstr "" +msgstr "``await`` :func:`create_subprocess_exec`" msgid "Create a subprocess." msgstr "" msgid "``await`` :func:`create_subprocess_shell`" -msgstr "" +msgstr "``await`` :func:`create_subprocess_shell`" msgid "Run a shell command." msgstr "" @@ -223,37 +222,37 @@ msgid "High-level APIs to work with network IO." msgstr "" msgid "``await`` :func:`open_connection`" -msgstr "" +msgstr "``await`` :func:`open_connection`" msgid "Establish a TCP connection." msgstr "" msgid "``await`` :func:`open_unix_connection`" -msgstr "" +msgstr "``await`` :func:`open_unix_connection`" msgid "Establish a Unix socket connection." msgstr "" msgid "``await`` :func:`start_server`" -msgstr "" +msgstr "``await`` :func:`start_server`" msgid "Start a TCP server." msgstr "" msgid "``await`` :func:`start_unix_server`" -msgstr "" +msgstr "``await`` :func:`start_unix_server`" msgid "Start a Unix socket server." msgstr "" msgid ":class:`StreamReader`" -msgstr "" +msgstr ":class:`StreamReader`" msgid "High-level async/await object to receive network data." msgstr "" msgid ":class:`StreamWriter`" -msgstr "" +msgstr ":class:`StreamWriter`" msgid "High-level async/await object to send network data." msgstr "" @@ -271,37 +270,37 @@ msgid "Threading-like synchronization primitives that can be used in Tasks." msgstr "" msgid ":class:`Lock`" -msgstr "" +msgstr ":class:`Lock`" msgid "A mutex lock." msgstr "" msgid ":class:`Event`" -msgstr "" +msgstr ":class:`Event`" msgid "An event object." msgstr "" msgid ":class:`Condition`" -msgstr "" +msgstr ":class:`Condition`" msgid "A condition object." msgstr "" msgid ":class:`Semaphore`" -msgstr "" +msgstr ":class:`Semaphore`" msgid "A semaphore." msgstr "" msgid ":class:`BoundedSemaphore`" -msgstr "" +msgstr ":class:`BoundedSemaphore`" msgid "A bounded semaphore." msgstr "" msgid ":class:`Barrier`" -msgstr "" +msgstr ":class:`Barrier`" msgid "A barrier object." msgstr "" @@ -321,13 +320,13 @@ msgid "Exceptions" msgstr "Wyjątki" msgid ":exc:`asyncio.CancelledError`" -msgstr "" +msgstr ":exc:`asyncio.CancelledError`" msgid "Raised when a Task is cancelled. See also :meth:`Task.cancel`." msgstr "" msgid ":exc:`asyncio.BrokenBarrierError`" -msgstr "" +msgstr ":exc:`asyncio.BrokenBarrierError`" msgid "Raised when a Barrier is broken. See also :meth:`Barrier.wait`." msgstr "" diff --git a/library/asyncio-dev.po b/library/asyncio-dev.po new file mode 100644 index 0000000000..1edb3b84e9 --- /dev/null +++ b/library/asyncio-dev.po @@ -0,0 +1,223 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Developing with asyncio" +msgstr "" + +msgid "" +"Asynchronous programming is different from classic \"sequential\" " +"programming." +msgstr "" + +msgid "" +"This page lists common mistakes and traps and explains how to avoid them." +msgstr "" + +msgid "Debug Mode" +msgstr "" + +msgid "" +"By default asyncio runs in production mode. In order to ease the " +"development asyncio has a *debug mode*." +msgstr "" + +msgid "There are several ways to enable asyncio debug mode:" +msgstr "" + +msgid "Setting the :envvar:`PYTHONASYNCIODEBUG` environment variable to ``1``." +msgstr "" + +msgid "Using the :ref:`Python Development Mode `." +msgstr "" + +msgid "Passing ``debug=True`` to :func:`asyncio.run`." +msgstr "" + +msgid "Calling :meth:`loop.set_debug`." +msgstr "" + +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::" +msgstr "" + +msgid "" +"configuring the :mod:`warnings` module to display :exc:`ResourceWarning` " +"warnings. One way of doing that is by using the :option:`-W` ``default`` " +"command line option." +msgstr "" + +msgid "When the debug mode is enabled:" +msgstr "" + +msgid "" +"asyncio checks for :ref:`coroutines that were not awaited ` and logs them; this mitigates the \"forgotten await\" " +"pitfall." +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." +msgstr "" + +msgid "" +"The execution time of the I/O selector is logged if it takes too long to " +"perform an I/O operation." +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\"." +msgstr "" + +msgid "Concurrency and Multithreading" +msgstr "" + +msgid "" +"An event loop runs in a thread (typically the main thread) and executes all " +"callbacks and Tasks in its thread. While a Task is running in the event " +"loop, no other Tasks can run in the same thread. When a Task executes an " +"``await`` expression, the running Task gets suspended, and the event loop " +"executes the next Task." +msgstr "" + +msgid "" +"To schedule a :term:`callback` from another OS thread, the :meth:`loop." +"call_soon_threadsafe` method should be used. Example::" +msgstr "" + +msgid "" +"Almost all asyncio objects are not thread safe, which is typically not a " +"problem unless there is code that works with them from outside of a Task or " +"a callback. If there's a need for such code to call a low-level asyncio " +"API, the :meth:`loop.call_soon_threadsafe` method should be used, e.g.::" +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::" +msgstr "" + +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` 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 " +"different process." +msgstr "" + +msgid "Running Blocking Code" +msgstr "" + +msgid "" +"Blocking (CPU-bound) code should not be called directly. For example, if a " +"function performs a CPU-intensive calculation for 1 second, all concurrent " +"asyncio Tasks and IO operations would be delayed by 1 second." +msgstr "" + +msgid "" +"An executor can be used to run a task in a different thread or even in a " +"different process to avoid blocking the OS thread with the event loop. See " +"the :meth:`loop.run_in_executor` method for more details." +msgstr "" + +msgid "Logging" +msgstr "Logowanie" + +msgid "" +"asyncio uses the :mod:`logging` module and all logging is performed via the " +"``\"asyncio\"`` logger." +msgstr "" + +msgid "" +"The default log level is :py:const:`logging.INFO`, which can be easily " +"adjusted::" +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`." +msgstr "" + +msgid "Detect never-awaited coroutines" +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`::" +msgstr "" + +msgid "Output::" +msgstr "" + +msgid "Output in debug mode::" +msgstr "" + +msgid "" +"The usual fix is to either await the coroutine or call the :meth:`asyncio." +"create_task` function::" +msgstr "" + +msgid "Detect never-retrieved exceptions" +msgstr "" + +msgid "" +"If a :meth:`Future.set_exception` is called but the Future object is never " +"awaited on, the exception would never be propagated to the user code. In " +"this case, asyncio would emit a log message when the Future object is " +"garbage collected." +msgstr "" + +msgid "Example of an unhandled exception::" +msgstr "" + +msgid "" +":ref:`Enable the debug mode ` to get the traceback where " +"the task was created::" +msgstr "" diff --git a/library/asyncio-eventloop.po b/library/asyncio-eventloop.po new file mode 100644 index 0000000000..b674258871 --- /dev/null +++ b/library/asyncio-eventloop.po @@ -0,0 +1,1744 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Event Loop" +msgstr "" + +msgid "" +"**Source code:** :source:`Lib/asyncio/events.py`, :source:`Lib/asyncio/" +"base_events.py`" +msgstr "" +"**Kod źródłowy:** :source:`Lib/asyncio/events.py`, :source:`Lib/asyncio/" +"base_events.py`" + +msgid "Preface" +msgstr "" + +msgid "" +"The event loop is the core of every asyncio application. Event loops run " +"asynchronous tasks and callbacks, perform network IO operations, and run " +"subprocesses." +msgstr "" + +msgid "" +"Application developers should typically use the high-level asyncio " +"functions, such as :func:`asyncio.run`, and should rarely need to reference " +"the loop object or call its methods. This section is intended mostly for " +"authors of lower-level code, libraries, and frameworks, who need finer " +"control over the event loop behavior." +msgstr "" + +msgid "Obtaining the Event Loop" +msgstr "" + +msgid "" +"The following low-level functions can be used to get, set, or create an " +"event loop:" +msgstr "" + +msgid "Return the running event loop in the current OS thread." +msgstr "" + +msgid "Raise a :exc:`RuntimeError` if there is no running event loop." +msgstr "" + +msgid "This function can only be called from a coroutine or a callback." +msgstr "" + +msgid "Get the current event loop." +msgstr "" + +msgid "" +"When called from a coroutine or a callback (e.g. scheduled with call_soon or " +"similar API), this function will always return the running event loop." +msgstr "" + +msgid "" +"If there is no running event loop set, the function will return the result " +"of the ``get_event_loop_policy().get_event_loop()`` call." +msgstr "" + +msgid "" +"Because this function has rather complex behavior (especially when custom " +"event loop policies are in use), using the :func:`get_running_loop` function " +"is preferred to :func:`get_event_loop` in coroutines and callbacks." +msgstr "" + +msgid "" +"As noted above, consider using the higher-level :func:`asyncio.run` " +"function, instead of using these lower level functions to manually create " +"and close an event loop." +msgstr "" + +msgid "" +"In Python versions 3.10.0--3.10.8 and 3.11.0 this function (and other " +"functions which use it implicitly) emitted a :exc:`DeprecationWarning` if " +"there was no running event loop, even if the current loop was set on the " +"policy. In Python versions 3.10.9, 3.11.1 and 3.12 they emit a :exc:" +"`DeprecationWarning` if there is no running event loop and no current loop " +"is set. In some future Python release this will become an error." +msgstr "" + +msgid "Set *loop* as the current event loop for the current OS thread." +msgstr "" + +msgid "Create and return a new event loop object." +msgstr "" + +msgid "" +"Note that the behaviour of :func:`get_event_loop`, :func:`set_event_loop`, " +"and :func:`new_event_loop` functions can be altered by :ref:`setting a " +"custom event loop policy `." +msgstr "" + +msgid "Contents" +msgstr "Zawartość" + +msgid "This documentation page contains the following sections:" +msgstr "" + +msgid "" +"The `Event Loop Methods`_ section is the reference documentation of the " +"event loop APIs;" +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`;" +msgstr "" + +msgid "" +"The `Server Objects`_ section documents types returned from event loop " +"methods like :meth:`loop.create_server`;" +msgstr "" + +msgid "" +"The `Event Loop Implementations`_ section documents the :class:" +"`SelectorEventLoop` and :class:`ProactorEventLoop` classes;" +msgstr "" + +msgid "" +"The `Examples`_ section showcases how to work with some event loop APIs." +msgstr "" + +msgid "Event Loop Methods" +msgstr "" + +msgid "Event loops have **low-level** APIs for the following:" +msgstr "" + +msgid "Running and stopping the loop" +msgstr "" + +msgid "Run until the *future* (an instance of :class:`Future`) has completed." +msgstr "" + +msgid "" +"If the argument is a :ref:`coroutine object ` it is implicitly " +"scheduled to run as a :class:`asyncio.Task`." +msgstr "" + +msgid "Return the Future's result or raise its exception." +msgstr "" + +msgid "Run the event loop until :meth:`stop` is called." +msgstr "" + +msgid "" +"If :meth:`stop` is called before :meth:`run_forever()` is called, the loop " +"will poll the I/O selector once with a timeout of zero, run all callbacks " +"scheduled in response to I/O events (and those that were already scheduled), " +"and then exit." +msgstr "" + +msgid "" +"If :meth:`stop` is called while :meth:`run_forever` is running, the loop " +"will run the current batch of callbacks and then exit. Note that new " +"callbacks scheduled by callbacks will not run in this case; instead, they " +"will run the next time :meth:`run_forever` or :meth:`run_until_complete` is " +"called." +msgstr "" + +msgid "Stop the event loop." +msgstr "" + +msgid "Return ``True`` if the event loop is currently running." +msgstr "" + +msgid "Return ``True`` if the event loop was closed." +msgstr "" + +msgid "Close the event loop." +msgstr "" + +msgid "" +"The loop must not be running when this function is called. Any pending " +"callbacks will be discarded." +msgstr "" + +msgid "" +"This method clears all queues and shuts down the executor, but does not wait " +"for the executor to finish." +msgstr "" + +msgid "" +"This method is idempotent and irreversible. No other methods should be " +"called after the event loop is closed." +msgstr "" + +msgid "" +"Schedule all currently open :term:`asynchronous generator` objects to close " +"with an :meth:`~agen.aclose()` call. After calling this method, the event " +"loop will issue a warning if a new asynchronous generator is iterated. This " +"should be used to reliably finalize all scheduled asynchronous generators." +msgstr "" + +msgid "" +"Note that there is no need to call this function when :func:`asyncio.run` is " +"used." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +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`." +msgstr "" + +msgid "" +"Do not call this method when using :func:`asyncio.run`, as the latter " +"handles default executor shutdown automatically." +msgstr "" + +msgid "Scheduling callbacks" +msgstr "" + +msgid "" +"Schedule the *callback* :term:`callback` to be called with *args* arguments " +"at the next iteration of the event loop." +msgstr "" + +msgid "" +"Return an instance of :class:`asyncio.Handle`, which can be used later to " +"cancel the callback." +msgstr "" + +msgid "" +"Callbacks are called in the order in which they are registered. Each " +"callback will be called exactly once." +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." +msgstr "" + +msgid "Unlike :meth:`call_soon_threadsafe`, this method is not thread-safe." +msgstr "" + +msgid "" +"A thread-safe variant of :meth:`call_soon`. When scheduling callbacks from " +"another thread, this function *must* be used, since :meth:`call_soon` is not " +"thread-safe." +msgstr "" + +msgid "" +"Raises :exc:`RuntimeError` if called on a loop that's been closed. This can " +"happen on a secondary thread when the main application is shutting down." +msgstr "" + +msgid "" +"See the :ref:`concurrency and multithreading ` " +"section of the documentation." +msgstr "" + +msgid "" +"The *context* keyword-only parameter was added. See :pep:`567` for more " +"details." +msgstr "" + +msgid "" +"Most :mod:`asyncio` scheduling functions don't allow passing keyword " +"arguments. To do that, use :func:`functools.partial`::" +msgstr "" + +msgid "" +"Using partial objects is usually more convenient than using lambdas, as " +"asyncio can render partial objects better in debug and error messages." +msgstr "" + +msgid "Scheduling delayed callbacks" +msgstr "" + +msgid "" +"Event loop provides mechanisms to schedule callback functions to be called " +"at some point in the future. Event loop uses monotonic clocks to track time." +msgstr "" + +msgid "" +"Schedule *callback* to be called after the given *delay* number of seconds " +"(can be either an int or a float)." +msgstr "" + +msgid "" +"An instance of :class:`asyncio.TimerHandle` is returned which can be used to " +"cancel the callback." +msgstr "" + +msgid "" +"*callback* will be called exactly once. If two callbacks are scheduled for " +"exactly the same time, the order in which they are called is undefined." +msgstr "" + +msgid "" +"The optional positional *args* will be passed to the callback when it is " +"called. If you want the callback to be called with keyword arguments use :" +"func:`functools.partial`." +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." +msgstr "" + +msgid "" +"In Python 3.7 and earlier with the default event loop implementation, the " +"*delay* could not exceed one day. This has been fixed in Python 3.8." +msgstr "" + +msgid "" +"Schedule *callback* to be called at the given absolute timestamp *when* (an " +"int or a float), using the same time reference as :meth:`loop.time`." +msgstr "" + +msgid "This method's behavior is the same as :meth:`call_later`." +msgstr "" + +msgid "" +"In Python 3.7 and earlier with the default event loop implementation, the " +"difference between *when* and the current time could not exceed one day. " +"This has been fixed in Python 3.8." +msgstr "" + +msgid "" +"Return the current time, as a :class:`float` value, according to the event " +"loop's internal monotonic clock." +msgstr "" + +msgid "" +"In Python 3.7 and earlier timeouts (relative *delay* or absolute *when*) " +"should not exceed one day. This has been fixed in Python 3.8." +msgstr "" + +msgid "The :func:`asyncio.sleep` function." +msgstr "" + +msgid "Creating Futures and Tasks" +msgstr "" + +msgid "Create an :class:`asyncio.Future` object attached to the event loop." +msgstr "" + +msgid "" +"This is the preferred way to create Futures in asyncio. This lets third-" +"party event loops provide alternative implementations of the Future object " +"(with better performance or instrumentation)." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "" +"If the *name* argument is provided and not ``None``, it is set as the name " +"of the task using :meth:`Task.set_name`." +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." +msgstr "" + +msgid "Added the *name* parameter." +msgstr "" + +msgid "Added the *context* parameter." +msgstr "" + +msgid "Set a task factory that will be used by :meth:`loop.create_task`." +msgstr "" + +msgid "" +"If *factory* is ``None`` the default task factory will be set. Otherwise, " +"*factory* must be a *callable* with the signature matching ``(loop, coro, " +"context=None)``, where *loop* is a reference to the active event loop, and " +"*coro* is a coroutine object. The callable must return a :class:`asyncio." +"Future`-compatible object." +msgstr "" + +msgid "Return a task factory or ``None`` if the default one is in use." +msgstr "" + +msgid "Opening network connections" +msgstr "" + +msgid "" +"Open a streaming transport connection to a given address specified by *host* " +"and *port*." +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)." +msgstr "" + +msgid "The socket type will be :py:const:`~socket.SOCK_STREAM`." +msgstr "" + +msgid "" +"*protocol_factory* must be a callable returning an :ref:`asyncio protocol " +"` implementation." +msgstr "" + +msgid "" +"This method will try to establish the connection in the background. When " +"successful, it returns a ``(transport, protocol)`` pair." +msgstr "" + +msgid "The chronological synopsis of the underlying operation is as follows:" +msgstr "" + +msgid "" +"The connection is established and a :ref:`transport ` is " +"created for it." +msgstr "" + +msgid "" +"*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." +msgstr "" + +msgid "A ``(transport, protocol)`` tuple is returned on success." +msgstr "" + +msgid "" +"The created transport is an implementation-dependent bidirectional stream." +msgstr "" + +msgid "Other arguments:" +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." +msgstr "" + +msgid ":ref:`SSL/TLS security considerations `" +msgstr "" + +msgid "" +"*server_hostname* sets or overrides the hostname that the target server's " +"certificate will be matched against. Should only be passed if *ssl* is not " +"``None``. By default the value of the *host* argument is used. If *host* " +"is empty, there is no default and you must pass a value for " +"*server_hostname*. If *server_hostname* is an empty string, hostname " +"matching is disabled (which is a serious security risk, allowing for " +"potential man-in-the-middle attacks)." +msgstr "" + +msgid "" +"*family*, *proto*, *flags* are the optional address family, protocol and " +"flags to be passed through to getaddrinfo() for *host* resolution. If given, " +"these should all be integers from the corresponding :mod:`socket` module " +"constants." +msgstr "" + +msgid "" +"*happy_eyeballs_delay*, if given, enables Happy Eyeballs for this " +"connection. It should be a floating-point number representing the amount of " +"time in seconds to wait for a connection attempt to complete, before " +"starting the next attempt in parallel. This is the \"Connection Attempt " +"Delay\" as defined in :rfc:`8305`. A sensible default value recommended by " +"the RFC is ``0.25`` (250 milliseconds)." +msgstr "" + +msgid "" +"*interleave* controls address reordering when a host name resolves to " +"multiple IP addresses. If ``0`` or unspecified, no reordering is done, and " +"addresses are tried in the order returned by :meth:`getaddrinfo`. If a " +"positive integer is specified, the addresses are interleaved by address " +"family, and the given integer is interpreted as \"First Address Family " +"Count\" as defined in :rfc:`8305`. The default is ``0`` if " +"*happy_eyeballs_delay* is not specified, and ``1`` if it is." +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." +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." +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 " +"``getaddrinfo()``, similarly to *host* and *port*." +msgstr "" + +msgid "" +"*ssl_handshake_timeout* is (for a TLS connection) the time in seconds to " +"wait for the TLS handshake to complete before aborting the connection. " +"``60.0`` seconds if ``None`` (default)." +msgstr "" + +msgid "" +"*ssl_shutdown_timeout* is the time in seconds to wait for the SSL shutdown " +"to complete before aborting the connection. ``30.0`` seconds if ``None`` " +"(default)." +msgstr "" + +msgid "Added support for SSL/TLS in :class:`ProactorEventLoop`." +msgstr "" + +msgid "" +"The socket option :ref:`socket.TCP_NODELAY ` is set " +"by default for all TCP connections." +msgstr "" + +msgid "Added the *ssl_handshake_timeout* parameter." +msgstr "" + +msgid "Added the *happy_eyeballs_delay* and *interleave* parameters." +msgstr "" + +msgid "" +"Happy Eyeballs Algorithm: Success with Dual-Stack Hosts. When a server's " +"IPv4 path and protocol are working, but the server's IPv6 path and protocol " +"are not working, a dual-stack client application experiences significant " +"connection delay compared to an IPv4-only client. This is undesirable " +"because it causes the dual-stack client to have a worse user experience. " +"This document specifies requirements for algorithms that reduce this user-" +"visible delay and provides an algorithm." +msgstr "" + +msgid "For more information: https://datatracker.ietf.org/doc/html/rfc6555" +msgstr "" + +msgid "Added the *ssl_shutdown_timeout* parameter." +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 " +"used directly in async/await code." +msgstr "" + +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)." +msgstr "" + +msgid "The socket type will be :py:const:`~socket.SOCK_DGRAM`." +msgstr "" + +msgid "" +"*protocol_factory* must be a callable returning a :ref:`protocol ` implementation." +msgstr "" + +msgid "A tuple of ``(transport, protocol)`` is returned on success." +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`." +msgstr "" + +msgid "" +"*remote_addr*, if given, is a ``(remote_host, remote_port)`` tuple used to " +"connect the socket to a remote address. The *remote_host* and *remote_port* " +"are looked up using :meth:`getaddrinfo`." +msgstr "" + +msgid "" +"*family*, *proto*, *flags* are the optional address family, protocol and " +"flags to be passed through to :meth:`getaddrinfo` for *host* resolution. If " +"given, these should all be integers from the corresponding :mod:`socket` " +"module constants." +msgstr "" + +msgid "" +"*reuse_port* tells the kernel to allow this endpoint to be bound to the same " +"port as other existing endpoints are bound to, so long as they all set this " +"flag when being created. This option is not supported on Windows and some " +"Unixes. If the :ref:`socket.SO_REUSEPORT ` constant " +"is not defined then this capability is unsupported." +msgstr "" + +msgid "" +"*allow_broadcast* tells the kernel to allow this endpoint to send messages " +"to the broadcast address." +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`)." +msgstr "" + +msgid "" +"See :ref:`UDP echo client protocol ` and :" +"ref:`UDP echo server protocol ` examples." +msgstr "" + +msgid "" +"The *family*, *proto*, *flags*, *reuse_address*, *reuse_port*, " +"*allow_broadcast*, and *sock* parameters were added." +msgstr "" + +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." +msgstr "" + +msgid "" +"When multiple processes with differing UIDs assign sockets to an identical " +"UDP socket address with ``SO_REUSEADDR``, incoming packets can become " +"randomly distributed among the sockets." +msgstr "" + +msgid "" +"For supported platforms, *reuse_port* can be used as a replacement for " +"similar functionality. With *reuse_port*, :ref:`socket.SO_REUSEPORT ` is used instead, which specifically prevents processes with " +"differing UIDs from assigning sockets to the same socket address." +msgstr "" + +msgid "" +"The *reuse_address* parameter, disabled since Python 3.8.1, 3.7.6 and " +"3.6.10, has been entirely removed." +msgstr "" + +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`." +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." +msgstr "" + +msgid "" +"See the documentation of the :meth:`loop.create_connection` method for " +"information about arguments to this method." +msgstr "" + +msgid ":ref:`Availability `: Unix." +msgstr "" + +msgid "" +"Added the *ssl_handshake_timeout* parameter. The *path* parameter can now be " +"a :term:`path-like object`." +msgstr "" + +msgid "Creating network servers" +msgstr "" + +msgid "" +"Create a TCP server (socket type :const:`~socket.SOCK_STREAM`) listening on " +"*port* of the *host* address." +msgstr "" + +msgid "Returns a :class:`Server` object." +msgstr "" + +msgid "Arguments:" +msgstr "" + +msgid "" +"The *host* parameter can be set to several types which determine where the " +"server would be listening:" +msgstr "" + +msgid "" +"If *host* is a string, the TCP server is bound to a single network interface " +"specified by *host*." +msgstr "" + +msgid "" +"If *host* is a sequence of strings, the TCP server is bound to all network " +"interfaces specified by the sequence." +msgstr "" + +msgid "" +"If *host* is an empty string or ``None``, all interfaces are assumed and a " +"list of multiple sockets will be returned (most likely one for IPv4 and " +"another one for IPv6)." +msgstr "" + +msgid "" +"The *port* parameter can be set to specify which port the server should " +"listen on. If ``0`` or ``None`` (the default), a random unused port will be " +"selected (note that if *host* resolves to multiple network interfaces, a " +"different random port will be selected for each interface)." +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`)." +msgstr "" + +msgid "*flags* is a bitmask for :meth:`getaddrinfo`." +msgstr "" + +msgid "" +"*sock* can optionally be specified in order to use a preexisting socket " +"object. If specified, *host* and *port* must not be specified." +msgstr "" + +msgid "" +"The *sock* argument transfers ownership of the socket to the server created. " +"To close the socket, call the server's :meth:`~asyncio.Server.close` method." +msgstr "" + +msgid "" +"*backlog* is the maximum number of queued connections passed to :meth:" +"`~socket.socket.listen` (defaults to 100)." +msgstr "" + +msgid "" +"*ssl* can be set to an :class:`~ssl.SSLContext` instance to enable TLS over " +"the accepted connections." +msgstr "" + +msgid "" +"*reuse_address* tells the kernel to reuse a local socket in ``TIME_WAIT`` " +"state, without waiting for its natural timeout to expire. If not specified " +"will automatically be set to ``True`` on Unix." +msgstr "" + +msgid "" +"*reuse_port* tells the kernel to allow this endpoint to be bound to the same " +"port as other existing endpoints are bound to, so long as they all set this " +"flag when being created. This option is not supported on Windows." +msgstr "" + +msgid "" +"*ssl_handshake_timeout* is (for a TLS server) the time in seconds to wait " +"for the TLS handshake to complete before aborting the connection. ``60.0`` " +"seconds if ``None`` (default)." +msgstr "" + +msgid "" +"*start_serving* set to ``True`` (the default) causes the created server to " +"start accepting connections immediately. When set to ``False``, the user " +"should await on :meth:`Server.start_serving` or :meth:`Server.serve_forever` " +"to make the server to start accepting connections." +msgstr "" + +msgid "The *host* parameter can be a sequence of strings." +msgstr "" + +msgid "" +"Added *ssl_handshake_timeout* and *start_serving* parameters. The socket " +"option :ref:`socket.TCP_NODELAY ` is set by default " +"for all TCP connections." +msgstr "" + +msgid "" +"The :func:`start_server` function is a higher-level alternative API that " +"returns a pair of :class:`StreamReader` and :class:`StreamWriter` that can " +"be used in an async/await code." +msgstr "" + +msgid "" +"Similar to :meth:`loop.create_server` but works with the :py:const:`~socket." +"AF_UNIX` socket family." +msgstr "" + +msgid "" +"*path* is the name of a Unix domain socket, and is required, unless a *sock* " +"argument is provided. Abstract Unix sockets, :class:`str`, :class:`bytes`, " +"and :class:`~pathlib.Path` paths are supported." +msgstr "" + +msgid "" +"See the documentation of the :meth:`loop.create_server` method for " +"information about arguments to this method." +msgstr "" + +msgid "" +"Added the *ssl_handshake_timeout* and *start_serving* parameters. The *path* " +"parameter can now be a :class:`~pathlib.Path` object." +msgstr "" + +msgid "Wrap an already accepted connection into a transport/protocol pair." +msgstr "" + +msgid "" +"This method can be used by servers that accept connections outside of " +"asyncio but that use asyncio to handle them." +msgstr "" + +msgid "Parameters:" +msgstr "" + +msgid "" +"*sock* is a preexisting socket object returned from :meth:`socket.accept " +"`." +msgstr "" + +msgid "" +"*ssl* can be set to an :class:`~ssl.SSLContext` to enable SSL over the " +"accepted connections." +msgstr "" + +msgid "" +"*ssl_handshake_timeout* is (for an SSL connection) the time in seconds to " +"wait for the SSL handshake to complete before aborting the connection. " +"``60.0`` seconds if ``None`` (default)." +msgstr "" + +msgid "Returns a ``(transport, protocol)`` pair." +msgstr "" + +msgid "Transferring files" +msgstr "" + +msgid "" +"Send a *file* over a *transport*. Return the total number of bytes sent." +msgstr "" + +msgid "The method uses high-performance :meth:`os.sendfile` if available." +msgstr "" + +msgid "*file* must be a regular file object opened in binary mode." +msgstr "" + +msgid "" +"*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 always updated, even when this method " +"raises an error, and :meth:`file.tell() ` can be used to " +"obtain the actual number of bytes sent." +msgstr "" + +msgid "" +"*fallback* set to ``True`` makes asyncio to manually read and send the file " +"when the platform does not support the sendfile system call (e.g. Windows or " +"SSL socket on Unix)." +msgstr "" + +msgid "" +"Raise :exc:`SendfileNotAvailableError` if the system does not support the " +"*sendfile* syscall and *fallback* is ``False``." +msgstr "" + +msgid "TLS Upgrade" +msgstr "" + +msgid "Upgrade an existing transport-based connection to TLS." +msgstr "" + +msgid "" +"Create a TLS coder/decoder instance and insert it between the *transport* " +"and the *protocol*. The coder/decoder implements both *transport*-facing " +"protocol and *protocol*-facing transport." +msgstr "" + +msgid "" +"Return the created two-interface instance. After *await*, the *protocol* " +"must stop using the original *transport* and communicate with the returned " +"object only because the coder caches *protocol*-side data and sporadically " +"exchanges extra TLS session packets with *transport*." +msgstr "" + +msgid "" +"In some situations (e.g. when the passed transport is already closing) this " +"may return ``None``." +msgstr "" + +msgid "" +"*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`." +msgstr "" + +msgid "" +"*server_side* pass ``True`` when a server-side connection is being upgraded " +"(like the one created by :meth:`~loop.create_server`)." +msgstr "" + +msgid "" +"*server_hostname*: sets or overrides the host name that the target server's " +"certificate will be matched against." +msgstr "" + +msgid "Watching file descriptors" +msgstr "" + +msgid "" +"Start monitoring the *fd* file descriptor for read availability and invoke " +"*callback* with the specified arguments once *fd* is available for reading." +msgstr "" + +msgid "" +"Stop monitoring the *fd* file descriptor for read availability. Returns " +"``True`` if *fd* was previously being monitored for reads." +msgstr "" + +msgid "" +"Start monitoring the *fd* file descriptor for write availability and invoke " +"*callback* with the specified arguments once *fd* is available for writing." +msgstr "" + +msgid "" +"Use :func:`functools.partial` :ref:`to pass keyword arguments ` to *callback*." +msgstr "" + +msgid "" +"Stop monitoring the *fd* file descriptor for write availability. Returns " +"``True`` if *fd* was previously being monitored for writes." +msgstr "" + +msgid "" +"See also :ref:`Platform Support ` section for some " +"limitations of these methods." +msgstr "" + +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." +msgstr "" + +msgid "" +"Receive up to *nbytes* from *sock*. Asynchronous version of :meth:`socket." +"recv() `." +msgstr "" + +msgid "Return the received data as a bytes object." +msgstr "" + +msgid "*sock* must be a non-blocking socket." +msgstr "" + +msgid "" +"Even though this method was always documented as a coroutine method, " +"releases before Python 3.7 returned a :class:`Future`. Since Python 3.7 this " +"is an ``async def`` method." +msgstr "" + +msgid "" +"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() `." +msgstr "" + +msgid "Return a tuple of (received data, remote address)." +msgstr "" + +msgid "" +"Receive a datagram of up to *nbytes* from *sock* into *buf*. Asynchronous " +"version of :meth:`socket.recvfrom_into() `." +msgstr "" + +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() `." +msgstr "" + +msgid "" +"This method continues to send to the socket until either all data in *data* " +"has been sent or an error occurs. ``None`` is returned on success. On " +"error, an exception is raised. Additionally, there is no way to determine " +"how much data, if any, was successfully processed by the receiving end of " +"the connection." +msgstr "" + +msgid "" +"Even though the method was always documented as a coroutine method, before " +"Python 3.7 it returned a :class:`Future`. Since Python 3.7, this is an " +"``async def`` method." +msgstr "" + +msgid "" +"Send a datagram from *sock* to *address*. Asynchronous version of :meth:" +"`socket.sendto() `." +msgstr "" + +msgid "Return the number of bytes sent." +msgstr "" + +msgid "Connect *sock* to a remote socket at *address*." +msgstr "" + +msgid "" +"Asynchronous version of :meth:`socket.connect() `." +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*." +msgstr "" + +msgid "" +":meth:`loop.create_connection` and :func:`asyncio.open_connection() " +"`." +msgstr "" + +msgid "" +"Accept a connection. Modeled after the blocking :meth:`socket.accept() " +"` method." +msgstr "" + +msgid "" +"The socket must be bound to an address and listening for connections. The " +"return value is a pair ``(conn, address)`` where *conn* is a *new* socket " +"object usable to send and receive data on the connection, and *address* is " +"the address bound to the socket on the other end of the connection." +msgstr "" + +msgid ":meth:`loop.create_server` and :func:`start_server`." +msgstr "" + +msgid "" +"Send a file using high-performance :mod:`os.sendfile` if possible. Return " +"the total number of bytes sent." +msgstr "" + +msgid "" +"Asynchronous version of :meth:`socket.sendfile() `." +msgstr "" + +msgid "" +"*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." +msgstr "" + +msgid "" +"*fallback*, when set to ``True``, makes asyncio manually read and send the " +"file when the platform does not support the sendfile syscall (e.g. Windows " +"or SSL socket on Unix)." +msgstr "" + +msgid "" +"Raise :exc:`SendfileNotAvailableError` if the system does not support " +"*sendfile* syscall and *fallback* is ``False``." +msgstr "" + +msgid "DNS" +msgstr "" + +msgid "Asynchronous version of :meth:`socket.getaddrinfo`." +msgstr "" + +msgid "Asynchronous version of :meth:`socket.getnameinfo`." +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." +msgstr "" + +msgid "Working with pipes" +msgstr "" + +msgid "Register the read end of *pipe* in the event loop." +msgstr "" + +msgid "*pipe* is a :term:`file-like object `." +msgstr "" + +msgid "" +"Return pair ``(transport, protocol)``, where *transport* supports the :class:" +"`ReadTransport` interface and *protocol* is an object instantiated by the " +"*protocol_factory*." +msgstr "" + +msgid "" +"With :class:`SelectorEventLoop` event loop, the *pipe* is set to non-" +"blocking mode." +msgstr "" + +msgid "Register the write end of *pipe* in the event loop." +msgstr "" + +msgid "*pipe* is :term:`file-like object `." +msgstr "" + +msgid "" +"Return pair ``(transport, protocol)``, where *transport* supports :class:" +"`WriteTransport` interface and *protocol* is an object instantiated by the " +"*protocol_factory*." +msgstr "" + +msgid "" +":class:`SelectorEventLoop` does not support the above methods on Windows. " +"Use :class:`ProactorEventLoop` instead for Windows." +msgstr "" + +msgid "" +"The :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell` methods." +msgstr "" + +msgid "Unix signals" +msgstr "" + +msgid "Set *callback* as the handler for the *signum* signal." +msgstr "" + +msgid "" +"The callback will be invoked by *loop*, along with other queued callbacks " +"and runnable coroutines of that event loop. Unlike signal handlers " +"registered using :func:`signal.signal`, a callback registered with this " +"function is allowed to interact with the event loop." +msgstr "" + +msgid "" +"Raise :exc:`ValueError` if the signal number is invalid or uncatchable. " +"Raise :exc:`RuntimeError` if there is a problem setting up the handler." +msgstr "" + +msgid "" +"Like :func:`signal.signal`, this function must be invoked in the main thread." +msgstr "" + +msgid "Remove the handler for the *sig* signal." +msgstr "" + +msgid "" +"Return ``True`` if the signal handler was removed, or ``False`` if no " +"handler was set for the given signal." +msgstr "" + +msgid "The :mod:`signal` module." +msgstr "" + +msgid "Executing code in thread or process pools" +msgstr "" + +msgid "Arrange for *func* to be called in the specified executor." +msgstr "" + +msgid "" +"The *executor* argument should be an :class:`concurrent.futures.Executor` " +"instance. The default executor is used if *executor* is ``None``." +msgstr "" + +msgid "" +"Note that the entry point guard (``if __name__ == '__main__'``) is required " +"for option 3 due to the peculiarities of :mod:`multiprocessing`, which is " +"used by :class:`~concurrent.futures.ProcessPoolExecutor`. See :ref:`Safe " +"importing of main module `." +msgstr "" + +msgid "This method returns a :class:`asyncio.Future` object." +msgstr "" + +msgid "" +"Use :func:`functools.partial` :ref:`to pass keyword arguments ` to *func*." +msgstr "" + +msgid "" +":meth:`loop.run_in_executor` no longer configures the ``max_workers`` of the " +"thread pool executor it creates, instead leaving it up to the thread pool " +"executor (:class:`~concurrent.futures.ThreadPoolExecutor`) to set the " +"default." +msgstr "" + +msgid "" +"Set *executor* as the default executor used by :meth:`run_in_executor`. " +"*executor* must be an instance of :class:`~concurrent.futures." +"ThreadPoolExecutor`." +msgstr "" + +msgid "" +"*executor* must be an instance of :class:`~concurrent.futures." +"ThreadPoolExecutor`." +msgstr "" + +msgid "Error Handling API" +msgstr "" + +msgid "Allows customizing how exceptions are handled in the event loop." +msgstr "" + +msgid "Set *handler* as the new event loop exception handler." +msgstr "" + +msgid "" +"If *handler* is ``None``, the default exception handler will be set. " +"Otherwise, *handler* must be a callable with the signature matching ``(loop, " +"context)``, where ``loop`` is a reference to the active event loop, and " +"``context`` is a ``dict`` object containing the details of the exception " +"(see :meth:`call_exception_handler` documentation for details about context)." +msgstr "" + +msgid "" +"Return the current exception handler, or ``None`` if no custom exception " +"handler was set." +msgstr "" + +msgid "Default exception handler." +msgstr "" + +msgid "" +"This is called when an exception occurs and no exception handler is set. " +"This can be called by a custom exception handler that wants to defer to the " +"default handler behavior." +msgstr "" + +msgid "" +"*context* parameter has the same meaning as in :meth:" +"`call_exception_handler`." +msgstr "" + +msgid "Call the current event loop exception handler." +msgstr "" + +msgid "" +"*context* is a ``dict`` object containing the following keys (new keys may " +"be introduced in future Python versions):" +msgstr "" + +msgid "'message': Error message;" +msgstr "" + +msgid "'exception' (optional): Exception object;" +msgstr "" + +msgid "'future' (optional): :class:`asyncio.Future` instance;" +msgstr "" + +msgid "'task' (optional): :class:`asyncio.Task` instance;" +msgstr "" + +msgid "'handle' (optional): :class:`asyncio.Handle` instance;" +msgstr "" + +msgid "'protocol' (optional): :ref:`Protocol ` instance;" +msgstr "" + +msgid "'transport' (optional): :ref:`Transport ` instance;" +msgstr "" + +msgid "'socket' (optional): :class:`socket.socket` instance;" +msgstr "" + +msgid "'asyncgen' (optional): Asynchronous generator that caused" +msgstr "" + +msgid "the exception." +msgstr "" + +msgid "" +"This method should not be overloaded in subclassed event loops. For custom " +"exception handling, use the :meth:`set_exception_handler()` method." +msgstr "" + +msgid "Enabling debug mode" +msgstr "" + +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." +msgstr "" + +msgid "Set the debug mode of the event loop." +msgstr "" + +msgid "" +"The new :ref:`Python Development Mode ` can now also be used to " +"enable the debug mode." +msgstr "" + +msgid "" +"This attribute can be used to set the minimum execution duration in seconds " +"that is considered \"slow\". When debug mode is enabled, \"slow\" callbacks " +"are logged." +msgstr "" + +msgid "Default value is 100 milliseconds." +msgstr "" + +msgid "The :ref:`debug mode of asyncio `." +msgstr "" + +msgid "Running Subprocesses" +msgstr "" + +msgid "" +"Methods described in this subsections are low-level. In regular async/await " +"code consider using the high-level :func:`asyncio.create_subprocess_shell` " +"and :func:`asyncio.create_subprocess_exec` convenience functions instead." +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." +msgstr "" + +msgid "" +"Create a subprocess from one or more string arguments specified by *args*." +msgstr "" + +msgid "*args* must be a list of strings represented by:" +msgstr "" + +msgid ":class:`str`;" +msgstr ":class:`str`;" + +msgid "" +"or :class:`bytes`, encoded to the :ref:`filesystem encoding `." +msgstr "" + +msgid "" +"The first string specifies the program executable, and the remaining strings " +"specify the arguments. Together, string arguments form the ``argv`` of the " +"program." +msgstr "" + +msgid "" +"This is similar to the standard library :class:`subprocess.Popen` class " +"called with ``shell=False`` and the list of strings passed as the first " +"argument; however, where :class:`~subprocess.Popen` takes a single argument " +"which is list of strings, *subprocess_exec* takes multiple string arguments." +msgstr "" + +msgid "" +"The *protocol_factory* must be a callable returning a subclass of the :class:" +"`asyncio.SubprocessProtocol` class." +msgstr "" + +msgid "Other parameters:" +msgstr "" + +msgid "*stdin* can be any of these:" +msgstr "" + +msgid "" +"a file-like object representing a pipe to be connected to the subprocess's " +"standard input stream using :meth:`~loop.connect_write_pipe`" +msgstr "" + +msgid "" +"the :const:`subprocess.PIPE` constant (default) which will create a new pipe " +"and connect it," +msgstr "" + +msgid "" +"the value ``None`` which will make the subprocess inherit the file " +"descriptor from this process" +msgstr "" + +msgid "" +"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:" +msgstr "" + +msgid "" +"a file-like object representing a pipe to be connected to the subprocess's " +"standard output stream using :meth:`~loop.connect_write_pipe`" +msgstr "" + +msgid "*stderr* can be any of these:" +msgstr "" + +msgid "" +"a file-like object representing a pipe to be connected to the subprocess's " +"standard error stream using :meth:`~loop.connect_write_pipe`" +msgstr "" + +msgid "" +"the :const:`subprocess.STDOUT` constant which will connect the standard " +"error stream to the process' standard output stream" +msgstr "" + +msgid "" +"All other keyword arguments are passed to :class:`subprocess.Popen` without " +"interpretation, except for *bufsize*, *universal_newlines*, *shell*, *text*, " +"*encoding* and *errors*, which should not be specified at all." +msgstr "" + +msgid "" +"The ``asyncio`` subprocess API does not support decoding the streams as " +"text. :func:`bytes.decode` can be used to convert the bytes returned from " +"the stream to text." +msgstr "" + +msgid "" +"See the constructor of the :class:`subprocess.Popen` class for documentation " +"on other arguments." +msgstr "" + +msgid "" +"Returns a pair of ``(transport, protocol)``, where *transport* conforms to " +"the :class:`asyncio.SubprocessTransport` base class and *protocol* is an " +"object instantiated by the *protocol_factory*." +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 "" + +msgid "" +"This is similar to the standard library :class:`subprocess.Popen` class " +"called with ``shell=True``." +msgstr "" + +msgid "" +"The *protocol_factory* must be a callable returning a subclass of the :class:" +"`SubprocessProtocol` class." +msgstr "" + +msgid "" +"See :meth:`~loop.subprocess_exec` for more details about the remaining " +"arguments." +msgstr "" + +msgid "" +"Returns a pair of ``(transport, protocol)``, where *transport* conforms to " +"the :class:`SubprocessTransport` base class and *protocol* is an object " +"instantiated by the *protocol_factory*." +msgstr "" + +msgid "" +"It is the application's responsibility to ensure that all whitespace and " +"special characters are quoted appropriately to avoid `shell injection " +"`_ " +"vulnerabilities. The :func:`shlex.quote` function can be used to properly " +"escape whitespace and special characters in strings that are going to be " +"used to construct shell commands." +msgstr "" + +msgid "Callback Handles" +msgstr "" + +msgid "" +"A callback wrapper object returned by :meth:`loop.call_soon`, :meth:`loop." +"call_soon_threadsafe`." +msgstr "" + +msgid "" +"Cancel the callback. If the callback has already been canceled or executed, " +"this method has no effect." +msgstr "" + +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`." +msgstr "" + +msgid "This class is a subclass of :class:`Handle`." +msgstr "" + +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`." +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." +msgstr "" + +msgid "Do not instantiate the :class:`Server` class directly." +msgstr "" + +msgid "" +"*Server* objects are asynchronous context managers. When used in an ``async " +"with`` statement, it's guaranteed that the Server object is closed and not " +"accepting new connections when the ``async with`` statement is completed::" +msgstr "" + +msgid "Server object is an asynchronous context manager since Python 3.7." +msgstr "" + +msgid "" +"This class was exposed publicly as ``asyncio.Server`` in Python 3.9.11, " +"3.10.3 and 3.11." +msgstr "" + +msgid "" +"Stop serving: close listening sockets and set the :attr:`sockets` attribute " +"to ``None``." +msgstr "" + +msgid "" +"The sockets that represent existing incoming client connections are left " +"open." +msgstr "" + +msgid "" +"The server is closed asynchronously, use the :meth:`wait_closed` coroutine " +"to wait until the server is closed." +msgstr "" + +msgid "Return the event loop associated with the server object." +msgstr "" + +msgid "Start accepting connections." +msgstr "" + +msgid "" +"This method is idempotent, so it can be called when the server is already " +"serving." +msgstr "" + +msgid "" +"The *start_serving* keyword-only parameter to :meth:`loop.create_server` " +"and :meth:`asyncio.start_server` allows creating a Server object that is not " +"accepting connections initially. In this case ``Server.start_serving()``, " +"or :meth:`Server.serve_forever` can be used to make the Server start " +"accepting connections." +msgstr "" + +msgid "" +"Start accepting connections until the coroutine is cancelled. Cancellation " +"of ``serve_forever`` task causes the server to be closed." +msgstr "" + +msgid "" +"This method can be called if the server is already accepting connections. " +"Only one ``serve_forever`` task can exist per one *Server* object." +msgstr "" + +msgid "Return ``True`` if the server is accepting new connections." +msgstr "" + +msgid "Wait until the :meth:`close` method completes." +msgstr "" + +msgid "" +"List of socket-like objects, ``asyncio.trsock.TransportSocket``, which the " +"server is listening on." +msgstr "" + +msgid "" +"Prior to Python 3.7 ``Server.sockets`` used to return an internal list of " +"server sockets directly. In 3.7 a copy of that list is returned." +msgstr "" + +msgid "Event Loop Implementations" +msgstr "" + +msgid "" +"asyncio ships with two different event loop implementations: :class:" +"`SelectorEventLoop` and :class:`ProactorEventLoop`." +msgstr "" + +msgid "" +"By default asyncio is configured to use :class:`SelectorEventLoop` on Unix " +"and :class:`ProactorEventLoop` on Windows." +msgstr "" + +msgid "An event loop based on the :mod:`selectors` module." +msgstr "" + +msgid "" +"Uses the most efficient *selector* available for the given platform. It is " +"also possible to manually configure the exact selector implementation to be " +"used::" +msgstr "" + +msgid ":ref:`Availability `: Unix, Windows." +msgstr "" + +msgid "An event loop for Windows that uses \"I/O Completion Ports\" (IOCP)." +msgstr "" + +msgid ":ref:`Availability `: Windows." +msgstr "" + +msgid "" +"`MSDN documentation on I/O Completion Ports `_." +msgstr "" + +msgid "Abstract base class for asyncio-compliant event loops." +msgstr "" + +msgid "" +"The :ref:`asyncio-event-loop-methods` section lists all methods that an " +"alternative implementation of ``AbstractEventLoop`` should have defined." +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`." +msgstr "" + +msgid "Hello World with call_soon()" +msgstr "" + +msgid "" +"An example using the :meth:`loop.call_soon` method to schedule a callback. " +"The callback displays ``\"Hello World\"`` and then stops the event loop::" +msgstr "" + +msgid "" +"A similar :ref:`Hello World ` example created with a coroutine " +"and the :func:`run` function." +msgstr "" + +msgid "Display the current date with call_later()" +msgstr "" + +msgid "" +"An example of a callback displaying the current date every second. The " +"callback uses the :meth:`loop.call_later` method to reschedule itself after " +"5 seconds, and then stops the event loop::" +msgstr "" + +msgid "" +"A similar :ref:`current date ` example created with a " +"coroutine and the :func:`run` function." +msgstr "" + +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::" +msgstr "" + +msgid "" +"A similar :ref:`example ` using " +"transports, protocols, and the :meth:`loop.create_connection` method." +msgstr "" + +msgid "" +"Another similar :ref:`example ` " +"using the high-level :func:`asyncio.open_connection` function and streams." +msgstr "" + +msgid "Set signal handlers for SIGINT and SIGTERM" +msgstr "" + +msgid "(This ``signals`` 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::" +msgstr "" diff --git a/library/asyncio-exceptions.po b/library/asyncio-exceptions.po index e179a739d6..9c213aa621 100644 --- a/library/asyncio-exceptions.po +++ b/library/asyncio-exceptions.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid "Exceptions" msgstr "Wyjątki" msgid "**Source code:** :source:`Lib/asyncio/exceptions.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/exceptions.py`" msgid "" "A deprecated alias of :exc:`TimeoutError`, raised when the operation has " @@ -45,7 +45,9 @@ msgid "" "are cancelled. In almost all situations the exception must be re-raised." msgstr "" -msgid ":exc:`CancelledError` is now a subclass of :class:`BaseException`." +msgid "" +":exc:`CancelledError` is now a subclass of :class:`BaseException` rather " +"than :class:`Exception`." msgstr "" msgid "Invalid internal state of :class:`Task` or :class:`Future`." diff --git a/library/asyncio-llapi-index.po b/library/asyncio-llapi-index.po new file mode 100644 index 0000000000..cf776dd341 --- /dev/null +++ b/library/asyncio-llapi-index.po @@ -0,0 +1,794 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Low-level API Index" +msgstr "" + +msgid "This page lists all low-level asyncio APIs." +msgstr "" + +msgid "Obtaining the Event Loop" +msgstr "" + +msgid ":func:`asyncio.get_running_loop`" +msgstr ":func:`asyncio.get_running_loop`" + +msgid "The **preferred** function to get the running event loop." +msgstr "" + +msgid ":func:`asyncio.get_event_loop`" +msgstr ":func:`asyncio.get_event_loop`" + +msgid "Get an event loop instance (running or current via the current policy)." +msgstr "" + +msgid ":func:`asyncio.set_event_loop`" +msgstr ":func:`asyncio.set_event_loop`" + +msgid "Set the event loop as current via the current policy." +msgstr "" + +msgid ":func:`asyncio.new_event_loop`" +msgstr ":func:`asyncio.new_event_loop`" + +msgid "Create a new event loop." +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid ":ref:`Using asyncio.get_running_loop() `." +msgstr "" + +msgid "Event Loop Methods" +msgstr "" + +msgid "" +"See also the main documentation section about the :ref:`asyncio-event-loop-" +"methods`." +msgstr "" + +msgid "Lifecycle" +msgstr "" + +msgid ":meth:`loop.run_until_complete`" +msgstr ":meth:`loop.run_until_complete`" + +msgid "Run a Future/Task/awaitable until complete." +msgstr "" + +msgid ":meth:`loop.run_forever`" +msgstr ":meth:`loop.run_forever`" + +msgid "Run the event loop forever." +msgstr "" + +msgid ":meth:`loop.stop`" +msgstr ":meth:`loop.stop`" + +msgid "Stop the event loop." +msgstr "" + +msgid ":meth:`loop.close`" +msgstr ":meth:`loop.close`" + +msgid "Close the event loop." +msgstr "" + +msgid ":meth:`loop.is_running()`" +msgstr "" + +msgid "Return ``True`` if the event loop is running." +msgstr "" + +msgid ":meth:`loop.is_closed()`" +msgstr "" + +msgid "Return ``True`` if the event loop is closed." +msgstr "" + +msgid "``await`` :meth:`loop.shutdown_asyncgens`" +msgstr "``await`` :meth:`loop.shutdown_asyncgens`" + +msgid "Close asynchronous generators." +msgstr "" + +msgid "Debugging" +msgstr "" + +msgid ":meth:`loop.set_debug`" +msgstr ":meth:`loop.set_debug`" + +msgid "Enable or disable the debug mode." +msgstr "" + +msgid ":meth:`loop.get_debug`" +msgstr ":meth:`loop.get_debug`" + +msgid "Get the current debug mode." +msgstr "" + +msgid "Scheduling Callbacks" +msgstr "" + +msgid ":meth:`loop.call_soon`" +msgstr ":meth:`loop.call_soon`" + +msgid "Invoke a callback soon." +msgstr "" + +msgid ":meth:`loop.call_soon_threadsafe`" +msgstr ":meth:`loop.call_soon_threadsafe`" + +msgid "A thread-safe variant of :meth:`loop.call_soon`." +msgstr "" + +msgid ":meth:`loop.call_later`" +msgstr ":meth:`loop.call_later`" + +msgid "Invoke a callback *after* the given time." +msgstr "" + +msgid ":meth:`loop.call_at`" +msgstr ":meth:`loop.call_at`" + +msgid "Invoke a callback *at* the given time." +msgstr "" + +msgid "Thread/Process Pool" +msgstr "" + +msgid "``await`` :meth:`loop.run_in_executor`" +msgstr "``await`` :meth:`loop.run_in_executor`" + +msgid "" +"Run a CPU-bound or other blocking function in a :mod:`concurrent.futures` " +"executor." +msgstr "" + +msgid ":meth:`loop.set_default_executor`" +msgstr ":meth:`loop.set_default_executor`" + +msgid "Set the default executor for :meth:`loop.run_in_executor`." +msgstr "" + +msgid "Tasks and Futures" +msgstr "" + +msgid ":meth:`loop.create_future`" +msgstr ":meth:`loop.create_future`" + +msgid "Create a :class:`Future` object." +msgstr "" + +msgid ":meth:`loop.create_task`" +msgstr ":meth:`loop.create_task`" + +msgid "Schedule coroutine as a :class:`Task`." +msgstr "" + +msgid ":meth:`loop.set_task_factory`" +msgstr ":meth:`loop.set_task_factory`" + +msgid "" +"Set a factory used by :meth:`loop.create_task` to create :class:`Tasks " +"`." +msgstr "" + +msgid ":meth:`loop.get_task_factory`" +msgstr ":meth:`loop.get_task_factory`" + +msgid "" +"Get the factory :meth:`loop.create_task` uses to create :class:`Tasks " +"`." +msgstr "" + +msgid "DNS" +msgstr "" + +msgid "``await`` :meth:`loop.getaddrinfo`" +msgstr "``await`` :meth:`loop.getaddrinfo`" + +msgid "Asynchronous version of :meth:`socket.getaddrinfo`." +msgstr "" + +msgid "``await`` :meth:`loop.getnameinfo`" +msgstr "``await`` :meth:`loop.getnameinfo`" + +msgid "Asynchronous version of :meth:`socket.getnameinfo`." +msgstr "" + +msgid "Networking and IPC" +msgstr "" + +msgid "``await`` :meth:`loop.create_connection`" +msgstr "``await`` :meth:`loop.create_connection`" + +msgid "Open a TCP connection." +msgstr "" + +msgid "``await`` :meth:`loop.create_server`" +msgstr "``await`` :meth:`loop.create_server`" + +msgid "Create a TCP server." +msgstr "" + +msgid "``await`` :meth:`loop.create_unix_connection`" +msgstr "``await`` :meth:`loop.create_unix_connection`" + +msgid "Open a Unix socket connection." +msgstr "" + +msgid "``await`` :meth:`loop.create_unix_server`" +msgstr "``await`` :meth:`loop.create_unix_server`" + +msgid "Create a Unix socket server." +msgstr "" + +msgid "``await`` :meth:`loop.connect_accepted_socket`" +msgstr "``await`` :meth:`loop.connect_accepted_socket`" + +msgid "Wrap a :class:`~socket.socket` into a ``(transport, protocol)`` pair." +msgstr "" + +msgid "``await`` :meth:`loop.create_datagram_endpoint`" +msgstr "``await`` :meth:`loop.create_datagram_endpoint`" + +msgid "Open a datagram (UDP) connection." +msgstr "" + +msgid "``await`` :meth:`loop.sendfile`" +msgstr "``await`` :meth:`loop.sendfile`" + +msgid "Send a file over a transport." +msgstr "" + +msgid "``await`` :meth:`loop.start_tls`" +msgstr "``await`` :meth:`loop.start_tls`" + +msgid "Upgrade an existing connection to TLS." +msgstr "" + +msgid "``await`` :meth:`loop.connect_read_pipe`" +msgstr "``await`` :meth:`loop.connect_read_pipe`" + +msgid "Wrap a read end of a pipe into a ``(transport, protocol)`` pair." +msgstr "" + +msgid "``await`` :meth:`loop.connect_write_pipe`" +msgstr "``await`` :meth:`loop.connect_write_pipe`" + +msgid "Wrap a write end of a pipe into a ``(transport, protocol)`` pair." +msgstr "" + +msgid "Sockets" +msgstr "" + +msgid "``await`` :meth:`loop.sock_recv`" +msgstr "``await`` :meth:`loop.sock_recv`" + +msgid "Receive data from the :class:`~socket.socket`." +msgstr "" + +msgid "``await`` :meth:`loop.sock_recv_into`" +msgstr "``await`` :meth:`loop.sock_recv_into`" + +msgid "Receive data from the :class:`~socket.socket` into a buffer." +msgstr "" + +msgid "``await`` :meth:`loop.sock_recvfrom`" +msgstr "" + +msgid "Receive a datagram from the :class:`~socket.socket`." +msgstr "" + +msgid "``await`` :meth:`loop.sock_recvfrom_into`" +msgstr "" + +msgid "Receive a datagram from the :class:`~socket.socket` into a buffer." +msgstr "" + +msgid "``await`` :meth:`loop.sock_sendall`" +msgstr "``await`` :meth:`loop.sock_sendall`" + +msgid "Send data to the :class:`~socket.socket`." +msgstr "" + +msgid "``await`` :meth:`loop.sock_sendto`" +msgstr "" + +msgid "Send a datagram via the :class:`~socket.socket` to the given address." +msgstr "" + +msgid "``await`` :meth:`loop.sock_connect`" +msgstr "``await`` :meth:`loop.sock_connect`" + +msgid "Connect the :class:`~socket.socket`." +msgstr "" + +msgid "``await`` :meth:`loop.sock_accept`" +msgstr "``await`` :meth:`loop.sock_accept`" + +msgid "Accept a :class:`~socket.socket` connection." +msgstr "" + +msgid "``await`` :meth:`loop.sock_sendfile`" +msgstr "``await`` :meth:`loop.sock_sendfile`" + +msgid "Send a file over the :class:`~socket.socket`." +msgstr "" + +msgid ":meth:`loop.add_reader`" +msgstr ":meth:`loop.add_reader`" + +msgid "Start watching a file descriptor for read availability." +msgstr "" + +msgid ":meth:`loop.remove_reader`" +msgstr ":meth:`loop.remove_reader`" + +msgid "Stop watching a file descriptor for read availability." +msgstr "" + +msgid ":meth:`loop.add_writer`" +msgstr ":meth:`loop.add_writer`" + +msgid "Start watching a file descriptor for write availability." +msgstr "" + +msgid ":meth:`loop.remove_writer`" +msgstr ":meth:`loop.remove_writer`" + +msgid "Stop watching a file descriptor for write availability." +msgstr "" + +msgid "Unix Signals" +msgstr "" + +msgid ":meth:`loop.add_signal_handler`" +msgstr ":meth:`loop.add_signal_handler`" + +msgid "Add a handler for a :mod:`signal`." +msgstr "" + +msgid ":meth:`loop.remove_signal_handler`" +msgstr ":meth:`loop.remove_signal_handler`" + +msgid "Remove a handler for a :mod:`signal`." +msgstr "" + +msgid "Subprocesses" +msgstr "" + +msgid ":meth:`loop.subprocess_exec`" +msgstr ":meth:`loop.subprocess_exec`" + +msgid "Spawn a subprocess." +msgstr "" + +msgid ":meth:`loop.subprocess_shell`" +msgstr ":meth:`loop.subprocess_shell`" + +msgid "Spawn a subprocess from a shell command." +msgstr "" + +msgid "Error Handling" +msgstr "Przechwytywanie błędów" + +msgid ":meth:`loop.call_exception_handler`" +msgstr ":meth:`loop.call_exception_handler`" + +msgid "Call the exception handler." +msgstr "" + +msgid ":meth:`loop.set_exception_handler`" +msgstr ":meth:`loop.set_exception_handler`" + +msgid "Set a new exception handler." +msgstr "" + +msgid ":meth:`loop.get_exception_handler`" +msgstr ":meth:`loop.get_exception_handler`" + +msgid "Get the current exception handler." +msgstr "" + +msgid ":meth:`loop.default_exception_handler`" +msgstr ":meth:`loop.default_exception_handler`" + +msgid "The default exception handler implementation." +msgstr "" + +msgid "" +":ref:`Using asyncio.new_event_loop() and loop.run_forever() " +"`." +msgstr "" + +msgid ":ref:`Using loop.call_later() `." +msgstr "" + +msgid "" +"Using ``loop.create_connection()`` to implement :ref:`an echo-client " +"`." +msgstr "" + +msgid "" +"Using ``loop.create_connection()`` to :ref:`connect a socket " +"`." +msgstr "" + +msgid "" +":ref:`Using add_reader() to watch an FD for read events " +"`." +msgstr "" + +msgid ":ref:`Using loop.add_signal_handler() `." +msgstr "" + +msgid ":ref:`Using loop.subprocess_exec() `." +msgstr "" + +msgid "Transports" +msgstr "" + +msgid "All transports implement the following methods:" +msgstr "" + +msgid ":meth:`transport.close() `" +msgstr ":meth:`transport.close() `" + +msgid "Close the transport." +msgstr "" + +msgid ":meth:`transport.is_closing() `" +msgstr ":meth:`transport.is_closing() `" + +msgid "Return ``True`` if the transport is closing or is closed." +msgstr "" + +msgid ":meth:`transport.get_extra_info() `" +msgstr ":meth:`transport.get_extra_info() `" + +msgid "Request for information about the transport." +msgstr "" + +msgid ":meth:`transport.set_protocol() `" +msgstr ":meth:`transport.set_protocol() `" + +msgid "Set a new protocol." +msgstr "" + +msgid ":meth:`transport.get_protocol() `" +msgstr ":meth:`transport.get_protocol() `" + +msgid "Return the current protocol." +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:" +msgstr "" + +msgid "Read Transports" +msgstr "" + +msgid ":meth:`transport.is_reading() `" +msgstr ":meth:`transport.is_reading() `" + +msgid "Return ``True`` if the transport is receiving." +msgstr "" + +msgid ":meth:`transport.pause_reading() `" +msgstr ":meth:`transport.pause_reading() `" + +msgid "Pause receiving." +msgstr "" + +msgid ":meth:`transport.resume_reading() `" +msgstr ":meth:`transport.resume_reading() `" + +msgid "Resume receiving." +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:" +msgstr "" + +msgid "Write Transports" +msgstr "" + +msgid ":meth:`transport.write() `" +msgstr ":meth:`transport.write() `" + +msgid "Write data to the transport." +msgstr "" + +msgid ":meth:`transport.writelines() `" +msgstr ":meth:`transport.writelines() `" + +msgid "Write buffers to the transport." +msgstr "" + +msgid ":meth:`transport.can_write_eof() `" +msgstr ":meth:`transport.can_write_eof() `" + +msgid "Return :const:`True` if the transport supports sending EOF." +msgstr "" + +msgid ":meth:`transport.write_eof() `" +msgstr ":meth:`transport.write_eof() `" + +msgid "Close and send EOF after flushing buffered data." +msgstr "" + +msgid ":meth:`transport.abort() `" +msgstr ":meth:`transport.abort() `" + +msgid "Close the transport immediately." +msgstr "" + +msgid "" +":meth:`transport.get_write_buffer_size() `" +msgstr "" +":meth:`transport.get_write_buffer_size() `" + +msgid "Return the current size of the output buffer." +msgstr "" + +msgid "" +":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() `" +msgstr "" +":meth:`transport.set_write_buffer_limits() `" + +msgid "Set new high and low water marks for write flow control." +msgstr "" + +msgid "Transports returned by :meth:`loop.create_datagram_endpoint`:" +msgstr "" + +msgid "Datagram Transports" +msgstr "" + +msgid ":meth:`transport.sendto() `" +msgstr ":meth:`transport.sendto() `" + +msgid "Send data to the remote peer." +msgstr "" + +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`:" +msgstr "" + +msgid "Subprocess Transports" +msgstr "" + +msgid ":meth:`transport.get_pid() `" +msgstr ":meth:`transport.get_pid() `" + +msgid "Return the subprocess process id." +msgstr "" + +msgid "" +":meth:`transport.get_pipe_transport() `" +msgstr "" +":meth:`transport.get_pipe_transport() `" + +msgid "" +"Return the transport for the requested communication pipe (*stdin*, " +"*stdout*, or *stderr*)." +msgstr "" + +msgid ":meth:`transport.get_returncode() `" +msgstr "" +":meth:`transport.get_returncode() `" + +msgid "Return the subprocess return code." +msgstr "" + +msgid ":meth:`transport.kill() `" +msgstr ":meth:`transport.kill() `" + +msgid "Kill the subprocess." +msgstr "" + +msgid ":meth:`transport.send_signal() `" +msgstr ":meth:`transport.send_signal() `" + +msgid "Send a signal to the subprocess." +msgstr "" + +msgid ":meth:`transport.terminate() `" +msgstr ":meth:`transport.terminate() `" + +msgid "Stop the subprocess." +msgstr "" + +msgid ":meth:`transport.close() `" +msgstr ":meth:`transport.close() `" + +msgid "Kill the subprocess and close all pipes." +msgstr "" + +msgid "Protocols" +msgstr "" + +msgid "Protocol classes can implement the following **callback methods**:" +msgstr "" + +msgid "``callback`` :meth:`connection_made() `" +msgstr "``callback`` :meth:`connection_made() `" + +msgid "Called when a connection is made." +msgstr "" + +msgid "``callback`` :meth:`connection_lost() `" +msgstr "``callback`` :meth:`connection_lost() `" + +msgid "Called when the connection is lost or closed." +msgstr "" + +msgid "``callback`` :meth:`pause_writing() `" +msgstr "``callback`` :meth:`pause_writing() `" + +msgid "Called when the transport's buffer goes over the high water mark." +msgstr "" + +msgid "``callback`` :meth:`resume_writing() `" +msgstr "``callback`` :meth:`resume_writing() `" + +msgid "Called when the transport's buffer drains below the low water mark." +msgstr "" + +msgid "Streaming Protocols (TCP, Unix Sockets, Pipes)" +msgstr "" + +msgid "``callback`` :meth:`data_received() `" +msgstr "``callback`` :meth:`data_received() `" + +msgid "Called when some data is received." +msgstr "" + +msgid "``callback`` :meth:`eof_received() `" +msgstr "``callback`` :meth:`eof_received() `" + +msgid "Called when an EOF is received." +msgstr "" + +msgid "Buffered Streaming Protocols" +msgstr "" + +msgid "``callback`` :meth:`get_buffer() `" +msgstr "``callback`` :meth:`get_buffer() `" + +msgid "Called to allocate a new receive buffer." +msgstr "" + +msgid "``callback`` :meth:`buffer_updated() `" +msgstr "" +"``callback`` :meth:`buffer_updated() `" + +msgid "Called when the buffer was updated with the received data." +msgstr "" + +msgid "``callback`` :meth:`eof_received() `" +msgstr "``callback`` :meth:`eof_received() `" + +msgid "Datagram Protocols" +msgstr "" + +msgid "" +"``callback`` :meth:`datagram_received() `" +msgstr "" +"``callback`` :meth:`datagram_received() `" + +msgid "Called when a datagram is received." +msgstr "" + +msgid "``callback`` :meth:`error_received() `" +msgstr "" +"``callback`` :meth:`error_received() `" + +msgid "" +"Called when a previous send or receive operation raises an :class:`OSError`." +msgstr "" + +msgid "Subprocess Protocols" +msgstr "" + +msgid "``callback`` :meth:`~SubprocessProtocol.pipe_data_received`" +msgstr "" + +msgid "" +"Called when the child process writes data into its *stdout* or *stderr* pipe." +msgstr "" + +msgid "``callback`` :meth:`~SubprocessProtocol.pipe_connection_lost`" +msgstr "" + +msgid "" +"Called when one of the pipes communicating with the child process is closed." +msgstr "" + +msgid "" +"``callback`` :meth:`process_exited() `" +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." +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." +msgstr "" + +msgid "Accessing Policies" +msgstr "" + +msgid ":meth:`asyncio.get_event_loop_policy`" +msgstr ":meth:`asyncio.get_event_loop_policy`" + +msgid "Return the current process-wide policy." +msgstr "" + +msgid ":meth:`asyncio.set_event_loop_policy`" +msgstr ":meth:`asyncio.set_event_loop_policy`" + +msgid "Set a new process-wide policy." +msgstr "" + +msgid ":class:`AbstractEventLoopPolicy`" +msgstr ":class:`AbstractEventLoopPolicy`" + +msgid "Base class for policy objects." +msgstr "" diff --git a/library/asyncio-platforms.po b/library/asyncio-platforms.po new file mode 100644 index 0000000000..2742faa25c --- /dev/null +++ b/library/asyncio-platforms.po @@ -0,0 +1,137 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "Platform Support" +msgstr "" + +msgid "" +"The :mod:`asyncio` module is designed to be portable, but some platforms " +"have subtle differences and limitations due to the platforms' underlying " +"architecture and capabilities." +msgstr "" + +msgid "All Platforms" +msgstr "" + +msgid "" +":meth:`loop.add_reader` and :meth:`loop.add_writer` cannot be used to " +"monitor file I/O." +msgstr "" + +msgid "Windows" +msgstr "Windows" + +msgid "" +"**Source code:** :source:`Lib/asyncio/proactor_events.py`, :source:`Lib/" +"asyncio/windows_events.py`, :source:`Lib/asyncio/windows_utils.py`" +msgstr "" +"**Kod źródłowy:** :source:`Lib/asyncio/proactor_events.py`, :source:`Lib/" +"asyncio/windows_events.py`, :source:`Lib/asyncio/windows_utils.py`" + +msgid "On Windows, :class:`ProactorEventLoop` is now the default event loop." +msgstr "" + +msgid "All event loops on Windows do not support the following methods:" +msgstr "" + +msgid "" +":meth:`loop.create_unix_connection` and :meth:`loop.create_unix_server` are " +"not supported. The :const:`socket.AF_UNIX` socket family is specific to Unix." +msgstr "" + +msgid "" +":meth:`loop.add_signal_handler` and :meth:`loop.remove_signal_handler` are " +"not supported." +msgstr "" + +msgid ":class:`SelectorEventLoop` has the following limitations:" +msgstr "" + +msgid "" +":class:`~selectors.SelectSelector` is used to wait on socket events: it " +"supports sockets and is limited to 512 sockets." +msgstr "" + +msgid "" +":meth:`loop.add_reader` and :meth:`loop.add_writer` only accept socket " +"handles (e.g. pipe file descriptors are not supported)." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid ":class:`ProactorEventLoop` has the following limitations:" +msgstr "" + +msgid "" +"The :meth:`loop.add_reader` and :meth:`loop.add_writer` methods are not " +"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 " +"depends on the hardware (availability of `HPET `_) and on the Windows configuration." +msgstr "" + +msgid "Subprocess Support on Windows" +msgstr "" + +msgid "" +"On Windows, the default event loop :class:`ProactorEventLoop` supports " +"subprocesses, whereas :class:`SelectorEventLoop` does not." +msgstr "" + +msgid "" +"The :meth:`policy.set_child_watcher() ` function is also not supported, as :class:" +"`ProactorEventLoop` has a different mechanism to watch child processes." +msgstr "" + +msgid "macOS" +msgstr "" + +msgid "Modern macOS versions are fully supported." +msgstr "" + +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::" +msgstr "" diff --git a/library/asyncio-protocol.po b/library/asyncio-protocol.po index ec90a2ed0f..a25b6ccd7a 100644 --- a/library/asyncio-protocol.po +++ b/library/asyncio-protocol.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -107,7 +105,7 @@ msgid "Transports" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/transports.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/transports.py`" msgid "" "Transports are classes provided by :mod:`asyncio` in order to abstract " @@ -280,7 +278,7 @@ msgid "subprocess:" msgstr "" msgid "``'subprocess'``: :class:`subprocess.Popen` instance" -msgstr "" +msgstr "``'subprocess'``: :class:`subprocess.Popen` instance" msgid "Set a new protocol." msgstr "" @@ -474,8 +472,9 @@ msgid "Stop the subprocess." msgstr "" msgid "" -"On POSIX systems, this method sends SIGTERM to the subprocess. On Windows, " -"the Windows API function TerminateProcess() is called to stop the subprocess." +"On POSIX systems, this method sends :py:const:`~signal.SIGTERM` to the " +"subprocess. On Windows, the Windows API function :c:func:`!TerminateProcess` " +"is called to stop the subprocess." msgstr "" msgid "See also :meth:`subprocess.Popen.terminate`." @@ -493,7 +492,7 @@ msgid "Protocols" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/protocols.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/protocols.py`" msgid "" "asyncio provides a set of abstract base classes that should be used to " @@ -772,6 +771,11 @@ msgstr "" 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." +msgstr "" + msgid "Examples" msgstr "Przykłady" diff --git a/library/asyncio-queue.po b/library/asyncio-queue.po index 06577f410e..859d0676eb 100644 --- a/library/asyncio-queue.po +++ b/library/asyncio-queue.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +27,7 @@ msgid "Queues" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/queues.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/queues.py`" msgid "" "asyncio queues are designed to be similar to classes of the :mod:`queue` " diff --git a/library/asyncio-runner.po b/library/asyncio-runner.po new file mode 100644 index 0000000000..c4e7f095fd --- /dev/null +++ b/library/asyncio-runner.po @@ -0,0 +1,177 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Runners" +msgstr "" + +msgid "**Source code:** :source:`Lib/asyncio/runners.py`" +msgstr "" + +msgid "" +"This section outlines high-level asyncio primitives to run asyncio code." +msgstr "" + +msgid "" +"They are built on top of an :ref:`event loop ` with the " +"aim to simplify async code usage for common wide-spread scenarios." +msgstr "" + +msgid "Running an asyncio Program" +msgstr "" + +msgid "Execute the :term:`coroutine` *coro* and return the result." +msgstr "" + +msgid "" +"This function runs the passed coroutine, taking care of managing the asyncio " +"event loop, *finalizing asynchronous generators*, and closing the threadpool." +msgstr "" + +msgid "" +"This function cannot be called when another asyncio event loop is running in " +"the same thread." +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." +msgstr "" + +msgid "" +"This function always creates a new event loop and closes it at the end. It " +"should be used as a main entry point for asyncio programs, and should " +"ideally only be called once." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "Updated to use :meth:`loop.shutdown_default_executor`." +msgstr "" + +msgid "" +"*debug* is ``None`` by default to respect the global debug mode settings." +msgstr "" + +msgid "Runner context manager" +msgstr "" + +msgid "" +"A context manager that simplifies *multiple* async function calls in the " +"same context." +msgstr "" + +msgid "" +"Sometimes several top-level async functions should be called in the same :" +"ref:`event loop ` and :class:`contextvars.Context`." +msgstr "" + +msgid "" +"*loop_factory* could be used for overriding the loop creation. It is the " +"responsibility of the *loop_factory* to set the created loop as the current " +"one. By default :func:`asyncio.new_event_loop` is used and set as current " +"event loop with :func:`asyncio.set_event_loop` if *loop_factory* is ``None``." +msgstr "" + +msgid "" +"Basically, :func:`asyncio.run()` example can be rewritten with the runner " +"usage::" +msgstr "" + +msgid "Run a :term:`coroutine ` *coro* in the embedded loop." +msgstr "" + +msgid "Return the coroutine's result or raise its exception." +msgstr "" + +msgid "" +"An optional keyword-only *context* argument allows specifying a custom :" +"class:`contextvars.Context` for the *coro* to run in. The runner's default " +"context is used if ``None``." +msgstr "" + +msgid "Close the runner." +msgstr "" + +msgid "" +"Finalize asynchronous generators, shutdown default executor, close the event " +"loop and release embedded :class:`contextvars.Context`." +msgstr "" + +msgid "Return the event loop associated with the runner instance." +msgstr "" + +msgid "" +":class:`Runner` uses the lazy initialization strategy, its constructor " +"doesn't initialize underlying low-level structures." +msgstr "" + +msgid "" +"Embedded *loop* and *context* are created at the :keyword:`with` body " +"entering or the first call of :meth:`run` or :meth:`get_loop`." +msgstr "" + +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." +msgstr "" + +msgid "" +"To mitigate this issue, :mod:`asyncio` handles :const:`signal.SIGINT` as " +"follows:" +msgstr "" + +msgid "" +":meth:`asyncio.Runner.run` installs a custom :const:`signal.SIGINT` handler " +"before any user code is executed and removes it when exiting from the " +"function." +msgstr "" + +msgid "" +"The :class:`~asyncio.Runner` creates the main task for the passed coroutine " +"for its execution." +msgstr "" + +msgid "" +"When :const:`signal.SIGINT` is raised by :kbd:`Ctrl-C`, the custom signal " +"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`." +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." +msgstr "" diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po index 55b5771a85..4de2fbe643 100644 --- a/library/asyncio-stream.po +++ b/library/asyncio-stream.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid "Streams" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/streams.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/streams.py`" msgid "" "Streams are high-level async/await-ready primitives to work with network " @@ -78,7 +78,7 @@ msgstr "" msgid "Added the *ssl_handshake_timeout* parameter." msgstr "" -msgid "Added *happy_eyeballs_delay* and *interleave* parameters." +msgid "Added the *happy_eyeballs_delay* and *interleave* parameters." msgstr "" msgid "Removed the *loop* parameter." @@ -164,6 +164,9 @@ msgid "" "func:`open_connection` and :func:`start_server` instead." msgstr "" +msgid "Acknowledge the EOF." +msgstr "" + msgid "Read up to *n* bytes from the stream." msgstr "" diff --git a/library/asyncio-subprocess.po b/library/asyncio-subprocess.po index 4e11263caa..c06aed6f1d 100644 --- a/library/asyncio-subprocess.po +++ b/library/asyncio-subprocess.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Michał Biliński , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Michał Biliński , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +30,8 @@ msgid "" "**Source code:** :source:`Lib/asyncio/subprocess.py`, :source:`Lib/asyncio/" "base_subprocess.py`" msgstr "" +"**Kod źródłowy:** :source:`Lib/asyncio/subprocess.py`, :source:`Lib/asyncio/" +"base_subprocess.py`" msgid "" "This section describes high-level async/await asyncio APIs to create and " @@ -63,7 +64,7 @@ msgstr "" msgid "" "The *limit* argument sets the buffer limit for :class:`StreamReader` " -"wrappers for :attr:`Process.stdout` and :attr:`Process.stderr` (if :attr:" +"wrappers for :attr:`Process.stdout` and :attr:`Process.stderr` (if :const:" "`subprocess.PIPE` is passed to *stdout* and *stderr* arguments)." msgstr "" @@ -241,7 +242,7 @@ msgid "Sends the signal *signal* to the child process." msgstr "" msgid "" -"On Windows, :py:data:`SIGTERM` is an alias for :meth:`terminate`. " +"On Windows, :py:const:`~signal.SIGTERM` is an alias for :meth:`terminate`. " "``CTRL_C_EVENT`` and ``CTRL_BREAK_EVENT`` can be sent to processes started " "with a *creationflags* parameter which includes ``CREATE_NEW_PROCESS_GROUP``." msgstr "" @@ -250,12 +251,12 @@ msgid "Stop the child process." msgstr "" msgid "" -"On POSIX systems this method sends :py:data:`signal.SIGTERM` to the child " +"On POSIX systems this method sends :py:const:`~signal.SIGTERM` to the child " "process." msgstr "" msgid "" -"On Windows the Win32 API function :c:func:`TerminateProcess` is called to " +"On Windows the Win32 API function :c:func:`!TerminateProcess` is called to " "stop the child process." msgstr "" diff --git a/library/asyncio-sync.po b/library/asyncio-sync.po index 968ca45fd6..158b457c7c 100644 --- a/library/asyncio-sync.po +++ b/library/asyncio-sync.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid "Synchronization Primitives" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/locks.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/locks.py`" msgid "" "asyncio synchronization primitives are designed to be similar to those of " @@ -49,22 +49,22 @@ msgid "asyncio has the following basic synchronization primitives:" msgstr "" msgid ":class:`Lock`" -msgstr "" +msgstr ":class:`Lock`" msgid ":class:`Event`" -msgstr "" +msgstr ":class:`Event`" msgid ":class:`Condition`" -msgstr "" +msgstr ":class:`Condition`" msgid ":class:`Semaphore`" -msgstr "" +msgstr ":class:`Semaphore`" msgid ":class:`BoundedSemaphore`" -msgstr "" +msgstr ":class:`BoundedSemaphore`" msgid ":class:`Barrier`" -msgstr "" +msgstr ":class:`Barrier`" msgid "Lock" msgstr "" @@ -135,7 +135,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "Wait until the event is set." msgstr "" diff --git a/library/asyncio-task.po b/library/asyncio-task.po index 1f527191ad..17ed0e6d1e 100644 --- a/library/asyncio-task.po +++ b/library/asyncio-task.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.10\n" +"Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-04 14:28+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Maciej Olko , 2021\n" -"Language-Team: Polish (https://www.transifex.com/python-doc/teams/5390/pl/)\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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" @@ -34,6 +34,9 @@ msgstr "" msgid "Coroutines" msgstr "" +msgid "**Source code:** :source:`Lib/asyncio/coroutines.py`" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/coroutines.py`" + msgid "" ":term:`Coroutines ` declared with the async/await syntax is the " "preferred way of writing asyncio applications. For example, the following " @@ -44,7 +47,7 @@ msgid "" "Note that simply calling a coroutine will not schedule it to be executed::" msgstr "" -msgid "To actually run a coroutine, asyncio provides three main mechanisms:" +msgid "To actually run a coroutine, asyncio provides the following mechanisms:" msgstr "" msgid "" @@ -76,6 +79,17 @@ msgid "" "than before::" msgstr "" +msgid "" +"The :class:`asyncio.TaskGroup` class provides a more modern alternative to :" +"func:`create_task`. Using this API, the last example becomes::" +msgstr "" + +msgid "The timing and output should be the same as for the previous version." +msgstr "" + +msgid ":class:`asyncio.TaskGroup`." +msgstr ":class:`asyncio.TaskGroup`." + msgid "Awaitables" msgstr "" @@ -107,11 +121,6 @@ msgid "" "a *coroutine object*: an object returned by calling a *coroutine function*." msgstr "" -msgid "" -"asyncio also supports legacy :ref:`generator-based " -"` coroutines." -msgstr "" - msgid "Tasks" msgstr "" @@ -156,69 +165,143 @@ msgid "" "`loop.run_in_executor`." msgstr "" -msgid "Running an asyncio Program" +msgid "Creating Tasks" msgstr "" -msgid "Execute the :term:`coroutine` *coro* and return the result." +msgid "**Source code:** :source:`Lib/asyncio/tasks.py`" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/tasks.py`" + +msgid "" +"Wrap the *coro* :ref:`coroutine ` into a :class:`Task` and " +"schedule its execution. Return the Task object." msgstr "" msgid "" -"This function runs the passed coroutine, taking care of managing the asyncio " -"event loop, *finalizing asynchronous generators*, and closing the threadpool." +"If *name* is not ``None``, it is set as the name of the task using :meth:" +"`Task.set_name`." msgstr "" msgid "" -"This function cannot be called when another asyncio event loop is running in " -"the same thread." +"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 "If *debug* is ``True``, the event loop will be run in debug mode." +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." msgstr "" msgid "" -"This function always creates a new event loop and closes it at the end. It " -"should be used as a main entry point for asyncio programs, and should " -"ideally only be called once." +":meth:`asyncio.TaskGroup.create_task` is a newer alternative that allows for " +"convenient waiting for a group of related tasks." msgstr "" -msgid "Example::" +msgid "" +"Save a reference to the result of this function, to avoid a task " +"disappearing mid-execution. The event loop only keeps weak references to " +"tasks. A task that isn't referenced elsewhere may get garbage collected at " +"any time, even before it's done. For reliable \"fire-and-forget\" background " +"tasks, gather them in a collection::" +msgstr "" + +msgid "Added the *name* parameter." +msgstr "" + +msgid "Added the *context* parameter." msgstr "" -msgid "Updated to use :meth:`loop.shutdown_default_executor`." +msgid "Task Cancellation" msgstr "" msgid "" -"The source code for ``asyncio.run()`` can be found in :source:`Lib/asyncio/" -"runners.py`." +"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 "Creating Tasks" +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." msgstr "" msgid "" -"Wrap the *coro* :ref:`coroutine ` into a :class:`Task` and " -"schedule its execution. Return the Task object." +"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" msgstr "" msgid "" -"If *name* is not ``None``, it is set as the name of the task using :meth:" -"`Task.set_name`." +"Task groups combine a task creation API with a convenient and reliable way " +"to wait for all tasks in the group to finish." 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." +"An :ref:`asynchronous context manager ` holding a " +"group of tasks. Tasks can be added to the group using :meth:`create_task`. " +"All tasks are awaited when the context manager exits." msgstr "" msgid "" -"Save a reference to the result of this function, to avoid a task " -"disappearing mid-execution. The event loop only keeps weak references to " -"tasks. A task that isn't referenced elsewhere may get garbage collected at " -"any time, even before it's done. For reliable \"fire-and-forget\" background " -"tasks, gather them in a collection::" +"Create a task in this task group. The signature matches that of :func:" +"`asyncio.create_task`." msgstr "" -msgid "Added the *name* parameter." +msgid "Example::" +msgstr "Przykład::" + +msgid "" +"The ``async with`` statement will wait for all tasks in the group to finish. " +"While waiting, new tasks may still be added to the group (for example, by " +"passing ``tg`` into one of the coroutines and calling ``tg.create_task()`` " +"in that coroutine). Once the last task has finished and the ``async with`` " +"block is exited, no new tasks may be added to the group." +msgstr "" + +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." +msgstr "" + +msgid "" +"Once all tasks have finished, if any tasks have failed with an exception " +"other than :exc:`asyncio.CancelledError`, those exceptions are combined in " +"an :exc:`ExceptionGroup` or :exc:`BaseExceptionGroup` (as appropriate; see " +"their documentation) which is then raised." +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`." +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." msgstr "" msgid "Sleeping" @@ -242,12 +325,6 @@ msgid "" "loop for the full duration of the function call." msgstr "" -msgid "" -"The ``loop`` parameter. This function has been implicitly getting the " -"current running loop since 3.7. See :ref:`What's New in 3.10's Removed " -"section ` for more information." -msgstr "" - msgid "" "Example of coroutine displaying the current date every second for 5 seconds::" msgstr "" @@ -298,6 +375,11 @@ msgid "" "submitted Task/Future to cause other Tasks/Futures to be cancelled." msgstr "" +msgid "" +"A more modern way to create and run tasks concurrently and wait for their " +"completion is :class:`asyncio.TaskGroup`." +msgstr "" + msgid "" "If *return_exceptions* is False, cancelling gather() after it has been " "marked done won't cancel any submitted awaitables. For instance, gather can " @@ -368,6 +450,79 @@ msgstr "" msgid "Timeouts" msgstr "" +msgid "" +"Return an :ref:`asynchronous context manager ` that " +"can be used to limit the amount of time spent waiting on something." +msgstr "" + +msgid "" +"*delay* can either be ``None``, or a float/int number of seconds to wait. If " +"*delay* is ``None``, no time limit will be applied; this can be useful if " +"the delay is unknown when the context manager is created." +msgstr "" + +msgid "" +"In either case, the context manager can be rescheduled after creation using :" +"meth:`Timeout.reschedule`." +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." +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." +msgstr "" + +msgid "Example of catching :exc:`TimeoutError`::" +msgstr "" + +msgid "" +"The context manager produced by :func:`asyncio.timeout` can be rescheduled " +"to a different deadline and inspected." +msgstr "" + +msgid "" +"An :ref:`asynchronous context manager ` for " +"cancelling overdue coroutines." +msgstr "" + +msgid "" +"``when`` should be an absolute time at which the context should time out, as " +"measured by the event loop's clock:" +msgstr "" + +msgid "If ``when`` is ``None``, the timeout will never trigger." +msgstr "" + +msgid "" +"If ``when < loop.time()``, the timeout will trigger on the next iteration of " +"the event loop." +msgstr "" + +msgid "" +"Return the current deadline, or ``None`` if the current deadline is not set." +msgstr "" + +msgid "Reschedule the timeout." +msgstr "" + +msgid "Return whether the context manager has exceeded its deadline (expired)." +msgstr "" + +msgid "Timeout context managers can be safely nested." +msgstr "" + +msgid "" +"Similar to :func:`asyncio.timeout`, except *when* is the absolute time to " +"stop waiting, or ``None``." +msgstr "" + msgid "" "Wait for the *aw* :ref:`awaitable ` to complete with a " "timeout." @@ -379,8 +534,7 @@ msgid "" msgstr "" msgid "" -"If a timeout occurs, it cancels the task and raises :exc:`asyncio." -"TimeoutError`." +"If a timeout occurs, it cancels the task and raises :exc:`TimeoutError`." msgstr "" msgid "" @@ -399,18 +553,24 @@ msgstr "" msgid "" "When *aw* is cancelled due to a timeout, ``wait_for`` waits for *aw* to be " -"cancelled. Previously, it raised :exc:`asyncio.TimeoutError` immediately." +"cancelled. Previously, it raised :exc:`TimeoutError` immediately." +msgstr "" + +msgid "Raises :exc:`TimeoutError` instead of :exc:`asyncio.TimeoutError`." msgstr "" msgid "Waiting Primitives" msgstr "" msgid "" -"Run :ref:`awaitable objects ` in the *aws* iterable " -"concurrently and block until the condition specified by *return_when*." +"Run :class:`~asyncio.Future` and :class:`~asyncio.Task` instances in the " +"*aws* iterable concurrently and block until the condition specified by " +"*return_when*." msgstr "" -msgid "The *aws* iterable must not be empty." +msgid "" +"The *aws* iterable must not be empty and generators yielding tasks are not " +"accepted." msgstr "" msgid "Returns two sets of Tasks/Futures: ``(done, pending)``." @@ -425,9 +585,9 @@ msgid "" msgstr "" msgid "" -"Note that this function does not raise :exc:`asyncio.TimeoutError`. Futures " -"or Tasks that aren't done when the timeout occurs are simply returned in the " -"second set." +"Note that this function does not raise :exc:`TimeoutError`. Futures or Tasks " +"that aren't done when the timeout occurs are simply returned in the second " +"set." msgstr "" msgid "" @@ -441,24 +601,15 @@ msgstr "Stała" msgid "Description" msgstr "Opis" -msgid ":const:`FIRST_COMPLETED`" -msgstr "" - msgid "The function will return when any future finishes or is cancelled." msgstr "" -msgid ":const:`FIRST_EXCEPTION`" -msgstr "" - msgid "" -"The function will return when any future finishes by raising an exception. " +"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`." msgstr "" -msgid ":const:`ALL_COMPLETED`" -msgstr "" - msgid "The function will return when all futures finish or are cancelled." msgstr "" @@ -467,34 +618,18 @@ msgid "" "when a timeout occurs." msgstr "" -msgid "" -"If any awaitable in *aws* is a coroutine, it is automatically scheduled as a " -"Task. Passing coroutines objects to ``wait()`` directly is deprecated as it " -"leads to :ref:`confusing behavior `." -msgstr "" - -msgid "" -"``wait()`` schedules coroutines as Tasks automatically and later returns " -"those implicitly created Task objects in ``(done, pending)`` sets. " -"Therefore the following code won't work as expected::" -msgstr "" - -msgid "Here is how the above snippet can be fixed::" -msgstr "" - -msgid "Passing coroutine objects to ``wait()`` directly is deprecated." +msgid "Passing coroutine objects to ``wait()`` directly is forbidden." msgstr "" msgid "" "Run :ref:`awaitable objects ` in the *aws* iterable " -"concurrently. Return an iterator of coroutines. Each coroutine returned can " -"be awaited to get the earliest next result from the iterable of the " -"remaining awaitables." +"concurrently. Generators yielding tasks are not accepted as *aws* iterable. " +"Return an iterator of coroutines. Each coroutine returned can be awaited to " +"get the earliest next result from the iterable of the remaining awaitables." msgstr "" msgid "" -"Raises :exc:`asyncio.TimeoutError` if the timeout occurs before all Futures " -"are done." +"Raises :exc:`TimeoutError` if the timeout occurs before all Futures are done." msgstr "" msgid "" @@ -522,7 +657,7 @@ msgstr "" msgid "" "This coroutine function is primarily intended to be used for executing IO-" "bound functions/methods that would otherwise block the event loop if they " -"were ran in the main thread. For example::" +"were run in the main thread. For example::" msgstr "" msgid "" @@ -591,6 +726,9 @@ msgid "" "loop." msgstr "" +msgid "Return ``True`` if *obj* is a coroutine object." +msgstr "" + msgid "Task Object" msgstr "" @@ -637,9 +775,10 @@ msgid "" msgstr "" msgid "" -"Tasks support the :mod:`contextvars` module. When a Task is created it " -"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 "Added support for the :mod:`contextvars` module." @@ -650,40 +789,6 @@ msgid "" "running event loop." msgstr "" -msgid "Request the Task to be cancelled." -msgstr "" - -msgid "" -"This arranges for a :exc:`CancelledError` exception to be thrown into the " -"wrapped coroutine on the next cycle of the event loop." -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." -msgstr "" - -msgid "Added the *msg* parameter." -msgstr "" - -msgid "" -"The following example illustrates how coroutines can intercept the " -"cancellation request::" -msgstr "" - -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." -msgstr "" - msgid "Return ``True`` if the Task is *done*." msgstr "" @@ -778,7 +883,7 @@ msgstr "" msgid "" "The *file* argument is an I/O stream to which the output is written; by " -"default output is written to :data:`sys.stderr`." +"default output is written to :data:`sys.stdout`." msgstr "" msgid "Return the coroutine object wrapped by the :class:`Task`." @@ -804,52 +909,92 @@ msgid "" "`repr` output of a task object." msgstr "" -msgid "Generator-based Coroutines" +msgid "Request the Task to be cancelled." msgstr "" msgid "" -"Support for generator-based coroutines is **deprecated** and is removed in " -"Python 3.11." +"This arranges for a :exc:`CancelledError` exception to be thrown into the " +"wrapped coroutine on the next cycle of the event loop." msgstr "" msgid "" -"Generator-based coroutines predate async/await syntax. They are Python " -"generators that use ``yield from`` expressions to await on Futures and other " -"coroutines." +"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." +msgstr "" + +msgid "Added the *msg* parameter." +msgstr "" + +msgid "The ``msg`` parameter is propagated from cancelled task to its awaiter." +msgstr "" + +msgid "" +"The following example illustrates how coroutines can intercept the " +"cancellation request::" +msgstr "" + +msgid "Return ``True`` if the Task is *cancelled*." msgstr "" msgid "" -"Generator-based coroutines should be decorated with :func:`@asyncio." -"coroutine `, although this is not enforced." +"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 "Decorator to mark generator-based coroutines." +msgid "Decrement the count of cancellation requests to this Task." +msgstr "" + +msgid "Returns the remaining number of cancellation requests." msgstr "" msgid "" -"This decorator enables legacy generator-based coroutines to be compatible " -"with async/await code::" +"Note that once execution of a cancelled task completed, further calls to :" +"meth:`uncancel` are ineffective." msgstr "" -msgid "This decorator should not be used for :keyword:`async def` coroutines." +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::" msgstr "" -msgid "Use :keyword:`async def` instead." +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." msgstr "" -msgid "Return ``True`` if *obj* is a :ref:`coroutine object `." +msgid "" +"If end-user code is, for some reason, suppresing cancellation by catching :" +"exc:`CancelledError`, it needs to call this method to remove the " +"cancellation state." msgstr "" msgid "" -"This method is different from :func:`inspect.iscoroutine` because it returns " -"``True`` for generator-based coroutines." +"Return the number of pending cancellation requests to this Task, i.e., the " +"number of calls to :meth:`cancel` less the number of :meth:`uncancel` calls." msgstr "" -msgid "Return ``True`` if *func* is a :ref:`coroutine function `." +msgid "" +"Note that if this number is greater than zero but the Task is still " +"executing, :meth:`cancelled` will still return ``False``. This is because " +"this number can be lowered by calling :meth:`uncancel`, which can lead to " +"the task not being cancelled after all if the cancellation requests go down " +"to zero." msgstr "" msgid "" -"This method is different from :func:`inspect.iscoroutinefunction` because it " -"returns ``True`` for generator-based coroutine functions decorated with :" -"func:`@coroutine `." +"This method is used by asyncio's internals and isn't expected to be used by " +"end-user code. See :meth:`uncancel` for more details." msgstr "" diff --git a/library/asyncore.po b/library/asyncore.po index e31314dfb1..a9d85faf70 100644 --- a/library/asyncore.po +++ b/library/asyncore.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:12+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/audit_events.po b/library/audit_events.po new file mode 100644 index 0000000000..d7dd77ef36 --- /dev/null +++ b/library/audit_events.po @@ -0,0 +1,105 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "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`)." +msgstr "" + +msgid "" +"See :func:`sys.addaudithook` and :c:func:`PySys_AddAuditHook` for " +"information on handling these events." +msgstr "" + +msgid "" +"This table is generated from the CPython documentation, and may not " +"represent events raised by other implementations. See your runtime specific " +"documentation for actual events raised." +msgstr "" + +msgid "" +"The following events are raised internally and do not correspond to any " +"public API of CPython:" +msgstr "" + +msgid "Audit event" +msgstr "" + +msgid "Arguments" +msgstr "" + +msgid "_winapi.CreateFile" +msgstr "" + +msgid "" +"``file_name``, ``desired_access``, ``share_mode``, ``creation_disposition``, " +"``flags_and_attributes``" +msgstr "" + +msgid "_winapi.CreateJunction" +msgstr "" + +msgid "``src_path``, ``dst_path``" +msgstr "" + +msgid "_winapi.CreateNamedPipe" +msgstr "" + +msgid "``name``, ``open_mode``, ``pipe_mode``" +msgstr "" + +msgid "_winapi.CreatePipe" +msgstr "" + +msgid "_winapi.CreateProcess" +msgstr "" + +msgid "``application_name``, ``command_line``, ``current_directory``" +msgstr "" + +msgid "_winapi.OpenProcess" +msgstr "" + +msgid "``process_id``, ``desired_access``" +msgstr "" + +msgid "_winapi.TerminateProcess" +msgstr "" + +msgid "``handle``, ``exit_code``" +msgstr "" + +msgid "ctypes.PyObj_FromPtr" +msgstr "" + +msgid "``obj``" +msgstr "``obj``" + +msgid "audit events" +msgstr "" diff --git a/library/base64.po b/library/base64.po index c6810c1148..93fc567aca 100644 --- a/library/base64.po +++ b/library/base64.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid ":mod:`base64` --- Base16, Base32, Base64, Base85 Data Encodings" msgstr "" msgid "**Source code:** :source:`Lib/base64.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/base64.py`" msgid "" "This module provides functions for encoding binary data to printable ASCII " diff --git a/library/binascii.po b/library/binascii.po index 8d5e06d987..dd778e6e0f 100644 --- a/library/binascii.po +++ b/library/binascii.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/binhex.po b/library/binhex.po deleted file mode 100644 index 9f02ec381a..0000000000 --- a/library/binhex.po +++ /dev/null @@ -1,101 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2022, Python Software Foundation -# This file is distributed under the same license as the Python package. -# FIRST AUTHOR , YEAR. -# -# Translators: -# Maciej Olko , 2021 -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: Python 3.10\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2022-11-05 16:26+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Maciej Olko , 2021\n" -"Language-Team: 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:`binhex` --- Encode and decode binhex4 files" -msgstr ":mod:`binhex` --- Koduj i dekoduj pliki binhex4" - -msgid "**Source code:** :source:`Lib/binhex.py`" -msgstr "" - -msgid "" -"This module encodes and decodes files in binhex4 format, a format allowing " -"representation of Macintosh files in ASCII. Only the data fork is handled." -msgstr "" -"Ten moduł koduje i dekoduje pliki w formacie binhex4, formacie pozwalającym " -"reprezentację plików Macintosha w ASCII. Tylko rozwidlenie danych jest " -"obsługiwane." - -msgid "The :mod:`binhex` module defines the following functions:" -msgstr "moduł :mod:`binhex` definiuje następujące funkcje:" - -msgid "" -"Convert a binary file with filename *input* to binhex file *output*. The " -"*output* parameter can either be a filename or a file-like object (any " -"object supporting a :meth:`write` and :meth:`close` method)." -msgstr "" -"Zamień plik binarny z nazwą pliku *input* do pliku binhex *output*. Parametr " -"*output* może albo być nazwą pliku lub obiektem podobnym do pliku (dowolny " -"obiekt wspierający metody :meth:`write` i :meth:`close`)." - -msgid "" -"Decode a binhex file *input*. *input* may be a filename or a file-like " -"object supporting :meth:`read` and :meth:`close` methods. The resulting file " -"is written to a file named *output*, unless the argument is ``None`` in " -"which case the output filename is read from the binhex file." -msgstr "" -"Dekoduj plik binhex *input*. *input* może być nazwą pliku lub obiektem " -"podobnym do pliku wspierającym metody :meth:`read` i :meth:`close`. " -"Wynikający plik jest zapisywany do pliku nazwanego *output*, chyba, że " -"parametr jest ``None``, w którym przypadku nazwa pliku jest wczytywana z " -"pliku binhex." - -msgid "The following exception is also defined:" -msgstr "Zdefiniowany jest także następujący wyjątek:" - -msgid "" -"Exception raised when something can't be encoded using the binhex format " -"(for example, a filename is too long to fit in the filename field), or when " -"input is not properly encoded binhex data." -msgstr "" -"Wyjątek zgłaszany gdy coś nie może być zakodowane używając formatu binhex " -"(dla przykładu, nazwa pliku jest za długa aby dopasować do pola nazwy " -"pliku), lub gdy wejście nie jest poprawnie zakodowanymi danymi binhex." - -msgid "Module :mod:`binascii`" -msgstr "" - -msgid "" -"Support module containing ASCII-to-binary and binary-to-ASCII conversions." -msgstr "" -"Wspierający moduł zawierający konwersję ASCII-do-binarnego i binarnego-do-" -"ASCII." - -msgid "Notes" -msgstr "Notatki" - -msgid "" -"There is an alternative, more powerful interface to the coder and decoder, " -"see the source for details." -msgstr "" -"Istnieje alternatywny, bardziej silny interfejs kodera i dekodera, zobacz " -"źródło dla szczegółów." - -msgid "" -"If you code or decode textfiles on non-Macintosh platforms they will still " -"use the old Macintosh newline convention (carriage-return as end of line)." -msgstr "" -"Jeśli kodujesz lub dekodujesz pliki tekstowe na maszynie/środowisku nie-" -"Macintoshu one będą wciąż używały starej konwencji znaków nowego wiersza z " -"Macintosha (powrót-karetki jako końca linii)." diff --git a/library/bisect.po b/library/bisect.po index fcc84db9ea..5b8578df7f 100644 --- a/library/bisect.po +++ b/library/bisect.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid ":mod:`bisect` --- Array bisection algorithm" msgstr ":mod:`bisect` --- algorytm bisekcji tablicy" msgid "**Source code:** :source:`Lib/bisect.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/bisect.py`" msgid "" "This module provides support for maintaining a list in sorted order without " @@ -94,7 +94,7 @@ msgstr "" msgid "" "This function first runs :py:func:`~bisect.bisect_left` to locate an " -"insertion point. Next, it runs the :meth:`insert` method on *a* to insert " +"insertion point. Next, it runs the :meth:`!insert` method on *a* to insert " "*x* at the appropriate position to maintain sort order." msgstr "" @@ -104,8 +104,8 @@ msgid "" msgstr "" msgid "" -"Keep in mind that the ``O(log n)`` search is dominated by the slow O(n) " -"insertion step." +"Keep in mind that the *O*\\ (log *n*) search is dominated by the slow *O*\\ " +"(*n*) insertion step." msgstr "" msgid "" @@ -115,7 +115,7 @@ msgstr "" msgid "" "This function first runs :py:func:`~bisect.bisect_right` to locate an " -"insertion point. Next, it runs the :meth:`insert` method on *a* to insert " +"insertion point. Next, it runs the :meth:`!insert` method on *a* to insert " "*x* at the appropriate position to maintain sort order." msgstr "" @@ -133,8 +133,8 @@ msgid "" msgstr "" msgid "" -"The *insort()* functions are ``O(n)`` because the logarithmic search step is " -"dominated by the linear time insertion step." +"The *insort()* functions are *O*\\ (*n*) because the logarithmic search step " +"is dominated by the linear time insertion step." msgstr "" msgid "" diff --git a/library/bz2.po b/library/bz2.po index 1ce6d001b7..41bc030c36 100644 --- a/library/bz2.po +++ b/library/bz2.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid ":mod:`bz2` --- Support for :program:`bzip2` compression" msgstr "" msgid "**Source code:** :source:`Lib/bz2.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/bz2.py`" msgid "" "This module provides a comprehensive interface for compressing and " @@ -130,11 +130,11 @@ msgstr "" msgid "" ":class:`BZ2File` provides all of the members specified by the :class:`io." -"BufferedIOBase`, except for :meth:`detach` and :meth:`truncate`. Iteration " -"and the :keyword:`with` statement are supported." +"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 method:" +msgid ":class:`BZ2File` also provides the following methods:" msgstr "" msgid "" @@ -150,12 +150,34 @@ msgid "" "*filename*)." msgstr "" -msgid "Support for the :keyword:`with` statement was added." +msgid "Return the file descriptor for the underlying file." +msgstr "" + +msgid "Return whether the file was opened for reading." +msgstr "" + +msgid "Return whether the file supports seeking." +msgstr "" + +msgid "Return whether the file was opened for writing." msgstr "" msgid "" -"The :meth:`fileno`, :meth:`readable`, :meth:`seekable`, :meth:`writable`, :" -"meth:`read1` and :meth:`readinto` methods were added." +"Read up to *size* uncompressed bytes, while trying to avoid making multiple " +"reads from the underlying stream. Reads up to a buffer's worth of data if " +"size is negative." +msgstr "" + +msgid "Returns ``b''`` if the file is at EOF." +msgstr "" + +msgid "Read bytes into *b*." +msgstr "" + +msgid "Returns the number of bytes read (0 for EOF)." +msgstr "" + +msgid "Support for the :keyword:`with` statement was added." msgstr "" msgid "" diff --git a/library/cgi.po b/library/cgi.po index 4d123827a7..9fb9fd42d0 100644 --- a/library/cgi.po +++ b/library/cgi.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -804,7 +803,7 @@ msgstr "" "przeglądarki jest nużące i podatne na błędy." msgid "WWW" -msgstr "" +msgstr "WWW" msgid "server" msgstr "" diff --git a/library/chunk.po b/library/chunk.po index f550653ffc..d99c942333 100644 --- a/library/chunk.po +++ b/library/chunk.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/cmath.po b/library/cmath.po index 77e39fa6dd..40964377bc 100644 --- a/library/cmath.po +++ b/library/cmath.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Michał Biliński , 2021 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -31,18 +30,11 @@ msgid "" "This module provides access to mathematical functions for complex numbers. " "The functions in this module accept integers, floating-point numbers or " "complex numbers as arguments. They will also accept any Python object that " -"has either a :meth:`__complex__` or a :meth:`__float__` method: these " -"methods are used to convert the object to a complex or floating-point " -"number, respectively, and the function is then applied to the result of the " -"conversion." +"has either a :meth:`~object.__complex__` or a :meth:`~object.__float__` " +"method: these methods are used to convert the object to a complex or " +"floating-point number, respectively, and the function is then applied to the " +"result of the conversion." msgstr "" -"Ten moduł zapewnia dostęp do funkcji matematycznych dla liczb zespolonych. " -"Funkcje w tym module akceptują liczby całkowite, liczby zmiennoprzecinkowe " -"lub liczby zespolone jako argumenty. Funkcje w tym module zaakceptują " -"również obiekty Python które zawierają metody :meth:`__complex__` lub :meth:" -"`__float__`: te metody są używane do konwertowania obiektów do liczb " -"zmiennoprzecinkowych lub zespolonych, odpowiednio, a funkcje używają później " -"wyników konwersji." msgid "" "For functions involving branch cuts, we have the problem of deciding how to " @@ -186,7 +178,7 @@ msgid "" msgstr "" msgid "Return the hyperbolic cosine of *x*." -msgstr "Zwraca cosinus hiperboliczny z *x*." +msgstr "Zwraca cosinus hiperboliczny z *x*." msgid "Return the hyperbolic sine of *x*." msgstr "Zwraca sinus hiperboliczny z *x*." @@ -249,8 +241,8 @@ msgid "" "If no errors occur, the result will be: ``abs(a-b) <= max(rel_tol * " "max(abs(a), abs(b)), abs_tol)``." msgstr "" -"Jeżeli nie wystąpi żaden błąd wynikiem będzie: ``abs(a-b) <= max(rel_tol * " -"max(abs(a), abs(b)), abs_tol)``." +"Jeżeli nie wystąpi żaden błąd wynikiem będzie:\n" +" ``abs(a-b) <= max(rel_tol * max(abs(a), abs(b)), abs_tol)``." msgid "" "The IEEE 754 special values of ``NaN``, ``inf``, and ``-inf`` will be " diff --git a/library/codecs.po b/library/codecs.po new file mode 100644 index 0000000000..736024eaa9 --- /dev/null +++ b/library/codecs.po @@ -0,0 +1,2206 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 03:55+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`codecs` --- Codec registry and base classes" +msgstr "" + +msgid "**Source code:** :source:`Lib/codecs.py`" +msgstr "**Kod źródłowy:** :source:`Lib/codecs.py`" + +msgid "" +"This module defines base classes for standard Python codecs (encoders and " +"decoders) and provides access to the internal Python codec registry, which " +"manages the codec and error handling lookup process. Most standard codecs " +"are :term:`text encodings `, which encode text to bytes (and " +"decode bytes to text), but there are also codecs provided that encode text " +"to text, and bytes to bytes. Custom codecs may encode and decode between " +"arbitrary types, but some module features are restricted to be used " +"specifically with :term:`text encodings ` or with codecs that " +"encode to :class:`bytes`." +msgstr "" + +msgid "" +"The module defines the following functions for encoding and decoding with " +"any codec:" +msgstr "" + +msgid "Encodes *obj* using the codec registered for *encoding*." +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 " +"information on codec error handling." +msgstr "" + +msgid "Decodes *obj* using the codec registered for *encoding*." +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 " +"information on codec error handling." +msgstr "" + +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." +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." +msgstr "" + +msgid "" +"Codec details when looking up the codec registry. The constructor arguments " +"are stored in attributes of the same name:" +msgstr "" + +msgid "The name of the encoding." +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." +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." +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." +msgstr "" + +msgid "" +"To simplify access to the various codec components, the module provides " +"these additional functions which use :func:`lookup` for the codec lookup:" +msgstr "" + +msgid "" +"Look up the codec for the given encoding and return its encoder function." +msgstr "" + +msgid "Raises a :exc:`LookupError` in case the encoding cannot be found." +msgstr "" + +msgid "" +"Look up the codec for the given encoding and return its decoder function." +msgstr "" + +msgid "" +"Look up the codec for the given encoding and return its incremental encoder " +"class or factory function." +msgstr "" + +msgid "" +"Raises a :exc:`LookupError` in case the encoding cannot be found or the " +"codec doesn't support an incremental encoder." +msgstr "" + +msgid "" +"Look up the codec for the given encoding and return its incremental decoder " +"class or factory function." +msgstr "" + +msgid "" +"Raises a :exc:`LookupError` in case the encoding cannot be found or the " +"codec doesn't support an incremental decoder." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"Custom codecs are made available by registering a suitable codec search " +"function:" +msgstr "" + +msgid "" +"Register a codec search function. Search functions are expected to take one " +"argument, being the encoding name in all lower case letters with hyphens and " +"spaces converted to underscores, and return a :class:`CodecInfo` object. In " +"case a search function cannot find a given encoding, it should return " +"``None``." +msgstr "" + +msgid "Hyphens and spaces are converted to underscore." +msgstr "" + +msgid "" +"Unregister a codec search function and clear the registry's cache. If the " +"search function is not registered, do nothing." +msgstr "" + +msgid "" +"While the builtin :func:`open` and the associated :mod:`io` module are the " +"recommended approach for working with encoded text files, this module " +"provides additional utility functions and classes that allow the use of a " +"wider range of codecs when working with binary files:" +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." +msgstr "" + +msgid "" +"If *encoding* is not ``None``, then the underlying encoded files are always " +"opened in binary mode. No automatic conversion of ``'\\n'`` is done on " +"reading and writing. The *mode* argument may be any binary mode acceptable " +"to the built-in :func:`open` function; the ``'b'`` is automatically added." +msgstr "" + +msgid "" +"*encoding* specifies the encoding which is to be used for the file. Any " +"encoding that encodes to and decodes from bytes is allowed, and the data " +"types supported by the file methods depend on the codec used." +msgstr "" + +msgid "" +"*errors* may be given to define the error handling. It defaults to " +"``'strict'`` which causes a :exc:`ValueError` to be raised in case an " +"encoding error occurs." +msgstr "" + +msgid "" +"*buffering* has the same meaning as for the built-in :func:`open` function. " +"It defaults to -1 which means that the default buffer size will be used." +msgstr "" + +msgid "The ``'U'`` mode has been removed." +msgstr "Tryb ``'U'`` został usunięty." + +msgid "" +"Return a :class:`StreamRecoder` instance, a wrapped version of *file* which " +"provides transparent transcoding. The original file is closed when the " +"wrapped version is closed." +msgstr "" + +msgid "" +"Data written to the wrapped file is decoded according to the given " +"*data_encoding* and then written to the original file as bytes using " +"*file_encoding*. Bytes read from the original file are decoded according to " +"*file_encoding*, and the result is encoded using *data_encoding*." +msgstr "" + +msgid "If *file_encoding* is not given, it defaults to *data_encoding*." +msgstr "" + +msgid "" +"*errors* may be given to define the error handling. It defaults to " +"``'strict'``, which causes :exc:`ValueError` to be raised in case an " +"encoding error occurs." +msgstr "" + +msgid "" +"Uses an incremental encoder to iteratively encode the input provided by " +"*iterator*. This function is a :term:`generator`. The *errors* argument (as " +"well as any other keyword argument) is passed through to the incremental " +"encoder." +msgstr "" + +msgid "" +"This function requires that the codec accept text :class:`str` objects to " +"encode. Therefore it does not support bytes-to-bytes encoders such as " +"``base64_codec``." +msgstr "" + +msgid "" +"Uses an incremental decoder to iteratively decode the input provided by " +"*iterator*. This function is a :term:`generator`. The *errors* argument (as " +"well as any other keyword argument) is passed through to the incremental " +"decoder." +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`." +msgstr "" + +msgid "" +"The module also provides the following constants which are useful for " +"reading and writing to platform dependent files:" +msgstr "" + +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." +msgstr "" + +msgid "Codec Base Classes" +msgstr "" + +msgid "" +"The :mod:`codecs` module defines a set of base classes which define the " +"interfaces for working with codec objects, and can also be used as the basis " +"for custom codec implementations." +msgstr "" + +msgid "" +"Each codec has to define four interfaces to make it usable as codec in " +"Python: stateless encoder, stateless decoder, stream reader and stream " +"writer. The stream reader and writers typically reuse the stateless encoder/" +"decoder to implement the file protocols. Codec authors also need to define " +"how the codec will handle encoding and decoding errors." +msgstr "" + +msgid "Error Handlers" +msgstr "" + +msgid "" +"To simplify and standardize error handling, codecs may implement different " +"error handling schemes by accepting the *errors* string argument:" +msgstr "" + +msgid "" +"The following error handlers can be used with all Python :ref:`standard-" +"encodings` codecs:" +msgstr "" + +msgid "Value" +msgstr "Wartość" + +msgid "Meaning" +msgstr "Znaczenie" + +msgid "``'strict'``" +msgstr "``'strict'``" + +msgid "" +"Raise :exc:`UnicodeError` (or a subclass), this is the default. Implemented " +"in :func:`strict_errors`." +msgstr "" + +msgid "``'ignore'``" +msgstr "``'ignore'``" + +msgid "" +"Ignore the malformed data and continue without further notice. Implemented " +"in :func:`ignore_errors`." +msgstr "" + +msgid "``'replace'``" +msgstr "``'replace'``" + +msgid "" +"Replace with a replacement marker. On encoding, use ``?`` (ASCII character). " +"On decoding, use ``�`` (U+FFFD, the official REPLACEMENT CHARACTER). " +"Implemented in :func:`replace_errors`." +msgstr "" + +msgid "``'backslashreplace'``" +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`." +msgstr "" + +msgid "``'surrogateescape'``" +msgstr "``'surrogateescape'``" + +msgid "" +"On decoding, replace byte with individual surrogate code ranging from " +"``U+DC80`` to ``U+DCFF``. This code will then be turned back into the same " +"byte when the ``'surrogateescape'`` error handler is used when encoding the " +"data. (See :pep:`383` for more.)" +msgstr "" + +msgid "" +"The following error handlers are only applicable to encoding (within :term:" +"`text encodings `):" +msgstr "" + +msgid "``'xmlcharrefreplace'``" +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`." +msgstr "" + +msgid "``'namereplace'``" +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`." +msgstr "" + +msgid "" +"In addition, the following error handler is specific to the given codecs:" +msgstr "" + +msgid "Codecs" +msgstr "" + +msgid "``'surrogatepass'``" +msgstr "``'surrogatepass'``" + +msgid "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le" +msgstr "" + +msgid "" +"Allow encoding and decoding surrogate code point (``U+D800`` - ``U+DFFF``) " +"as normal code point. Otherwise these codecs treat the presence of surrogate " +"code point in :class:`str` as an error." +msgstr "" + +msgid "The ``'surrogateescape'`` and ``'surrogatepass'`` error handlers." +msgstr "" + +msgid "" +"The ``'surrogatepass'`` error handler now works with utf-16\\* and utf-32\\* " +"codecs." +msgstr "" + +msgid "The ``'namereplace'`` error handler." +msgstr "" + +msgid "" +"The ``'backslashreplace'`` error handler now works with decoding and " +"translating." +msgstr "" + +msgid "" +"The set of allowed values can be extended by registering a new named error " +"handler:" +msgstr "" + +msgid "" +"Register the error handling function *error_handler* under the name *name*. " +"The *error_handler* argument will be called during encoding and decoding in " +"case of an error, when *name* is specified as the errors parameter." +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." +msgstr "" + +msgid "" +"Decoding and translating works similarly, except :exc:`UnicodeDecodeError` " +"or :exc:`UnicodeTranslateError` will be passed to the handler and that the " +"replacement from the error handler will be put into the output directly." +msgstr "" + +msgid "" +"Previously registered error handlers (including the standard error handlers) " +"can be looked up by name:" +msgstr "" + +msgid "Return the error handler previously registered under the name *name*." +msgstr "" + +msgid "Raises a :exc:`LookupError` in case the handler cannot be found." +msgstr "" + +msgid "" +"The following standard error handlers are also made available as module " +"level functions:" +msgstr "" + +msgid "Implements the ``'strict'`` error handling." +msgstr "" + +msgid "Each encoding or decoding error raises a :exc:`UnicodeError`." +msgstr "" + +msgid "Implements the ``'ignore'`` error handling." +msgstr "" + +msgid "" +"Malformed data is ignored; encoding or decoding is continued without further " +"notice." +msgstr "" + +msgid "Implements the ``'replace'`` error handling." +msgstr "" + +msgid "" +"Substitutes ``?`` (ASCII character) for encoding errors or ``�`` (U+FFFD, " +"the official REPLACEMENT CHARACTER) for decoding errors." +msgstr "" + +msgid "Implements the ``'backslashreplace'`` error handling." +msgstr "" + +msgid "" +"Malformed data is replaced by a backslashed escape sequence. On encoding, " +"use the hexadecimal form of Unicode code point with formats :samp:`\\\\x{hh}" +"` :samp:`\\\\u{xxxx}` :samp:`\\\\U{xxxxxxxx}`. On decoding, use the " +"hexadecimal form of byte value with format :samp:`\\\\x{hh}`." +msgstr "" + +msgid "Works with decoding and translating." +msgstr "" + +msgid "" +"Implements the ``'xmlcharrefreplace'`` error handling (for encoding within :" +"term:`text encoding` only)." +msgstr "" + +msgid "" +"The unencodable character is replaced by an appropriate XML/HTML numeric " +"character reference, which is a decimal form of Unicode code point with " +"format :samp:`&#{num};` ." +msgstr "" + +msgid "" +"Implements the ``'namereplace'`` error handling (for encoding within :term:" +"`text encoding` only)." +msgstr "" + +msgid "" +"The unencodable character is replaced by a ``\\N{...}`` escape sequence. The " +"set of characters that appear in the braces is the Name property from " +"Unicode Character Database. For example, the German lowercase letter ``'ß'`` " +"will be converted to byte sequence ``\\N{LATIN SMALL LETTER SHARP S}`` ." +msgstr "" + +msgid "Stateless Encoding and Decoding" +msgstr "" + +msgid "" +"The base :class:`Codec` class defines these methods which also define the " +"function interfaces of the stateless encoder and decoder:" +msgstr "" + +msgid "" +"Encodes the object *input* and returns a tuple (output object, length " +"consumed). For instance, :term:`text encoding` converts a string object to a " +"bytes object using a particular character set encoding (e.g., ``cp1252`` or " +"``iso-8859-1``)." +msgstr "" + +msgid "" +"The *errors* argument defines the error handling to apply. It defaults to " +"``'strict'`` handling." +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." +msgstr "" + +msgid "" +"The encoder must be able to handle zero length input and return an empty " +"object of the output object type in this situation." +msgstr "" + +msgid "" +"Decodes the object *input* and returns a tuple (output object, length " +"consumed). For instance, for a :term:`text encoding`, decoding converts a " +"bytes object encoded using a particular character set encoding to a string " +"object." +msgstr "" + +msgid "" +"For text encodings and bytes-to-bytes codecs, *input* must be a bytes object " +"or one which provides the read-only buffer interface -- for example, buffer " +"objects and memory mapped files." +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." +msgstr "" + +msgid "" +"The decoder must be able to handle zero length input and return an empty " +"object of the output object type in this situation." +msgstr "" + +msgid "Incremental Encoding and Decoding" +msgstr "" + +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." +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." +msgstr "" + +msgid "IncrementalEncoder Objects" +msgstr "" + +msgid "" +"The :class:`IncrementalEncoder` class is used for encoding an input in " +"multiple steps. It defines the following methods which every incremental " +"encoder must define in order to be compatible with the Python codec registry." +msgstr "" + +msgid "Constructor for an :class:`IncrementalEncoder` instance." +msgstr "" + +msgid "" +"All incremental encoders must provide this constructor interface. They are " +"free to add additional keyword arguments, but only the ones defined here are " +"used by the Python codec registry." +msgstr "" + +msgid "" +"The :class:`IncrementalEncoder` may implement different error handling " +"schemes by providing the *errors* keyword argument. See :ref:`error-" +"handlers` for possible values." +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." +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)." +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 " +"necessary, to reset the encoder and to get the output." +msgstr "" + +msgid "" +"Return the current state of the encoder which must be an integer. The " +"implementation should make sure that ``0`` is the most common state. (States " +"that are more complicated than integers can be converted into an integer by " +"marshaling/pickling the state and encoding the bytes of the resulting string " +"into an integer.)" +msgstr "" + +msgid "" +"Set the state of the encoder to *state*. *state* must be an encoder state " +"returned by :meth:`getstate`." +msgstr "" + +msgid "IncrementalDecoder Objects" +msgstr "" + +msgid "" +"The :class:`IncrementalDecoder` class is used for decoding an input in " +"multiple steps. It defines the following methods which every incremental " +"decoder must define in order to be compatible with the Python codec registry." +msgstr "" + +msgid "Constructor for an :class:`IncrementalDecoder` instance." +msgstr "" + +msgid "" +"All incremental decoders must provide this constructor interface. They are " +"free to add additional keyword arguments, but only the ones defined here are " +"used by the Python codec registry." +msgstr "" + +msgid "" +"The :class:`IncrementalDecoder` may implement different error handling " +"schemes by providing the *errors* keyword argument. See :ref:`error-" +"handlers` for possible values." +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." +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)." +msgstr "" + +msgid "Reset the decoder to the initial state." +msgstr "" + +msgid "" +"Return the current state of the decoder. This must be a tuple with two " +"items, the first must be the buffer containing the still undecoded input. " +"The second must be an integer and can be additional state info. (The " +"implementation should make sure that ``0`` is the most common additional " +"state info.) If this additional state info is ``0`` it must be possible to " +"set the decoder to the state which has no input buffered and ``0`` as the " +"additional state info, so that feeding the previously buffered input to the " +"decoder returns it to the previous state without producing any output. " +"(Additional state info that is more complicated than integers can be " +"converted into an integer by marshaling/pickling the info and encoding the " +"bytes of the resulting string into an integer.)" +msgstr "" + +msgid "" +"Set the state of the decoder to *state*. *state* must be a decoder state " +"returned by :meth:`getstate`." +msgstr "" + +msgid "Stream Encoding and Decoding" +msgstr "" + +msgid "" +"The :class:`StreamWriter` and :class:`StreamReader` classes provide generic " +"working interfaces which can be used to implement new encoding submodules " +"very easily. See :mod:`!encodings.utf_8` for an example of how this is done." +msgstr "" + +msgid "StreamWriter Objects" +msgstr "" + +msgid "" +"The :class:`StreamWriter` class is a subclass of :class:`Codec` and defines " +"the following methods which every stream writer must define in order to be " +"compatible with the Python codec registry." +msgstr "" + +msgid "Constructor for a :class:`StreamWriter` instance." +msgstr "" + +msgid "" +"All stream writers must provide this constructor interface. They are free to " +"add additional keyword arguments, but only the ones defined here are used by " +"the Python codec registry." +msgstr "" + +msgid "" +"The *stream* argument must be a file-like object open for writing text or " +"binary data, as appropriate for the specific codec." +msgstr "" + +msgid "" +"The :class:`StreamWriter` may implement different error handling schemes by " +"providing the *errors* keyword argument. See :ref:`error-handlers` for the " +"standard error handlers the underlying stream codec may support." +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:`StreamWriter` " +"object." +msgstr "" + +msgid "Writes the object's contents encoded to the stream." +msgstr "" + +msgid "" +"Writes the concatenated iterable of strings to the stream (possibly by " +"reusing the :meth:`write` method). Infinite or very large iterables are not " +"supported. The standard bytes-to-bytes codecs do not support this method." +msgstr "" + +msgid "Resets the codec buffers used for keeping internal state." +msgstr "" + +msgid "" +"Calling this method should ensure that the data on the output is put into a " +"clean state that allows appending of new fresh data without having to rescan " +"the whole stream to recover state." +msgstr "" + +msgid "" +"In addition to the above methods, the :class:`StreamWriter` must also " +"inherit all other methods and attributes from the underlying stream." +msgstr "" + +msgid "StreamReader Objects" +msgstr "" + +msgid "" +"The :class:`StreamReader` class is a subclass of :class:`Codec` and defines " +"the following methods which every stream reader must define in order to be " +"compatible with the Python codec registry." +msgstr "" + +msgid "Constructor for a :class:`StreamReader` instance." +msgstr "" + +msgid "" +"All stream readers must provide this constructor interface. They are free to " +"add additional keyword arguments, but only the ones defined here are used by " +"the Python codec registry." +msgstr "" + +msgid "" +"The *stream* argument must be a file-like object open for reading text or " +"binary data, as appropriate for the specific codec." +msgstr "" + +msgid "" +"The :class:`StreamReader` may implement different error handling schemes by " +"providing the *errors* keyword argument. See :ref:`error-handlers` for the " +"standard error handlers the underlying stream codec may support." +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:`StreamReader` " +"object." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"The *chars* argument indicates the number of decoded code points or bytes to " +"return. The :func:`read` method will never return more data than requested, " +"but it might return less, if there is not enough available." +msgstr "" + +msgid "" +"The *size* argument indicates the approximate maximum number of encoded " +"bytes or code points to read for decoding. The decoder can modify this " +"setting as appropriate. The default value -1 indicates to read and decode as " +"much as possible. This parameter is intended to prevent having to decode " +"huge files in one step." +msgstr "" + +msgid "" +"The *firstline* flag indicates that it would be sufficient to only return " +"the first line, if there are decoding errors on later lines." +msgstr "" + +msgid "" +"The method should use a greedy read strategy meaning that it should read as " +"much data as is allowed within the definition of the encoding and the given " +"size, e.g. if optional encoding endings or state markers are available on " +"the stream, these should be read too." +msgstr "" + +msgid "Read one line from the input stream and return the decoded data." +msgstr "" + +msgid "" +"*size*, if given, is passed as size argument to the stream's :meth:`read` " +"method." +msgstr "" + +msgid "" +"If *keepends* is false line-endings will be stripped from the lines returned." +msgstr "" + +msgid "" +"Read all lines available on the input stream and return them as a list of " +"lines." +msgstr "" + +msgid "" +"Line-endings are implemented using the codec's :meth:`decode` method and are " +"included in the list entries if *keepends* is true." +msgstr "" + +msgid "" +"*sizehint*, if given, is passed as the *size* argument to the stream's :meth:" +"`read` method." +msgstr "" + +msgid "" +"Note that no stream repositioning should take place. This method is " +"primarily intended to be able to recover from decoding errors." +msgstr "" + +msgid "" +"In addition to the above methods, the :class:`StreamReader` must also " +"inherit all other methods and attributes from the underlying stream." +msgstr "" + +msgid "StreamReaderWriter Objects" +msgstr "" + +msgid "" +"The :class:`StreamReaderWriter` is a convenience class that allows wrapping " +"streams which work in both read and write modes." +msgstr "" + +msgid "" +"The design is such that one can use the factory functions returned by the :" +"func:`lookup` function to construct the instance." +msgstr "" + +msgid "" +"Creates a :class:`StreamReaderWriter` instance. *stream* must be a file-like " +"object. *Reader* and *Writer* must be factory functions or classes providing " +"the :class:`StreamReader` and :class:`StreamWriter` interface resp. Error " +"handling is done in the same way as defined for the stream readers and " +"writers." +msgstr "" + +msgid "" +":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 "" + +msgid "StreamRecoder Objects" +msgstr "" + +msgid "" +"The :class:`StreamRecoder` translates data from one encoding to another, " +"which is sometimes useful when dealing with different encoding environments." +msgstr "" + +msgid "" +"Creates a :class:`StreamRecoder` instance which implements a two-way " +"conversion: *encode* and *decode* work on the frontend — the data visible to " +"code calling :meth:`~StreamReader.read` and :meth:`~StreamWriter.write`, " +"while *Reader* and *Writer* work on the backend — the data in *stream*." +msgstr "" + +msgid "" +"You can use these objects to do transparent transcodings, e.g., from Latin-1 " +"to UTF-8 and back." +msgstr "" + +msgid "The *stream* argument must be a file-like object." +msgstr "" + +msgid "" +"The *encode* and *decode* arguments must adhere to the :class:`Codec` " +"interface. *Reader* and *Writer* must be factory functions or classes " +"providing objects of the :class:`StreamReader` and :class:`StreamWriter` " +"interface respectively." +msgstr "" + +msgid "" +"Error handling is done in the same way as defined for the stream readers and " +"writers." +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." +msgstr "" + +msgid "Encodings and Unicode" +msgstr "" + +msgid "" +"Strings are stored internally as sequences of code points in range " +"``U+0000``--``U+10FFFF``. (See :pep:`393` for more details about the " +"implementation.) Once a string object is used outside of CPU and memory, " +"endianness and how these arrays are stored as bytes become an issue. As with " +"other codecs, serialising a string into a sequence of bytes is known as " +"*encoding*, and recreating the string from the sequence of bytes is known as " +"*decoding*. There are a variety of different text serialisation codecs, " +"which are collectivity referred to as :term:`text encodings `." +msgstr "" + +msgid "" +"The simplest text encoding (called ``'latin-1'`` or ``'iso-8859-1'``) maps " +"the code points 0--255 to the bytes ``0x0``--``0xff``, which means that a " +"string object that contains code points above ``U+00FF`` can't be encoded " +"with this codec. Doing so will raise a :exc:`UnicodeEncodeError` that looks " +"like the following (although the details of the error message may differ): " +"``UnicodeEncodeError: 'latin-1' codec can't encode character '\\u1234' in " +"position 3: ordinal not in range(256)``." +msgstr "" + +msgid "" +"There's another group of encodings (the so called charmap encodings) that " +"choose a different subset of all Unicode code points and how these code " +"points are mapped to the bytes ``0x0``--``0xff``. To see how this is done " +"simply open e.g. :file:`encodings/cp1252.py` (which is an encoding that is " +"used primarily on Windows). There's a string constant with 256 characters " +"that shows you which character is mapped to which byte value." +msgstr "" + +msgid "" +"All of these encodings can only encode 256 of the 1114112 code points " +"defined in Unicode. A simple and straightforward way that can store each " +"Unicode code point, is to store each code point as four consecutive bytes. " +"There are two possibilities: store the bytes in big endian or in little " +"endian order. These two encodings are called ``UTF-32-BE`` and ``UTF-32-LE`` " +"respectively. Their disadvantage is that if e.g. you use ``UTF-32-BE`` on a " +"little endian machine you will always have to swap bytes on encoding and " +"decoding. ``UTF-32`` avoids this problem: bytes will always be in natural " +"endianness. When these bytes are read by a CPU with a different endianness, " +"then bytes have to be swapped though. To be able to detect the endianness of " +"a ``UTF-16`` or ``UTF-32`` byte sequence, there's the so called BOM (\"Byte " +"Order Mark\"). This is the Unicode character ``U+FEFF``. This character can " +"be prepended to every ``UTF-16`` or ``UTF-32`` byte sequence. The byte " +"swapped version of this character (``0xFFFE``) is an illegal character that " +"may not appear in a Unicode text. So when the first character in a " +"``UTF-16`` or ``UTF-32`` byte sequence appears to be a ``U+FFFE`` the bytes " +"have to be swapped on decoding. Unfortunately the character ``U+FEFF`` had a " +"second purpose as a ``ZERO WIDTH NO-BREAK SPACE``: a character that has no " +"width and doesn't allow a word to be split. It can e.g. be used to give " +"hints to a ligature algorithm. With Unicode 4.0 using ``U+FEFF`` as a ``ZERO " +"WIDTH NO-BREAK SPACE`` has been deprecated (with ``U+2060`` (``WORD " +"JOINER``) assuming this role). Nevertheless Unicode software still must be " +"able to handle ``U+FEFF`` in both roles: as a BOM it's a device to determine " +"the storage layout of the encoded bytes, and vanishes once the byte sequence " +"has been decoded into a string; as a ``ZERO WIDTH NO-BREAK SPACE`` it's a " +"normal character that will be decoded like any other." +msgstr "" + +msgid "" +"There's another encoding that is able to encode the full range of Unicode " +"characters: UTF-8. UTF-8 is an 8-bit encoding, which means there are no " +"issues with byte order in UTF-8. Each byte in a UTF-8 byte sequence consists " +"of two parts: marker bits (the most significant bits) and payload bits. The " +"marker bits are a sequence of zero to four ``1`` bits followed by a ``0`` " +"bit. Unicode characters are encoded like this (with x being payload bits, " +"which when concatenated give the Unicode character):" +msgstr "" + +msgid "Range" +msgstr "" + +msgid "Encoding" +msgstr "" + +msgid "``U-00000000`` ... ``U-0000007F``" +msgstr "``U-00000000`` ... ``U-0000007F``" + +msgid "0xxxxxxx" +msgstr "" + +msgid "``U-00000080`` ... ``U-000007FF``" +msgstr "``U-00000080`` ... ``U-000007FF``" + +msgid "110xxxxx 10xxxxxx" +msgstr "" + +msgid "``U-00000800`` ... ``U-0000FFFF``" +msgstr "``U-00000800`` ... ``U-0000FFFF``" + +msgid "1110xxxx 10xxxxxx 10xxxxxx" +msgstr "" + +msgid "``U-00010000`` ... ``U-0010FFFF``" +msgstr "``U-00010000`` ... ``U-0010FFFF``" + +msgid "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" +msgstr "" + +msgid "" +"The least significant bit of the Unicode character is the rightmost x bit." +msgstr "" + +msgid "" +"As UTF-8 is an 8-bit encoding no BOM is required and any ``U+FEFF`` " +"character in the decoded string (even if it's the first character) is " +"treated as a ``ZERO WIDTH NO-BREAK SPACE``." +msgstr "" + +msgid "" +"Without external information it's impossible to reliably determine which " +"encoding was used for encoding a string. Each charmap encoding can decode " +"any random byte sequence. However that's not possible with UTF-8, as UTF-8 " +"byte sequences have a structure that doesn't allow arbitrary byte sequences. " +"To increase the reliability with which a UTF-8 encoding can be detected, " +"Microsoft invented a variant of UTF-8 (that Python calls ``\"utf-8-sig\"``) " +"for its Notepad program: Before any of the Unicode characters is written to " +"the file, a UTF-8 encoded BOM (which looks like this as a byte sequence: " +"``0xef``, ``0xbb``, ``0xbf``) is written. As it's rather improbable that any " +"charmap encoded file starts with these byte values (which would e.g. map to" +msgstr "" + +msgid "LATIN SMALL LETTER I WITH DIAERESIS" +msgstr "" + +msgid "RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK" +msgstr "" + +msgid "INVERTED QUESTION MARK" +msgstr "" + +msgid "" +"in iso-8859-1), this increases the probability that a ``utf-8-sig`` encoding " +"can be correctly guessed from the byte sequence. So here the BOM is not used " +"to be able to determine the byte order used for generating the byte " +"sequence, but as a signature that helps in guessing the encoding. On " +"encoding the utf-8-sig codec will write ``0xef``, ``0xbb``, ``0xbf`` as the " +"first three bytes to the file. On decoding ``utf-8-sig`` will skip those " +"three bytes if they appear as the first three bytes in the file. In UTF-8, " +"the use of the BOM is discouraged and should generally be avoided." +msgstr "" + +msgid "Standard Encodings" +msgstr "" + +msgid "" +"Python comes with a number of codecs built-in, either implemented as C " +"functions or with dictionaries as mapping tables. The following table lists " +"the codecs by name, together with a few common aliases, and the languages " +"for which the encoding is likely used. Neither the list of aliases nor the " +"list of languages is meant to be exhaustive. Notice that spelling " +"alternatives that only differ in case or use a hyphen instead of an " +"underscore are also valid aliases; therefore, e.g. ``'utf-8'`` is a valid " +"alias for the ``'utf_8'`` codec." +msgstr "" + +msgid "" +"Some common encodings can bypass the codecs lookup machinery to improve " +"performance. These optimization opportunities are only recognized by CPython " +"for a limited set of (case insensitive) aliases: utf-8, utf8, latin-1, " +"latin1, iso-8859-1, iso8859-1, mbcs (Windows only), ascii, us-ascii, utf-16, " +"utf16, utf-32, utf32, and the same using underscores instead of dashes. " +"Using alternative aliases for these encodings may result in slower execution." +msgstr "" + +msgid "Optimization opportunity recognized for us-ascii." +msgstr "" + +msgid "" +"Many of the character sets support the same languages. They vary in " +"individual characters (e.g. whether the EURO SIGN is supported or not), and " +"in the assignment of characters to code positions. For the European " +"languages in particular, the following variants typically exist:" +msgstr "" + +msgid "an ISO 8859 codeset" +msgstr "" + +msgid "" +"a Microsoft Windows code page, which is typically derived from an 8859 " +"codeset, but replaces control characters with additional graphic characters" +msgstr "" + +msgid "an IBM EBCDIC code page" +msgstr "" + +msgid "an IBM PC code page, which is ASCII compatible" +msgstr "" + +msgid "Codec" +msgstr "" + +msgid "Aliases" +msgstr "" + +msgid "Languages" +msgstr "" + +msgid "ascii" +msgstr "" + +msgid "646, us-ascii" +msgstr "" + +msgid "English" +msgstr "" + +msgid "big5" +msgstr "" + +msgid "big5-tw, csbig5" +msgstr "" + +msgid "Traditional Chinese" +msgstr "" + +msgid "big5hkscs" +msgstr "" + +msgid "big5-hkscs, hkscs" +msgstr "" + +msgid "cp037" +msgstr "" + +msgid "IBM037, IBM039" +msgstr "" + +msgid "cp273" +msgstr "" + +msgid "273, IBM273, csIBM273" +msgstr "" + +msgid "German" +msgstr "" + +msgid "cp424" +msgstr "" + +msgid "EBCDIC-CP-HE, IBM424" +msgstr "" + +msgid "Hebrew" +msgstr "" + +msgid "cp437" +msgstr "" + +msgid "437, IBM437" +msgstr "" + +msgid "cp500" +msgstr "" + +msgid "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" +msgstr "" + +msgid "Western Europe" +msgstr "" + +msgid "cp720" +msgstr "" + +msgid "Arabic" +msgstr "" + +msgid "cp737" +msgstr "" + +msgid "Greek" +msgstr "" + +msgid "cp775" +msgstr "" + +msgid "IBM775" +msgstr "" + +msgid "Baltic languages" +msgstr "" + +msgid "cp850" +msgstr "" + +msgid "850, IBM850" +msgstr "" + +msgid "cp852" +msgstr "" + +msgid "852, IBM852" +msgstr "" + +msgid "Central and Eastern Europe" +msgstr "" + +msgid "cp855" +msgstr "" + +msgid "855, IBM855" +msgstr "" + +msgid "Bulgarian, Byelorussian, Macedonian, Russian, Serbian" +msgstr "" + +msgid "cp856" +msgstr "" + +msgid "cp857" +msgstr "" + +msgid "857, IBM857" +msgstr "" + +msgid "Turkish" +msgstr "" + +msgid "cp858" +msgstr "" + +msgid "858, IBM858" +msgstr "" + +msgid "cp860" +msgstr "" + +msgid "860, IBM860" +msgstr "" + +msgid "Portuguese" +msgstr "" + +msgid "cp861" +msgstr "" + +msgid "861, CP-IS, IBM861" +msgstr "" + +msgid "Icelandic" +msgstr "" + +msgid "cp862" +msgstr "" + +msgid "862, IBM862" +msgstr "" + +msgid "cp863" +msgstr "" + +msgid "863, IBM863" +msgstr "" + +msgid "Canadian" +msgstr "" + +msgid "cp864" +msgstr "" + +msgid "IBM864" +msgstr "" + +msgid "cp865" +msgstr "" + +msgid "865, IBM865" +msgstr "" + +msgid "Danish, Norwegian" +msgstr "" + +msgid "cp866" +msgstr "" + +msgid "866, IBM866" +msgstr "" + +msgid "Russian" +msgstr "" + +msgid "cp869" +msgstr "" + +msgid "869, CP-GR, IBM869" +msgstr "" + +msgid "cp874" +msgstr "" + +msgid "Thai" +msgstr "" + +msgid "cp875" +msgstr "" + +msgid "cp932" +msgstr "" + +msgid "932, ms932, mskanji, ms-kanji" +msgstr "" + +msgid "Japanese" +msgstr "" + +msgid "cp949" +msgstr "" + +msgid "949, ms949, uhc" +msgstr "" + +msgid "Korean" +msgstr "" + +msgid "cp950" +msgstr "" + +msgid "950, ms950" +msgstr "" + +msgid "cp1006" +msgstr "" + +msgid "Urdu" +msgstr "" + +msgid "cp1026" +msgstr "" + +msgid "ibm1026" +msgstr "" + +msgid "cp1125" +msgstr "" + +msgid "1125, ibm1125, cp866u, ruscii" +msgstr "" + +msgid "Ukrainian" +msgstr "" + +msgid "cp1140" +msgstr "" + +msgid "ibm1140" +msgstr "" + +msgid "cp1250" +msgstr "" + +msgid "windows-1250" +msgstr "" + +msgid "cp1251" +msgstr "" + +msgid "windows-1251" +msgstr "" + +msgid "cp1252" +msgstr "" + +msgid "windows-1252" +msgstr "" + +msgid "cp1253" +msgstr "" + +msgid "windows-1253" +msgstr "" + +msgid "cp1254" +msgstr "" + +msgid "windows-1254" +msgstr "" + +msgid "cp1255" +msgstr "" + +msgid "windows-1255" +msgstr "" + +msgid "cp1256" +msgstr "" + +msgid "windows-1256" +msgstr "" + +msgid "cp1257" +msgstr "" + +msgid "windows-1257" +msgstr "" + +msgid "cp1258" +msgstr "" + +msgid "windows-1258" +msgstr "" + +msgid "Vietnamese" +msgstr "" + +msgid "euc_jp" +msgstr "" + +msgid "eucjp, ujis, u-jis" +msgstr "" + +msgid "euc_jis_2004" +msgstr "" + +msgid "jisx0213, eucjis2004" +msgstr "" + +msgid "euc_jisx0213" +msgstr "" + +msgid "eucjisx0213" +msgstr "" + +msgid "euc_kr" +msgstr "" + +msgid "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" +msgstr "" + +msgid "gb2312" +msgstr "" + +msgid "" +"chinese, csiso58gb231280, euc-cn, euccn, eucgb2312-cn, gb2312-1980, " +"gb2312-80, iso-ir-58" +msgstr "" + +msgid "Simplified Chinese" +msgstr "" + +msgid "gbk" +msgstr "" + +msgid "936, cp936, ms936" +msgstr "" + +msgid "Unified Chinese" +msgstr "" + +msgid "gb18030" +msgstr "" + +msgid "gb18030-2000" +msgstr "" + +msgid "hz" +msgstr "" + +msgid "hzgb, hz-gb, hz-gb-2312" +msgstr "" + +msgid "iso2022_jp" +msgstr "" + +msgid "csiso2022jp, iso2022jp, iso-2022-jp" +msgstr "" + +msgid "iso2022_jp_1" +msgstr "" + +msgid "iso2022jp-1, iso-2022-jp-1" +msgstr "" + +msgid "iso2022_jp_2" +msgstr "" + +msgid "iso2022jp-2, iso-2022-jp-2" +msgstr "" + +msgid "Japanese, Korean, Simplified Chinese, Western Europe, Greek" +msgstr "" + +msgid "iso2022_jp_2004" +msgstr "" + +msgid "iso2022jp-2004, iso-2022-jp-2004" +msgstr "" + +msgid "iso2022_jp_3" +msgstr "" + +msgid "iso2022jp-3, iso-2022-jp-3" +msgstr "" + +msgid "iso2022_jp_ext" +msgstr "" + +msgid "iso2022jp-ext, iso-2022-jp-ext" +msgstr "" + +msgid "iso2022_kr" +msgstr "" + +msgid "csiso2022kr, iso2022kr, iso-2022-kr" +msgstr "" + +msgid "latin_1" +msgstr "" + +msgid "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" +msgstr "" + +msgid "iso8859_2" +msgstr "" + +msgid "iso-8859-2, latin2, L2" +msgstr "" + +msgid "iso8859_3" +msgstr "" + +msgid "iso-8859-3, latin3, L3" +msgstr "" + +msgid "Esperanto, Maltese" +msgstr "" + +msgid "iso8859_4" +msgstr "" + +msgid "iso-8859-4, latin4, L4" +msgstr "" + +msgid "iso8859_5" +msgstr "" + +msgid "iso-8859-5, cyrillic" +msgstr "" + +msgid "iso8859_6" +msgstr "" + +msgid "iso-8859-6, arabic" +msgstr "" + +msgid "iso8859_7" +msgstr "" + +msgid "iso-8859-7, greek, greek8" +msgstr "" + +msgid "iso8859_8" +msgstr "" + +msgid "iso-8859-8, hebrew" +msgstr "" + +msgid "iso8859_9" +msgstr "" + +msgid "iso-8859-9, latin5, L5" +msgstr "" + +msgid "iso8859_10" +msgstr "" + +msgid "iso-8859-10, latin6, L6" +msgstr "" + +msgid "Nordic languages" +msgstr "" + +msgid "iso8859_11" +msgstr "" + +msgid "iso-8859-11, thai" +msgstr "" + +msgid "Thai languages" +msgstr "" + +msgid "iso8859_13" +msgstr "" + +msgid "iso-8859-13, latin7, L7" +msgstr "" + +msgid "iso8859_14" +msgstr "" + +msgid "iso-8859-14, latin8, L8" +msgstr "" + +msgid "Celtic languages" +msgstr "" + +msgid "iso8859_15" +msgstr "" + +msgid "iso-8859-15, latin9, L9" +msgstr "" + +msgid "iso8859_16" +msgstr "" + +msgid "iso-8859-16, latin10, L10" +msgstr "" + +msgid "South-Eastern Europe" +msgstr "" + +msgid "johab" +msgstr "" + +msgid "cp1361, ms1361" +msgstr "" + +msgid "koi8_r" +msgstr "" + +msgid "koi8_t" +msgstr "" + +msgid "Tajik" +msgstr "" + +msgid "koi8_u" +msgstr "" + +msgid "kz1048" +msgstr "" + +msgid "kz_1048, strk1048_2002, rk1048" +msgstr "" + +msgid "Kazakh" +msgstr "" + +msgid "mac_cyrillic" +msgstr "" + +msgid "maccyrillic" +msgstr "" + +msgid "mac_greek" +msgstr "" + +msgid "macgreek" +msgstr "" + +msgid "mac_iceland" +msgstr "" + +msgid "maciceland" +msgstr "" + +msgid "mac_latin2" +msgstr "" + +msgid "maclatin2, maccentraleurope, mac_centeuro" +msgstr "" + +msgid "mac_roman" +msgstr "" + +msgid "macroman, macintosh" +msgstr "" + +msgid "mac_turkish" +msgstr "" + +msgid "macturkish" +msgstr "" + +msgid "ptcp154" +msgstr "" + +msgid "csptcp154, pt154, cp154, cyrillic-asian" +msgstr "" + +msgid "shift_jis" +msgstr "" + +msgid "csshiftjis, shiftjis, sjis, s_jis" +msgstr "" + +msgid "shift_jis_2004" +msgstr "" + +msgid "shiftjis2004, sjis_2004, sjis2004" +msgstr "" + +msgid "shift_jisx0213" +msgstr "" + +msgid "shiftjisx0213, sjisx0213, s_jisx0213" +msgstr "" + +msgid "utf_32" +msgstr "" + +msgid "U32, utf32" +msgstr "" + +msgid "all languages" +msgstr "" + +msgid "utf_32_be" +msgstr "" + +msgid "UTF-32BE" +msgstr "" + +msgid "utf_32_le" +msgstr "" + +msgid "UTF-32LE" +msgstr "" + +msgid "utf_16" +msgstr "" + +msgid "U16, utf16" +msgstr "" + +msgid "utf_16_be" +msgstr "" + +msgid "UTF-16BE" +msgstr "" + +msgid "utf_16_le" +msgstr "" + +msgid "UTF-16LE" +msgstr "" + +msgid "utf_7" +msgstr "" + +msgid "U7, unicode-1-1-utf-7" +msgstr "" + +msgid "utf_8" +msgstr "" + +msgid "U8, UTF, utf8, cp65001" +msgstr "" + +msgid "utf_8_sig" +msgstr "" + +msgid "" +"The utf-16\\* and utf-32\\* encoders no longer allow surrogate code points " +"(``U+D800``--``U+DFFF``) to be encoded. The utf-32\\* decoders no longer " +"decode byte sequences that correspond to surrogate code points." +msgstr "" + +msgid "``cp65001`` is now an alias to ``utf_8``." +msgstr "" + +msgid "Python Specific Encodings" +msgstr "" + +msgid "" +"A number of predefined codecs are specific to Python, so their codec names " +"have no meaning outside Python. These are listed in the tables below based " +"on the expected input and output types (note that while text encodings are " +"the most common use case for codecs, the underlying codec infrastructure " +"supports arbitrary data transforms rather than just text encodings). For " +"asymmetric codecs, the stated meaning describes the encoding direction." +msgstr "" + +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." +msgstr "" + +msgid "idna" +msgstr "" + +msgid "" +"Implement :rfc:`3490`, see also :mod:`encodings.idna`. Only " +"``errors='strict'`` is supported." +msgstr "" + +msgid "mbcs" +msgstr "" + +msgid "ansi, dbcs" +msgstr "" + +msgid "" +"Windows only: Encode the operand according to the ANSI codepage (CP_ACP)." +msgstr "" + +msgid "oem" +msgstr "" + +msgid "" +"Windows only: Encode the operand according to the OEM codepage (CP_OEMCP)." +msgstr "" + +msgid "palmos" +msgstr "" + +msgid "Encoding of PalmOS 3.5." +msgstr "" + +msgid "punycode" +msgstr "" + +msgid "Implement :rfc:`3492`. Stateful codecs are not supported." +msgstr "" + +msgid "raw_unicode_escape" +msgstr "" + +msgid "" +"Latin-1 encoding with :samp:`\\\\u{XXXX}` and :samp:`\\\\U{XXXXXXXX}` for " +"other code points. Existing backslashes are not escaped in any way. It is " +"used in the Python pickle protocol." +msgstr "" + +msgid "undefined" +msgstr "" + +msgid "" +"Raise an exception for all conversions, even empty strings. The error " +"handler is ignored." +msgstr "" + +msgid "unicode_escape" +msgstr "" + +msgid "" +"Encoding suitable as the contents of a Unicode literal in ASCII-encoded " +"Python source code, except that quotes are not escaped. Decode from Latin-1 " +"source code. Beware that Python source code actually uses UTF-8 by default." +msgstr "" + +msgid "\"unicode_internal\" codec is removed." +msgstr "" + +msgid "Binary Transforms" +msgstr "" + +msgid "" +"The following codecs provide binary transforms: :term:`bytes-like object` " +"to :class:`bytes` mappings. They are not supported by :meth:`bytes.decode` " +"(which only produces :class:`str` output)." +msgstr "" + +msgid "Encoder / decoder" +msgstr "" + +msgid "base64_codec [#b64]_" +msgstr "" + +msgid "base64, base_64" +msgstr "" + +msgid "" +"Convert the operand to multiline MIME base64 (the result always includes a " +"trailing ``'\\n'``)." +msgstr "" + +msgid "" +"accepts any :term:`bytes-like object` as input for encoding and decoding" +msgstr "" + +msgid ":meth:`base64.encodebytes` / :meth:`base64.decodebytes`" +msgstr "" + +msgid "bz2_codec" +msgstr "" + +msgid "bz2" +msgstr "" + +msgid "Compress the operand using bz2." +msgstr "" + +msgid ":meth:`bz2.compress` / :meth:`bz2.decompress`" +msgstr "" + +msgid "hex_codec" +msgstr "" + +msgid "hex" +msgstr "" + +msgid "" +"Convert the operand to hexadecimal representation, with two digits per byte." +msgstr "" + +msgid ":meth:`binascii.b2a_hex` / :meth:`binascii.a2b_hex`" +msgstr "" + +msgid "quopri_codec" +msgstr "" + +msgid "quopri, quotedprintable, quoted_printable" +msgstr "" + +msgid "Convert the operand to MIME quoted printable." +msgstr "" + +msgid ":meth:`quopri.encode` with ``quotetabs=True`` / :meth:`quopri.decode`" +msgstr "" + +msgid "uu_codec" +msgstr "" + +msgid "uu" +msgstr "" + +msgid "Convert the operand using uuencode." +msgstr "" + +msgid "" +":meth:`!uu.encode` / :meth:`!uu.decode` (Note: :mod:`uu` is deprecated.)" +msgstr "" + +msgid "zlib_codec" +msgstr "" + +msgid "zip, zlib" +msgstr "" + +msgid "Compress the operand using gzip." +msgstr "" + +msgid ":meth:`zlib.compress` / :meth:`zlib.decompress`" +msgstr "" + +msgid "" +"In addition to :term:`bytes-like objects `, " +"``'base64_codec'`` also accepts ASCII-only instances of :class:`str` for " +"decoding" +msgstr "" + +msgid "Restoration of the binary transforms." +msgstr "" + +msgid "Restoration of the aliases for the binary transforms." +msgstr "" + +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)." +msgstr "" + +msgid "rot_13" +msgstr "" + +msgid "rot13" +msgstr "" + +msgid "Return the Caesar-cypher encryption of the operand." +msgstr "" + +msgid "Restoration of the ``rot_13`` text transform." +msgstr "" + +msgid "Restoration of the ``rot13`` alias." +msgstr "" + +msgid "" +":mod:`encodings.idna` --- Internationalized Domain Names in Applications" +msgstr "" + +msgid "" +"This module implements :rfc:`3490` (Internationalized Domain Names in " +"Applications) and :rfc:`3492` (Nameprep: A Stringprep Profile for " +"Internationalized Domain Names (IDN)). It builds upon the ``punycode`` " +"encoding and :mod:`stringprep`." +msgstr "" + +msgid "" +"If you need the IDNA 2008 standard from :rfc:`5891` and :rfc:`5895`, use the " +"third-party `idna module `_." +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." +msgstr "" + +msgid "" +"Python supports this conversion in several ways: the ``idna`` codec " +"performs conversion between Unicode and ACE, separating an input string into " +"labels based on the separator characters defined in :rfc:`section 3.1 of RFC " +"3490 <3490#section-3.1>` and converting each label to ACE as required, and " +"conversely separating an input byte string into labels based on the ``.`` " +"separator and converting any ACE labels found into unicode. Furthermore, " +"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 " +"transparently sends an IDNA hostname in the :mailheader:`Host` field if it " +"sends that field at all)." +msgstr "" + +msgid "" +"When receiving host names from the wire (such as in reverse name lookup), no " +"automatic conversion to Unicode is performed: applications wishing to " +"present such host names to the user should decode them to Unicode." +msgstr "" + +msgid "" +"The module :mod:`encodings.idna` also implements the nameprep procedure, " +"which performs certain normalizations on host names, to achieve case-" +"insensitivity of international domain names, and to unify similar " +"characters. The nameprep functions can be used directly if desired." +msgstr "" + +msgid "" +"Return the nameprepped version of *label*. The implementation currently " +"assumes query strings, so ``AllowUnassigned`` is true." +msgstr "" + +msgid "" +"Convert a label to ASCII, as specified in :rfc:`3490`. ``UseSTD3ASCIIRules`` " +"is assumed to be false." +msgstr "" + +msgid "Convert a label to Unicode, as specified in :rfc:`3490`." +msgstr "" + +msgid ":mod:`encodings.mbcs` --- Windows ANSI codepage" +msgstr "" + +msgid "This module implements the ANSI codepage (CP_ACP)." +msgstr "" + +msgid ":ref:`Availability `: Windows." +msgstr "" + +msgid "" +"Before 3.2, the *errors* argument was ignored; ``'replace'`` was always used " +"to encode, and ``'ignore'`` to decode." +msgstr "" + +msgid "Support any error handler." +msgstr "" + +msgid ":mod:`encodings.utf_8_sig` --- UTF-8 codec with BOM signature" +msgstr "" + +msgid "" +"This module implements a variant of the UTF-8 codec. On encoding, a UTF-8 " +"encoded BOM will be prepended to the UTF-8 encoded bytes. For the stateful " +"encoder this is only done once (on the first write to the byte stream). On " +"decoding, an optional UTF-8 encoded BOM at the start of the data will be " +"skipped." +msgstr "" + +msgid "Unicode" +msgstr "" + +msgid "encode" +msgstr "" + +msgid "decode" +msgstr "" + +msgid "streams" +msgstr "" + +msgid "stackable" +msgstr "" + +msgid "strict" +msgstr "" + +msgid "error handler's name" +msgstr "" + +msgid "ignore" +msgstr "" + +msgid "replace" +msgstr "" + +msgid "backslashreplace" +msgstr "" + +msgid "surrogateescape" +msgstr "" + +msgid "? (question mark)" +msgstr "" + +msgid "replacement character" +msgstr "" + +msgid "\\ (backslash)" +msgstr "" + +msgid "escape sequence" +msgstr "" + +msgid "\\x" +msgstr "" + +msgid "\\u" +msgstr "" + +msgid "\\U" +msgstr "" + +msgid "xmlcharrefreplace" +msgstr "" + +msgid "namereplace" +msgstr "" + +msgid "surrogatepass" +msgstr "" diff --git a/library/collections.abc.po b/library/collections.abc.po new file mode 100644 index 0000000000..b077c708bc --- /dev/null +++ b/library/collections.abc.po @@ -0,0 +1,510 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`collections.abc` --- Abstract Base Classes for Containers" +msgstr "" + +msgid "Formerly, this module was part of the :mod:`collections` module." +msgstr "" + +msgid "**Source code:** :source:`Lib/_collections_abc.py`" +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`." +msgstr "" + +msgid "" +"An :func:`issubclass` or :func:`isinstance` test for an interface works in " +"one of three ways." +msgstr "" + +msgid "" +"1) A newly written class can inherit directly from one of the abstract base " +"classes. The class must supply the required abstract methods. The " +"remaining mixin methods come from inheritance and can be overridden if " +"desired. Other methods may be added as needed:" +msgstr "" + +msgid "" +"2) Existing classes and built-in classes can be registered as \"virtual " +"subclasses\" of the ABCs. Those classes should define the full API " +"including all of the abstract methods and all of the mixin methods. This " +"lets users rely on :func:`issubclass` or :func:`isinstance` tests to " +"determine whether the full interface is supported. The exception to this " +"rule is for methods that are automatically inferred from the rest of the API:" +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__``." +msgstr "" + +msgid "" +"3) Some simple interfaces are directly recognizable by the presence of the " +"required methods (unless those methods have been set to :const:`None`):" +msgstr "" + +msgid "" +"Complex interfaces do not support this last technique because an interface " +"is more than just the presence of method names. Interfaces specify " +"semantics and relationships between methods that cannot be inferred solely " +"from the presence of specific method names. For example, knowing that a " +"class supplies ``__getitem__``, ``__len__``, and ``__iter__`` is " +"insufficient for distinguishing a :class:`Sequence` from a :class:`Mapping`." +msgstr "" + +msgid "" +"These abstract classes now support ``[]``. See :ref:`types-genericalias` " +"and :pep:`585`." +msgstr "" + +msgid "Collections Abstract Base Classes" +msgstr "" + +msgid "" +"The collections module offers the following :term:`ABCs `:" +msgstr "" + +msgid "ABC" +msgstr "" + +msgid "Inherits from" +msgstr "" + +msgid "Abstract Methods" +msgstr "" + +msgid "Mixin Methods" +msgstr "" + +msgid ":class:`Container` [1]_" +msgstr "" + +msgid "``__contains__``" +msgstr "``__contains__``" + +msgid ":class:`Hashable` [1]_" +msgstr "" + +msgid "``__hash__``" +msgstr "``__hash__``" + +msgid ":class:`Iterable` [1]_ [2]_" +msgstr "" + +msgid "``__iter__``" +msgstr "``__iter__``" + +msgid ":class:`Iterator` [1]_" +msgstr "" + +msgid ":class:`Iterable`" +msgstr ":class:`Iterable`" + +msgid "``__next__``" +msgstr "``__next__``" + +msgid ":class:`Reversible` [1]_" +msgstr "" + +msgid "``__reversed__``" +msgstr "``__reversed__``" + +msgid ":class:`Generator` [1]_" +msgstr "" + +msgid ":class:`Iterator`" +msgstr ":class:`Iterator`" + +msgid "``send``, ``throw``" +msgstr "" + +msgid "``close``, ``__iter__``, ``__next__``" +msgstr "``close``, ``__iter__``, ``__next__``" + +msgid ":class:`Sized` [1]_" +msgstr "" + +msgid "``__len__``" +msgstr "``__len__``" + +msgid ":class:`Callable` [1]_" +msgstr "" + +msgid "``__call__``" +msgstr "``__call__``" + +msgid ":class:`Collection` [1]_" +msgstr "" + +msgid ":class:`Sized`, :class:`Iterable`, :class:`Container`" +msgstr "" + +msgid "``__contains__``, ``__iter__``, ``__len__``" +msgstr "``__contains__``, ``__iter__``, ``__len__``" + +msgid ":class:`Sequence`" +msgstr ":class:`Sequence`" + +msgid ":class:`Reversible`, :class:`Collection`" +msgstr ":class:`Reversible`, :class:`Collection`" + +msgid "``__getitem__``, ``__len__``" +msgstr "``__getitem__``, ``__len__``" + +msgid "" +"``__contains__``, ``__iter__``, ``__reversed__``, ``index``, and ``count``" +msgstr "" + +msgid ":class:`MutableSequence`" +msgstr ":class:`MutableSequence`" + +msgid "" +"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__len__``, ``insert``" +msgstr "" + +msgid "" +"Inherited :class:`Sequence` methods and ``append``, ``clear``, ``reverse``, " +"``extend``, ``pop``, ``remove``, and ``__iadd__``" +msgstr "" + +msgid ":class:`ByteString`" +msgstr ":class:`ByteString`" + +msgid "Inherited :class:`Sequence` methods" +msgstr "" + +msgid ":class:`Set`" +msgstr ":class:`Set`" + +msgid ":class:`Collection`" +msgstr ":class:`Collection`" + +msgid "" +"``__le__``, ``__lt__``, ``__eq__``, ``__ne__``, ``__gt__``, ``__ge__``, " +"``__and__``, ``__or__``, ``__sub__``, ``__xor__``, and ``isdisjoint``" +msgstr "" + +msgid ":class:`MutableSet`" +msgstr ":class:`MutableSet`" + +msgid "``__contains__``, ``__iter__``, ``__len__``, ``add``, ``discard``" +msgstr "" + +msgid "" +"Inherited :class:`Set` methods and ``clear``, ``pop``, ``remove``, " +"``__ior__``, ``__iand__``, ``__ixor__``, and ``__isub__``" +msgstr "" + +msgid ":class:`Mapping`" +msgstr ":class:`Mapping`" + +msgid "``__getitem__``, ``__iter__``, ``__len__``" +msgstr "``__getitem__``, ``__iter__``, ``__len__``" + +msgid "" +"``__contains__``, ``keys``, ``items``, ``values``, ``get``, ``__eq__``, and " +"``__ne__``" +msgstr "" + +msgid ":class:`MutableMapping`" +msgstr ":class:`MutableMapping`" + +msgid "" +"``__getitem__``, ``__setitem__``, ``__delitem__``, ``__iter__``, ``__len__``" +msgstr "" + +msgid "" +"Inherited :class:`Mapping` methods and ``pop``, ``popitem``, ``clear``, " +"``update``, and ``setdefault``" +msgstr "" + +msgid ":class:`MappingView`" +msgstr ":class:`MappingView`" + +msgid ":class:`Sized`" +msgstr ":class:`Sized`" + +msgid ":class:`ItemsView`" +msgstr ":class:`ItemsView`" + +msgid ":class:`MappingView`, :class:`Set`" +msgstr ":class:`MappingView`, :class:`Set`" + +msgid "``__contains__``, ``__iter__``" +msgstr "``__contains__``, ``__iter__``" + +msgid ":class:`KeysView`" +msgstr ":class:`KeysView`" + +msgid ":class:`ValuesView`" +msgstr ":class:`ValuesView`" + +msgid ":class:`MappingView`, :class:`Collection`" +msgstr ":class:`MappingView`, :class:`Collection`" + +msgid ":class:`Awaitable` [1]_" +msgstr "" + +msgid "``__await__``" +msgstr "``__await__``" + +msgid ":class:`Coroutine` [1]_" +msgstr "" + +msgid ":class:`Awaitable`" +msgstr ":class:`Awaitable`" + +msgid "``close``" +msgstr "``close``" + +msgid ":class:`AsyncIterable` [1]_" +msgstr "" + +msgid "``__aiter__``" +msgstr "``__aiter__``" + +msgid ":class:`AsyncIterator` [1]_" +msgstr "" + +msgid ":class:`AsyncIterable`" +msgstr ":class:`AsyncIterable`" + +msgid "``__anext__``" +msgstr "``__anext__``" + +msgid ":class:`AsyncGenerator` [1]_" +msgstr "" + +msgid ":class:`AsyncIterator`" +msgstr ":class:`AsyncIterator`" + +msgid "``asend``, ``athrow``" +msgstr "" + +msgid "``aclose``, ``__aiter__``, ``__anext__``" +msgstr "``aclose``, ``__aiter__``, ``__anext__``" + +msgid "Footnotes" +msgstr "Przypisy" + +msgid "" +"These ABCs override :meth:`~abc.ABCMeta.__subclasshook__` to support testing " +"an interface by verifying the required methods are present and have not been " +"set to :const:`None`. This only works for simple interfaces. More complex " +"interfaces require registration or direct subclassing." +msgstr "" + +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)``." +msgstr "" + +msgid "Collections Abstract Base Classes -- Detailed Descriptions" +msgstr "" + +msgid "ABC for classes that provide the :meth:`~object.__contains__` method." +msgstr "" + +msgid "ABC for classes that provide the :meth:`~object.__hash__` method." +msgstr "" + +msgid "ABC for classes that provide the :meth:`~object.__len__` method." +msgstr "" + +msgid "ABC for classes that provide the :meth:`~object.__call__` method." +msgstr "" + +msgid "ABC for classes that provide the :meth:`~container.__iter__` method." +msgstr "" + +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)``." +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`." +msgstr "" + +msgid "" +"ABC for iterable classes that also provide the :meth:`~object.__reversed__` " +"method." +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." +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:`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 "The index() method added support for *stop* and *start* arguments." +msgstr "" + +msgid "ABCs for read-only and mutable :ref:`sets `." +msgstr "" + +msgid "ABCs for read-only and mutable :term:`mappings `." +msgstr "" + +msgid "" +"ABCs for mapping, items, keys, and values :term:`views `." +msgstr "" + +msgid "" +"ABC for :term:`awaitable` objects, which can be used in :keyword:`await` " +"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." +msgstr "" + +msgid "" +"In CPython, generator-based coroutines (:term:`generators ` " +"decorated with :func:`@types.coroutine `) are *awaitables*, " +"even though they do not have an :meth:`~object.__await__` method. Using " +"``isinstance(gencoro, Awaitable)`` for them will return ``False``. Use :func:" +"`inspect.isawaitable` to detect them." +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`." +msgstr "" + +msgid "" +"In CPython, generator-based coroutines (:term:`generators ` " +"decorated with :func:`@types.coroutine `) are *awaitables*, " +"even though they do not have an :meth:`~object.__await__` method. Using " +"``isinstance(gencoro, Coroutine)`` for them will return ``False``. Use :func:" +"`inspect.isawaitable` to detect them." +msgstr "" + +msgid "" +"ABC for classes that provide an ``__aiter__`` method. See also the " +"definition of :term:`asynchronous iterable`." +msgstr "" + +msgid "" +"ABC for classes that provide ``__aiter__`` and ``__anext__`` methods. See " +"also the definition of :term:`asynchronous iterator`." +msgstr "" + +msgid "" +"ABC for :term:`asynchronous generator` classes that implement the protocol " +"defined in :pep:`525` and :pep:`492`." +msgstr "" + +msgid "Examples and Recipes" +msgstr "" + +msgid "" +"ABCs allow us to ask classes or instances if they provide particular " +"functionality, for example::" +msgstr "" + +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`::" +msgstr "" + +msgid "Notes on using :class:`Set` and :class:`MutableSet` as a mixin:" +msgstr "" + +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." +msgstr "" + +msgid "" +"To override the comparisons (presumably for speed, as the semantics are " +"fixed), redefine :meth:`~object.__le__` and :meth:`~object.__ge__`, then the " +"other operations will automatically follow suit." +msgstr "" + +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 " +"define ``__hash__ = Set._hash``." +msgstr "" + +msgid "" +"`OrderedSet recipe `_ for an " +"example built on :class:`MutableSet`." +msgstr "" + +msgid "For more about ABCs, see the :mod:`abc` module and :pep:`3119`." +msgstr "" diff --git a/library/colorsys.po b/library/colorsys.po new file mode 100644 index 0000000000..317f13ac33 --- /dev/null +++ b/library/colorsys.po @@ -0,0 +1,70 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`colorsys` --- Conversions between color systems" +msgstr "" + +msgid "**Source code:** :source:`Lib/colorsys.py`" +msgstr "**Kod źródłowy:** :source:`Lib/colorsys.py`" + +msgid "" +"The :mod:`colorsys` module defines bidirectional conversions of color values " +"between colors expressed in the RGB (Red Green Blue) color space used in " +"computer monitors and three other coordinate systems: YIQ, HLS (Hue " +"Lightness Saturation) and HSV (Hue Saturation Value). Coordinates in all of " +"these color spaces are floating point values. In the YIQ space, the Y " +"coordinate is between 0 and 1, but the I and Q coordinates can be positive " +"or negative. In all other spaces, the coordinates are all between 0 and 1." +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." +msgstr "" + +msgid "The :mod:`colorsys` module defines the following functions:" +msgstr "" + +msgid "Convert the color from RGB coordinates to YIQ coordinates." +msgstr "" + +msgid "Convert the color from YIQ coordinates to RGB coordinates." +msgstr "" + +msgid "Convert the color from RGB coordinates to HLS coordinates." +msgstr "" + +msgid "Convert the color from HLS coordinates to RGB coordinates." +msgstr "" + +msgid "Convert the color from RGB coordinates to HSV coordinates." +msgstr "" + +msgid "Convert the color from HSV coordinates to RGB coordinates." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" diff --git a/library/concurrent_futures.po b/library/concurrent.futures.po similarity index 93% rename from library/concurrent_futures.po rename to library/concurrent.futures.po index c1e0b24040..926c4e0d52 100644 --- a/library/concurrent_futures.po +++ b/library/concurrent.futures.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -66,14 +66,14 @@ msgid "" "callable. ::" msgstr "" -msgid "Similar to :func:`map(func, *iterables) ` except:" +msgid "Similar to :func:`map(fn, *iterables) ` except:" msgstr "" msgid "the *iterables* are collected immediately rather than lazily;" msgstr "" msgid "" -"*func* is executed asynchronously and several calls to *func* may be made " +"*fn* is executed asynchronously and several calls to *fn* may be made " "concurrently." msgstr "" @@ -86,8 +86,8 @@ msgid "" msgstr "" msgid "" -"If a *func* call raises an exception, then that exception will be raised " -"when its value is retrieved from the iterator." +"If a *fn* call raises an exception, then that exception will be raised when " +"its value is retrieved from the iterator." msgstr "" msgid "" @@ -187,7 +187,7 @@ msgid "" msgstr "" msgid "" -"The *thread_name_prefix* argument was added to allow users to control the :" +"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 "" @@ -265,10 +265,10 @@ msgid "" msgstr "" msgid "" -"When one of the worker processes terminates abruptly, a :exc:" -"`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 "" @@ -442,24 +442,15 @@ msgstr "Stała" msgid "Description" msgstr "Opis" -msgid ":const:`FIRST_COMPLETED`" -msgstr "" - msgid "The function will return when any future finishes or is cancelled." msgstr "" -msgid ":const:`FIRST_EXCEPTION`" -msgstr "" - msgid "" -"The function will return when any future finishes by raising an exception. " +"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`." msgstr "" -msgid ":const:`ALL_COMPLETED`" -msgstr "" - msgid "The function will return when all futures finish or are cancelled." msgstr "" @@ -510,13 +501,13 @@ msgstr "" msgid "" "Derived from :exc:`~concurrent.futures.BrokenExecutor`, this exception class " -"is raised when one of the workers of a :class:`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.BrokenExecutor` (formerly :exc:" "`RuntimeError`), this exception class is raised when one of the workers of " -"a :class:`ProcessPoolExecutor` has terminated in a non-clean fashion (for " -"example, if it was killed from the outside)." +"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/configparser.po b/library/configparser.po index c89e5f59e5..91cdabf383 100644 --- a/library/configparser.po +++ b/library/configparser.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2021 -# Stefan Ocetkiewicz , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +50,7 @@ msgid "" msgstr "" msgid "Module :mod:`shlex`" -msgstr "" +msgstr "moduł :mod:`shlex`" msgid "" "Support for creating Unix shell-like mini-languages which can also be used " @@ -60,7 +58,7 @@ msgid "" msgstr "" msgid "Module :mod:`json`" -msgstr "" +msgstr "moduł :mod:`json`" msgid "" "The ``json`` module implements a subset of JavaScript syntax which is " @@ -141,8 +139,8 @@ msgid "Fallback Values" msgstr "" msgid "" -"As with a dictionary, you can use a section's :meth:`get` method to provide " -"fallback values:" +"As with a dictionary, you can use a section's :meth:`~ConfigParser.get` " +"method to provide fallback values:" msgstr "" msgid "" @@ -154,10 +152,10 @@ msgid "" msgstr "" msgid "" -"One more thing to be aware of is that the parser-level :meth:`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 "" @@ -182,8 +180,8 @@ msgid "" msgstr "" msgid "" -"By default, a valid section name can be any string that does not contain '\\" -"\\n' or ']'. To change this, see :attr:`ConfigParser.SECTCRE`." +"By default, a valid section name can be any string that does not contain '\\" +"\\n'. To change this, see :attr:`ConfigParser.SECTCRE`." msgstr "" msgid "" @@ -331,7 +329,7 @@ msgstr "" msgid "" "The most common way to change the way a specific config parser works is to " -"use the :meth:`__init__` options:" +"use the :meth:`!__init__` options:" msgstr "" msgid "*defaults*, default value: ``None``" @@ -346,7 +344,7 @@ msgstr "" msgid "" "Hint: if you want to specify default values for a specific section, use :" -"meth:`read_dict` before you read the actual file." +"meth:`~ConfigParser.read_dict` before you read the actual file." msgstr "" msgid "*dict_type*, default value: :class:`dict`" @@ -428,9 +426,9 @@ 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:`read_file`, :" -"meth:`read_string` or :meth:`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 "" @@ -498,7 +496,7 @@ msgid "" "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 " +"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)``." @@ -616,7 +614,9 @@ msgid "" "When *default_section* is given, it specifies the name for the special " "section holding default values for other sections and interpolation purposes " "(normally named ``\"DEFAULT\"``). This value can be retrieved and changed " -"on runtime using the ``default_section`` instance attribute." +"at runtime using the ``default_section`` instance attribute. This won't re-" +"evaluate an already parsed config file, but will be used when writing parsed " +"settings to a new config file." msgstr "" msgid "" @@ -639,7 +639,7 @@ msgid "" "When *converters* is given, it should be a dictionary where each key " "represents the name of a type converter and each value is a callable " "implementing the conversion from string to the desired datatype. Every " -"converter gets its own corresponding :meth:`get*()` method on the parser " +"converter gets its own corresponding :meth:`!get*()` method on the parser " "object and section proxies." msgstr "" @@ -720,8 +720,8 @@ msgid "" msgstr "" msgid "" -"The *encoding* parameter. Previously, all files were read using the default " -"encoding for :func:`open`." +"Added the *encoding* parameter. Previously, all files were read using the " +"default encoding for :func:`open`." msgstr "" msgid "The *filenames* parameter accepts a :term:`path-like object`." @@ -737,11 +737,11 @@ msgstr "" msgid "" "Optional argument *source* specifies the name of the file being read. If " -"not given and *f* has a :attr:`name` attribute, that is used for *source*; " +"not given and *f* has a :attr:`!name` attribute, that is used for *source*; " "the default is ``''``." msgstr "" -msgid "Replaces :meth:`readfp`." +msgid "Replaces :meth:`!readfp`." msgstr "" msgid "Parse configuration data from a string." @@ -899,9 +899,9 @@ msgid "" msgstr "" msgid "" -"The maximum depth for recursive interpolation for :meth:`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" @@ -957,14 +957,14 @@ msgid "Exception raised when a specified section is not found." msgstr "" msgid "" -"Exception raised if :meth:`add_section` is called with the name of a section " -"that is already present or in strict parsers when a section if found more " -"than once in a single input file, string or dictionary." +"Exception raised if :meth:`~ConfigParser.add_section` is called with the " +"name of a section that is already present or in strict parsers when a " +"section if found more than once in a single input file, string or dictionary." msgstr "" msgid "" -"Optional ``source`` and ``lineno`` attributes and arguments to :meth:" -"`__init__` were added." +"Added the optional *source* and *lineno* attributes and parameters to :meth:" +"`!__init__`." msgstr "" msgid "" @@ -1009,7 +1009,7 @@ msgid "Exception raised when errors occur attempting to parse a file." msgstr "" msgid "" -"The ``filename`` attribute and :meth:`__init__` argument were renamed to " +"The ``filename`` attribute and :meth:`!__init__` argument were renamed to " "``source`` for consistency." msgstr "" @@ -1026,7 +1026,7 @@ msgid ".ini" msgstr "" msgid "file" -msgstr "" +msgstr "plik" msgid "configuration" msgstr "" @@ -1044,4 +1044,4 @@ msgid "interpolation in configuration files" msgstr "" msgid "$ (dollar)" -msgstr "" +msgstr "$ (dollar)" diff --git a/library/constants.po b/library/constants.po new file mode 100644 index 0000000000..8dac122c84 --- /dev/null +++ b/library/constants.po @@ -0,0 +1,187 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 :data:`~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." +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 " +"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 "" +"``NotImplementedError`` and :data:`!NotImplemented` are not interchangeable, " +"even though they have similar names and purposes. See :exc:" +"`NotImplementedError` for details on when to use it." +msgstr "" +"``NotImplementedError`` i :data:`!NotImplemented` nie są wymienne, nawet " +"jeśli mają podobne nazwy i zastosowanie. Zobacz :exc:`NotImplementedError` " +"by dowiedzieć się kiedy go użyć." + +msgid "" +"Evaluating :data:`!NotImplemented` in a boolean context is deprecated. While " +"it currently evaluates as true, it will emit a :exc:`DeprecationWarning`. It " +"will raise a :exc:`TypeError` in a future version of Python." +msgstr "" +"Ewaluacja :data:`!NotImplemented` w kontekście logicznym jest przestarzała. " +"Podczas gdy obecnie jej wartość zostanie oceniona jako \"prawda\", to " +"jednocześnie wyemituje ostrzeżenie :exc:`DeprecationWarning`. W przyszłych " +"wersjach Pythona będzie rzucać wyjątkiem :exc:`TypeError`." + +msgid "" +"The same as the ellipsis literal \"``...``\". Special value used mostly in " +"conjunction with extended slicing syntax for user-defined container data " +"types. ``Ellipsis`` is the sole instance of the :data:`types.EllipsisType` " +"type." +msgstr "" +"To samo co literalny zapis wielokropka \"``...``\". Wartość specjalna " +"używana głównie w połączeniu z rozszerzoną składnią krojenia typów danych " +"kontenerów zdefiniowanych przez użytkownika. ``Ellipsis`` jest jedyną " +"instancją typu :data:`types.EllipsisType`." + +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 called, raise :exc:`SystemExit` with the specified " +"exit code." +msgstr "" +"Obiekty, które, gdy ich nazwa zostanie wpisana w powłoce - wyświetlają " +"wiadomość w formie \"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 "" +"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/library/contextvars.po b/library/contextvars.po index 541cc5dab0..ccb3865ece 100644 --- a/library/contextvars.po +++ b/library/contextvars.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -142,8 +142,9 @@ msgid "" msgstr "" msgid "" -"The function has an O(1) complexity, i.e. works equally fast for contexts " -"with a few context variables and for contexts that have a lot of them." +"The function has an *O*\\ (1) complexity, i.e. works equally fast for " +"contexts with a few context variables and for contexts that have a lot of " +"them." msgstr "" msgid "A mapping of :class:`ContextVars ` to their values." diff --git a/library/copy.po b/library/copy.po index 305e2fcc59..1f168f0f75 100644 --- a/library/copy.po +++ b/library/copy.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +38,7 @@ msgid "" msgstr "" msgid "Interface summary:" -msgstr "" +msgstr "Podsumowanie interfejsu:" msgid "Return a shallow copy of *x*." msgstr "" @@ -127,7 +127,7 @@ msgid "" msgstr "" msgid "Module :mod:`pickle`" -msgstr "" +msgstr "moduł :mod:`pickle`" msgid "" "Discussion of the special methods used to support object state retrieval and " diff --git a/library/copyreg.po b/library/copyreg.po index e3b13f0422..a8521577d0 100644 --- a/library/copyreg.po +++ b/library/copyreg.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +61,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "" "The example below would like to show how to register a pickle function and " diff --git a/library/crypt.po b/library/crypt.po index c2813d9a42..68712dc92a 100644 --- a/library/crypt.po +++ b/library/crypt.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:13+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -32,7 +32,8 @@ msgstr "" msgid "" "The :mod:`crypt` module is deprecated (see :pep:`PEP 594 <594#crypt>` for " "details and alternatives). The :mod:`hashlib` module is a potential " -"replacement for certain use cases." +"replacement for certain use cases. The `passlib `_ package can replace all use cases of this module." msgstr "" msgid "" diff --git a/library/csv.po b/library/csv.po index 5d224591c6..59e7d9eb1f 100644 --- a/library/csv.po +++ b/library/csv.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,18 +70,17 @@ msgid "The :mod:`csv` module defines the following functions:" msgstr "" msgid "" -"Return a reader object which will iterate over lines in the given *csvfile*. " -"*csvfile* can be any object which supports the :term:`iterator` protocol and " -"returns a string each time its :meth:`!__next__` method is called --- :term:" -"`file objects ` and list objects are both suitable. 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 the dialect and formatting " -"parameters, see section :ref:`csv-fmt-params`." +"Return a :ref:`reader object ` that will process lines from " +"the given *csvfile*. A csvfile must be an iterable of strings, each in the " +"reader's defined csv format. A csvfile is most commonly a file-like object " +"or list. 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 the dialect and " +"formatting parameters, see section :ref:`csv-fmt-params`." msgstr "" msgid "" @@ -97,20 +96,20 @@ 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 :func:`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 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 without preprocessing the data " -"returned from a ``cursor.fetch*`` call. All other non-string data are " -"stringified with :func:`str` before being written." +"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 " +"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 " +"without preprocessing the data returned from a ``cursor.fetch*`` call. All " +"other non-string data are stringified with :func:`str` before being written." msgstr "" msgid "" @@ -179,15 +178,15 @@ msgid "" "Create an object which operates like a regular writer but maps dictionaries " "onto output rows. The *fieldnames* parameter is a :mod:`sequence " "` of keys that identify the order in which values in the " -"dictionary passed to the :meth:`writerow` method are written to file *f*. " -"The optional *restval* parameter specifies the value to be written if the " -"dictionary is missing a key in *fieldnames*. If the dictionary passed to " -"the :meth:`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." +"dictionary passed to the :meth:`~csvwriter.writerow` method are written to " +"file *f*. The optional *restval* parameter specifies the value to be " +"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." msgstr "" msgid "" @@ -308,10 +307,10 @@ msgstr "" 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 having a set of specific " -"methods and a single :meth:`validate` method. 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 " +"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." @@ -369,8 +368,8 @@ msgstr "" msgid "" "Controls when quotes should be generated by the writer and recognised by the " -"reader. It can take on any of the :const:`QUOTE_\\*` constants (see " -"section :ref:`csv-contents`) and defaults to :const:`QUOTE_MINIMAL`." +"reader. It can take on any of the :ref:`QUOTE_\\* constants ` and defaults to :const:`QUOTE_MINIMAL`." msgstr "" msgid "" @@ -421,9 +420,9 @@ msgid "Writer Objects" msgstr "" msgid "" -":class:`Writer` objects (:class:`DictWriter` instances and objects returned " +":class:`writer` objects (:class:`DictWriter` instances and objects returned " "by the :func:`writer` function) have the following public methods. A *row* " -"must be an iterable of strings or numbers for :class:`Writer` objects and a " +"must be an iterable of strings or numbers for :class:`writer` objects and a " "dictionary mapping fieldnames to strings or numbers (by passing them " "through :func:`str` first) for :class:`DictWriter` objects. Note that " "complex numbers are written out surrounded by parens. This may cause some " @@ -524,7 +523,7 @@ msgid "tabular" msgstr "" msgid "universal newlines" -msgstr "" +msgstr "uniwersalne nowe linie" msgid "csv.reader function" msgstr "" diff --git a/library/ctypes.po b/library/ctypes.po index c66f9cec18..2e9cbb9b2e 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -201,127 +201,127 @@ msgid "Python type" msgstr "" msgid ":class:`c_bool`" -msgstr "" +msgstr ":class:`c_bool`" msgid ":c:expr:`_Bool`" -msgstr "" +msgstr ":c:expr:`_Bool`" msgid "bool (1)" msgstr "" msgid ":class:`c_char`" -msgstr "" +msgstr ":class:`c_char`" msgid ":c:expr:`char`" -msgstr "" +msgstr ":c:expr:`char`" msgid "1-character bytes object" msgstr "" msgid ":class:`c_wchar`" -msgstr "" +msgstr ":class:`c_wchar`" -msgid ":c:expr:`wchar_t`" -msgstr "" +msgid ":c:type:`wchar_t`" +msgstr ":c:type:`wchar_t`" msgid "1-character string" msgstr "" msgid ":class:`c_byte`" -msgstr "" +msgstr ":class:`c_byte`" msgid "int" msgstr "int" msgid ":class:`c_ubyte`" -msgstr "" +msgstr ":class:`c_ubyte`" msgid ":c:expr:`unsigned char`" msgstr "" msgid ":class:`c_short`" -msgstr "" +msgstr ":class:`c_short`" msgid ":c:expr:`short`" -msgstr "" +msgstr ":c:expr:`short`" msgid ":class:`c_ushort`" -msgstr "" +msgstr ":class:`c_ushort`" msgid ":c:expr:`unsigned short`" msgstr "" msgid ":class:`c_int`" -msgstr "" +msgstr ":class:`c_int`" msgid ":c:expr:`int`" -msgstr "" +msgstr ":c:expr:`int`" msgid ":class:`c_uint`" -msgstr "" +msgstr ":class:`c_uint`" msgid ":c:expr:`unsigned int`" msgstr "" msgid ":class:`c_long`" -msgstr "" +msgstr ":class:`c_long`" msgid ":c:expr:`long`" -msgstr "" +msgstr ":c:expr:`long`" msgid ":class:`c_ulong`" -msgstr "" +msgstr ":class:`c_ulong`" msgid ":c:expr:`unsigned long`" msgstr "" msgid ":class:`c_longlong`" -msgstr "" +msgstr ":class:`c_longlong`" msgid ":c:expr:`__int64` or :c:expr:`long long`" msgstr "" msgid ":class:`c_ulonglong`" -msgstr "" +msgstr ":class:`c_ulonglong`" msgid ":c:expr:`unsigned __int64` or :c:expr:`unsigned long long`" msgstr "" msgid ":class:`c_size_t`" -msgstr "" +msgstr ":class:`c_size_t`" -msgid ":c:expr:`size_t`" -msgstr "" +msgid ":c:type:`size_t`" +msgstr ":c:type:`size_t`" msgid ":class:`c_ssize_t`" -msgstr "" +msgstr ":class:`c_ssize_t`" -msgid ":c:expr:`ssize_t` or :c:expr:`Py_ssize_t`" +msgid ":c:type:`ssize_t` or :c:expr:`Py_ssize_t`" msgstr "" msgid ":class:`c_float`" -msgstr "" +msgstr ":class:`c_float`" msgid ":c:expr:`float`" -msgstr "" +msgstr ":c:expr:`float`" msgid "float" msgstr "typ (float) zmiennoprzecinkowy pojedynczej precyzji" msgid ":class:`c_double`" -msgstr "" +msgstr ":class:`c_double`" msgid ":c:expr:`double`" -msgstr "" +msgstr ":c:expr:`double`" msgid ":class:`c_longdouble`" -msgstr "" +msgstr ":class:`c_longdouble`" msgid ":c:expr:`long double`" msgstr "" msgid ":class:`c_char_p`" -msgstr "" +msgstr ":class:`c_char_p`" msgid ":c:expr:`char *` (NUL terminated)" msgstr "" @@ -330,7 +330,7 @@ msgid "bytes object or ``None``" msgstr "" msgid ":class:`c_wchar_p`" -msgstr "" +msgstr ":class:`c_wchar_p`" msgid ":c:expr:`wchar_t *` (NUL terminated)" msgstr "" @@ -339,7 +339,7 @@ msgid "string or ``None``" msgstr "" msgid ":class:`c_void_p`" -msgstr "" +msgstr ":class:`c_void_p`" msgid ":c:expr:`void *`" msgstr "" @@ -378,7 +378,7 @@ msgstr "" msgid "" "The :func:`create_string_buffer` function replaces the old :func:`c_buffer` " "function (which is still available as an alias). To create a mutable memory " -"block containing unicode characters of the C type :c:expr:`wchar_t`, use " +"block containing unicode characters of the C type :c:type:`wchar_t`, use " "the :func:`create_unicode_buffer` function." msgstr "" @@ -423,9 +423,10 @@ msgstr "" msgid "" "You can also customize :mod:`ctypes` argument conversion to allow instances " -"of your own classes be used as function arguments. :mod:`ctypes` looks for " -"an :attr:`_as_parameter_` attribute and uses this as the function argument. " -"Of course, it must be one of integer, string, or bytes::" +"of your own classes be used as function arguments. :mod:`ctypes` looks for " +"an :attr:`!_as_parameter_` attribute and uses this as the function argument. " +"The attribute must be an integer, string, bytes, a :mod:`ctypes` instance, " +"or an object with an :attr:`!_as_parameter_` attribute::" msgstr "" msgid "" @@ -811,7 +812,7 @@ msgid "" msgstr "" msgid "The result::" -msgstr "" +msgstr "Wynik::" msgid "Now we can actually compare the two items and return a useful result::" msgstr "" @@ -1082,7 +1083,9 @@ msgid "" "value signals a failure, an :class:`OSError` is automatically raised." msgstr "" -msgid ":exc:`WindowsError` used to be raised." +msgid "" +":exc:`WindowsError` used to be raised, which is now an alias of :exc:" +"`OSError`." msgstr "" msgid "" @@ -1454,7 +1457,7 @@ msgstr "" msgid "" "COM methods use a special calling convention: They require a pointer to the " "COM interface as first argument, in addition to those parameters that are " -"specified in the :attr:`argtypes` tuple." +"specified in the :attr:`!argtypes` tuple." msgstr "" msgid "" @@ -1462,7 +1465,9 @@ msgid "" "much more functionality than the features described above." msgstr "" -msgid "*paramflags* must be a tuple of the same length as :attr:`argtypes`." +msgid "" +"*paramflags* must be a tuple of the same length as :attr:`~_FuncPtr." +"argtypes`." msgstr "" msgid "" @@ -1502,8 +1507,8 @@ msgid "The optional third item is the default value for this parameter." msgstr "" msgid "" -"This example demonstrates how to wrap the Windows ``MessageBoxW`` function " -"so that it supports default parameters and named arguments. The C " +"The following example demonstrates how to wrap the Windows ``MessageBoxW`` " +"function so that it supports default parameters and named arguments. The C " "declaration from the windows header file is this::" msgstr "" @@ -1704,14 +1709,14 @@ msgid "" msgstr "" msgid "" -"This factory function creates and returns a new ctypes pointer type. Pointer " -"types are cached and reused internally, so calling this function repeatedly " -"is cheap. *type* must be a ctypes type." +"Create and return a new ctypes pointer type. Pointer types are cached and " +"reused internally, so calling this function repeatedly is cheap. *type* must " +"be a ctypes type." msgstr "" msgid "" -"This function creates a new pointer instance, pointing to *obj*. The " -"returned object is of the type ``POINTER(type(obj))``." +"Create a new pointer instance, pointing to *obj*. The returned object is of " +"the type ``POINTER(type(obj))``." msgstr "" msgid "" @@ -1765,13 +1770,15 @@ msgstr "" msgid "" "Windows only: this function is probably the worst-named thing in ctypes. It " -"creates an instance of OSError. If *code* is not specified, " +"creates an instance of :exc:`OSError`. If *code* is not specified, " "``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 "An instance of :exc:`WindowsError` used to be created." +msgid "" +"An instance of :exc:`WindowsError` used to be created, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "" @@ -2057,7 +2064,7 @@ msgid "" msgstr "" msgid "" -"Represents the C :c:expr:`wchar_t` datatype, and interprets the value as a " +"Represents the C :c:type:`wchar_t` datatype, and interprets the value as a " "single character unicode string. The constructor accepts an optional string " "initializer, the length of the string must be exactly one character." msgstr "" diff --git a/library/curses_ascii.po b/library/curses.ascii.po similarity index 95% rename from library/curses_ascii.po rename to library/curses.ascii.po index 4dd1a9a87b..801f4d04f8 100644 --- a/library/curses_ascii.po +++ b/library/curses.ascii.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/curses_panel.po b/library/curses.panel.po similarity index 92% rename from library/curses_panel.po rename to library/curses.panel.po index 1b6e0aab96..d3cc18a139 100644 --- a/library/curses_panel.po +++ b/library/curses.panel.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/curses.po b/library/curses.po index 4fac3ef610..6dbf249c07 100644 --- a/library/curses.po +++ b/library/curses.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Michał Biliński , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Michał Biliński , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +52,7 @@ msgid "" msgstr "" msgid "Module :mod:`curses.ascii`" -msgstr "" +msgstr "moduł :mod:`curses.ascii`" msgid "" "Utilities for working with ASCII characters, regardless of your locale " @@ -61,13 +60,13 @@ msgid "" msgstr "" msgid "Module :mod:`curses.panel`" -msgstr "" +msgstr "moduł :mod:`curses.panel`" msgid "A panel stack extension that adds depth to curses windows." msgstr "" msgid "Module :mod:`curses.textpad`" -msgstr "" +msgstr "moduł :mod:`curses.textpad`" msgid "" "Editable text widget for curses supporting :program:`Emacs`\\ -like " @@ -75,7 +74,7 @@ msgid "" msgstr "" msgid ":ref:`curses-howto`" -msgstr "" +msgstr ":ref:`curses-howto`" msgid "" "Tutorial material on using curses with Python, by Andrew Kuchling and Eric " @@ -621,8 +620,8 @@ msgid "Only one *ch* can be pushed before :meth:`!getch` is called." msgstr "" msgid "" -"Update :envvar:`LINES` and :envvar:`COLS`. Useful for detecting manual " -"screen resize." +"Update the :const:`LINES` and :const:`COLS` module variables. Useful for " +"detecting manual screen resize." msgstr "" msgid "Push *ch* so the next :meth:`~window.get_wch` will return it." @@ -780,7 +779,7 @@ msgid "Left side" msgstr "" msgid ":const:`ACS_VLINE`" -msgstr "" +msgstr ":const:`ACS_VLINE`" msgid "*rs*" msgstr "" @@ -795,7 +794,7 @@ msgid "Top" msgstr "" msgid ":const:`ACS_HLINE`" -msgstr "" +msgstr ":const:`ACS_HLINE`" msgid "*bs*" msgstr "" @@ -810,7 +809,7 @@ msgid "Upper-left corner" msgstr "" msgid ":const:`ACS_ULCORNER`" -msgstr "" +msgstr ":const:`ACS_ULCORNER`" msgid "*tr*" msgstr "" @@ -819,7 +818,7 @@ msgid "Upper-right corner" msgstr "" msgid ":const:`ACS_URCORNER`" -msgstr "" +msgstr ":const:`ACS_URCORNER`" msgid "*bl*" msgstr "" @@ -828,7 +827,7 @@ msgid "Bottom-left corner" msgstr "" msgid ":const:`ACS_LLCORNER`" -msgstr "" +msgstr ":const:`ACS_LLCORNER`" msgid "*br*" msgstr "" @@ -837,7 +836,7 @@ msgid "Bottom-right corner" msgstr "" msgid ":const:`ACS_LRCORNER`" -msgstr "" +msgstr ":const:`ACS_LRCORNER`" msgid "" "Similar to :meth:`border`, but both *ls* and *rs* are *vertch* and both *ts* " @@ -1269,10 +1268,26 @@ msgstr "" msgid "Availability: if the ncurses library is used." msgstr "" -msgid "The maximum number of colors the terminal can support." +msgid "" +"The maximum number of colors the terminal can support. It is defined only " +"after the call to :func:`start_color`." +msgstr "" + +msgid "" +"The maximum number of color pairs the terminal can support. It is defined " +"only after the call to :func:`start_color`." msgstr "" -msgid "The maximum number of color pairs the terminal can support." +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`." +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`." msgstr "" msgid "" @@ -1281,7 +1296,7 @@ msgid "" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Meaning" msgstr "Znaczenie" @@ -1668,37 +1683,37 @@ msgid "Constant" msgstr "Stała" msgid ":kbd:`Insert`" -msgstr "" +msgstr ":kbd:`Insert`" msgid "KEY_IC" msgstr "" msgid ":kbd:`Delete`" -msgstr "" +msgstr ":kbd:`Delete`" msgid "KEY_DC" msgstr "" msgid ":kbd:`Home`" -msgstr "" +msgstr ":kbd:`Home`" msgid "KEY_HOME" msgstr "" msgid ":kbd:`End`" -msgstr "" +msgstr ":kbd:`End`" msgid "KEY_END" msgstr "" msgid ":kbd:`Page Up`" -msgstr "" +msgstr ":kbd:`Page Up`" msgid "KEY_PPAGE" msgstr "" msgid ":kbd:`Page Down`" -msgstr "" +msgstr ":kbd:`Page Down`" msgid "KEY_NPAGE" msgstr "" @@ -1968,79 +1983,79 @@ msgid "Action" msgstr "" msgid ":kbd:`Control-A`" -msgstr "" +msgstr ":kbd:`Control-A`" msgid "Go to left edge of window." msgstr "" msgid ":kbd:`Control-B`" -msgstr "" +msgstr ":kbd:`Control-B`" msgid "Cursor left, wrapping to previous line if appropriate." msgstr "" msgid ":kbd:`Control-D`" -msgstr "" +msgstr ":kbd:`Control-D`" msgid "Delete character under cursor." msgstr "" msgid ":kbd:`Control-E`" -msgstr "" +msgstr ":kbd:`Control-E`" msgid "Go to right edge (stripspaces off) or end of line (stripspaces on)." msgstr "" msgid ":kbd:`Control-F`" -msgstr "" +msgstr ":kbd:`Control-F`" msgid "Cursor right, wrapping to next line when appropriate." msgstr "" msgid ":kbd:`Control-G`" -msgstr "" +msgstr ":kbd:`Control-G`" msgid "Terminate, returning the window contents." msgstr "" msgid ":kbd:`Control-H`" -msgstr "" +msgstr ":kbd:`Control-H`" msgid "Delete character backward." msgstr "" msgid ":kbd:`Control-J`" -msgstr "" +msgstr ":kbd:`Control-J`" msgid "Terminate if the window is 1 line, otherwise insert newline." msgstr "" msgid ":kbd:`Control-K`" -msgstr "" +msgstr ":kbd:`Control-K`" msgid "If line is blank, delete it, otherwise clear to end of line." msgstr "" msgid ":kbd:`Control-L`" -msgstr "" +msgstr ":kbd:`Control-L`" msgid "Refresh screen." msgstr "" msgid ":kbd:`Control-N`" -msgstr "" +msgstr ":kbd:`Control-N`" msgid "Cursor down; move down one line." msgstr "" msgid ":kbd:`Control-O`" -msgstr "" +msgstr ":kbd:`Control-O`" msgid "Insert a blank line at cursor location." msgstr "" msgid ":kbd:`Control-P`" -msgstr "" +msgstr ":kbd:`Control-P`" msgid "Cursor up; move up one line." msgstr "" @@ -2051,22 +2066,22 @@ msgid "" msgstr "" msgid ":const:`~curses.KEY_LEFT`" -msgstr "" +msgstr ":const:`~curses.KEY_LEFT`" msgid ":const:`~curses.KEY_RIGHT`" -msgstr "" +msgstr ":const:`~curses.KEY_RIGHT`" msgid ":const:`~curses.KEY_UP`" -msgstr "" +msgstr ":const:`~curses.KEY_UP`" msgid ":const:`~curses.KEY_DOWN`" -msgstr "" +msgstr ":const:`~curses.KEY_DOWN`" msgid ":const:`~curses.KEY_BACKSPACE`" -msgstr "" +msgstr ":const:`~curses.KEY_BACKSPACE`" msgid ":kbd:`Control-h`" -msgstr "" +msgstr ":kbd:`Control-h`" msgid "" "All other keystrokes are treated as a command to insert the given character " diff --git a/library/datatypes.po b/library/datatypes.po index d63bd776f7..3572f56d87 100644 --- a/library/datatypes.po +++ b/library/datatypes.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/datetime.po b/library/datetime.po index f325f3849f..6091c2a7e3 100644 --- a/library/datetime.po +++ b/library/datetime.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 -# Michał Biliński , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Michał Biliński , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +30,8 @@ msgid "**Source code:** :source:`Lib/datetime.py`" msgstr "" msgid "" -"The :mod:`datetime` module supplies classes for manipulating dates and times." +"The :mod:`!datetime` module supplies classes for manipulating dates and " +"times." msgstr "" msgid "" @@ -40,6 +39,9 @@ msgid "" "is on efficient attribute extraction for output formatting and manipulation." msgstr "" +msgid "Skip to :ref:`the format codes `." +msgstr "" + msgid "Module :mod:`calendar`" msgstr "" @@ -64,6 +66,15 @@ msgstr "" msgid "Third-party library with expanded time zone and parsing support." msgstr "" +msgid "Package `DateType `_" +msgstr "" + +msgid "" +"Third-party library that introduces distinct static types to e.g. allow :" +"term:`static type checkers ` to differentiate between " +"naive and aware datetimes." +msgstr "" + msgid "Aware and Naive Objects" msgstr "" @@ -101,7 +112,7 @@ msgstr "" msgid "" "Only one concrete :class:`tzinfo` class, the :class:`timezone` class, is " -"supplied by the :mod:`datetime` module. The :class:`timezone` class can " +"supplied by the :mod:`!datetime` module. The :class:`timezone` class can " "represent simple timezones with fixed offsets from UTC, such as UTC itself " "or North American EST and EDT timezones. Supporting timezones at deeper " "levels of detail is up to the application. The rules for time adjustment " @@ -112,7 +123,7 @@ msgstr "" msgid "Constants" msgstr "Stały" -msgid "The :mod:`datetime` module exports the following constants:" +msgid "The :mod:`!datetime` module exports the following constants:" msgstr "" msgid "" @@ -151,8 +162,8 @@ msgid "" msgstr "" msgid "" -"A duration expressing the difference between two :class:`date`, :class:`." -"time`, or :class:`.datetime` instances to microsecond resolution." +"A duration expressing the difference between two :class:`.datetime` or :" +"class:`date` instances to microsecond resolution." msgstr "" msgid "" @@ -235,7 +246,7 @@ msgstr "" msgid "" "A :class:`timedelta` object represents a duration, the difference between " -"two dates or times." +"two :class:`.datetime` or :class:`date` instances." msgstr "" msgid "" @@ -323,7 +334,7 @@ msgid "Instance attributes (read-only):" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Value" msgstr "Wartość" @@ -415,7 +426,7 @@ msgid "" msgstr "" msgid "``t1 = t2 % t3``" -msgstr "" +msgstr "``t1 = t2 % t3``" msgid "The remainder is computed as a :class:`timedelta` object. (3)" msgstr "" @@ -429,13 +440,13 @@ msgid "" msgstr "" msgid "``+t1``" -msgstr "" +msgstr "``+t1``" msgid "Returns a :class:`timedelta` object with the same value. (2)" msgstr "" msgid "``-t1``" -msgstr "" +msgstr "``-t1``" msgid "" "equivalent to :class:`timedelta`\\ (-*t1.days*, -*t1.seconds*, -*t1." @@ -443,7 +454,7 @@ msgid "" msgstr "" msgid "``abs(t)``" -msgstr "" +msgstr "``abs(t)``" msgid "" "equivalent to +\\ *t* when ``t.days >= 0``, and to -*t* when ``t.days < 0``. " @@ -451,7 +462,7 @@ msgid "" msgstr "" msgid "``str(t)``" -msgstr "" +msgstr "``str(t)``" msgid "" "Returns a string in the form ``[D day[s], ][H]H:MM:SS[.UUUUUU]``, where D is " @@ -459,7 +470,7 @@ msgid "" msgstr "" msgid "``repr(t)``" -msgstr "" +msgstr "``repr(t)``" msgid "" "Returns a string representation of the :class:`timedelta` object as a " @@ -506,19 +517,7 @@ msgid "" "`timedelta` object by a :class:`float` object are now supported." msgstr "" -msgid "" -"Comparisons of :class:`timedelta` objects are supported, with some caveats." -msgstr "" - -msgid "" -"The comparisons ``==`` or ``!=`` *always* return a :class:`bool`, no matter " -"the type of the compared object::" -msgstr "" - -msgid "" -"For all other comparisons (such as ``<`` and ``>``), when a :class:" -"`timedelta` object is compared to an object of a different type, :exc:" -"`TypeError` is raised::" +msgid ":class:`timedelta` objects support equality and order comparisons." msgstr "" msgid "" @@ -623,9 +622,24 @@ msgstr "" msgid "" "Return a :class:`date` corresponding to a *date_string* given in any valid " -"ISO 8601 format, except ordinal dates (e.g. ``YYYY-DDD``)::" +"ISO 8601 format, with the following exceptions:" +msgstr "" + +msgid "" +"Reduced precision dates are not currently supported (``YYYY-MM``, ``YYYY``)." +msgstr "" + +msgid "" +"Extended date representations are not currently supported (``±YYYYYY-MM-" +"DD``)." +msgstr "" + +msgid "Ordinal dates are not currently supported (``YYYY-OOO``)." msgstr "" +msgid "Examples::" +msgstr "Przykłady::" + msgid "Previously, this method only supported the format ``YYYY-MM-DD``." msgstr "" @@ -673,12 +687,28 @@ msgstr "" msgid "\\(3)" msgstr "\\(3)" -msgid "``date1 < date2``" +msgid "``date1 == date2``" +msgstr "``date1 == date2``" + +msgid "``date1 != date2``" +msgstr "``date1 != date2``" + +msgid "Equality comparison. (4)" msgstr "" -msgid "" -"*date1* is considered less than *date2* when *date1* precedes *date2* in " -"time. (4)" +msgid "``date1 < date2``" +msgstr "``date1 < date2``" + +msgid "``date1 > date2``" +msgstr "``date1 > date2``" + +msgid "``date1 <= date2``" +msgstr "``date1 <= date2``" + +msgid "``date1 >= date2``" +msgstr "``date1 >= date2``" + +msgid "Order comparison. (5)" msgstr "" msgid "" @@ -697,16 +727,13 @@ msgid "" "microseconds are 0, and date2 + timedelta == date1 after." msgstr "" +msgid ":class:`date` objects are equal if they represent the same date." +msgstr "" + msgid "" -"In other words, ``date1 < date2`` if and only if ``date1.toordinal() < date2." -"toordinal()``. Date comparison raises :exc:`TypeError` if the other " -"comparand isn't also a :class:`date` object. However, ``NotImplemented`` is " -"returned instead if the other comparand has a :meth:`timetuple` attribute. " -"This hook gives other kinds of date objects a chance at implementing mixed-" -"type comparison. If not, when a :class:`date` object is compared to an " -"object of a different type, :exc:`TypeError` is raised unless the comparison " -"is ``==`` or ``!=``. The latter cases return :const:`False` or :const:" -"`True`, respectively." +"*date1* is considered less than *date2* when *date1* precedes *date2* in " +"time. In other words, ``date1 < date2`` if and only if ``date1.toordinal() < " +"date2.toordinal()``." msgstr "" msgid "" @@ -719,7 +746,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "" "Return a :class:`time.struct_time` such as returned by :func:`time." @@ -870,14 +897,14 @@ msgstr "" msgid "``fold in [0, 1]``." msgstr "" -msgid "Added the ``fold`` argument." +msgid "Added the *fold* parameter." msgstr "" msgid "Return the current local datetime, with :attr:`.tzinfo` ``None``." msgstr "" msgid "Equivalent to::" -msgstr "" +msgstr "Odpowiednik::" msgid "See also :meth:`now`, :meth:`fromtimestamp`." msgstr "" @@ -1031,15 +1058,9 @@ msgstr "" msgid "The ``T`` separator may be replaced by any single unicode character." msgstr "" -msgid "Ordinal dates are not currently supported." -msgstr "" - msgid "Fractional hours and minutes are not supported." msgstr "" -msgid "Examples::" -msgstr "" - msgid "" "Previously, this method only supported formats that could be emitted by :" "meth:`date.isoformat()` or :meth:`datetime.isoformat()`." @@ -1085,13 +1106,13 @@ msgid "" msgstr "" msgid "In ``range(24)``." -msgstr "" +msgstr "In ``range(24)``." msgid "In ``range(60)``." -msgstr "" +msgstr "In ``range(60)``." msgid "In ``range(1000000)``." -msgstr "" +msgstr "In ``range(1000000)``." msgid "" "The object passed as the *tzinfo* argument to the :class:`.datetime` " @@ -1121,11 +1142,23 @@ msgstr "\\(2)" msgid "``timedelta = datetime1 - datetime2``" msgstr "" +msgid "``datetime1 == datetime2``" +msgstr "``datetime1 == datetime2``" + +msgid "``datetime1 != datetime2``" +msgstr "``datetime1 != datetime2``" + msgid "``datetime1 < datetime2``" -msgstr "" +msgstr "``datetime1 < datetime2``" -msgid "Compares :class:`.datetime` to :class:`.datetime`. (4)" -msgstr "" +msgid "``datetime1 > datetime2``" +msgstr "``datetime1 > datetime2``" + +msgid "``datetime1 <= datetime2``" +msgstr "``datetime1 <= datetime2``" + +msgid "``datetime1 >= datetime2``" +msgstr "``datetime1 >= datetime2``" msgid "" "datetime2 is a duration of timedelta removed from datetime1, moving forward " @@ -1159,47 +1192,56 @@ 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 " -"first. The result is ``(a.replace(tzinfo=None) - a.utcoffset()) - (b." +"``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." msgstr "" msgid "" -"*datetime1* is considered less than *datetime2* when *datetime1* precedes " -"*datetime2* in time." +":class:`.datetime` objects are equal if they represent the same date and " +"time, taking into account the time zone." msgstr "" msgid "" -"If one comparand is naive and the other is aware, :exc:`TypeError` is raised " -"if an order comparison is attempted. For equality comparisons, naive " -"instances are never equal to aware instances." +"Naive and aware :class:`!datetime` objects are never equal. :class:`!" +"datetime` objects are never equal to :class:`date` objects that are not " +"also :class:`!datetime` instances, even if they represent the same date." msgstr "" msgid "" -"If both comparands are aware, and have the same :attr:`~.datetime.tzinfo` " -"attribute, the common :attr:`~.datetime.tzinfo` attribute is ignored and the " -"base datetimes are compared. If both comparands are aware and have " -"different :attr:`~.datetime.tzinfo` attributes, the comparands are first " -"adjusted by subtracting their UTC offsets (obtained from ``self." -"utcoffset()``)." +"If both comparands are aware, and have the same :attr:`!tzinfo` attribute, " +"the :attr:`!tzinfo` and :attr:`~.datetime.fold` attributes are ignored and " +"the base datetimes are compared. If both comparands are aware and have " +"different :attr:`~.datetime.tzinfo` attributes, the comparison acts as " +"comparands were first converted to UTC datetimes except that the " +"implementation never overflows. :class:`!datetime` instances in a repeated " +"interval are never equal to :class:`!datetime` instances in other time zone." msgstr "" msgid "" -"Equality comparisons between aware and naive :class:`.datetime` instances " -"don't raise :exc:`TypeError`." +"*datetime1* is considered less than *datetime2* when *datetime1* precedes " +"*datetime2* in time, taking into account the time zone." msgstr "" msgid "" -"In order to stop comparison from falling back to the default scheme of " -"comparing object addresses, datetime comparison normally raises :exc:" -"`TypeError` if the other comparand isn't also a :class:`.datetime` object. " -"However, ``NotImplemented`` is returned instead if the other comparand has " -"a :meth:`timetuple` attribute. This hook gives other kinds of date objects a " -"chance at implementing mixed-type comparison. If not, when a :class:`." -"datetime` object is compared to an object of a different type, :exc:" -"`TypeError` is raised unless the comparison is ``==`` or ``!=``. The latter " -"cases return :const:`False` or :const:`True`, respectively." +"Order comparison between naive and aware :class:`.datetime` objects, as well " +"as a :class:`!datetime` object and a :class:`!date` object that is not also " +"a :class:`!datetime` instance, raises :exc:`TypeError`." +msgstr "" + +msgid "" +"If both comparands are aware, and have the same :attr:`!tzinfo` attribute, " +"the :attr:`!tzinfo` and :attr:`~.datetime.fold` attributes are ignored and " +"the base datetimes are compared. If both comparands are aware and have " +"different :attr:`~.datetime.tzinfo` attributes, the comparison acts as " +"comparands were first converted to UTC datetimes except that the " +"implementation never overflows." +msgstr "" + +msgid "" +"Equality comparisons between aware and naive :class:`.datetime` instances " +"don't raise :exc:`TypeError`." msgstr "" msgid "Return :class:`date` object with same year, month and day." @@ -1300,24 +1342,26 @@ 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:`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``." +"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:`tm_isdst` is forced to 0 regardless of what " -"``d.dst()`` returns. DST is never in effect for a UTC time." +"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." +"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 "" @@ -1448,7 +1492,7 @@ msgstr "" msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument::" msgstr "" -msgid "Added the *timespec* argument." +msgid "Added the *timespec* parameter." msgstr "" msgid "" @@ -1486,7 +1530,7 @@ msgstr "" msgid "Examples of Usage: :class:`.datetime`" msgstr "" -msgid "Examples of working with :class:`~datetime.datetime` objects:" +msgid "Examples of working with :class:`.datetime` objects:" msgstr "" msgid "" @@ -1502,7 +1546,7 @@ msgid ":class:`.time` Objects" msgstr "" msgid "" -"A :class:`time` object represents a (local) time of day, independent of any " +"A :class:`.time` object represents a (local) time of day, independent of any " "particular day, and subject to adjustment via a :class:`tzinfo` object." msgstr "" @@ -1535,29 +1579,26 @@ msgid "" msgstr "" msgid "" -":class:`.time` objects support comparison of :class:`.time` to :class:`." -"time`, where *a* is considered less than *b* when *a* precedes *b* in time. " -"If one comparand is naive and the other is aware, :exc:`TypeError` is raised " -"if an order comparison is attempted. For equality comparisons, naive " -"instances are never equal to aware instances." +":class:`.time` objects support equality and order comparisons, where *a* is " +"considered less than *b* when *a* precedes *b* in time." msgstr "" msgid "" -"If both comparands are aware, and have the same :attr:`~time.tzinfo` " -"attribute, the common :attr:`~time.tzinfo` attribute is ignored and the base " -"times are compared. If both comparands are aware and have different :attr:" -"`~time.tzinfo` attributes, the comparands are first adjusted by subtracting " -"their UTC offsets (obtained from ``self.utcoffset()``). In order to stop " -"mixed-type comparisons from falling back to the default comparison by object " -"address, when a :class:`.time` object is compared to an object of a " -"different type, :exc:`TypeError` is raised unless the comparison is ``==`` " -"or ``!=``. The latter cases return :const:`False` or :const:`True`, " -"respectively." +"Naive and aware :class:`!time` objects are never equal. Order comparison " +"between naive and aware :class:`!time` objects raises :exc:`TypeError`." msgstr "" msgid "" -"Equality comparisons between aware and naive :class:`~datetime.time` " -"instances don't raise :exc:`TypeError`." +"If both comparands are aware, and have the same :attr:`~.time.tzinfo` " +"attribute, the :attr:`!tzinfo` and :attr:`!fold` attributes are ignored and " +"the base times are compared. If both comparands are aware and have " +"different :attr:`!tzinfo` attributes, the comparands are first adjusted by " +"subtracting their UTC offsets (obtained from ``self.utcoffset()``)." +msgstr "" + +msgid "" +"Equality comparisons between aware and naive :class:`.time` instances don't " +"raise :exc:`TypeError`." msgstr "" msgid "" @@ -1589,6 +1630,9 @@ msgid "" "truncated)." msgstr "" +msgid "Examples:" +msgstr "Przykłady:" + msgid "" "Previously, this method only supported formats that could be emitted by :" "meth:`time.isoformat()`." @@ -1684,7 +1728,7 @@ 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:" +"`.datetime` methods you use. The :mod:`!datetime` module provides :class:" "`timezone`, a simple concrete subclass of :class:`tzinfo` which can " "represent timezones with fixed offset from UTC such as UTC itself or North " "American EST and EDT." @@ -1692,15 +1736,15 @@ msgstr "" msgid "" "Special requirement for pickling: A :class:`tzinfo` subclass must have an :" -"meth:`__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." +"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." +"mod:`!datetime` objects. If in doubt, simply implement all of them." msgstr "" msgid "" @@ -1740,9 +1784,9 @@ msgid "" "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:`tm_isdst` flag " -"should be set, and :meth:`tzinfo.fromutc` calls :meth:`dst` to account for " -"DST changes when crossing time zones." +"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 "" @@ -1751,7 +1795,7 @@ msgid "" msgstr "" msgid "``tz.utcoffset(dt) - tz.dst(dt)``" -msgstr "" +msgstr "``tz.utcoffset(dt) - tz.dst(dt)``" msgid "" "must return the same result for every :class:`.datetime` *dt* with ``dt." @@ -1761,8 +1805,8 @@ msgid "" "`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:`astimezone` " -"regardless." +"of :meth:`tzinfo.fromutc` to work correctly with :meth:`~.datetime." +"astimezone` regardless." msgstr "" msgid "" @@ -1779,8 +1823,8 @@ msgstr "" msgid "" "Return the time zone name corresponding to the :class:`.datetime` object " -"*dt*, as a string. Nothing about string names is defined by the :mod:" -"`datetime` module, and there's no requirement that it mean anything in " +"*dt*, as a string. Nothing about string names is defined by the :mod:`!" +"datetime` module, and there's no requirement that it mean anything in " "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 " @@ -1842,8 +1886,9 @@ msgid "" "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:" -"`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." +"`~.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 "" @@ -1878,22 +1923,22 @@ msgid "" "last hour of daylight time. In Eastern, that's times of the form 5:MM UTC on " "the day daylight time ends. The local wall clock leaps from 1:59 (daylight " "time) back to 1:00 (standard time) again. Local times of the form 1:MM are " -"ambiguous. :meth:`astimezone` mimics the local clock's behavior by mapping " -"two adjacent UTC hours into the same local hour then. In the Eastern " -"example, UTC times of the form 5:MM and 6:MM both map to 1:MM when converted " -"to Eastern, but earlier times have the :attr:`~datetime.fold` attribute set " -"to 0 and the later times have it set to 1. For example, at the Fall back " -"transition of 2016, we get::" +"ambiguous. :meth:`~.datetime.astimezone` mimics the local clock's behavior " +"by mapping two adjacent UTC hours into the same local hour then. In the " +"Eastern example, UTC times of the form 5:MM and 6:MM both map to 1:MM when " +"converted to Eastern, but earlier times have the :attr:`~.datetime.fold` " +"attribute set to 0 and the later times have it set to 1. For example, at the " +"Fall back transition of 2016, we get::" msgstr "" msgid "" "Note that the :class:`.datetime` instances that differ only by the value of " -"the :attr:`~datetime.fold` attribute are considered equal in comparisons." +"the :attr:`~.datetime.fold` attribute are considered equal in comparisons." 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 :" +"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 " @@ -1901,12 +1946,12 @@ msgid "" msgstr "" msgid ":mod:`zoneinfo`" -msgstr "" +msgstr ":mod:`zoneinfo`" msgid "" -"The :mod:`datetime` module has a basic :class:`timezone` class (for handling " -"arbitrary fixed offsets from UTC) and its :attr:`timezone.utc` attribute (a " -"UTC timezone instance)." +"The :mod:`!datetime` module has a basic :class:`timezone` class (for " +"handling arbitrary fixed offsets from UTC) and its :attr:`timezone.utc` " +"attribute (a UTC timezone instance)." msgstr "" msgid "" @@ -1985,7 +2030,7 @@ msgstr "" msgid "The UTC timezone, ``timezone(timedelta(0))``." msgstr "" -msgid ":meth:`strftime` and :meth:`strptime` Behavior" +msgid ":meth:`~.datetime.strftime` and :meth:`~.datetime.strptime` Behavior" msgstr "" msgid "" @@ -2001,15 +2046,15 @@ msgid "" msgstr "" msgid "" -"The table below provides a high-level comparison of :meth:`strftime` versus :" -"meth:`strptime`:" +"The table below provides a high-level comparison of :meth:`~.datetime." +"strftime` versus :meth:`~.datetime.strptime`:" msgstr "" msgid "``strftime``" -msgstr "" +msgstr "``strftime``" msgid "``strptime``" -msgstr "" +msgstr "``strptime``" msgid "Usage" msgstr "" @@ -2037,18 +2082,19 @@ msgid ":class:`date`; :class:`.datetime`; :class:`.time`" msgstr "" msgid ":class:`.datetime`" -msgstr "" +msgstr ":class:`.datetime`" msgid "Signature" msgstr "" msgid "``strftime(format)``" -msgstr "" +msgstr "``strftime(format)``" msgid "``strptime(date_string, format)``" -msgstr "" +msgstr "``strptime(date_string, format)``" -msgid ":meth:`strftime` and :meth:`strptime` Format Codes" +msgid "" +":meth:`~.datetime.strftime` and :meth:`~.datetime.strptime` Format Codes" msgstr "" msgid "" @@ -2068,13 +2114,13 @@ msgid "Meaning" msgstr "Znaczenie" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "Notes" msgstr "Notatki" msgid "``%a``" -msgstr "" +msgstr "``%a``" msgid "Weekday as locale's abbreviated name." msgstr "" @@ -2086,7 +2132,7 @@ msgid "So, Mo, ..., Sa (de_DE)" msgstr "" msgid "``%A``" -msgstr "" +msgstr "``%A``" msgid "Weekday as locale's full name." msgstr "" @@ -2098,7 +2144,7 @@ msgid "Sonntag, Montag, ..., Samstag (de_DE)" msgstr "" msgid "``%w``" -msgstr "" +msgstr "``%w``" msgid "Weekday as a decimal number, where 0 is Sunday and 6 is Saturday." msgstr "" @@ -2107,7 +2153,7 @@ msgid "0, 1, ..., 6" msgstr "" msgid "``%d``" -msgstr "" +msgstr "``%d``" msgid "Day of the month as a zero-padded decimal number." msgstr "" @@ -2119,7 +2165,7 @@ msgid "\\(9)" msgstr "" msgid "``%b``" -msgstr "" +msgstr "``%b``" msgid "Month as locale's abbreviated name." msgstr "" @@ -2131,7 +2177,7 @@ msgid "Jan, Feb, ..., Dez (de_DE)" msgstr "" msgid "``%B``" -msgstr "" +msgstr "``%B``" msgid "Month as locale's full name." msgstr "" @@ -2143,7 +2189,7 @@ msgid "Januar, Februar, ..., Dezember (de_DE)" msgstr "" msgid "``%m``" -msgstr "" +msgstr "``%m``" msgid "Month as a zero-padded decimal number." msgstr "" @@ -2152,7 +2198,7 @@ msgid "01, 02, ..., 12" msgstr "" msgid "``%y``" -msgstr "" +msgstr "``%y``" msgid "Year without century as a zero-padded decimal number." msgstr "" @@ -2161,7 +2207,7 @@ msgid "00, 01, ..., 99" msgstr "" msgid "``%Y``" -msgstr "" +msgstr "``%Y``" msgid "Year with century as a decimal number." msgstr "" @@ -2170,7 +2216,7 @@ msgid "0001, 0002, ..., 2013, 2014, ..., 9998, 9999" msgstr "" msgid "``%H``" -msgstr "" +msgstr "``%H``" msgid "Hour (24-hour clock) as a zero-padded decimal number." msgstr "" @@ -2179,13 +2225,13 @@ msgid "00, 01, ..., 23" msgstr "" msgid "``%I``" -msgstr "" +msgstr "``%I``" msgid "Hour (12-hour clock) as a zero-padded decimal number." msgstr "" msgid "``%p``" -msgstr "" +msgstr "``%p``" msgid "Locale's equivalent of either AM or PM." msgstr "" @@ -2200,7 +2246,7 @@ msgid "\\(1), \\(3)" msgstr "" msgid "``%M``" -msgstr "" +msgstr "``%M``" msgid "Minute as a zero-padded decimal number." msgstr "" @@ -2209,7 +2255,7 @@ msgid "00, 01, ..., 59" msgstr "" msgid "``%S``" -msgstr "" +msgstr "``%S``" msgid "Second as a zero-padded decimal number." msgstr "" @@ -2218,7 +2264,7 @@ msgid "\\(4), \\(9)" msgstr "" msgid "``%f``" -msgstr "" +msgstr "``%f``" msgid "Microsecond as a decimal number, zero-padded to 6 digits." msgstr "" @@ -2230,7 +2276,7 @@ msgid "\\(5)" msgstr "\\(5)" msgid "``%z``" -msgstr "" +msgstr "``%z``" msgid "" "UTC offset in the form ``±HHMM[SS[.ffffff]]`` (empty string if the object is " @@ -2244,7 +2290,7 @@ msgid "\\(6)" msgstr "" msgid "``%Z``" -msgstr "" +msgstr "``%Z``" msgid "Time zone name (empty string if the object is naive)." msgstr "" @@ -2253,7 +2299,7 @@ msgid "(empty), UTC, GMT" msgstr "" msgid "``%j``" -msgstr "" +msgstr "``%j``" msgid "Day of the year as a zero-padded decimal number." msgstr "" @@ -2262,7 +2308,7 @@ msgid "001, 002, ..., 366" msgstr "" msgid "``%U``" -msgstr "" +msgstr "``%U``" msgid "" "Week number of the year (Sunday as the first day of the week) as a zero-" @@ -2277,7 +2323,7 @@ msgid "\\(7), \\(9)" msgstr "" msgid "``%W``" -msgstr "" +msgstr "``%W``" msgid "" "Week number of the year (Monday as the first day of the week) as a zero-" @@ -2286,7 +2332,7 @@ msgid "" msgstr "" msgid "``%c``" -msgstr "" +msgstr "``%c``" msgid "Locale's appropriate date and time representation." msgstr "" @@ -2298,7 +2344,7 @@ msgid "Di 16 Aug 21:30:00 1988 (de_DE)" msgstr "" msgid "``%x``" -msgstr "" +msgstr "``%x``" msgid "Locale's appropriate date representation." msgstr "" @@ -2313,25 +2359,25 @@ msgid "16.08.1988 (de_DE)" msgstr "" msgid "``%X``" -msgstr "" +msgstr "``%X``" msgid "Locale's appropriate time representation." msgstr "" msgid "21:30:00 (en_US);" -msgstr "" +msgstr "21:30:00 (en_US);" msgid "21:30:00 (de_DE)" -msgstr "" +msgstr "21:30:00 (de_DE)" msgid "``%%``" -msgstr "" +msgstr "``%%``" msgid "A literal ``'%'`` character." msgstr "" msgid "%" -msgstr "" +msgstr "%" msgid "" "Several additional directives not required by the C89 standard are included " @@ -2339,7 +2385,7 @@ msgid "" msgstr "" msgid "``%G``" -msgstr "" +msgstr "``%G``" msgid "" "ISO 8601 year with century representing the year that contains the greater " @@ -2350,7 +2396,7 @@ msgid "\\(8)" msgstr "" msgid "``%u``" -msgstr "" +msgstr "``%u``" msgid "ISO 8601 weekday as a decimal number where 1 is Monday." msgstr "" @@ -2359,7 +2405,7 @@ msgid "1, 2, ..., 7" msgstr "" msgid "``%V``" -msgstr "" +msgstr "``%V``" msgid "" "ISO 8601 week as a decimal number with Monday as the first day of the week. " @@ -2373,16 +2419,16 @@ msgid "\\(8), \\(9)" msgstr "" msgid "" -"These may not be available on all platforms when used with the :meth:" -"`strftime` method. The ISO 8601 year and ISO 8601 week directives are not " -"interchangeable with the year and week number directives above. Calling :" -"meth:`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 "" "The full set of format codes supported varies across platforms, because " -"Python calls the platform C library's :func:`strftime` function, and " +"Python calls the platform C library's :c:func:`strftime` function, and " "platform variations are common. To see the full set of format codes " "supported on your platform, consult the :manpage:`strftime(3)` " "documentation. There are also differences between platforms in handling of " @@ -2398,11 +2444,11 @@ 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:`timetuple` method." +"meth:`~date.timetuple` method." msgstr "" msgid "" -"For the :meth:`datetime.strptime` class method, the default value is " +"For the :meth:`.datetime.strptime` class method, the default value is " "``1900-01-01T00:00:00.000``: any components not specified in the format " "string will be pulled from the default value. [#]_" msgstr "" @@ -2418,7 +2464,7 @@ msgstr "" msgid "" "For :class:`.time` objects, the format codes for year, month, and day should " -"not be used, as :class:`time` objects have no such values. If they're used " +"not be used, as :class:`!time` objects have no such values. If they're used " "anyway, ``1900`` is substituted for the year, and ``1`` for the month and " "day." msgstr "" @@ -2445,35 +2491,36 @@ msgid "" msgstr "" msgid "" -"The :meth:`strptime` method can parse years in the full [1, 9999] range, but " -"years < 1000 must be zero-filled to 4-digit width." +"The :meth:`~.datetime.strptime` method can parse years in the full [1, 9999] " +"range, but years < 1000 must be zero-filled to 4-digit width." msgstr "" msgid "" -"In previous versions, :meth:`strftime` method was restricted to years >= " -"1900." +"In previous versions, :meth:`~.datetime.strftime` method was restricted to " +"years >= 1900." msgstr "" msgid "" -"In version 3.2, :meth:`strftime` method was restricted to years >= 1000." +"In version 3.2, :meth:`~.datetime.strftime` method was restricted to years " +">= 1000." msgstr "" msgid "" -"When used with the :meth:`strptime` method, the ``%p`` directive only " -"affects the output hour field if the ``%I`` directive is used to parse the " -"hour." +"When used with the :meth:`~.datetime.strptime` method, the ``%p`` directive " +"only affects the output hour field if the ``%I`` directive is used to parse " +"the hour." msgstr "" msgid "" -"Unlike the :mod:`time` module, the :mod:`datetime` module does not support " +"Unlike the :mod:`time` module, the :mod:`!datetime` module does not support " "leap seconds." msgstr "" msgid "" -"When used with the :meth:`strptime` method, the ``%f`` directive accepts " -"from one to six digits and zero pads on the right. ``%f`` is an extension to " -"the set of format characters in the C standard (but implemented separately " -"in datetime objects, and therefore always available)." +"When used with the :meth:`~.datetime.strptime` method, the ``%f`` directive " +"accepts from one to six digits and zero pads on the right. ``%f`` is an " +"extension to the set of format characters in the C standard (but implemented " +"separately in datetime objects, and therefore always available)." msgstr "" msgid "" @@ -2485,32 +2532,33 @@ msgid "For an aware object:" msgstr "" msgid "" -":meth:`utcoffset` is transformed into a string of the form ``±HHMM[SS[." -"ffffff]]``, where ``HH`` is a 2-digit string giving the number of UTC offset " -"hours, ``MM`` is a 2-digit string giving the number of UTC offset minutes, " -"``SS`` is a 2-digit string giving the number of UTC offset 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:`utcoffset` returns " -"``timedelta(hours=-3, minutes=-30)``, ``%z`` is replaced with the string " -"``'-0330'``." +":meth:`~.datetime.utcoffset` is transformed into a string of the form " +"``±HHMM[SS[.ffffff]]``, where ``HH`` is a 2-digit string giving the number " +"of UTC offset hours, ``MM`` is a 2-digit string giving the number of UTC " +"offset minutes, ``SS`` is a 2-digit string giving the number of UTC offset " +"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'``." msgstr "" msgid "" -"When the ``%z`` directive is provided to the :meth:`strptime` method, the " -"UTC offsets can have a colon as a separator between hours, minutes and " -"seconds. For example, ``'+01:00:00'`` will be parsed as an offset of one " -"hour. In addition, providing ``'Z'`` is identical to ``'+00:00'``." +"When the ``%z`` directive is provided to the :meth:`~.datetime.strptime` " +"method, the UTC offsets can have a colon as a separator between hours, " +"minutes and seconds. For example, ``'+01:00:00'`` will be parsed as an " +"offset of one hour. In addition, providing ``'Z'`` is identical to " +"``'+00:00'``." msgstr "" msgid "" -"In :meth:`strftime`, ``%Z`` is replaced by an empty string if :meth:`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:`strptime` only accepts certain values for ``%Z``:" +msgid ":meth:`~.datetime.strptime` only accepts certain values for ``%Z``:" msgstr "" msgid "any value in ``time.tzname`` for your machine's locale" @@ -2526,28 +2574,29 @@ msgid "" msgstr "" msgid "" -"When the ``%z`` directive is provided to the :meth:`strptime` method, an " -"aware :class:`.datetime` object will be produced. The ``tzinfo`` of the " -"result will be set to a :class:`timezone` instance." +"When the ``%z`` directive is provided to the :meth:`~.datetime.strptime` " +"method, an aware :class:`.datetime` object will be produced. The ``tzinfo`` " +"of the result will be set to a :class:`timezone` instance." msgstr "" msgid "" -"When used with the :meth:`strptime` method, ``%U`` and ``%W`` are only used " -"in calculations when the day of the week and the calendar year (``%Y``) are " -"specified." +"When used with the :meth:`~.datetime.strptime` method, ``%U`` and ``%W`` are " +"only used in calculations when the day of the week and the calendar year " +"(``%Y``) are specified." 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:" -"`strptime` format string. Also note that ``%G`` and ``%Y`` are not " +"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 "" -"When used with the :meth:`strptime` method, the leading zero is optional " -"for formats ``%d``, ``%m``, ``%H``, ``%I``, ``%M``, ``%S``, ``%j``, ``%U``, " -"``%W``, and ``%V``. Format ``%y`` does require a leading zero." +"When used with the :meth:`~.datetime.strptime` method, the leading zero is " +"optional for formats ``%d``, ``%m``, ``%H``, ``%I``, ``%M``, ``%S``, " +"``%j``, ``%U``, ``%W``, and ``%V``. Format ``%y`` does require a leading " +"zero." msgstr "" msgid "Footnotes" diff --git a/library/dbm.po b/library/dbm.po index 1b91e09c86..e98c3071f5 100644 --- a/library/dbm.po +++ b/library/dbm.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,97 +49,101 @@ msgid "" "be used to open a given file." msgstr "" -msgid "" -"Returns one of the following values: ``None`` if the file can't be opened " -"because it's unreadable or doesn't exist; the empty string (``''``) if the " -"file's format can't be guessed; or a string containing the required module " -"name, such as ``'dbm.ndbm'`` or ``'dbm.gnu'``." +msgid "Return one of the following values:" msgstr "" -msgid "Accepts :term:`path-like object` for filename." +msgid "" +"``None`` if the file can't be opened because it's unreadable or doesn't exist" msgstr "" -msgid "Open the database file *file* and return a corresponding object." +msgid "the empty string (``''``) if the file's format can't be guessed" msgstr "" msgid "" -"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 module listed above that can be imported is used." +"a string containing the required module name, such as ``'dbm.ndbm'`` or " +"``'dbm.gnu'``" msgstr "" -msgid "The optional *flag* argument can be:" +msgid "*filename* accepts a :term:`path-like object`." msgstr "" -msgid "Value" -msgstr "Wartość" +msgid "Open a database and return the corresponding database object." +msgstr "" -msgid "Meaning" -msgstr "Znaczenie" +msgid "Parameters" +msgstr "parametry" -msgid "``'r'``" +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." msgstr "" -msgid "Open existing database for reading only (default)" +msgid "The database file to open." msgstr "" -msgid "``'w'``" +msgid "" +"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 "Open existing database for reading and writing" +msgid "" +"* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * " +"``'n'``: |flag_n|" msgstr "" -msgid "``'c'``" +msgid "``'r'`` (default): |flag_r|" msgstr "" -msgid "Open database for reading and writing, creating it if it doesn't exist" +msgid "``'w'``: |flag_w|" msgstr "" -msgid "``'n'``" +msgid "``'c'``: |flag_c|" msgstr "" -msgid "Always create a new, empty database, open for reading and writing" +msgid "``'n'``: |flag_n|" msgstr "" -msgid "" -"The optional *mode* argument is the Unix mode of the file, used only when " -"the database has to be created. It defaults to octal ``0o666`` (and will be " -"modified by the prevailing umask)." +msgid "|mode_param_doc|" msgstr "" -msgid "" -"The object returned by :func:`.open` supports the same basic functionality " -"as dictionaries; keys and their corresponding values can be stored, " -"retrieved, and deleted, and the :keyword:`in` operator and the :meth:`keys` " -"method are available, as well as :meth:`get` and :meth:`setdefault`." +msgid "*file* accepts a :term:`path-like object`." msgstr "" msgid "" -":meth:`get` and :meth:`setdefault` are now available in all database modules." +"The object returned by :func:`~dbm.open` supports the same basic " +"functionality as a :class:`dict`; keys and their corresponding values can be " +"stored, retrieved, and deleted, and the :keyword:`in` operator and the :meth:" +"`!keys` method are available, as well as :meth:`!get` and :meth:`!" +"setdefault` methods." msgstr "" msgid "" -"Deleting a key from a read-only database raises database module specific " -"error instead of :exc:`KeyError`." +"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." msgstr "" -msgid "Accepts :term:`path-like object` for file." +msgid "" +"These objects also support being used in a :keyword:`with` statement, which " +"will automatically close them when done." msgstr "" msgid "" -"Key and values are always stored as bytes. This means that when strings are " -"used they are implicitly converted to the default encoding before being " -"stored." +":meth:`!get` and :meth:`!setdefault` methods are now available for all :mod:" +"`dbm` backends." msgstr "" msgid "" -"These objects also support being used in a :keyword:`with` statement, which " -"will automatically close them when done." +"Added native support for the context management protocol to the objects " +"returned by :func:`~dbm.open`." msgstr "" msgid "" -"Added native support for the context management protocol to the objects " -"returned by :func:`.open`." +"Deleting a key from a read-only database raises a database module specific " +"exception instead of :exc:`KeyError`." msgstr "" msgid "" @@ -156,25 +160,21 @@ msgstr "" msgid "The individual submodules are described in the following sections." msgstr "" -msgid ":mod:`dbm.gnu` --- GNU's reinterpretation of dbm" +msgid ":mod:`dbm.gnu` --- GNU database manager" msgstr "" msgid "**Source code:** :source:`Lib/dbm/gnu.py`" msgstr "" msgid "" -"This module is quite similar to the :mod:`dbm` module, but uses the GNU " -"library ``gdbm`` instead to provide some additional functionality. Please " -"note that the file formats created by :mod:`dbm.gnu` and :mod:`dbm.ndbm` are " -"incompatible." +"The :mod:`dbm.gnu` module provides an interface to the :abbr:`GDBM (GNU " +"dbm)` library, similar to the :mod:`dbm.ndbm` module, but with additional " +"functionality like crash tolerance." msgstr "" msgid "" -"The :mod:`dbm.gnu` module provides an interface to the GNU DBM library. " -"``dbm.gnu.gdbm`` objects behave like mappings (dictionaries), except that " -"keys and values are always converted to bytes before storing. Printing a " -"``gdbm`` object doesn't print the keys and values, and the :meth:`items` " -"and :meth:`values` methods are not supported." +"The file formats created by :mod:`dbm.gnu` and :mod:`dbm.ndbm` are " +"incompatible and can not be used interchangeably." msgstr "" msgid "" @@ -183,57 +183,63 @@ msgid "" "key." msgstr "" -msgid "" -"Open a ``gdbm`` database and return a :class:`gdbm` object. The *filename* " -"argument is the name of the database file." +msgid "Open a GDBM database and return a :class:`!gdbm` object." msgstr "" msgid "" -"The following additional characters may be appended to the flag to control " -"how the database is opened:" +"* ``'r'`` (default): |flag_r| * ``'w'``: |flag_w| * ``'c'``: |flag_c| * " +"``'n'``: |flag_n| The following additional characters may be appended to " +"control how the database is opened: * ``'f'``: Open the database in fast " +"mode. Writes to the database will not be synchronized. * ``'s'``: " +"Synchronized mode. Changes to the database will be written immediately to " +"the file. * ``'u'``: Do not lock database. Not all flags are valid for all " +"versions of GDBM. See the :data:`open_flags` member for a list of supported " +"flag characters." msgstr "" -msgid "``'f'``" -msgstr "``'f'``" +msgid "" +"The following additional characters may be appended to control how the " +"database is opened:" +msgstr "" msgid "" -"Open the database in fast mode. Writes to the database will not be " +"``'f'``: Open the database in fast mode. Writes to the database will not be " "synchronized." msgstr "" -msgid "``'s'``" +msgid "" +"``'s'``: Synchronized mode. Changes to the database will be written " +"immediately to the file." +msgstr "" + +msgid "``'u'``: Do not lock database." msgstr "" msgid "" -"Synchronized mode. This will cause changes to the database to be immediately " -"written to the file." +"Not all flags are valid for all versions of GDBM. See the :data:`open_flags` " +"member for a list of supported flag characters." msgstr "" -msgid "``'u'``" -msgstr "``'u'``" - -msgid "Do not lock database." +msgid "Raises" msgstr "" -msgid "" -"Not all flags are valid for all versions of ``gdbm``. The module constant :" -"const:`open_flags` is a string of supported flag characters. The exception :" -"exc:`error` is raised if an invalid flag is specified." +msgid "If an invalid *flag* argument is passed." msgstr "" msgid "" -"The optional *mode* argument is the Unix mode of the file, used only when " -"the database has to be created. It defaults to octal ``0o666``." +"A string of characters the *flag* parameter of :meth:`~dbm.gnu.open` " +"supports." msgstr "" msgid "" -"In addition to the dictionary-like methods, ``gdbm`` objects have the " -"following methods:" +":class:`!gdbm` objects behave similar to :term:`mappings `, but :" +"meth:`!items` and :meth:`!values` methods are not supported. The following " +"methods are also provided:" msgstr "" msgid "" "It's possible to loop over every key in the database using this method and " -"the :meth:`nextkey` method. The traversal is ordered by ``gdbm``'s internal " +"the :meth:`nextkey` method. The traversal is ordered by GDBM's internal " "hash values, and won't be sorted by the key values. This method returns the " "starting key." msgstr "" @@ -246,9 +252,9 @@ 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. " -"``gdbm`` objects will not shorten the length of a database file except by " -"using this reorganization; otherwise, deleted file space will be kept and " +"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 "" @@ -257,28 +263,26 @@ msgid "" "unwritten data to be written to the disk." msgstr "" -msgid "Close the ``gdbm`` database." +msgid "Close the GDBM database." msgstr "" -msgid ":mod:`dbm.ndbm` --- Interface based on ndbm" +msgid ":mod:`dbm.ndbm` --- New Database Manager" msgstr "" msgid "**Source code:** :source:`Lib/dbm/ndbm.py`" msgstr "" msgid "" -"The :mod:`dbm.ndbm` module provides an interface to the Unix \"(n)dbm\" " -"library. Dbm objects behave like mappings (dictionaries), except that keys " -"and values are always stored as bytes. Printing a ``dbm`` object doesn't " -"print the keys and values, and the :meth:`items` and :meth:`values` methods " -"are not supported." +"The :mod:`dbm.ndbm` module provides an interface to the :abbr:`NDBM (New " +"Database Manager)` library. This module can be used with the \"classic\" " +"NDBM interface or the :abbr:`GDBM (GNU dbm)` compatibility interface." msgstr "" msgid "" -"This module can be used with the \"classic\" ndbm interface or the GNU GDBM " -"compatibility interface. On Unix, the :program:`configure` script will " -"attempt to locate the appropriate header file to simplify building this " -"module." +"The NDBM library shipped as part of macOS has an undocumented limitation on " +"the size of values, which can result in corrupted database files when " +"storing values larger than this limit. Reading such corrupted files can " +"result in a hard crash (segmentation fault)." msgstr "" msgid "" @@ -287,24 +291,27 @@ msgid "" "key." msgstr "" -msgid "Name of the ``ndbm`` implementation library used." +msgid "Name of the NDBM implementation library used." +msgstr "" + +msgid "Open an NDBM database and return an :class:`!ndbm` object." msgstr "" msgid "" -"Open a dbm database and return a ``ndbm`` object. The *filename* argument " -"is the name of the database file (without the :file:`.dir` or :file:`.pag` " +"The basename of the database file (without the :file:`.dir` or :file:`.pag` " "extensions)." msgstr "" -msgid "The optional *flag* argument must be one of these values:" +msgid "" +":class:`!ndbm` objects behave similar to :term:`mappings `, but :" +"meth:`!items` and :meth:`!values` methods are not supported. The following " +"methods are also provided:" msgstr "" -msgid "" -"In addition to the dictionary-like methods, ``ndbm`` objects provide the " -"following method:" +msgid "Accepts :term:`path-like object` for filename." msgstr "" -msgid "Close the ``ndbm`` database." +msgid "Close the NDBM database." msgstr "" msgid ":mod:`dbm.dumb` --- Portable DBM implementation" @@ -321,13 +328,12 @@ msgid "" msgstr "" msgid "" -"The :mod:`dbm.dumb` module provides a persistent dictionary-like interface " -"which is written entirely in Python. Unlike other modules such as :mod:`dbm." -"gnu` no external library is required. As with other persistent mappings, " -"the keys and values are always stored as bytes." +"The :mod:`dbm.dumb` module provides a persistent :class:`dict`-like " +"interface which is written entirely in Python. Unlike other :mod:`dbm` " +"backends, such as :mod:`dbm.gnu`, no external library is required." msgstr "" -msgid "The module defines the following:" +msgid "The :mod:`!dbm.dumb` module defines the following:" msgstr "" msgid "" @@ -337,10 +343,37 @@ msgid "" msgstr "" msgid "" -"Open a ``dumbdbm`` database and return a dumbdbm object. The *filename* " -"argument is the basename of the database file (without any specific " -"extensions). When a dumbdbm database is created, files with :file:`.dat` " -"and :file:`.dir` extensions are created." +"Open a :mod:`!dbm.dumb` database. The returned database object behaves " +"similar to a :term:`mapping`, in addition to providing :meth:`~dumbdbm.sync` " +"and :meth:`~dumbdbm.close` methods." +msgstr "" + +msgid "" +"The basename of the database file (without extensions). A new database " +"creates the following files: - :file:`{filename}.dat` - :file:`{filename}." +"dir`" +msgstr "" + +msgid "" +"The basename of the database file (without extensions). A new database " +"creates the following files:" +msgstr "" + +msgid ":file:`{filename}.dat`" +msgstr ":file:`{filename}.dat`" + +msgid ":file:`{filename}.dir`" +msgstr ":file:`{filename}.dir`" + +msgid "" +"* ``'r'``: |flag_r| * ``'w'``: |flag_w| * ``'c'`` (default): |flag_c| * " +"``'n'``: |flag_n|" +msgstr "" + +msgid "``'r'``: |flag_r|" +msgstr "" + +msgid "``'c'`` (default): |flag_c|" msgstr "" msgid "" @@ -350,19 +383,17 @@ msgid "" msgstr "" msgid "" -":func:`.open` always creates a new database when the flag has the value " -"``'n'``." +":func:`~dbm.dumb.open` always creates a new database when *flag* is ``'n'``." msgstr "" msgid "" -"A database opened with flags ``'r'`` is now read-only. Opening with flags " -"``'r'`` and ``'w'`` no longer creates a database if it does not exist." +"A database opened read-only if *flag* is ``'r'``. A database is not created " +"if it does not exist if *flag* is ``'r'`` or ``'w'``." msgstr "" msgid "" "In addition to the methods provided by the :class:`collections.abc." -"MutableMapping` class, :class:`dumbdbm` objects provide the following " -"methods:" +"MutableMapping` class, the following methods are provided:" msgstr "" msgid "" @@ -370,7 +401,7 @@ msgid "" "the :meth:`Shelve.sync` method." msgstr "" -msgid "Close the ``dumbdbm`` database." +msgid "Close the database." msgstr "" msgid "databases" diff --git a/library/debug.po b/library/debug.po index 9f7e2b7180..9b0cd4347f 100644 --- a/library/debug.po +++ b/library/debug.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/decimal.po b/library/decimal.po new file mode 100644 index 0000000000..9d43742020 --- /dev/null +++ b/library/decimal.po @@ -0,0 +1,1743 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`decimal` --- Decimal fixed point and floating point arithmetic" +msgstr "" + +msgid "**Source code:** :source:`Lib/decimal.py`" +msgstr "" + +msgid "" +"The :mod:`decimal` module provides support for fast correctly rounded " +"decimal floating point arithmetic. It offers several advantages over the :" +"class:`float` datatype:" +msgstr "" + +msgid "" +"Decimal \"is based on a floating-point model which was designed with people " +"in mind, and necessarily has a paramount guiding principle -- computers must " +"provide an arithmetic that works in the same way as the arithmetic that " +"people learn at school.\" -- excerpt from the decimal arithmetic " +"specification." +msgstr "" + +msgid "" +"Decimal numbers can be represented exactly. In contrast, numbers like " +"``1.1`` and ``2.2`` do not have exact representations in binary floating " +"point. End users typically would not expect ``1.1 + 2.2`` to display as " +"``3.3000000000000003`` as it does with binary floating point." +msgstr "" + +msgid "" +"The exactness carries over into arithmetic. In decimal floating point, " +"``0.1 + 0.1 + 0.1 - 0.3`` is exactly equal to zero. In binary floating " +"point, the result is ``5.5511151231257827e-017``. While near to zero, the " +"differences prevent reliable equality testing and differences can " +"accumulate. For this reason, decimal is preferred in accounting applications " +"which have strict equality invariants." +msgstr "" + +msgid "" +"The decimal module incorporates a notion of significant places so that " +"``1.30 + 1.20`` is ``2.50``. The trailing zero is kept to indicate " +"significance. This is the customary presentation for monetary applications. " +"For multiplication, the \"schoolbook\" approach uses all the figures in the " +"multiplicands. For instance, ``1.3 * 1.2`` gives ``1.56`` while ``1.30 * " +"1.20`` gives ``1.5600``." +msgstr "" + +msgid "" +"Unlike hardware based binary floating point, the decimal module has a user " +"alterable precision (defaulting to 28 places) which can be as large as " +"needed for a given problem:" +msgstr "" + +msgid "" +"Both binary and decimal floating point are implemented in terms of published " +"standards. While the built-in float type exposes only a modest portion of " +"its capabilities, the decimal module exposes all required parts of the " +"standard. When needed, the programmer has full control over rounding and " +"signal handling. This includes an option to enforce exact arithmetic by " +"using exceptions to block any inexact operations." +msgstr "" + +msgid "" +"The decimal module was designed to support \"without prejudice, both exact " +"unrounded decimal arithmetic (sometimes called fixed-point arithmetic) and " +"rounded floating-point arithmetic.\" -- excerpt from the decimal arithmetic " +"specification." +msgstr "" + +msgid "" +"The module design is centered around three concepts: the decimal number, " +"the context for arithmetic, and signals." +msgstr "" + +msgid "" +"A decimal number is immutable. It has a sign, coefficient digits, and an " +"exponent. To preserve significance, the coefficient digits do not truncate " +"trailing zeros. Decimals also include special values such as ``Infinity``, " +"``-Infinity``, and ``NaN``. The standard also differentiates ``-0`` from " +"``+0``." +msgstr "" + +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`." +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`." +msgstr "" + +msgid "" +"For each signal there is a flag and a trap enabler. When a signal is " +"encountered, its flag is set to one, then, if the trap enabler is set to " +"one, an exception is raised. Flags are sticky, so the user needs to reset " +"them before monitoring a calculation." +msgstr "" + +msgid "" +"IBM's General Decimal Arithmetic Specification, `The General Decimal " +"Arithmetic Specification `_." +msgstr "" + +msgid "Quick-start Tutorial" +msgstr "" + +msgid "" +"The usual start to using decimals is importing the module, viewing the " +"current context with :func:`getcontext` and, if necessary, setting new " +"values for precision, rounding, or enabled traps::" +msgstr "" + +msgid "" +"Decimal instances can be constructed from integers, strings, floats, or " +"tuples. Construction from an integer or a float performs an exact conversion " +"of the value of that integer or float. Decimal numbers include special " +"values such as ``NaN`` which stands for \"Not a number\", positive and " +"negative ``Infinity``, and ``-0``::" +msgstr "" + +msgid "" +"If the :exc:`FloatOperation` signal is trapped, accidental mixing of " +"decimals and floats in constructors or ordering comparisons raises an " +"exception::" +msgstr "" + +msgid "" +"The significance of a new Decimal is determined solely by the number of " +"digits input. Context precision and rounding only come into play during " +"arithmetic operations." +msgstr "" + +msgid "" +"If the internal limits of the C version are exceeded, constructing a decimal " +"raises :class:`InvalidOperation`::" +msgstr "" + +msgid "" +"Decimals interact well with much of the rest of Python. Here is a small " +"decimal floating point flying circus:" +msgstr "" + +msgid "And some mathematical functions are also available to Decimal:" +msgstr "" + +msgid "" +"The :meth:`~Decimal.quantize` method rounds a number to a fixed exponent. " +"This method is useful for monetary applications that often round results to " +"a fixed number of places:" +msgstr "" + +msgid "" +"As shown above, the :func:`getcontext` function accesses the current context " +"and allows the settings to be changed. This approach meets the needs of " +"most applications." +msgstr "" + +msgid "" +"For more advanced work, it may be useful to create alternate contexts using " +"the 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:" +msgstr "" + +msgid "" +"Contexts also have signal flags for monitoring exceptional conditions " +"encountered during computations. The flags remain set until explicitly " +"cleared, so it is best to clear the flags before each set of monitored " +"computations by using the :meth:`~Context.clear_flags` method. ::" +msgstr "" + +msgid "" +"The *flags* entry shows that the rational approximation to pi was rounded " +"(digits beyond the context precision were thrown away) and that the result " +"is inexact (some of the discarded digits were non-zero)." +msgstr "" + +msgid "" +"Individual traps are set using the dictionary in the :attr:`~Context.traps` " +"attribute of a context:" +msgstr "" + +msgid "" +"Most programs adjust the current context only once, at the beginning of the " +"program. And, in many applications, data is converted to :class:`Decimal` " +"with a single cast inside a loop. With context set and decimals created, " +"the bulk of the program manipulates the data no differently than with other " +"Python numeric types." +msgstr "" + +msgid "Decimal objects" +msgstr "" + +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::" +msgstr "" + +msgid "" +"Other Unicode decimal digits are also permitted where ``digit`` appears " +"above. These include decimal digits from various other alphabets (for " +"example, Arabic-Indic and Devanāgarī digits) along with the fullwidth digits " +"``'\\uff10'`` through ``'\\uff19'``." +msgstr "" + +msgid "" +"If *value* is a :class:`tuple`, it should have three components, a sign " +"(``0`` for positive or ``1`` for negative), a :class:`tuple` of digits, and " +"an integer exponent. For example, ``Decimal((0, (1, 4, 1, 4), -3))`` returns " +"``Decimal('1.414')``." +msgstr "" + +msgid "" +"If *value* is a :class:`float`, the binary floating point value is " +"losslessly converted to its exact decimal equivalent. This conversion can " +"often require 53 or more digits of precision. For example, " +"``Decimal(float('1.1'))`` converts to " +"``Decimal('1.100000000000000088817841970012523233890533447265625')``." +msgstr "" + +msgid "" +"The *context* precision does not affect how many digits are stored. That is " +"determined exclusively by the number of digits in *value*. For example, " +"``Decimal('3.00000')`` records all five zeros even if the context precision " +"is only three." +msgstr "" + +msgid "" +"The purpose of the *context* argument is determining what to do if *value* " +"is a malformed string. If the context traps :const:`InvalidOperation`, an " +"exception is raised; otherwise, the constructor returns a new Decimal with " +"the value of ``NaN``." +msgstr "" + +msgid "Once constructed, :class:`Decimal` objects are immutable." +msgstr "" + +msgid "" +"The argument to the constructor is now permitted to be a :class:`float` " +"instance." +msgstr "" + +msgid "" +":class:`float` arguments raise an exception if the :exc:`FloatOperation` " +"trap is set. By default the trap is off." +msgstr "" + +msgid "" +"Underscores are allowed for grouping, as with integral and floating-point " +"literals in code." +msgstr "" + +msgid "" +"Decimal floating point objects share many properties with the other built-in " +"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`)." +msgstr "" + +msgid "" +"There are some small differences between arithmetic on Decimal objects and " +"arithmetic on integers and floats. When the remainder operator ``%`` is " +"applied to Decimal objects, the sign of the result is the sign of the " +"*dividend* rather than the sign of the divisor::" +msgstr "" + +msgid "" +"The integer division operator ``//`` behaves analogously, returning the " +"integer part of the true quotient (truncating towards zero) rather than its " +"floor, so as to preserve the usual identity ``x == (x // y) * y + x % y``::" +msgstr "" + +msgid "" +"The ``%`` and ``//`` operators implement the ``remainder`` and ``divide-" +"integer`` operations (respectively) as described in the specification." +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." +msgstr "" + +msgid "" +"Mixed-type comparisons between :class:`Decimal` instances and other numeric " +"types are now fully supported." +msgstr "" + +msgid "" +"In addition to the standard numeric properties, decimal floating point " +"objects also have a number of specialized methods:" +msgstr "" + +msgid "" +"Return the adjusted exponent after shifting out the coefficient's rightmost " +"digits until only the lead digit remains: ``Decimal('321e+5').adjusted()`` " +"returns seven. Used for determining the position of the most significant " +"digit with respect to the decimal point." +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::" +msgstr "" + +msgid "" +"The conversion is exact. Raise OverflowError on infinities and ValueError " +"on NaNs." +msgstr "" + +msgid "" +"Return a :term:`named tuple` representation of the number: " +"``DecimalTuple(sign, digits, exponent)``." +msgstr "" + +msgid "" +"Return the canonical encoding of the argument. Currently, the encoding of " +"a :class:`Decimal` instance is always canonical, so this operation returns " +"its argument unchanged." +msgstr "" + +msgid "" +"Compare the values of two Decimal instances. :meth:`compare` returns a " +"Decimal instance, and if either operand is a NaN then the result is a NaN::" +msgstr "" + +msgid "" +"This operation is identical to the :meth:`compare` method, except that all " +"NaNs signal. That is, if neither operand is a signaling NaN then any quiet " +"NaN operand is treated as though it were a signaling NaN." +msgstr "" + +msgid "" +"Compare two operands using their abstract representation rather than their " +"numerical value. Similar to the :meth:`compare` method, but the result " +"gives a total ordering on :class:`Decimal` instances. Two :class:`Decimal` " +"instances with the same numeric value but different representations compare " +"unequal in this ordering:" +msgstr "" + +msgid "" +"Quiet and signaling NaNs are also included in the total ordering. The " +"result of this function is ``Decimal('0')`` if both operands have the same " +"representation, ``Decimal('-1')`` if the first operand is lower in the total " +"order than the second, and ``Decimal('1')`` if the first operand is higher " +"in the total order than the second operand. See the specification for " +"details of the total order." +msgstr "" + +msgid "" +"This operation is unaffected by context and is quiet: no flags are changed " +"and no rounding is performed. As an exception, the C version may raise " +"InvalidOperation if the second operand cannot be converted exactly." +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())``." +msgstr "" + +msgid "" +"Just returns self, this method is only to comply with the Decimal " +"Specification." +msgstr "" + +msgid "" +"Return the absolute value of the argument. This operation is unaffected by " +"the context and is quiet: no flags are changed and no rounding is performed." +msgstr "" + +msgid "" +"Return the negation of the argument. This operation is unaffected by the " +"context and is quiet: no flags are changed and no rounding is performed." +msgstr "" + +msgid "" +"Return a copy of the first operand with the sign set to be the same as the " +"sign of the second operand. For example:" +msgstr "" + +msgid "" +"Return the value of the (natural) exponential function ``e**x`` at the given " +"number. The result is correctly rounded using the :const:`ROUND_HALF_EVEN` " +"rounding mode." +msgstr "" + +msgid "" +"Alternative constructor that only accepts instances of :class:`float` or :" +"class:`int`." +msgstr "" + +msgid "" +"Note ``Decimal.from_float(0.1)`` is not the same as ``Decimal('0.1')``. " +"Since 0.1 is not exactly representable in binary floating point, the value " +"is stored as the nearest representable value which is " +"``0x1.999999999999ap-4``. That equivalent value in decimal is " +"``0.1000000000000000055511151231257827021181583404541015625``." +msgstr "" + +msgid "" +"From Python 3.2 onwards, a :class:`Decimal` instance can also be constructed " +"directly from a :class:`float`." +msgstr "" + +msgid "" +"Fused multiply-add. Return self*other+third with no rounding of the " +"intermediate product self*other." +msgstr "" + +msgid "" +"Return :const:`True` if the argument is canonical and :const:`False` " +"otherwise. Currently, a :class:`Decimal` instance is always canonical, so " +"this operation always returns :const:`True`." +msgstr "" + +msgid "" +"Return :const:`True` if the argument is a finite number, and :const:`False` " +"if the argument is an infinity or a NaN." +msgstr "" + +msgid "" +"Return :const:`True` if the argument is either positive or negative infinity " +"and :const:`False` otherwise." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"Return :const:`True` if the argument is a quiet NaN, and :const:`False` " +"otherwise." +msgstr "" + +msgid "" +"Return :const:`True` if the argument has a negative sign and :const:`False` " +"otherwise. Note that zeros and NaNs can both carry signs." +msgstr "" + +msgid "" +"Return :const:`True` if the argument is a signaling NaN and :const:`False` " +"otherwise." +msgstr "" + +msgid "" +"Return :const:`True` if the argument is subnormal, and :const:`False` " +"otherwise." +msgstr "" + +msgid "" +"Return :const:`True` if the argument is a (positive or negative) zero and :" +"const:`False` otherwise." +msgstr "" + +msgid "" +"Return the natural (base e) logarithm of the operand. The result is " +"correctly rounded using the :const:`ROUND_HALF_EVEN` rounding mode." +msgstr "" + +msgid "" +"Return the base ten logarithm of the operand. The result is correctly " +"rounded using the :const:`ROUND_HALF_EVEN` rounding mode." +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('-" +"Infinity')`` is returned and the :const:`DivisionByZero` flag is raised. If " +"the operand is an infinity then ``Decimal('Infinity')`` is returned." +msgstr "" + +msgid "" +":meth:`logical_and` is a logical operation which takes two *logical " +"operands* (see :ref:`logical_operands_label`). The result is the digit-wise " +"``and`` of the two operands." +msgstr "" + +msgid "" +":meth:`logical_invert` is a logical operation. The result is the digit-wise " +"inversion of the operand." +msgstr "" + +msgid "" +":meth:`logical_or` is a logical operation which takes two *logical operands* " +"(see :ref:`logical_operands_label`). The result is the digit-wise ``or`` of " +"the two operands." +msgstr "" + +msgid "" +":meth:`logical_xor` is a logical operation which takes two *logical " +"operands* (see :ref:`logical_operands_label`). The result is the digit-wise " +"exclusive or of the two operands." +msgstr "" + +msgid "" +"Like ``max(self, other)`` except that the context rounding rule is applied " +"before returning and that ``NaN`` values are either signaled or ignored " +"(depending on the context and whether they are signaling or quiet)." +msgstr "" + +msgid "" +"Similar to the :meth:`.max` method, but the comparison is done using the " +"absolute values of the operands." +msgstr "" + +msgid "" +"Like ``min(self, other)`` except that the context rounding rule is applied " +"before returning and that ``NaN`` values are either signaled or ignored " +"(depending on the context and whether they are signaling or quiet)." +msgstr "" + +msgid "" +"Similar to the :meth:`.min` method, but the comparison is done using the " +"absolute values of the operands." +msgstr "" + +msgid "" +"Return the largest number representable in the given context (or in the " +"current thread's context if no context is given) that is smaller than the " +"given operand." +msgstr "" + +msgid "" +"Return the smallest number representable in the given context (or in the " +"current thread's context if no context is given) that is larger than the " +"given operand." +msgstr "" + +msgid "" +"If the two operands are unequal, return the number closest to the first " +"operand in the direction of the second operand. If both operands are " +"numerically equal, return a copy of the first operand with the sign set to " +"be the same as the sign of the second operand." +msgstr "" + +msgid "" +"Used for producing canonical values of an equivalence class within either " +"the current context or the specified context." +msgstr "" + +msgid "" +"This has the same semantics as the unary plus operation, except that if the " +"final result is finite it is reduced to its simplest form, with all trailing " +"zeros removed and its sign preserved. That is, while the coefficient is non-" +"zero and a multiple of ten the coefficient is divided by ten and the " +"exponent is incremented by 1. Otherwise (the coefficient is zero) the " +"exponent is set to 0. In all cases the sign is unchanged." +msgstr "" + +msgid "" +"For example, ``Decimal('32.100')`` and ``Decimal('0.321000e+2')`` both " +"normalize to the equivalent value ``Decimal('32.1')``." +msgstr "" + +msgid "Note that rounding is applied *before* reducing to simplest form." +msgstr "" + +msgid "" +"In the latest versions of the specification, this operation is also known as " +"``reduce``." +msgstr "" + +msgid "" +"Return a string describing the *class* of the operand. The returned value " +"is one of the following ten strings." +msgstr "" + +msgid "``\"-Infinity\"``, indicating that the operand is negative infinity." +msgstr "" + +msgid "" +"``\"-Normal\"``, indicating that the operand is a negative normal number." +msgstr "" + +msgid "" +"``\"-Subnormal\"``, indicating that the operand is negative and subnormal." +msgstr "" + +msgid "``\"-Zero\"``, indicating that the operand is a negative zero." +msgstr "" + +msgid "``\"+Zero\"``, indicating that the operand is a positive zero." +msgstr "" + +msgid "" +"``\"+Subnormal\"``, indicating that the operand is positive and subnormal." +msgstr "" + +msgid "" +"``\"+Normal\"``, indicating that the operand is a positive normal number." +msgstr "" + +msgid "``\"+Infinity\"``, indicating that the operand is positive infinity." +msgstr "" + +msgid "``\"NaN\"``, indicating that the operand is a quiet NaN (Not a Number)." +msgstr "" + +msgid "``\"sNaN\"``, indicating that the operand is a signaling NaN." +msgstr "" + +msgid "" +"Return a value equal to the first operand after rounding and having the " +"exponent of the second operand." +msgstr "" + +msgid "" +"Unlike other operations, if the length of the coefficient after the quantize " +"operation would be greater than precision, then an :const:`InvalidOperation` " +"is signaled. This guarantees that, unless there is an error condition, the " +"quantized exponent is always equal to that of the right-hand operand." +msgstr "" + +msgid "" +"Also unlike other operations, quantize never signals Underflow, even if the " +"result is subnormal and inexact." +msgstr "" + +msgid "" +"If the exponent of the second operand is larger than that of the first then " +"rounding may be necessary. In this case, the rounding mode is determined by " +"the ``rounding`` argument if given, else by the given ``context`` argument; " +"if neither argument is given the rounding mode of the current thread's " +"context is used." +msgstr "" + +msgid "" +"An error is returned whenever the resulting exponent is greater than :attr:" +"`~Context.Emax` or less than :meth:`~Context.Etiny`." +msgstr "" + +msgid "" +"Return ``Decimal(10)``, the radix (base) in which the :class:`Decimal` class " +"does all its arithmetic. Included for compatibility with the specification." +msgstr "" + +msgid "" +"Return the remainder from dividing *self* by *other*. This differs from " +"``self % other`` in that the sign of the remainder is chosen so as to " +"minimize its absolute value. More precisely, the return value is ``self - n " +"* other`` where ``n`` is the integer nearest to the exact value of ``self / " +"other``, and if two integers are equally near then the even one is chosen." +msgstr "" + +msgid "If the result is zero then its sign will be the sign of *self*." +msgstr "" + +msgid "" +"Return the result of rotating the digits of the first operand by an amount " +"specified by the second operand. The second operand must be an integer in " +"the range -precision through precision. The absolute value of the second " +"operand gives the number of places to rotate. If the second operand is " +"positive then rotation is to the left; otherwise rotation is to the right. " +"The coefficient of the first operand is padded on the left with zeros to " +"length precision if necessary. The sign and exponent of the first operand " +"are unchanged." +msgstr "" + +msgid "" +"Test whether self and other have the same exponent or whether both are " +"``NaN``." +msgstr "" + +msgid "" +"Return the first operand with exponent adjusted by the second. Equivalently, " +"return the first operand multiplied by ``10**other``. The second operand " +"must be an integer." +msgstr "" + +msgid "" +"Return the result of shifting the digits of the first operand by an amount " +"specified by the second operand. The second operand must be an integer in " +"the range -precision through precision. The absolute value of the second " +"operand gives the number of places to shift. If the second operand is " +"positive then the shift is to the left; otherwise the shift is to the " +"right. Digits shifted into the coefficient are zeros. The sign and " +"exponent of the first operand are unchanged." +msgstr "" + +msgid "Return the square root of the argument to full precision." +msgstr "" + +msgid "" +"Convert to a string, using engineering notation if an exponent is needed." +msgstr "" + +msgid "" +"Engineering notation has an exponent which is a multiple of 3. This can " +"leave up to 3 digits to the left of the decimal place and may require the " +"addition of either one or two trailing zeros." +msgstr "" + +msgid "" +"For example, this converts ``Decimal('123E+1')`` to ``Decimal('1.23E+3')``." +msgstr "" + +msgid "" +"Identical to the :meth:`to_integral_value` method. The ``to_integral`` name " +"has been kept for compatibility with older versions." +msgstr "" + +msgid "" +"Round to the nearest integer, signaling :const:`Inexact` or :const:`Rounded` " +"as appropriate if rounding occurs. The rounding mode is determined by the " +"``rounding`` parameter if given, else by the given ``context``. If neither " +"parameter is given then the rounding mode of the current context is used." +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." +msgstr "" + +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``." +msgstr "" + +msgid "Context objects" +msgstr "" + +msgid "" +"Contexts are environments for arithmetic operations. They govern precision, " +"set rules for rounding, determine which signals are treated as exceptions, " +"and limit the range for exponents." +msgstr "" + +msgid "" +"Each thread has its own current context which is accessed or changed using " +"the :func:`getcontext` and :func:`setcontext` functions:" +msgstr "" + +msgid "Return the current context for the active thread." +msgstr "" + +msgid "Set the current context for the active thread to *c*." +msgstr "" + +msgid "" +"You can also use the :keyword:`with` statement and the :func:`localcontext` " +"function to temporarily change the active context." +msgstr "" + +msgid "" +"Return a context manager that will set the current context for the active " +"thread to a copy of *ctx* on entry to the with-statement and restore the " +"previous context when exiting the with-statement. If no context is " +"specified, a copy of the current context is used. The *kwargs* argument is " +"used to set the attributes of the new context." +msgstr "" + +msgid "" +"For example, the following code sets the current decimal precision to 42 " +"places, performs a calculation, and then automatically restores the previous " +"context::" +msgstr "" + +msgid "Using keyword arguments, the code would be the following::" +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." +msgstr "" + +msgid "" +":meth:`localcontext` now supports setting context attributes through the use " +"of keyword arguments." +msgstr "" + +msgid "" +"New contexts can also be created using the :class:`Context` constructor " +"described below. In addition, the module provides three pre-made contexts:" +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`." +msgstr "" + +msgid "" +"Because many of the traps are enabled, this context is useful for debugging." +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)." +msgstr "" + +msgid "" +"Because the traps are disabled, this context is useful for applications that " +"prefer to have result value of ``NaN`` or ``Infinity`` instead of raising " +"exceptions. This allows an application to complete a run in the presence of " +"conditions that would otherwise halt the program." +msgstr "" + +msgid "" +"This context is used by the :class:`Context` constructor as a prototype for " +"new contexts. Changing a field (such a precision) has the effect of " +"changing the default for new contexts created by the :class:`Context` " +"constructor." +msgstr "" + +msgid "" +"This context is most useful in multi-threaded environments. Changing one of " +"the fields before threads are started has the effect of setting system-wide " +"defaults. Changing the fields after threads have started is not recommended " +"as it would require thread synchronization to prevent race conditions." +msgstr "" + +msgid "" +"In single threaded environments, it is preferable to not use this context at " +"all. Instead, simply create contexts explicitly as described below." +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`." +msgstr "" + +msgid "" +"In addition to the three supplied contexts, new contexts can be created with " +"the :class:`Context` constructor." +msgstr "" + +msgid "" +"Creates a new context. If a field is not specified or is :const:`None`, the " +"default values are copied from the :const:`DefaultContext`. If the *flags* " +"field is not specified or is :const:`None`, all flags are cleared." +msgstr "" + +msgid "" +"*prec* is an integer in the range [``1``, :const:`MAX_PREC`] that sets the " +"precision for arithmetic operations in the context." +msgstr "" + +msgid "" +"The *rounding* option is one of the constants listed in the section " +"`Rounding Modes`_." +msgstr "" + +msgid "" +"The *traps* and *flags* fields list any signals to be set. Generally, new " +"contexts should only set traps and leave the flags clear." +msgstr "" + +msgid "" +"The *Emin* and *Emax* fields are 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`]." +msgstr "" + +msgid "" +"The *capitals* field is either ``0`` or ``1`` (the default). If set to " +"``1``, exponents are printed with a capital ``E``; otherwise, a lowercase " +"``e`` is used: ``Decimal('6.02e+23')``." +msgstr "" + +msgid "" +"The *clamp* field is 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::" +msgstr "" + +msgid "" +"A *clamp* value of ``1`` allows compatibility with the fixed-width decimal " +"interchange formats specified in IEEE 754." +msgstr "" + +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." +msgstr "" + +msgid "Resets all of the flags to ``0``." +msgstr "" + +msgid "Resets all of the traps to ``0``." +msgstr "" + +msgid "Return a duplicate of the context." +msgstr "" + +msgid "Return a copy of the Decimal instance num." +msgstr "" + +msgid "" +"Creates a new Decimal instance from *num* but using *self* as context. " +"Unlike the :class:`Decimal` constructor, the context precision, rounding " +"method, flags, and traps are applied to the conversion." +msgstr "" + +msgid "" +"This is useful because constants are often given to a greater precision than " +"is needed by the application. Another benefit is that rounding immediately " +"eliminates unintended effects from digits beyond the current precision. In " +"the following example, using unrounded inputs means that adding zero to a " +"sum can change the result:" +msgstr "" + +msgid "" +"This method implements the to-number operation of the IBM specification. If " +"the argument is a string, no leading or trailing whitespace or underscores " +"are permitted." +msgstr "" + +msgid "" +"Creates a new Decimal instance from a float *f* but rounding using *self* as " +"the context. Unlike the :meth:`Decimal.from_float` class method, the " +"context precision, rounding method, flags, and traps are applied to the " +"conversion." +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`." +msgstr "" + +msgid "Returns a value equal to ``Emax - prec + 1``." +msgstr "" + +msgid "" +"The usual approach to working with decimals is to create :class:`Decimal` " +"instances and then apply arithmetic operations which take place within the " +"current context for the active thread. An alternative approach is to use " +"context methods for calculating within a specific context. The methods are " +"similar to those for the :class:`Decimal` class and are only briefly " +"recounted here." +msgstr "" + +msgid "Returns the absolute value of *x*." +msgstr "" + +msgid "Return the sum of *x* and *y*." +msgstr "" + +msgid "Returns the same Decimal object *x*." +msgstr "" + +msgid "Compares *x* and *y* numerically." +msgstr "" + +msgid "Compares the values of the two operands numerically." +msgstr "" + +msgid "Compares two operands using their abstract representation." +msgstr "" + +msgid "" +"Compares two operands using their abstract representation, ignoring sign." +msgstr "" + +msgid "Returns a copy of *x* with the sign set to 0." +msgstr "" + +msgid "Returns a copy of *x* with the sign inverted." +msgstr "" + +msgid "Copies the sign from *y* to *x*." +msgstr "" + +msgid "Return *x* divided by *y*." +msgstr "" + +msgid "Return *x* divided by *y*, truncated to an integer." +msgstr "" + +msgid "Divides two numbers and returns the integer part of the result." +msgstr "" + +msgid "Returns ``e ** x``." +msgstr "" + +msgid "Returns *x* multiplied by *y*, plus *z*." +msgstr "" + +msgid "Returns ``True`` if *x* is canonical; otherwise returns ``False``." +msgstr "" + +msgid "Returns ``True`` if *x* is finite; otherwise returns ``False``." +msgstr "" + +msgid "Returns ``True`` if *x* is infinite; otherwise returns ``False``." +msgstr "" + +msgid "Returns ``True`` if *x* is a qNaN or sNaN; otherwise returns ``False``." +msgstr "" + +msgid "" +"Returns ``True`` if *x* is a normal number; otherwise returns ``False``." +msgstr "" + +msgid "Returns ``True`` if *x* is a quiet NaN; otherwise returns ``False``." +msgstr "" + +msgid "Returns ``True`` if *x* is negative; otherwise returns ``False``." +msgstr "" + +msgid "" +"Returns ``True`` if *x* is a signaling NaN; otherwise returns ``False``." +msgstr "" + +msgid "Returns ``True`` if *x* is subnormal; otherwise returns ``False``." +msgstr "" + +msgid "Returns ``True`` if *x* is a zero; otherwise returns ``False``." +msgstr "" + +msgid "Returns the natural (base e) logarithm of *x*." +msgstr "" + +msgid "Returns the base 10 logarithm of *x*." +msgstr "" + +msgid "Returns the exponent of the magnitude of the operand's MSD." +msgstr "" + +msgid "Applies the logical operation *and* between each operand's digits." +msgstr "" + +msgid "Invert all the digits in *x*." +msgstr "" + +msgid "Applies the logical operation *or* between each operand's digits." +msgstr "" + +msgid "Applies the logical operation *xor* between each operand's digits." +msgstr "" + +msgid "Compares two values numerically and returns the maximum." +msgstr "" + +msgid "Compares the values numerically with their sign ignored." +msgstr "" + +msgid "Compares two values numerically and returns the minimum." +msgstr "" + +msgid "Minus corresponds to the unary prefix minus operator in Python." +msgstr "" + +msgid "Return the product of *x* and *y*." +msgstr "" + +msgid "Returns the largest representable number smaller than *x*." +msgstr "" + +msgid "Returns the smallest representable number larger than *x*." +msgstr "" + +msgid "Returns the number closest to *x*, in direction towards *y*." +msgstr "" + +msgid "Reduces *x* to its simplest form." +msgstr "" + +msgid "Returns an indication of the class of *x*." +msgstr "" + +msgid "" +"Plus corresponds to the unary prefix plus operator in Python. This " +"operation applies the context precision and rounding, so it is *not* an " +"identity operation." +msgstr "" + +msgid "Return ``x`` to the power of ``y``, reduced modulo ``modulo`` if given." +msgstr "" + +msgid "" +"With two arguments, compute ``x**y``. If ``x`` is negative then ``y`` must " +"be integral. The result will be inexact unless ``y`` is integral and the " +"result is finite and can be expressed exactly in 'precision' digits. The " +"rounding mode of the context is used. Results are always correctly rounded " +"in the Python version." +msgstr "" + +msgid "" +"``Decimal(0) ** Decimal(0)`` results in ``InvalidOperation``, and if " +"``InvalidOperation`` is not trapped, then results in ``Decimal('NaN')``." +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\"." +msgstr "" + +msgid "" +"With three arguments, compute ``(x**y) % modulo``. For the three argument " +"form, the following restrictions on the arguments hold:" +msgstr "" + +msgid "all three arguments must be integral" +msgstr "" + +msgid "``y`` must be nonnegative" +msgstr "" + +msgid "at least one of ``x`` or ``y`` must be nonzero" +msgstr "" + +msgid "``modulo`` must be nonzero and have at most 'precision' digits" +msgstr "" + +msgid "" +"The value resulting from ``Context.power(x, y, modulo)`` is equal to the " +"value that would be obtained by computing ``(x**y) % modulo`` with unbounded " +"precision, but is computed more efficiently. The exponent of the result is " +"zero, regardless of the exponents of ``x``, ``y`` and ``modulo``. The " +"result is always exact." +msgstr "" + +msgid "Returns a value equal to *x* (rounded), having the exponent of *y*." +msgstr "" + +msgid "Just returns 10, as this is Decimal, :)" +msgstr "" + +msgid "Returns the remainder from integer division." +msgstr "" + +msgid "" +"The sign of the result, if non-zero, is the same as that of the original " +"dividend." +msgstr "" + +msgid "" +"Returns ``x - y * n``, where *n* is the integer nearest the exact value of " +"``x / y`` (if the result is 0 then its sign will be the sign of *x*)." +msgstr "" + +msgid "Returns a rotated copy of *x*, *y* times." +msgstr "" + +msgid "Returns ``True`` if the two operands have the same exponent." +msgstr "" + +msgid "Returns the first operand after adding the second value its exp." +msgstr "" + +msgid "Returns a shifted copy of *x*, *y* times." +msgstr "" + +msgid "Square root of a non-negative number to context precision." +msgstr "" + +msgid "Return the difference between *x* and *y*." +msgstr "" + +msgid "Rounds to an integer." +msgstr "" + +msgid "Converts a number to a string using scientific notation." +msgstr "" + +msgid "Constants" +msgstr "Stały" + +msgid "" +"The constants in this section are only relevant for the C module. They are " +"also included in the pure Python version for compatibility." +msgstr "" + +msgid "32-bit" +msgstr "" + +msgid "64-bit" +msgstr "" + +msgid "``425000000``" +msgstr "``425000000``" + +msgid "``999999999999999999``" +msgstr "``999999999999999999``" + +msgid "``-425000000``" +msgstr "``-425000000``" + +msgid "``-999999999999999999``" +msgstr "``-999999999999999999``" + +msgid "``-849999999``" +msgstr "``-849999999``" + +msgid "``-1999999999999999997``" +msgstr "``-1999999999999999997``" + +msgid "" +"The value is ``True``. Deprecated, because Python now always has threads." +msgstr "" + +msgid "" +"The default value is ``True``. If Python is :option:`configured using the --" +"without-decimal-contextvar option <--without-decimal-contextvar>`, the C " +"version uses a thread-local rather than a coroutine-local context and the " +"value is ``False``. This is slightly faster in some nested context " +"scenarios." +msgstr "" + +msgid "Rounding modes" +msgstr "" + +msgid "Round towards ``Infinity``." +msgstr "" + +msgid "Round towards zero." +msgstr "" + +msgid "Round towards ``-Infinity``." +msgstr "" + +msgid "Round to nearest with ties going towards zero." +msgstr "" + +msgid "Round to nearest with ties going to nearest even integer." +msgstr "" + +msgid "Round to nearest with ties going away from zero." +msgstr "" + +msgid "Round away from zero." +msgstr "" + +msgid "" +"Round away from zero if last digit after rounding towards zero would have " +"been 0 or 5; otherwise round towards zero." +msgstr "" + +msgid "Signals" +msgstr "" + +msgid "" +"Signals represent conditions that arise during computation. Each corresponds " +"to one context flag and one context trap enabler." +msgstr "" + +msgid "" +"The context flag is set whenever the condition is encountered. After the " +"computation, flags may be checked for informational purposes (for instance, " +"to determine whether a computation was exact). After checking the flags, be " +"sure to clear all flags before starting the next computation." +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." +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." +msgstr "" + +msgid "Base class for other signals and a subclass of :exc:`ArithmeticError`." +msgstr "" + +msgid "Signals the division of a non-infinite number by zero." +msgstr "" + +msgid "" +"Can occur with division, modulo division, or when raising a number to a " +"negative power. If this signal is not trapped, returns ``Infinity`` or ``-" +"Infinity`` with the sign determined by the inputs to the calculation." +msgstr "" + +msgid "Indicates that rounding occurred and the result is not exact." +msgstr "" + +msgid "" +"Signals when non-zero digits were discarded during rounding. The rounded " +"result is returned. The signal flag or trap is used to detect when results " +"are inexact." +msgstr "" + +msgid "An invalid operation was performed." +msgstr "" + +msgid "" +"Indicates that an operation was requested that does not make sense. If not " +"trapped, returns ``NaN``. Possible causes include::" +msgstr "" + +msgid "Numerical overflow." +msgstr "" + +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." +msgstr "" + +msgid "Rounding occurred though possibly no information was lost." +msgstr "" + +msgid "" +"Signaled whenever rounding discards digits; even if those digits are zero " +"(such as rounding ``5.00`` to ``5.0``). If not trapped, returns the result " +"unchanged. This signal is used to detect loss of significant digits." +msgstr "" + +msgid "Exponent was lower than :attr:`~Context.Emin` prior to rounding." +msgstr "" + +msgid "" +"Occurs when an operation result is subnormal (the exponent is too small). If " +"not trapped, returns the result unchanged." +msgstr "" + +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." +msgstr "" + +msgid "Enable stricter semantics for mixing floats and Decimals." +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." +msgstr "" + +msgid "" +"Otherwise (the signal is trapped), only equality comparisons and explicit " +"conversions are silent. All other mixed operations raise :exc:" +"`FloatOperation`." +msgstr "" + +msgid "The following table summarizes the hierarchy of signals::" +msgstr "" + +msgid "Floating Point Notes" +msgstr "" + +msgid "Mitigating round-off error with increased precision" +msgstr "" + +msgid "" +"The use of decimal floating point eliminates decimal representation error " +"(making it possible to represent ``0.1`` exactly); however, some operations " +"can still incur round-off error when non-zero digits exceed the fixed " +"precision." +msgstr "" + +msgid "" +"The effects of round-off error can be amplified by the addition or " +"subtraction of nearly offsetting quantities resulting in loss of " +"significance. Knuth provides two instructive examples where rounded " +"floating point arithmetic with insufficient precision causes the breakdown " +"of the associative and distributive properties of addition:" +msgstr "" + +msgid "" +"The :mod:`decimal` module makes it possible to restore the identities by " +"expanding the precision sufficiently to avoid loss of significance:" +msgstr "" + +msgid "Special values" +msgstr "" + +msgid "" +"The number system for the :mod:`decimal` module provides special values " +"including ``NaN``, ``sNaN``, ``-Infinity``, ``Infinity``, and two zeros, " +"``+0`` and ``-0``." +msgstr "" + +msgid "" +"Infinities can be constructed directly with: ``Decimal('Infinity')``. Also, " +"they can arise from dividing by zero when the :exc:`DivisionByZero` signal " +"is not trapped. Likewise, when the :exc:`Overflow` signal is not trapped, " +"infinity can result from rounding beyond the limits of the largest " +"representable number." +msgstr "" + +msgid "" +"The infinities are signed (affine) and can be used in arithmetic operations " +"where they get treated as very large, indeterminate numbers. For instance, " +"adding a constant to infinity gives another infinite result." +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 " +"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." +msgstr "" + +msgid "" +"A variant is ``sNaN`` which signals rather than remaining quiet after every " +"operation. This is a useful return value when an invalid result needs to " +"interrupt a calculation for special handling." +msgstr "" + +msgid "" +"The behavior of Python's comparison operators can be a little surprising " +"where a ``NaN`` is involved. A test for equality where one of the operands " +"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 " +"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." +msgstr "" + +msgid "" +"The signed zeros can result from calculations that underflow. They keep the " +"sign that would have resulted if the calculation had been carried out to " +"greater precision. Since their magnitude is zero, both positive and " +"negative zeros are treated as equal and their sign is informational." +msgstr "" + +msgid "" +"In addition to the two signed zeros which are distinct yet equal, there are " +"various representations of zero with differing precisions yet equivalent in " +"value. This takes a bit of getting used to. For an eye accustomed to " +"normalized floating point representations, it is not immediately obvious " +"that the following calculation returns a value equal to zero:" +msgstr "" + +msgid "Working with threads" +msgstr "" + +msgid "" +"The :func:`getcontext` function accesses a different :class:`Context` object " +"for each thread. Having separate thread contexts means that threads may " +"make changes (such as ``getcontext().prec=10``) without interfering with " +"other threads." +msgstr "" + +msgid "" +"Likewise, the :func:`setcontext` function automatically assigns its target " +"to the current thread." +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." +msgstr "" + +msgid "" +"The new context is copied from a prototype context called *DefaultContext*. " +"To control the defaults so that each thread will use the same values " +"throughout the application, directly modify the *DefaultContext* object. " +"This should be done *before* any threads are started so that there won't be " +"a race condition between threads calling :func:`getcontext`. For example::" +msgstr "" + +msgid "Recipes" +msgstr "" + +msgid "" +"Here are a few recipes that serve as utility functions and that demonstrate " +"ways to work with the :class:`Decimal` class::" +msgstr "" + +msgid "Decimal FAQ" +msgstr "" + +msgid "" +"Q. It is cumbersome to type ``decimal.Decimal('1234.5')``. Is there a way " +"to minimize typing when using the interactive interpreter?" +msgstr "" + +msgid "A. Some users abbreviate the constructor to just a single letter:" +msgstr "" + +msgid "" +"Q. In a fixed-point application with two decimal places, some inputs have " +"many places and need to be rounded. Others are not supposed to have excess " +"digits and need to be validated. What methods should be used?" +msgstr "" + +msgid "" +"A. The :meth:`~Decimal.quantize` method rounds to a fixed number of decimal " +"places. If the :const:`Inexact` trap is set, it is also useful for " +"validation:" +msgstr "" + +msgid "" +"Q. Once I have valid two place inputs, how do I maintain that invariant " +"throughout an application?" +msgstr "" + +msgid "" +"A. Some operations like addition, subtraction, and multiplication by an " +"integer will automatically preserve fixed point. Others operations, like " +"division and non-integer multiplication, will change the number of decimal " +"places and need to be followed-up with a :meth:`~Decimal.quantize` step:" +msgstr "" + +msgid "" +"In developing fixed-point applications, it is convenient to define functions " +"to handle the :meth:`~Decimal.quantize` step:" +msgstr "" + +msgid "" +"Q. There are many ways to express the same value. The numbers ``200``, " +"``200.000``, ``2E2``, and ``.02E+4`` all have the same value at various " +"precisions. Is there a way to transform them to a single recognizable " +"canonical value?" +msgstr "" + +msgid "" +"A. The :meth:`~Decimal.normalize` method maps all equivalent values to a " +"single representative:" +msgstr "" + +msgid "Q. When does rounding occur in a computation?" +msgstr "" + +msgid "" +"A. It occurs *after* the computation. The philosophy of the decimal " +"specification is that numbers are considered exact and are created " +"independent of the current context. They can even have greater precision " +"than current context. Computations process with those exact inputs and then " +"rounding (or other context operations) is applied to the *result* of the " +"computation::" +msgstr "" + +msgid "" +"Q. Some decimal values always print with exponential notation. Is there a " +"way to get a non-exponential representation?" +msgstr "" + +msgid "" +"A. For some values, exponential notation is the only way to express the " +"number of significant places in the coefficient. For example, expressing " +"``5.0E+3`` as ``5000`` keeps the value constant but cannot show the " +"original's two-place significance." +msgstr "" + +msgid "" +"If an application does not care about tracking significance, it is easy to " +"remove the exponent and trailing zeroes, losing significance, but keeping " +"the value unchanged:" +msgstr "" + +msgid "Q. Is there a way to convert a regular float to a :class:`Decimal`?" +msgstr "" + +msgid "" +"A. Yes, any binary floating point number can be exactly expressed as a " +"Decimal though an exact conversion may take more precision than intuition " +"would suggest:" +msgstr "" + +msgid "" +"Q. Within a complex calculation, how can I make sure that I haven't gotten a " +"spurious result because of insufficient precision or rounding anomalies." +msgstr "" + +msgid "" +"A. The decimal module makes it easy to test results. A best practice is to " +"re-run calculations using greater precision and with various rounding modes. " +"Widely differing results indicate insufficient precision, rounding mode " +"issues, ill-conditioned inputs, or a numerically unstable algorithm." +msgstr "" + +msgid "" +"Q. I noticed that context precision is applied to the results of operations " +"but not to the inputs. Is there anything to watch out for when mixing " +"values of different precisions?" +msgstr "" + +msgid "" +"A. Yes. The principle is that all values are considered to be exact and so " +"is the arithmetic on those values. Only the results are rounded. The " +"advantage for inputs is that \"what you type is what you get\". A " +"disadvantage is that the results can look odd if you forget that the inputs " +"haven't been rounded:" +msgstr "" + +msgid "" +"The solution is either to increase precision or to force rounding of inputs " +"using the unary plus operation:" +msgstr "" + +msgid "" +"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?" +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 `_ for medium-sized numbers and the `Number Theoretic " +"Transform `_ for very " +"large numbers." +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." +msgstr "" + +msgid "" +"The easiest approach for trying out bignum arithmetic is to use the maximum " +"value for :attr:`~Context.prec` as well [#]_::" +msgstr "" + +msgid "" +"For inexact results, :attr:`MAX_PREC` is far too large on 64-bit platforms " +"and the available memory will be insufficient::" +msgstr "" + +msgid "" +"On systems with overallocation (e.g. Linux), a more sophisticated approach " +"is to adjust :attr:`~Context.prec` to the amount of available RAM. Suppose " +"that you have 8GB of RAM and expect 10 simultaneous operands using a maximum " +"of 500MB each::" +msgstr "" + +msgid "" +"In general (and especially on systems without overallocation), it is " +"recommended to estimate even tighter bounds and set the :attr:`Inexact` trap " +"if all calculations are expected to be exact." +msgstr "" + +msgid "" +"This approach now works for all exact results except for non-integer powers." +msgstr "" diff --git a/library/devmode.po b/library/devmode.po new file mode 100644 index 0000000000..c943c9834d --- /dev/null +++ b/library/devmode.po @@ -0,0 +1,247 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Python Development Mode" +msgstr "" + +msgid "" +"The Python Development Mode introduces additional runtime checks that are " +"too expensive to be enabled by default. It should not be more verbose than " +"the default if the code is correct; new warnings are only emitted when an " +"issue is detected." +msgstr "" + +msgid "" +"It can be enabled using the :option:`-X dev <-X>` command line option or by " +"setting the :envvar:`PYTHONDEVMODE` environment variable to ``1``." +msgstr "" + +msgid "See also :ref:`Python debug build `." +msgstr "" + +msgid "Effects of the Python Development Mode" +msgstr "" + +msgid "" +"Enabling the Python Development Mode is similar to the following command, " +"but with additional effects described below::" +msgstr "" + +msgid "Effects of the Python Development Mode:" +msgstr "" + +msgid "" +"Add ``default`` :ref:`warning filter `. The " +"following warnings are shown:" +msgstr "" + +msgid ":exc:`DeprecationWarning`" +msgstr ":exc:`DeprecationWarning`" + +msgid ":exc:`ImportWarning`" +msgstr ":exc:`ImportWarning`" + +msgid ":exc:`PendingDeprecationWarning`" +msgstr ":exc:`PendingDeprecationWarning`" + +msgid ":exc:`ResourceWarning`" +msgstr ":exc:`ResourceWarning`" + +msgid "" +"Normally, the above warnings are filtered by the default :ref:`warning " +"filters `." +msgstr "" + +msgid "" +"It behaves as if the :option:`-W default <-W>` command line option is used." +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." +msgstr "" + +msgid "Install debug hooks on memory allocators to check for:" +msgstr "" + +msgid "Buffer underflow" +msgstr "" + +msgid "Buffer overflow" +msgstr "" + +msgid "Memory allocator API violation" +msgstr "" + +msgid "Unsafe usage of the GIL" +msgstr "" + +msgid "See the :c:func:`PyMem_SetupDebugHooks` C function." +msgstr "" + +msgid "" +"It behaves as if the :envvar:`PYTHONMALLOC` environment variable is set to " +"``debug``." +msgstr "" + +msgid "" +"To enable the Python Development Mode without installing debug hooks on " +"memory allocators, set the :envvar:`PYTHONMALLOC` environment variable to " +"``default``." +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." +msgstr "" + +msgid "" +"It behaves as if the :option:`-X faulthandler <-X>` command line option is " +"used or if the :envvar:`PYTHONFAULTHANDLER` environment variable is set to " +"``1``." +msgstr "" + +msgid "" +"Enable :ref:`asyncio debug mode `. For example, :mod:" +"`asyncio` checks for coroutines that were not awaited and logs them." +msgstr "" + +msgid "" +"It behaves as if the :envvar:`PYTHONASYNCIODEBUG` environment variable is " +"set to ``1``." +msgstr "" + +msgid "" +"Check the *encoding* and *errors* arguments for string encoding and decoding " +"operations. Examples: :func:`open`, :meth:`str.encode` and :meth:`bytes." +"decode`." +msgstr "" + +msgid "" +"By default, for best performance, the *errors* argument is only checked at " +"the first encoding/decoding error and the *encoding* argument is sometimes " +"ignored for empty strings." +msgstr "" + +msgid "The :class:`io.IOBase` destructor logs ``close()`` exceptions." +msgstr "" + +msgid "" +"Set the :attr:`~sys.flags.dev_mode` attribute of :data:`sys.flags` to " +"``True``." +msgstr "" + +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." +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``." +msgstr "" + +msgid "" +"The Python Development Mode can only be enabled at the Python startup. Its " +"value can be read from :data:`sys.flags.dev_mode `." +msgstr "" + +msgid "The :class:`io.IOBase` destructor now logs ``close()`` exceptions." +msgstr "" + +msgid "" +"The *encoding* and *errors* arguments are now checked for string encoding " +"and decoding operations." +msgstr "" + +msgid "ResourceWarning Example" +msgstr "" + +msgid "" +"Example of a script counting the number of lines of the text file specified " +"in the command line::" +msgstr "" + +msgid "" +"The script does not close the file explicitly. By default, Python does not " +"emit any warning. Example using README.txt, which has 269 lines:" +msgstr "" + +msgid "" +"Enabling the Python Development Mode displays a :exc:`ResourceWarning` " +"warning:" +msgstr "" + +msgid "" +"In addition, enabling :mod:`tracemalloc` shows the line where the file was " +"opened:" +msgstr "" + +msgid "" +"The fix is to close explicitly the file. Example using a context manager::" +msgstr "" + +msgid "" +"Not closing a resource explicitly can leave a resource open for way longer " +"than expected; it can cause severe issues upon exiting Python. It is bad in " +"CPython, but it is even worse in PyPy. Closing resources explicitly makes an " +"application more deterministic and more reliable." +msgstr "" + +msgid "Bad file descriptor error example" +msgstr "" + +msgid "Script displaying the first line of itself::" +msgstr "" + +msgid "By default, Python does not emit any warning:" +msgstr "" + +msgid "" +"The Python Development Mode shows a :exc:`ResourceWarning` and logs a \"Bad " +"file descriptor\" error when finalizing the file object:" +msgstr "" + +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)." +msgstr "" + +msgid "" +"The fix is to remove the ``os.close(fp.fileno())`` line, or open the file " +"with ``closefd=False``." +msgstr "" diff --git a/library/difflib.po b/library/difflib.po index b2f769f0ed..2516b5bc0d 100644 --- a/library/difflib.po +++ b/library/difflib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +71,7 @@ msgid "" "``False`` when creating the :class:`SequenceMatcher`." msgstr "" -msgid "The *autojunk* parameter." +msgid "Added the *autojunk* parameter." msgstr "" msgid "" @@ -91,25 +91,25 @@ msgid "Meaning" msgstr "Znaczenie" msgid "``'- '``" -msgstr "" +msgstr "``'- '``" msgid "line unique to sequence 1" msgstr "" msgid "``'+ '``" -msgstr "" +msgstr "``'+ '``" msgid "line unique to sequence 2" msgstr "" msgid "``' '``" -msgstr "" +msgstr "``' '``" msgid "line common to both sequences" msgstr "" msgid "``'? '``" -msgstr "" +msgstr "``'? '``" msgid "line not present in either input sequence" msgstr "" @@ -300,7 +300,7 @@ msgid "" msgstr "" msgid "Example:" -msgstr "" +msgstr "Przykład:" msgid "" "Compare *a* and *b* (lists of strings); return a delta (a :term:`generator` " @@ -322,6 +322,14 @@ msgid "" "trailing newlines." msgstr "" +msgid "" +"The unified diff format normally has a header for filenames and modification " +"times. Any or all of these may be specified using strings for *fromfile*, " +"*tofile*, *fromfiledate*, and *tofiledate*. The modification times are " +"normally expressed in the ISO 8601 format. If not specified, the strings " +"default to blanks." +msgstr "" + msgid "" "Compare *a* and *b* (lists of bytes objects) using *dfunc*; yield a sequence " "of delta lines (also bytes) in the format returned by *dfunc*. *dfunc* must " @@ -491,19 +499,19 @@ msgid "Value" msgstr "Wartość" msgid "``'replace'``" -msgstr "" +msgstr "``'replace'``" msgid "``a[i1:i2]`` should be replaced by ``b[j1:j2]``." msgstr "" msgid "``'delete'``" -msgstr "" +msgstr "``'delete'``" msgid "``a[i1:i2]`` should be deleted. Note that ``j1 == j2`` in this case." msgstr "" msgid "``'insert'``" -msgstr "" +msgstr "``'insert'``" msgid "" "``b[j1:j2]`` should be inserted at ``a[i1:i1]``. Note that ``i1 == i2`` in " @@ -511,7 +519,7 @@ msgid "" msgstr "" msgid "``'equal'``" -msgstr "" +msgstr "``'equal'``" msgid "``a[i1:i2] == b[j1:j2]`` (the sub-sequences are equal)." msgstr "" @@ -561,8 +569,9 @@ 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:`quick_ratio` and :meth:`real_quick_ratio` are always at least as large " -"as :meth:`ratio`:" +"meth:`~SequenceMatcher.quick_ratio` and :meth:`~SequenceMatcher." +"real_quick_ratio` are always at least as large as :meth:`~SequenceMatcher." +"ratio`:" msgstr "" msgid "SequenceMatcher Examples" @@ -572,25 +581,26 @@ msgid "This example compares two strings, considering blanks to be \"junk\":" msgstr "" msgid "" -":meth:`ratio` returns a float in [0, 1], measuring the similarity of the " -"sequences. As a rule of thumb, a :meth:`ratio` value over 0.6 means the " -"sequences are close matches:" +":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:" msgstr "" msgid "" "If you're only interested in where the sequences match, :meth:" -"`get_matching_blocks` is handy:" +"`~SequenceMatcher.get_matching_blocks` is handy:" msgstr "" msgid "" -"Note that the last tuple returned by :meth:`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:`get_opcodes`:" +"meth:`~SequenceMatcher.get_opcodes`:" msgstr "" msgid "" @@ -664,7 +674,7 @@ msgstr "" msgid "" "This example compares two texts. First we set up the texts, sequences of " "individual single-line strings ending with newlines (such sequences can also " -"be obtained from the :meth:`~io.BaseIO.readlines` method of file-like " +"be obtained from the :meth:`~io.IOBase.readlines` method of file-like " "objects):" msgstr "" diff --git a/library/dis.po b/library/dis.po new file mode 100644 index 0000000000..0dc533bf7f --- /dev/null +++ b/library/dis.po @@ -0,0 +1,1207 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`dis` --- Disassembler for Python bytecode" +msgstr "" + +msgid "**Source code:** :source:`Lib/dis.py`" +msgstr "" + +msgid "" +"The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by " +"disassembling it. The CPython bytecode which this module takes as an input " +"is defined in the file :file:`Include/opcode.h` and used by the compiler and " +"the interpreter." +msgstr "" + +msgid "" +"Bytecode is an implementation detail of the CPython interpreter. No " +"guarantees are made that bytecode will not be added, removed, or changed " +"between versions of Python. Use of this module should not be considered to " +"work across Python VMs or Python releases." +msgstr "" + +msgid "" +"Use 2 bytes for each instruction. Previously the number of bytes varied by " +"instruction." +msgstr "" + +msgid "" +"The argument of jump, exception handling and loop instructions is now the " +"instruction offset rather than the byte offset." +msgstr "" + +msgid "" +"Some instructions are accompanied by one or more inline cache entries, which " +"take the form of :opcode:`CACHE` instructions. These instructions are hidden " +"by default, but can be shown by passing ``show_caches=True`` to any :mod:" +"`dis` utility. Furthermore, the interpreter now adapts the bytecode to " +"specialize it for different runtime conditions. The adaptive bytecode can be " +"shown by passing ``adaptive=True``." +msgstr "" + +msgid "Example: Given the function :func:`myfunc`::" +msgstr "" + +msgid "" +"the following command can be used to display the disassembly of :func:" +"`myfunc`:" +msgstr "" + +msgid "(The \"2\" is a line number)." +msgstr "" + +msgid "Command-line interface" +msgstr "" + +msgid "The :mod:`dis` module can be invoked as a script from the command line:" +msgstr "" + +msgid "The following options are accepted:" +msgstr "" + +msgid "Display usage and exit." +msgstr "" + +msgid "Show inline caches." +msgstr "" + +msgid "" +"If :file:`infile` is specified, its disassembled code will be written to " +"stdout. Otherwise, disassembly is performed on compiled source code recieved " +"from stdin." +msgstr "" + +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." +msgstr "" + +msgid "" +"Analyse the bytecode corresponding to a function, generator, asynchronous " +"generator, coroutine, method, string of source code, or a code object (as " +"returned by :func:`compile`)." +msgstr "" + +msgid "" +"This is a convenience wrapper around many of the functions listed below, " +"most notably :func:`get_instructions`, as iterating over a :class:`Bytecode` " +"instance yields the bytecode operations as :class:`Instruction` instances." +msgstr "" + +msgid "" +"If *first_line* is not ``None``, it indicates the line number that should be " +"reported for the first source line in the disassembled code. Otherwise, the " +"source line information (if any) is taken directly from the disassembled " +"code object." +msgstr "" + +msgid "" +"If *current_offset* is not ``None``, it refers to an instruction offset in " +"the disassembled code. Setting this means :meth:`.dis` will display a " +"\"current instruction\" marker against the specified opcode." +msgstr "" + +msgid "" +"If *show_caches* is ``True``, :meth:`.dis` will display inline cache entries " +"used by the interpreter to specialize the bytecode." +msgstr "" + +msgid "" +"If *adaptive* is ``True``, :meth:`.dis` will display specialized bytecode " +"that may be different from the original bytecode." +msgstr "" + +msgid "" +"Construct a :class:`Bytecode` instance from the given traceback, setting " +"*current_offset* to the instruction responsible for the exception." +msgstr "" + +msgid "The compiled code object." +msgstr "" + +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)." +msgstr "" + +msgid "" +"Return a formatted multi-line string with detailed information about the " +"code object, like :func:`code_info`." +msgstr "" + +msgid "This can now handle coroutine and asynchronous generator objects." +msgstr "" + +msgid "Added the *show_caches* and *adaptive* parameters." +msgstr "" + +msgid "Example:" +msgstr "Przykład:" + +msgid "Analysis functions" +msgstr "" + +msgid "" +"The :mod:`dis` module also defines the following analysis functions that " +"convert the input directly to the desired output. They can be useful if only " +"a single operation is being performed, so the intermediate analysis object " +"isn't useful:" +msgstr "" + +msgid "" +"Return a formatted multi-line string with detailed code object information " +"for the supplied function, generator, asynchronous generator, coroutine, " +"method, source code string or code object." +msgstr "" + +msgid "" +"Note that the exact contents of code info strings are highly implementation " +"dependent and they may change arbitrarily across Python VMs or Python " +"releases." +msgstr "" + +msgid "" +"Print detailed code object information for the supplied function, method, " +"source code string or code object to *file* (or ``sys.stdout`` if *file* is " +"not specified)." +msgstr "" + +msgid "" +"This is a convenient shorthand for ``print(code_info(x), file=file)``, " +"intended for interactive exploration at the interpreter prompt." +msgstr "" + +msgid "Added *file* parameter." +msgstr "" + +msgid "" +"Disassemble the *x* object. *x* can denote either a module, a class, a " +"method, a function, a generator, an asynchronous generator, a coroutine, a " +"code object, a string of source code or a byte sequence of raw bytecode. For " +"a module, it disassembles all functions. For a class, it disassembles all " +"methods (including class and static methods). For a code object or sequence " +"of raw bytecode, it prints one line per bytecode instruction. It also " +"recursively disassembles nested code objects (the code of comprehensions, " +"generator expressions and nested functions, and the code used for building " +"nested classes). Strings are first compiled to code objects with the :func:" +"`compile` built-in function before being disassembled. If no object is " +"provided, this function disassembles the last traceback." +msgstr "" + +msgid "" +"The disassembly is written as text to the supplied *file* argument if " +"provided and to ``sys.stdout`` otherwise." +msgstr "" + +msgid "" +"The maximal depth of recursion is limited by *depth* unless it is ``None``. " +"``depth=0`` means no recursion." +msgstr "" + +msgid "" +"If *show_caches* is ``True``, this function will display inline cache " +"entries used by the interpreter to specialize the bytecode." +msgstr "" + +msgid "" +"If *adaptive* is ``True``, this function will display specialized bytecode " +"that may be different from the original bytecode." +msgstr "" + +msgid "Implemented recursive disassembling and added *depth* parameter." +msgstr "" + +msgid "" +"Disassemble the top-of-stack function of a traceback, using the last " +"traceback if none was passed. The instruction causing the exception is " +"indicated." +msgstr "" + +msgid "" +"Disassemble a code object, indicating the last instruction if *lasti* was " +"provided. The output is divided in the following columns:" +msgstr "" + +msgid "the line number, for the first instruction of each line" +msgstr "" + +msgid "the current instruction, indicated as ``-->``," +msgstr "" + +msgid "a labelled instruction, indicated with ``>>``," +msgstr "" + +msgid "the address of the instruction," +msgstr "" + +msgid "the operation code name," +msgstr "" + +msgid "operation parameters, and" +msgstr "" + +msgid "interpretation of the parameters in parentheses." +msgstr "" + +msgid "" +"The parameter interpretation recognizes local and global variable names, " +"constant values, branch targets, and compare operators." +msgstr "" + +msgid "" +"Return an iterator over the instructions in the supplied function, method, " +"source code string or code object." +msgstr "" + +msgid "" +"The iterator generates a series of :class:`Instruction` named tuples giving " +"the details of each operation in the supplied code." +msgstr "" + +msgid "" +"The *show_caches* and *adaptive* parameters work as they do in :func:`dis`." +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." +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` " +"attributes of the :ref:`code object `." +msgstr "" + +msgid "" +"Detect all offsets in the raw compiled bytecode string *code* which are jump " +"targets, and return a list of these offsets." +msgstr "" + +msgid "Compute the stack effect of *opcode* with argument *oparg*." +msgstr "" + +msgid "" +"If the code has a jump target and *jump* is ``True``, :func:`~stack_effect` " +"will return the stack effect of jumping. If *jump* is ``False``, it will " +"return the stack effect of not jumping. And if *jump* is ``None`` (default), " +"it will return the maximal stack effect of both cases." +msgstr "" + +msgid "Added *jump* parameter." +msgstr "" + +msgid "Python Bytecode Instructions" +msgstr "" + +msgid "" +"The :func:`get_instructions` function and :class:`Bytecode` class provide " +"details of bytecode instructions as :class:`Instruction` instances:" +msgstr "" + +msgid "Details for a bytecode operation" +msgstr "" + +msgid "" +"numeric code for operation, corresponding to the opcode values listed below " +"and the bytecode values in the :ref:`opcode_collections`." +msgstr "" + +msgid "human readable name for operation" +msgstr "" + +msgid "numeric argument to operation (if any), otherwise ``None``" +msgstr "" + +msgid "resolved arg value (if any), otherwise ``None``" +msgstr "" + +msgid "" +"human readable description of operation argument (if any), otherwise an " +"empty string." +msgstr "" + +msgid "start index of operation within bytecode sequence" +msgstr "" + +msgid "line started by this opcode (if any), otherwise ``None``" +msgstr "" + +msgid "``True`` if other code jumps to here, otherwise ``False``" +msgstr "" + +msgid "" +":class:`dis.Positions` object holding the start and end locations that are " +"covered by this instruction." +msgstr "" + +msgid "Field ``positions`` is added." +msgstr "" + +msgid "" +"In case the information is not available, some fields might be ``None``." +msgstr "" + +msgid "" +"The Python compiler currently generates the following bytecode instructions." +msgstr "" + +msgid "**General instructions**" +msgstr "" + +msgid "" +"Do nothing code. Used as a placeholder by the bytecode optimizer, and to " +"generate line tracing events." +msgstr "" + +msgid "Removes the top-of-stack (TOS) item." +msgstr "" + +msgid "" +"Push the *i*-th item to the top of the stack. The item is not removed from " +"its original location." +msgstr "" + +msgid "Swap TOS with the item at position *i*." +msgstr "" + +msgid "" +"Rather than being an actual instruction, this opcode is used to mark extra " +"space for the interpreter to cache useful data directly in the bytecode " +"itself. It is automatically hidden by all ``dis`` utilities, but can be " +"viewed with ``show_caches=True``." +msgstr "" + +msgid "" +"Logically, this space is part of the preceding instruction. Many opcodes " +"expect to be followed by an exact number of caches, and will instruct the " +"interpreter to skip over them at runtime." +msgstr "" + +msgid "" +"Populated caches can look like arbitrary instructions, so great care should " +"be taken when reading or modifying raw, adaptive bytecode containing " +"quickened data." +msgstr "" + +msgid "**Unary operations**" +msgstr "" + +msgid "" +"Unary operations take the top of the stack, apply the operation, and push " +"the result back on the stack." +msgstr "" + +msgid "Implements ``TOS = +TOS``." +msgstr "" + +msgid "Implements ``TOS = -TOS``." +msgstr "" + +msgid "Implements ``TOS = not TOS``." +msgstr "" + +msgid "Implements ``TOS = ~TOS``." +msgstr "" + +msgid "Implements ``TOS = iter(TOS)``." +msgstr "" + +msgid "" +"If ``TOS`` is a :term:`generator iterator` or :term:`coroutine` object it is " +"left as is. Otherwise, implements ``TOS = iter(TOS)``." +msgstr "" + +msgid "**Binary and in-place operations**" +msgstr "" + +msgid "" +"Binary operations remove the top of the stack (TOS) and the second top-most " +"stack item (TOS1) from the stack. They perform the operation, and put the " +"result back on the stack." +msgstr "" + +msgid "" +"In-place operations are like binary operations, in that they remove TOS and " +"TOS1, and push the result back on the stack, but the operation is done in-" +"place when TOS1 supports it, and the resulting TOS may be (but does not have " +"to be) the original TOS1." +msgstr "" + +msgid "" +"Implements the binary and in-place operators (depending on the value of " +"*op*)." +msgstr "" + +msgid "Implements ``TOS = TOS1[TOS]``." +msgstr "" + +msgid "Implements ``TOS1[TOS] = TOS2``." +msgstr "" + +msgid "Implements ``del TOS1[TOS]``." +msgstr "" + +msgid "**Coroutine opcodes**" +msgstr "" + +msgid "" +"Implements ``TOS = get_awaitable(TOS)``, where ``get_awaitable(o)`` returns " +"``o`` if ``o`` is a coroutine object or a generator object with the " +"CO_ITERABLE_COROUTINE flag, or resolves ``o.__await__``." +msgstr "" + +msgid "" +"If the ``where`` operand is nonzero, it indicates where the instruction " +"occurs:" +msgstr "" + +msgid "``1`` After a call to ``__aenter__``" +msgstr "" + +msgid "``2`` After a call to ``__aexit__``" +msgstr "" + +msgid "Previously, this instruction did not have an oparg." +msgstr "" + +msgid "Implements ``TOS = TOS.__aiter__()``." +msgstr "" + +msgid "Returning awaitable objects from ``__aiter__`` is no longer supported." +msgstr "" + +msgid "" +"Pushes ``get_awaitable(TOS.__anext__())`` to the stack. See " +"``GET_AWAITABLE`` for details about ``get_awaitable``." +msgstr "" + +msgid "" +"Terminates an :keyword:`async for` loop. Handles an exception raised when " +"awaiting a next item. The stack contains the async iterable in TOS1 and the " +"raised exception in TOS. Both are popped. If the exception is not :exc:" +"`StopAsyncIteration`, it is re-raised." +msgstr "" + +msgid "" +"Exception representation on the stack now consist of one, not three, items." +msgstr "" + +msgid "" +"Resolves ``__aenter__`` and ``__aexit__`` from the object on top of the " +"stack. Pushes ``__aexit__`` and result of ``__aenter__()`` to the stack." +msgstr "" + +msgid "**Miscellaneous opcodes**" +msgstr "" + +msgid "" +"Implements the expression statement for the interactive mode. TOS is " +"removed from the stack and printed. In non-interactive mode, an expression " +"statement is terminated with :opcode:`POP_TOP`." +msgstr "" + +msgid "" +"Calls ``set.add(TOS1[-i], TOS)``. Used to implement set comprehensions." +msgstr "" + +msgid "" +"Calls ``list.append(TOS1[-i], TOS)``. Used to implement list comprehensions." +msgstr "" + +msgid "" +"Calls ``dict.__setitem__(TOS1[-i], TOS1, TOS)``. Used to implement dict " +"comprehensions." +msgstr "" + +msgid "Map value is TOS and map key is TOS1. Before, those were reversed." +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." +msgstr "" + +msgid "Returns with TOS to the caller of the function." +msgstr "" + +msgid "Pops TOS and yields it from a :term:`generator`." +msgstr "" + +msgid "" +"Checks whether ``__annotations__`` is defined in ``locals()``, if not it is " +"set up to an empty ``dict``. This opcode is only emitted if a class or " +"module body contains :term:`variable annotations ` " +"statically." +msgstr "" + +msgid "" +"Loads all symbols not starting with ``'_'`` directly from the module TOS to " +"the local namespace. The module is popped after loading all names. This " +"opcode implements ``from module import *``." +msgstr "" + +msgid "" +"Pops a value from the stack, which is used to restore the exception state." +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." +msgstr "" + +msgid "" +"Pops a value from the stack. Pushes the current exception to the top of the " +"stack. Pushes the value originally popped back to the stack. Used in " +"exception handlers." +msgstr "" + +msgid "" +"Performs exception matching for ``except``. Tests whether the TOS1 is an " +"exception matching TOS. Pops TOS and pushes the boolean result of the test." +msgstr "" + +msgid "" +"Performs exception matching for ``except*``. Applies ``split(TOS)`` on the " +"exception group representing TOS1." +msgstr "" + +msgid "" +"In case of a match, pops two items from the stack and pushes the non-" +"matching subgroup (``None`` in case of full match) followed by the matching " +"subgroup. When there is no match, pops one item (the match type) and pushes " +"``None``." +msgstr "" + +msgid "" +"Combines the raised and reraised exceptions list from TOS, into an exception " +"group to propagate from a try-except* block. Uses the original exception " +"group from TOS1 to reconstruct the structure of reraised exceptions. Pops " +"two items from the stack and pushes the exception to reraise or ``None`` if " +"there isn't one." +msgstr "" + +msgid "" +"Calls the function in position 4 on the stack with arguments (type, val, tb) " +"representing the exception at the top of the stack. Used to implement the " +"call ``context_manager.__exit__(*exc_info())`` when an exception has " +"occurred in a :keyword:`with` statement." +msgstr "" + +msgid "" +"The ``__exit__`` function is in position 4 of the stack rather than 7. " +"Exception representation on the stack now consist of one, not three, items." +msgstr "" + +msgid "" +"Pushes :exc:`AssertionError` onto the stack. Used by the :keyword:`assert` " +"statement." +msgstr "" + +msgid "" +"Pushes :func:`builtins.__build_class__` onto the stack. It is later called " +"to construct a class." +msgstr "" + +msgid "" +"This opcode performs several operations before a with block starts. First, " +"it loads :meth:`~object.__exit__` from the context manager and pushes it " +"onto the stack for later use by :opcode:`WITH_EXCEPT_START`. Then, :meth:" +"`~object.__enter__` is called. Finally, the result of calling the " +"``__enter__()`` method is pushed onto the stack." +msgstr "" + +msgid "Push ``len(TOS)`` onto the stack." +msgstr "" + +msgid "" +"If TOS is an instance of :class:`collections.abc.Mapping` (or, more " +"technically: if it has the :c:macro:`Py_TPFLAGS_MAPPING` flag set in its :c:" +"member:`~PyTypeObject.tp_flags`), push ``True`` onto the stack. Otherwise, " +"push ``False``." +msgstr "" + +msgid "" +"If TOS is an instance of :class:`collections.abc.Sequence` and is *not* an " +"instance of :class:`str`/:class:`bytes`/:class:`bytearray` (or, more " +"technically: if it has the :c:macro:`Py_TPFLAGS_SEQUENCE` flag set in its :c:" +"member:`~PyTypeObject.tp_flags`), push ``True`` onto the stack. Otherwise, " +"push ``False``." +msgstr "" + +msgid "" +"TOS is a tuple of mapping keys, and TOS1 is the match subject. If TOS1 " +"contains all of the keys in TOS, push a :class:`tuple` containing the " +"corresponding values. Otherwise, push ``None``." +msgstr "" + +msgid "" +"Previously, this instruction also pushed a boolean value indicating success " +"(``True``) or failure (``False``)." +msgstr "" + +msgid "" +"Implements ``name = TOS``. *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." +msgstr "" + +msgid "" +"Implements ``del name``, where *namei* is the index into :attr:`~codeobject." +"co_names` attribute of the :ref:`code object `." +msgstr "" + +msgid "" +"Unpacks TOS into *count* individual values, which are put onto the stack " +"right-to-left." +msgstr "" + +msgid "" +"Implements assignment with a starred target: Unpacks an iterable in TOS into " +"individual values, where the total number of values can be smaller than the " +"number of items in the iterable: one of the new values will be a list of all " +"leftover items." +msgstr "" + +msgid "" +"The low byte of *counts* is the number of values before the list value, the " +"high byte of *counts* the number of values after it. The resulting values " +"are put onto the stack right-to-left." +msgstr "" + +msgid "" +"Implements ``TOS.name = TOS1``, where *namei* is the index of name in :attr:" +"`co_names`." +msgstr "" + +msgid "" +"Implements ``del TOS.name``, using *namei* as index into :attr:`~codeobject." +"co_names` of the :ref:`code object `." +msgstr "" + +msgid "Works as :opcode:`STORE_NAME`, but stores the name as a global." +msgstr "" + +msgid "Works as :opcode:`DELETE_NAME`, but deletes a global name." +msgstr "" + +msgid "Pushes ``co_consts[consti]`` onto the stack." +msgstr "" + +msgid "Pushes the value associated with ``co_names[namei]`` onto the stack." +msgstr "" + +msgid "" +"Creates a tuple consuming *count* items from the stack, and pushes the " +"resulting tuple onto the stack." +msgstr "" + +msgid "Works as :opcode:`BUILD_TUPLE`, but creates a list." +msgstr "" + +msgid "Works as :opcode:`BUILD_TUPLE`, but creates a set." +msgstr "" + +msgid "" +"Pushes a new dictionary object onto the stack. Pops ``2 * count`` items so " +"that the dictionary holds *count* entries: ``{..., TOS3: TOS2, TOS1: TOS}``." +msgstr "" + +msgid "" +"The dictionary is created from stack items instead of creating an empty " +"dictionary pre-sized to hold *count* items." +msgstr "" + +msgid "" +"The version of :opcode:`BUILD_MAP` specialized for constant keys. Pops the " +"top element on the stack which contains a tuple of keys, then starting from " +"``TOS1``, pops *count* values to form values in the built dictionary." +msgstr "" + +msgid "" +"Concatenates *count* strings from the stack and pushes the resulting string " +"onto the stack." +msgstr "" + +msgid "" +"Pops a list from the stack and pushes a tuple containing the same values." +msgstr "" + +msgid "Calls ``list.extend(TOS1[-i], TOS)``. Used to build lists." +msgstr "" + +msgid "Calls ``set.update(TOS1[-i], TOS)``. Used to build sets." +msgstr "" + +msgid "Calls ``dict.update(TOS1[-i], TOS)``. Used to build dicts." +msgstr "" + +msgid "Like :opcode:`DICT_UPDATE` but raises an exception for duplicate keys." +msgstr "" + +msgid "Replaces TOS with ``getattr(TOS, co_names[namei])``." +msgstr "" + +msgid "" +"Performs a Boolean operation. The operation name can be found in " +"``cmp_op[opname]``." +msgstr "" + +msgid "Performs ``is`` comparison, or ``is not`` if ``invert`` is 1." +msgstr "" + +msgid "Performs ``in`` comparison, or ``not in`` if ``invert`` is 1." +msgstr "" + +msgid "" +"Imports the module ``co_names[namei]``. TOS and TOS1 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." +msgstr "" + +msgid "" +"Loads the attribute ``co_names[namei]`` from the module found in TOS. The " +"resulting object is pushed onto the stack, to be subsequently stored by a :" +"opcode:`STORE_FAST` instruction." +msgstr "" + +msgid "Increments bytecode counter by *delta*." +msgstr "" + +msgid "Decrements bytecode counter by *delta*. Checks for interrupts." +msgstr "" + +msgid "Decrements bytecode counter by *delta*. Does not check for interrupts." +msgstr "" + +msgid "" +"If TOS is true, increments the bytecode counter by *delta*. TOS is popped." +msgstr "" + +msgid "" +"If TOS is true, decrements the bytecode counter by *delta*. TOS is popped." +msgstr "" + +msgid "" +"If TOS is false, increments the bytecode counter by *delta*. TOS is popped." +msgstr "" + +msgid "" +"If TOS is false, decrements the bytecode counter by *delta*. TOS is popped." +msgstr "" + +msgid "" +"If TOS is not ``None``, increments the bytecode counter by *delta*. TOS is " +"popped." +msgstr "" + +msgid "" +"If TOS is not ``None``, decrements the bytecode counter by *delta*. TOS is " +"popped." +msgstr "" + +msgid "" +"If TOS is ``None``, increments the bytecode counter by *delta*. TOS is " +"popped." +msgstr "" + +msgid "" +"If TOS is ``None``, decrements the bytecode counter by *delta*. TOS is " +"popped." +msgstr "" + +msgid "" +"If TOS is true, increments the bytecode counter by *delta* and leaves TOS on " +"the stack. Otherwise (TOS is false), TOS is popped." +msgstr "" + +msgid "The oparg is now a relative delta rather than an absolute target." +msgstr "" + +msgid "" +"If TOS is false, increments the bytecode counter by *delta* and leaves TOS " +"on the stack. Otherwise (TOS is true), TOS is popped." +msgstr "" + +msgid "" +"TOS 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, TOS is popped, and the byte " +"code counter is incremented by *delta*." +msgstr "" + +msgid "Loads the global named ``co_names[namei>>1]`` onto the stack." +msgstr "" + +msgid "" +"If the low bit of ``namei`` is set, then a ``NULL`` is pushed to the stack " +"before the global variable." +msgstr "" + +msgid "" +"Pushes a reference to the local ``co_varnames[var_num]`` onto the stack." +msgstr "" + +msgid "Stores TOS into the local ``co_varnames[var_num]``." +msgstr "" + +msgid "Deletes local ``co_varnames[var_num]``." +msgstr "" + +msgid "" +"Creates a new cell in slot ``i``. If that slot is nonempty then that value " +"is stored into the new cell." +msgstr "" + +msgid "" +"Pushes a reference to the cell contained in slot ``i`` of the \"fast " +"locals\" storage. The name of the variable is ``co_fastlocalnames[i]``." +msgstr "" + +msgid "" +"Note that ``LOAD_CLOSURE`` is effectively an alias for ``LOAD_FAST``. It " +"exists to keep bytecode a little more readable." +msgstr "" + +msgid "``i`` is no longer offset by the length of ``co_varnames``." +msgstr "" + +msgid "" +"Loads the cell contained in slot ``i`` of the \"fast locals\" storage. " +"Pushes a reference to the object the cell contains on the stack." +msgstr "" + +msgid "" +"``i`` is no longer offset by the length of :attr:`~codeobject.co_varnames`." +msgstr "" + +msgid "" +"Much like :opcode:`LOAD_DEREF` but first checks the locals dictionary before " +"consulting the cell. This is used for loading free variables in class " +"bodies." +msgstr "" + +msgid "" +"Stores TOS into the cell contained in slot ``i`` of the \"fast locals\" " +"storage." +msgstr "" + +msgid "" +"Empties the cell contained in slot ``i`` of the \"fast locals\" storage. " +"Used by the :keyword:`del` statement." +msgstr "" + +msgid "" +"Copies the ``n`` free variables from the closure into the frame. Removes the " +"need for special code on the caller's side when calling closures." +msgstr "" + +msgid "" +"Raises an exception using one of the 3 forms of the ``raise`` statement, " +"depending on the value of *argc*:" +msgstr "" + +msgid "0: ``raise`` (re-raise previous exception)" +msgstr "" + +msgid "1: ``raise TOS`` (raise exception instance or type at ``TOS``)" +msgstr "" + +msgid "" +"2: ``raise TOS1 from TOS`` (raise exception instance or type at ``TOS1`` " +"with ``__cause__`` set to ``TOS``)" +msgstr "" + +msgid "" +"Calls a callable object with the number of arguments specified by ``argc``, " +"including the named arguments specified by the preceding :opcode:`KW_NAMES`, " +"if any. On the stack are (in ascending order), either:" +msgstr "" + +msgid "NULL" +msgstr "NULL" + +msgid "The callable" +msgstr "" + +msgid "The positional arguments" +msgstr "" + +msgid "The named arguments" +msgstr "" + +msgid "or:" +msgstr "" + +msgid "``self``" +msgstr "" + +msgid "The remaining positional arguments" +msgstr "" + +msgid "" +"``argc`` is the total of the positional and named arguments, excluding " +"``self`` when a ``NULL`` is not present." +msgstr "" + +msgid "" +"``CALL`` pops all arguments and the callable object off the stack, calls the " +"callable object with those arguments, and pushes the return value returned " +"by the callable object." +msgstr "" + +msgid "" +"Calls a callable object with variable set of positional and keyword " +"arguments. If the lowest bit of *flags* is set, the top of the stack " +"contains a mapping object containing additional keyword arguments. Before " +"the callable is called, the mapping object and iterable object are each " +"\"unpacked\" and their contents passed in as keyword and positional " +"arguments respectively. ``CALL_FUNCTION_EX`` pops all arguments and the " +"callable object off the stack, calls the callable object with those " +"arguments, and pushes the return value returned by the callable object." +msgstr "" + +msgid "" +"Loads a method named ``co_names[namei]`` from the TOS object. TOS is popped. " +"This bytecode distinguishes two cases: if TOS has a method with the correct " +"name, the bytecode pushes the unbound method and TOS. TOS will be used as " +"the first argument (``self``) by :opcode:`CALL` when calling the unbound " +"method. Otherwise, ``NULL`` and the object return by the attribute lookup " +"are pushed." +msgstr "" + +msgid "" +"Prefixes :opcode:`CALL`. Logically this is a no op. It exists to enable " +"effective specialization of calls. ``argc`` is the number of arguments as " +"described in :opcode:`CALL`." +msgstr "" + +msgid "" +"Pushes a ``NULL`` to the stack. Used in the call sequence to match the " +"``NULL`` pushed by :opcode:`LOAD_METHOD` for non-method calls." +msgstr "" + +msgid "" +"Prefixes :opcode:`PRECALL`. Stores a reference to ``co_consts[consti]`` into " +"an internal variable for use by :opcode:`CALL`. ``co_consts[consti]`` must " +"be a tuple of strings." +msgstr "" + +msgid "" +"Pushes a new function object on the stack. From bottom to top, the consumed " +"stack must consist of values if the argument carries a specified flag value" +msgstr "" + +msgid "" +"``0x01`` a tuple of default values for positional-only and positional-or-" +"keyword parameters in positional order" +msgstr "" + +msgid "``0x02`` a dictionary of keyword-only parameters' default values" +msgstr "" + +msgid "``0x04`` a tuple of strings containing parameters' annotations" +msgstr "" + +msgid "``0x08`` a tuple containing cells for free variables, making a closure" +msgstr "" + +msgid "the code associated with the function (at TOS)" +msgstr "" + +msgid "Flag value ``0x04`` is a tuple of strings instead of dictionary" +msgstr "" + +msgid "Qualified name at TOS was removed." +msgstr "" + +msgid "" +"Pushes a slice object on the stack. *argc* must be 2 or 3. If it is 2, " +"``slice(TOS1, TOS)`` is pushed; if it is 3, ``slice(TOS2, TOS1, TOS)`` is " +"pushed. See the :func:`slice` built-in function for more information." +msgstr "" + +msgid "" +"Prefixes any opcode which has an argument too big to fit into the default " +"one byte. *ext* holds an additional byte which act as higher bits in the " +"argument. For each opcode, at most three prefixal ``EXTENDED_ARG`` are " +"allowed, forming an argument from two-byte to four-byte." +msgstr "" + +msgid "" +"Used for implementing formatted literal strings (f-strings). Pops an " +"optional *fmt_spec* from the stack, then a required *value*. *flags* is " +"interpreted as follows:" +msgstr "" + +msgid "``(flags & 0x03) == 0x00``: *value* is formatted as-is." +msgstr "" + +msgid "" +"``(flags & 0x03) == 0x01``: call :func:`str` on *value* before formatting it." +msgstr "" + +msgid "" +"``(flags & 0x03) == 0x02``: call :func:`repr` on *value* before formatting " +"it." +msgstr "" + +msgid "" +"``(flags & 0x03) == 0x03``: call :func:`ascii` on *value* before formatting " +"it." +msgstr "" + +msgid "" +"``(flags & 0x04) == 0x04``: pop *fmt_spec* from the stack and use it, else " +"use an empty *fmt_spec*." +msgstr "" + +msgid "" +"Formatting is performed using :c:func:`PyObject_Format`. The result is " +"pushed on the stack." +msgstr "" + +msgid "" +"TOS is a tuple of keyword attribute names, TOS1 is the class being matched " +"against, and TOS2 is the match subject. *count* is the number of positional " +"sub-patterns." +msgstr "" + +msgid "" +"Pop TOS, TOS1, and TOS2. If TOS2 is an instance of TOS1 and has the " +"positional and keyword attributes required by *count* and TOS, push a tuple " +"of extracted attributes. Otherwise, push ``None``." +msgstr "" + +msgid "A no-op. Performs internal tracing, debugging and optimization checks." +msgstr "" + +msgid "The ``where`` operand marks where the ``RESUME`` occurs:" +msgstr "" + +msgid "``0`` The start of a function" +msgstr "" + +msgid "``1`` After a ``yield`` expression" +msgstr "" + +msgid "``2`` After a ``yield from`` expression" +msgstr "" + +msgid "``3`` After an ``await`` expression" +msgstr "" + +msgid "" +"Create a generator, coroutine, or async generator from the current frame. " +"Clear the current frame and return the newly created generator." +msgstr "" + +msgid "" +"Sends ``None`` to the sub-generator of this generator. Used in ``yield " +"from`` and ``await`` statements." +msgstr "" + +msgid "" +"Wraps the value on top of the stack in an ``async_generator_wrapped_value``. " +"Used to yield in async generators." +msgstr "" + +msgid "" +"This is not really an opcode. It identifies the dividing line between " +"opcodes which don't use their argument and those that do (``< " +"HAVE_ARGUMENT`` and ``>= HAVE_ARGUMENT``, respectively)." +msgstr "" + +msgid "" +"Now every instruction has an argument, but opcodes ``< HAVE_ARGUMENT`` " +"ignore it. Before, only opcodes ``>= HAVE_ARGUMENT`` had an argument." +msgstr "" + +msgid "Opcode collections" +msgstr "" + +msgid "" +"These collections are provided for automatic introspection of bytecode " +"instructions:" +msgstr "" + +msgid "Sequence of operation names, indexable using the bytecode." +msgstr "" + +msgid "Dictionary mapping operation names to bytecodes." +msgstr "" + +msgid "Sequence of all compare operation names." +msgstr "" + +msgid "Sequence of bytecodes that access a constant." +msgstr "" + +msgid "" +"Sequence of bytecodes that access a free variable (note that 'free' in this " +"context refers to names in the current scope that are referenced by inner " +"scopes or names in outer scopes that are referenced from this scope. It " +"does *not* include references to global or builtin scopes)." +msgstr "" + +msgid "Sequence of bytecodes that access an attribute by name." +msgstr "" + +msgid "Sequence of bytecodes that have a relative jump target." +msgstr "" + +msgid "Sequence of bytecodes that have an absolute jump target." +msgstr "" + +msgid "Sequence of bytecodes that access a local variable." +msgstr "" + +msgid "Sequence of bytecodes of Boolean operations." +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "slice" +msgstr "" diff --git a/library/doctest.po b/library/doctest.po new file mode 100644 index 0000000000..04ff83cb5a --- /dev/null +++ b/library/doctest.po @@ -0,0 +1,1801 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`doctest` --- Test interactive Python examples" +msgstr "" + +msgid "**Source code:** :source:`Lib/doctest.py`" +msgstr "" + +msgid "" +"The :mod:`doctest` module searches for pieces of text that look like " +"interactive Python sessions, and then executes those sessions to verify that " +"they work exactly as shown. There are several common ways to use doctest:" +msgstr "" + +msgid "" +"To check that a module's docstrings are up-to-date by verifying that all " +"interactive examples still work as documented." +msgstr "" + +msgid "" +"To perform regression testing by verifying that interactive examples from a " +"test file or a test object work as expected." +msgstr "" + +msgid "" +"To write tutorial documentation for a package, liberally illustrated with " +"input-output examples. Depending on whether the examples or the expository " +"text are emphasized, this has the flavor of \"literate testing\" or " +"\"executable documentation\"." +msgstr "" + +msgid "Here's a complete but small example module::" +msgstr "" + +msgid "" +"If you run :file:`example.py` directly from the command line, :mod:`doctest` " +"works its magic:" +msgstr "" + +msgid "" +"There's no output! That's normal, and it means all the examples worked. " +"Pass ``-v`` to the script, and :mod:`doctest` prints a detailed log of what " +"it's trying, and prints a summary at the end:" +msgstr "" + +msgid "And so on, eventually ending with:" +msgstr "" + +msgid "" +"That's all you need to know to start making productive use of :mod:" +"`doctest`! Jump in. The following sections provide full details. Note that " +"there are many examples of doctests in the standard Python test suite and " +"libraries. Especially useful examples can be found in the standard test " +"file :file:`Lib/test/test_doctest/test_doctest.py`." +msgstr "" + +msgid "Simple Usage: Checking Examples in Docstrings" +msgstr "" + +msgid "" +"The simplest way to start using doctest (but not necessarily the way you'll " +"continue to do it) is to end each module :mod:`!M` with::" +msgstr "" + +msgid ":mod:`!doctest` then examines docstrings in module :mod:`!M`." +msgstr "" + +msgid "" +"Running the module as a script causes the examples in the docstrings to get " +"executed and verified::" +msgstr "" + +msgid "" +"This won't display anything unless an example fails, in which case the " +"failing example(s) and the cause(s) of the failure(s) are printed to stdout, " +"and the final line of output is ``***Test Failed*** N failures.``, where *N* " +"is the number of examples that failed." +msgstr "" + +msgid "Run it with the ``-v`` switch instead::" +msgstr "" + +msgid "" +"and a detailed report of all examples tried is printed to standard output, " +"along with assorted summaries at the end." +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, " +"``sys.argv`` is not examined by :func:`testmod` (so passing ``-v`` or not " +"has no effect)." +msgstr "" + +msgid "" +"There is also a command line shortcut for running :func:`testmod`. You can " +"instruct the Python interpreter to run the doctest module directly from the " +"standard library and pass the module name(s) on the command line::" +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." +msgstr "" + +msgid "" +"For more information on :func:`testmod`, see section :ref:`doctest-basic-" +"api`." +msgstr "" + +msgid "Simple Usage: Checking Examples in a Text File" +msgstr "" + +msgid "" +"Another simple application of doctest is testing interactive examples in a " +"text file. This can be done with the :func:`testfile` function::" +msgstr "" + +msgid "" +"That short script executes and verifies any interactive Python examples " +"contained in the file :file:`example.txt`. The file content is treated as " +"if it were a single giant docstring; the file doesn't need to contain a " +"Python program! For example, perhaps :file:`example.txt` contains this:" +msgstr "" + +msgid "" +"Running ``doctest.testfile(\"example.txt\")`` then finds the error in this " +"documentation::" +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`." +msgstr "" + +msgid "" +"By default, :func:`testfile` looks for files in the calling module's " +"directory. See section :ref:`doctest-basic-api` for a description of the " +"optional arguments that can be used to tell it to look for files in other " +"locations." +msgstr "" + +msgid "" +"Like :func:`testmod`, :func:`testfile`'s verbosity can be set with the ``-" +"v`` command-line switch or with the optional keyword argument *verbose*." +msgstr "" + +msgid "" +"There is also a command line shortcut for running :func:`testfile`. You can " +"instruct the Python interpreter to run the doctest module directly from the " +"standard library and pass the file name(s) on the command line::" +msgstr "" + +msgid "" +"Because the file name does not end with :file:`.py`, :mod:`doctest` infers " +"that it must be run with :func:`testfile`, not :func:`testmod`." +msgstr "" + +msgid "" +"For more information on :func:`testfile`, see section :ref:`doctest-basic-" +"api`." +msgstr "" + +msgid "How It Works" +msgstr "" + +msgid "" +"This section examines in detail how doctest works: which docstrings it looks " +"at, how it finds interactive examples, what execution context it uses, how " +"it handles exceptions, and how option flags can be used to control its " +"behavior. This is the information that you need to know to write doctest " +"examples; for information about actually running doctest on these examples, " +"see the following sections." +msgstr "" + +msgid "Which Docstrings Are Examined?" +msgstr "" + +msgid "" +"The module docstring, and all function, class and method docstrings are " +"searched. Objects imported into the module are not searched." +msgstr "" + +msgid "" +"In addition, there are cases when you want tests to be part of a module but " +"not part of the help text, which requires that the tests not be included in " +"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``." +msgstr "" + +msgid "For example, place this block of code at the top of :file:`example.py`:" +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 " +"scanned for tests." +msgstr "" + +msgid "" +"Any classes found are recursively searched similarly, to test docstrings in " +"their contained methods and nested classes." +msgstr "" + +msgid "How are Docstring Examples Recognized?" +msgstr "" + +msgid "" +"In most cases a copy-and-paste of an interactive console session works fine, " +"but doctest isn't trying to do an exact emulation of any specific Python " +"shell." +msgstr "" + +msgid "" +"Any expected output must immediately follow the final ``'>>> '`` or ``'... " +"'`` line containing the code, and the expected output (if any) extends to " +"the next ``'>>> '`` or all-whitespace line." +msgstr "" + +msgid "The fine print:" +msgstr "" + +msgid "" +"Expected output cannot contain an all-whitespace line, since such a line is " +"taken to signal the end of expected output. If expected output does contain " +"a blank line, put ```` in your doctest example each place a blank " +"line is expected." +msgstr "" + +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." +msgstr "" + +msgid "" +"Output to stdout is captured, but not output to stderr (exception tracebacks " +"are captured via a different means)." +msgstr "" + +msgid "" +"If you continue a line via backslashing in an interactive session, or for " +"any other reason use a backslash, you should use a raw docstring, which will " +"preserve your backslashes exactly as you type them::" +msgstr "" + +msgid "" +"Otherwise, the backslash will be interpreted as part of the string. For " +"example, the ``\\n`` above would be interpreted as a newline character. " +"Alternatively, you can double each backslash in the doctest version (and not " +"use a raw string)::" +msgstr "" + +msgid "The starting column doesn't matter::" +msgstr "" + +msgid "" +"and as many leading whitespace characters are stripped from the expected " +"output as appeared in the initial ``'>>> '`` line that started the example." +msgstr "" + +msgid "What's the Execution Context?" +msgstr "" + +msgid "" +"By default, each time :mod:`doctest` finds a docstring to test, it uses a " +"*shallow copy* of :mod:`!M`'s globals, so that running tests doesn't change " +"the module's real globals, and so that one test in :mod:`!M` can't leave " +"behind crumbs that accidentally allow another test to work. This means " +"examples can freely use any names defined at top-level in :mod:`!M`, and " +"names defined earlier in the docstring being run. Examples cannot see names " +"defined in other docstrings." +msgstr "" + +msgid "" +"You can force use of your own dict as the execution context by passing " +"``globs=your_dict`` to :func:`testmod` or :func:`testfile` instead." +msgstr "" + +msgid "What About Exceptions?" +msgstr "" + +msgid "" +"No problem, provided that the traceback is the only output produced by the " +"example: just paste in the traceback. [#]_ Since tracebacks contain details " +"that are likely to change rapidly (for example, exact file paths and line " +"numbers), this is one case where doctest works hard to be flexible in what " +"it accepts." +msgstr "" + +msgid "Simple example::" +msgstr "" + +msgid "" +"That doctest succeeds if :exc:`ValueError` is raised, with the ``list." +"remove(x): x not in list`` detail as shown." +msgstr "" + +msgid "" +"The expected output for an exception must start with a traceback header, " +"which may be either of the following two lines, indented the same as the " +"first line of the example::" +msgstr "" + +msgid "" +"The traceback header is followed by an optional traceback stack, whose " +"contents are ignored by doctest. The traceback stack is typically omitted, " +"or copied verbatim from an interactive session." +msgstr "" + +msgid "" +"The traceback stack is followed by the most interesting part: the line(s) " +"containing the exception type and detail. This is usually the last line of " +"a traceback, but can extend across multiple lines if the exception has a " +"multi-line detail::" +msgstr "" + +msgid "" +"The last three lines (starting with :exc:`ValueError`) are compared against " +"the exception's type and detail, and the rest are ignored." +msgstr "" + +msgid "" +"Best practice is to omit the traceback stack, unless it adds significant " +"documentation value to the example. So the last example is probably better " +"as::" +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." +msgstr "" + +msgid "Some details you should read once, but won't need to remember:" +msgstr "" + +msgid "" +"Doctest can't guess whether your expected output came from an exception " +"traceback or from ordinary printing. So, e.g., an example that expects " +"``ValueError: 42 is prime`` will pass whether :exc:`ValueError` is actually " +"raised or if the example merely prints that traceback text. In practice, " +"ordinary output rarely begins with a traceback header line, so this doesn't " +"create real problems." +msgstr "" + +msgid "" +"Each line of the traceback stack (if present) must be indented further than " +"the first line of the example, *or* start with a non-alphanumeric character. " +"The first line following the traceback header indented the same and starting " +"with an alphanumeric is taken to be the start of the exception detail. Of " +"course this does the right thing for genuine tracebacks." +msgstr "" + +msgid "" +"When the :const:`IGNORE_EXCEPTION_DETAIL` doctest option is specified, " +"everything following the leftmost colon and any module information in the " +"exception name is ignored." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"For some exceptions, Python displays the position of the error using ``^`` " +"markers and tildes::" +msgstr "" + +msgid "" +"Since the lines showing the position of the error come before the exception " +"type and detail, they are not checked by doctest. For example, the " +"following test would pass, even though it puts the ``^`` marker in the wrong " +"location::" +msgstr "" + +msgid "Option Flags" +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." +msgstr "" + +msgid "The ``-o`` command line option." +msgstr "" + +msgid "" +"The first group of options define test semantics, controlling aspects of how " +"doctest decides whether actual output matches an example's expected output:" +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." +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." +msgstr "" + +msgid "" +"When specified, all sequences of whitespace (blanks and newlines) are " +"treated as equal. Any sequence of whitespace within the expected output " +"will match any sequence of whitespace within the actual output. By default, " +"whitespace must match exactly. :const:`NORMALIZE_WHITESPACE` is especially " +"useful when a line of expected output is very long, and you want to wrap it " +"across multiple lines in your source." +msgstr "" + +msgid "" +"When specified, an ellipsis marker (``...``) in the expected output can " +"match any substring in the actual output. This includes substrings that " +"span line boundaries, and empty substrings, so it's best to keep usage of " +"this simple. Complicated uses can lead to the same kinds of \"oops, it " +"matched too much!\" surprises that ``.*`` is prone to in regular expressions." +msgstr "" + +msgid "" +"When specified, doctests expecting exceptions pass so long as an exception " +"of the expected type is raised, even if the details (message and fully " +"qualified exception name) don't match." +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:" +msgstr "" + +msgid "" +"Note that :const:`ELLIPSIS` can also be used to ignore the details of the " +"exception message, but such a test may still fail based on whether the " +"module name is present or matches exactly." +msgstr "" + +msgid "" +":const:`IGNORE_EXCEPTION_DETAIL` now also ignores any information relating " +"to the module containing the exception under test." +msgstr "" + +msgid "" +"When specified, do not run the example at all. This can be useful in " +"contexts where doctest examples serve as both documentation and test cases, " +"and an example should be included for documentation purposes, but should not " +"be checked. E.g., the example's output might be random; or the example " +"might depend on resources which would be unavailable to the test driver." +msgstr "" + +msgid "" +"The SKIP flag can also be used for temporarily \"commenting out\" examples." +msgstr "" + +msgid "A bitmask or'ing together all the comparison flags above." +msgstr "" + +msgid "The second group of options controls how test failures are reported:" +msgstr "" + +msgid "" +"When specified, failures that involve multi-line expected and actual outputs " +"are displayed using a unified diff." +msgstr "" + +msgid "" +"When specified, failures that involve multi-line expected and actual outputs " +"will be displayed using a context diff." +msgstr "" + +msgid "" +"When specified, differences are computed by ``difflib.Differ``, using the " +"same algorithm as the popular :file:`ndiff.py` utility. This is the only " +"method that marks differences within lines as well as across lines. For " +"example, if a line of expected output contains digit ``1`` where actual " +"output contains letter ``l``, a line is inserted with a caret marking the " +"mismatching column positions." +msgstr "" + +msgid "" +"When specified, display the first failing example in each doctest, but " +"suppress output for all remaining examples. This will prevent doctest from " +"reporting correct examples that break because of earlier failures; but it " +"might also hide incorrect examples that fail independently of the first " +"failure. When :const:`REPORT_ONLY_FIRST_FAILURE` is specified, the " +"remaining examples are still run, and still count towards the total number " +"of failures reported; only the output is suppressed." +msgstr "" + +msgid "" +"When specified, exit after the first failing example and don't attempt to " +"run the remaining examples. Thus, the number of failures reported will be at " +"most 1. This flag may be useful during debugging, since examples after the " +"first failure won't even produce debugging output." +msgstr "" + +msgid "" +"The doctest command line accepts the option ``-f`` as a shorthand for ``-o " +"FAIL_FAST``." +msgstr "" + +msgid "A bitmask or'ing together all the reporting flags above." +msgstr "" + +msgid "" +"There is also a way to register new option flag names, though this isn't " +"useful unless you intend to extend :mod:`doctest` internals via subclassing:" +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::" +msgstr "" + +msgid "Directives" +msgstr "" + +msgid "" +"Doctest directives may be used to modify the :ref:`option flags ` for an individual example. Doctest directives are special Python " +"comments following an example's source code:" +msgstr "" + +msgid "" +"Whitespace is not allowed between the ``+`` or ``-`` and the directive " +"option name. The directive option name can be any of the option flag names " +"explained above." +msgstr "" + +msgid "" +"An example's doctest directives modify doctest's behavior for that single " +"example. Use ``+`` to enable the named behavior, or ``-`` to disable it." +msgstr "" + +msgid "For example, this test passes:" +msgstr "" + +msgid "" +"Without the directive it would fail, both because the actual output doesn't " +"have two blanks before the single-digit list elements, and because the " +"actual output is on a single line. This test also passes, and also requires " +"a directive to do so:" +msgstr "" + +msgid "" +"Multiple directives can be used on a single physical line, separated by " +"commas:" +msgstr "" + +msgid "" +"If multiple directive comments are used for a single example, then they are " +"combined:" +msgstr "" + +msgid "" +"As the previous example shows, you can add ``...`` lines to your example " +"containing only directives. This can be useful when an example is too long " +"for a directive to comfortably fit on the same line:" +msgstr "" + +msgid "" +"Note that since all options are disabled by default, and directives apply " +"only to the example they appear in, enabling options (via ``+`` in a " +"directive) is usually the only meaningful choice. However, option flags can " +"also be passed to functions that run doctests, establishing different " +"defaults. In such cases, disabling an option via ``-`` in a directive can " +"be useful." +msgstr "" + +msgid "Warnings" +msgstr "" + +msgid "" +":mod:`doctest` is serious about requiring exact matches in expected output. " +"If even a single character doesn't match, the test fails. This will " +"probably surprise you a few times, as you learn exactly what Python does and " +"doesn't guarantee about output. For example, when printing a set, Python " +"doesn't guarantee that the element is printed in any particular order, so a " +"test like ::" +msgstr "" + +msgid "is vulnerable! One workaround is to do ::" +msgstr "" + +msgid "instead. Another is to do ::" +msgstr "" + +msgid "There are others, but you get the idea." +msgstr "" + +msgid "Another bad idea is to print things that embed an object address, like" +msgstr "" + +msgid "" +"The :const:`ELLIPSIS` directive gives a nice approach for the last example:" +msgstr "" + +msgid "" +"Floating-point numbers are also subject to small output variations across " +"platforms, because Python defers to the platform C library for float " +"formatting, and C libraries vary widely in quality here. ::" +msgstr "" + +msgid "" +"Numbers of the form ``I/2.**J`` are safe across all platforms, and I often " +"contrive doctest examples to produce numbers of that form::" +msgstr "" + +msgid "" +"Simple fractions are also easier for people to understand, and that makes " +"for better documentation." +msgstr "" + +msgid "Basic API" +msgstr "" + +msgid "" +"The functions :func:`testmod` and :func:`testfile` provide a simple " +"interface to doctest that should be sufficient for most basic uses. For a " +"less formal introduction to these two functions, see sections :ref:`doctest-" +"simple-testmod` and :ref:`doctest-simple-testfile`." +msgstr "" + +msgid "" +"All arguments except *filename* are optional, and should be specified in " +"keyword form." +msgstr "" + +msgid "" +"Test examples in the file named *filename*. Return ``(failure_count, " +"test_count)``." +msgstr "" + +msgid "" +"Optional argument *module_relative* specifies how the filename should be " +"interpreted:" +msgstr "" + +msgid "" +"If *module_relative* is ``True`` (the default), then *filename* specifies an " +"OS-independent module-relative path. By default, this path is relative to " +"the calling module's directory; but if the *package* argument is specified, " +"then it is relative to that package. To ensure OS-independence, *filename* " +"should use ``/`` characters to separate path segments, and may not be an " +"absolute path (i.e., it may not begin with ``/``)." +msgstr "" + +msgid "" +"If *module_relative* is ``False``, then *filename* specifies an OS-specific " +"path. The path may be absolute or relative; relative paths are resolved " +"with respect to the current working directory." +msgstr "" + +msgid "" +"Optional argument *name* gives the name of the test; by default, or if " +"``None``, ``os.path.basename(filename)`` is used." +msgstr "" + +msgid "" +"Optional argument *package* is a Python package or the name of a Python " +"package whose directory should be used as the base directory for a module-" +"relative filename. If no package is specified, then the calling module's " +"directory is used as the base directory for module-relative filenames. It " +"is an error to specify *package* if *module_relative* is ``False``." +msgstr "" + +msgid "" +"Optional argument *globs* gives a dict to be used as the globals when " +"executing examples. A new shallow copy of this dict is created for the " +"doctest, so its examples start with a clean slate. By default, or if " +"``None``, a new empty dict is used." +msgstr "" + +msgid "" +"Optional argument *extraglobs* gives a dict merged into the globals used to " +"execute examples. This works like :meth:`dict.update`: if *globs* and " +"*extraglobs* have a common key, the associated value in *extraglobs* appears " +"in the combined dict. By default, or if ``None``, no extra globals are " +"used. This is an advanced feature that allows parameterization of " +"doctests. For example, a doctest can be written for a base class, using a " +"generic name for the class, then reused to test any number of subclasses by " +"passing an *extraglobs* dict mapping the generic name to the subclass to be " +"tested." +msgstr "" + +msgid "" +"Optional argument *verbose* prints lots of stuff if true, and prints only " +"failures if false; by default, or if ``None``, it's true if and only if ``'-" +"v'`` is in ``sys.argv``." +msgstr "" + +msgid "" +"Optional argument *report* prints a summary at the end when true, else " +"prints nothing at the end. In verbose mode, the summary is detailed, else " +"the summary is very brief (in fact, empty if all tests passed)." +msgstr "" + +msgid "" +"Optional argument *optionflags* (default value 0) takes the :ref:`bitwise OR " +"` of option flags. See section :ref:`doctest-options`." +msgstr "" + +msgid "" +"Optional argument *raise_on_error* defaults to false. If true, an exception " +"is raised upon the first failure or unexpected exception in an example. " +"This allows failures to be post-mortem debugged. Default behavior is to " +"continue running examples." +msgstr "" + +msgid "" +"Optional argument *parser* specifies a :class:`DocTestParser` (or subclass) " +"that should be used to extract tests from the files. It defaults to a " +"normal parser (i.e., ``DocTestParser()``)." +msgstr "" + +msgid "" +"Optional argument *encoding* specifies an encoding that should be used to " +"convert the file to unicode." +msgstr "" + +msgid "" +"All arguments are optional, and all except for *m* should be specified in " +"keyword form." +msgstr "" + +msgid "" +"Test examples in docstrings in functions and classes reachable from module " +"*m* (or module :mod:`__main__` if *m* is not supplied or is ``None``), " +"starting with ``m.__doc__``." +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." +msgstr "" + +msgid "" +"Only docstrings attached to objects belonging to module *m* are searched." +msgstr "" + +msgid "Return ``(failure_count, test_count)``." +msgstr "" + +msgid "" +"Optional argument *name* gives the name of the module; by default, or if " +"``None``, ``m.__name__`` is used." +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." +msgstr "" + +msgid "" +"Optional arguments *extraglobs*, *verbose*, *report*, *optionflags*, " +"*raise_on_error*, and *globs* are the same as for function :func:`testfile` " +"above, except that *globs* defaults to ``m.__dict__``." +msgstr "" + +msgid "" +"Test examples associated with object *f*; for example, *f* may be a string, " +"a module, a function, or a class object." +msgstr "" + +msgid "" +"A shallow copy of dictionary argument *globs* is used for the execution " +"context." +msgstr "" + +msgid "" +"Optional argument *name* is used in failure messages, and defaults to " +"``\"NoName\"``." +msgstr "" + +msgid "" +"If optional argument *verbose* is true, output is generated even if there " +"are no failures. By default, output is generated only in case of an example " +"failure." +msgstr "" + +msgid "" +"Optional argument *compileflags* gives the set of flags that should be used " +"by the Python compiler when running the examples. By default, or if " +"``None``, flags are deduced corresponding to the set of future features " +"found in *globs*." +msgstr "" + +msgid "" +"Optional argument *optionflags* works as for function :func:`testfile` above." +msgstr "" + +msgid "Unittest API" +msgstr "" + +msgid "" +"As your collection of doctest'ed modules grows, you'll want a way to run all " +"their doctests systematically. :mod:`doctest` provides two functions that " +"can be used to create :mod:`unittest` test suites from modules and text " +"files containing doctests. To integrate with :mod:`unittest` test " +"discovery, include a :ref:`load_tests ` function in " +"your test module::" +msgstr "" + +msgid "" +"There are two main functions for creating :class:`unittest.TestSuite` " +"instances from text files and modules with doctests:" +msgstr "" + +msgid "" +"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:" +"`failureException` exception is raised showing the name of the file " +"containing the test and a (sometimes approximate) line number." +msgstr "" + +msgid "Pass one or more paths (as strings) to text files to be examined." +msgstr "" + +msgid "Options may be provided as keyword arguments:" +msgstr "" + +msgid "" +"Optional argument *module_relative* specifies how the filenames in *paths* " +"should be interpreted:" +msgstr "" + +msgid "" +"If *module_relative* is ``True`` (the default), then each filename in " +"*paths* specifies an OS-independent module-relative path. By default, this " +"path is relative to the calling module's directory; but if the *package* " +"argument is specified, then it is relative to that package. To ensure OS-" +"independence, each filename should use ``/`` characters to separate path " +"segments, and may not be an absolute path (i.e., it may not begin with ``/" +"``)." +msgstr "" + +msgid "" +"If *module_relative* is ``False``, then each filename in *paths* specifies " +"an OS-specific path. The path may be absolute or relative; relative paths " +"are resolved with respect to the current working directory." +msgstr "" + +msgid "" +"Optional argument *package* is a Python package or the name of a Python " +"package whose directory should be used as the base directory for module-" +"relative filenames in *paths*. If no package is specified, then the calling " +"module's directory is used as the base directory for module-relative " +"filenames. It is an error to specify *package* if *module_relative* is " +"``False``." +msgstr "" + +msgid "" +"Optional argument *setUp* specifies a set-up function for the test suite. " +"This is called before running the tests in each file. The *setUp* function " +"will be passed a :class:`DocTest` object. The setUp function can access the " +"test globals as the *globs* attribute of the test passed." +msgstr "" + +msgid "" +"Optional argument *tearDown* specifies a tear-down function for the test " +"suite. This is called after running the tests in each file. The *tearDown* " +"function will be passed a :class:`DocTest` object. The setUp function can " +"access the test globals as the *globs* attribute of the test passed." +msgstr "" + +msgid "" +"Optional argument *globs* is a dictionary containing the initial global " +"variables for the tests. A new copy of this dictionary is created for each " +"test. By default, *globs* is a new empty dictionary." +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." +msgstr "" + +msgid "" +"The global ``__file__`` is added to the globals provided to doctests loaded " +"from a text file using :func:`DocFileSuite`." +msgstr "" + +msgid "Convert doctest tests for a module to a :class:`unittest.TestSuite`." +msgstr "" + +msgid "" +"The returned :class:`unittest.TestSuite` is to be run by the unittest " +"framework and runs each doctest in the module. If any of the doctests fail, " +"then the synthesized unit test fails, and a :exc:`failureException` " +"exception is raised showing the name of the file containing the test and a " +"(sometimes approximate) line number." +msgstr "" + +msgid "" +"Optional argument *module* provides the module to be tested. It can be a " +"module object or a (possibly dotted) module name. If not specified, the " +"module calling this function is used." +msgstr "" + +msgid "" +"Optional argument *extraglobs* specifies an extra set of global variables, " +"which is merged into *globs*. By default, no extra globals are used." +msgstr "" + +msgid "" +"Optional argument *test_finder* is the :class:`DocTestFinder` object (or a " +"drop-in replacement) that is used to extract doctests from the module." +msgstr "" + +msgid "" +"Optional arguments *setUp*, *tearDown*, and *optionflags* are the same as " +"for function :func:`DocFileSuite` above." +msgstr "" + +msgid "This function uses the same search technique as :func:`testmod`." +msgstr "" + +msgid "" +":func:`DocTestSuite` returns an empty :class:`unittest.TestSuite` if " +"*module* contains no docstrings instead of raising :exc:`ValueError`." +msgstr "" + +msgid "" +"When doctests which have been converted to unit tests by :func:" +"`DocFileSuite` or :func:`DocTestSuite` fail, this exception is raised " +"showing the name of the file containing the test and a (sometimes " +"approximate) line number." +msgstr "" + +msgid "" +"Under the covers, :func:`DocTestSuite` creates a :class:`unittest.TestSuite` " +"out of :class:`!doctest.DocTestCase` instances, and :class:`!DocTestCase` is " +"a subclass of :class:`unittest.TestCase`. :class:`!DocTestCase` isn't " +"documented here (it's an internal detail), but studying its code can answer " +"questions about the exact details of :mod:`unittest` integration." +msgstr "" + +msgid "" +"Similarly, :func:`DocFileSuite` creates a :class:`unittest.TestSuite` out " +"of :class:`!doctest.DocFileCase` instances, and :class:`!DocFileCase` is a " +"subclass of :class:`!DocTestCase`." +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` 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 author " +"typically wants to control :mod:`doctest` reporting options (perhaps, e.g., " +"specified by command line options), but there's no way to pass options " +"through :mod:`unittest` to :mod:`doctest` test runners." +msgstr "" + +msgid "" +"For this reason, :mod:`doctest` also supports a notion of :mod:`doctest` " +"reporting flags specific to :mod:`unittest` support, via this function:" +msgstr "" + +msgid "Set the :mod:`doctest` reporting flags to use." +msgstr "" + +msgid "" +"Argument *flags* takes the :ref:`bitwise OR ` of option flags. See " +"section :ref:`doctest-options`. Only \"reporting flags\" can be used." +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." +msgstr "" + +msgid "" +"The value of the :mod:`unittest` reporting flags in effect before the " +"function was called is returned by the function." +msgstr "" + +msgid "Advanced API" +msgstr "" + +msgid "" +"The basic API is a simple wrapper that's intended to make doctest easy to " +"use. It is fairly flexible, and should meet most users' needs; however, if " +"you require more fine-grained control over testing, or wish to extend " +"doctest's capabilities, then you should use the advanced API." +msgstr "" + +msgid "" +"The advanced API revolves around two container classes, which are used to " +"store the interactive examples extracted from doctest cases:" +msgstr "" + +msgid "" +":class:`Example`: A single Python :term:`statement`, paired with its " +"expected output." +msgstr "" + +msgid "" +":class:`DocTest`: A collection of :class:`Example`\\ s, typically extracted " +"from a single docstring or text file." +msgstr "" + +msgid "" +"Additional processing classes are defined to find, parse, and run, and check " +"doctest examples:" +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." +msgstr "" + +msgid "" +":class:`DocTestParser`: Creates a :class:`DocTest` object from a string " +"(such as an object's docstring)." +msgstr "" + +msgid "" +":class:`DocTestRunner`: Executes the examples in a :class:`DocTest`, and " +"uses an :class:`OutputChecker` to verify their output." +msgstr "" + +msgid "" +":class:`OutputChecker`: Compares the actual output from a doctest example " +"with the expected output, and decides whether they match." +msgstr "" + +msgid "" +"The relationships among these processing classes are summarized in the " +"following diagram::" +msgstr "" + +msgid "DocTest Objects" +msgstr "" + +msgid "" +"A collection of doctest examples that should be run in a single namespace. " +"The constructor arguments are used to initialize the attributes of the same " +"names." +msgstr "" + +msgid "" +":class:`DocTest` defines the following attributes. They are initialized by " +"the constructor, and should not be modified directly." +msgstr "" + +msgid "" +"A list of :class:`Example` objects encoding the individual interactive " +"Python examples that should be run by this test." +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." +msgstr "" + +msgid "" +"A string name identifying the :class:`DocTest`. Typically, this is the name " +"of the object or file that the test was extracted from." +msgstr "" + +msgid "" +"The name of the file that this :class:`DocTest` was extracted from; or " +"``None`` if the filename is unknown, or if the :class:`DocTest` was not " +"extracted from a file." +msgstr "" + +msgid "" +"The line number within :attr:`filename` where this :class:`DocTest` begins, " +"or ``None`` if the line number is unavailable. This line number is zero-" +"based with respect to the beginning of the file." +msgstr "" + +msgid "" +"The string that the test was extracted from, or ``None`` if the string is " +"unavailable, or if the test was not extracted from a string." +msgstr "" + +msgid "Example Objects" +msgstr "" + +msgid "" +"A single interactive example, consisting of a Python statement and its " +"expected output. The constructor arguments are used to initialize the " +"attributes of the same names." +msgstr "" + +msgid "" +":class:`Example` defines the following attributes. They are initialized by " +"the constructor, and should not be modified directly." +msgstr "" + +msgid "" +"A string containing the example's source code. This source code consists of " +"a single Python statement, and always ends with a newline; the constructor " +"adds a newline when necessary." +msgstr "" + +msgid "" +"The expected output from running the example's source code (either from " +"stdout, or a traceback in case of exception). :attr:`want` ends with a " +"newline unless no output is expected, in which case it's an empty string. " +"The constructor adds a newline when necessary." +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." +msgstr "" + +msgid "" +"The line number within the string containing this example where the example " +"begins. This line number is zero-based with respect to the beginning of the " +"containing string." +msgstr "" + +msgid "" +"The example's indentation in the containing string, i.e., the number of " +"space characters that precede the example's first prompt." +msgstr "" + +msgid "" +"A dictionary mapping from option flags to ``True`` or ``False``, which is " +"used to override default options for this example. Any option flags not " +"contained in this dictionary are left at their default value (as specified " +"by the :class:`DocTestRunner`'s :ref:`optionflags `). By " +"default, no options are set." +msgstr "" + +msgid "DocTestFinder objects" +msgstr "" + +msgid "" +"A processing class used to extract the :class:`DocTest`\\ s that are " +"relevant to a given object, from its docstring and the docstrings of its " +"contained objects. :class:`DocTest`\\ s can be extracted from modules, " +"classes, functions, methods, staticmethods, classmethods, and properties." +msgstr "" + +msgid "" +"The optional argument *verbose* can be used to display the objects searched " +"by the finder. It defaults to ``False`` (no output)." +msgstr "" + +msgid "" +"The optional argument *parser* specifies the :class:`DocTestParser` object " +"(or a drop-in replacement) that is used to extract doctests from docstrings." +msgstr "" + +msgid "" +"If the optional argument *recurse* is false, then :meth:`DocTestFinder.find` " +"will only examine the given object, and not any contained objects." +msgstr "" + +msgid "" +"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:" +msgstr "" + +msgid "" +"Return a list of the :class:`DocTest`\\ s that are defined by *obj*'s " +"docstring, or by any of its contained objects' docstrings." +msgstr "" + +msgid "" +"The optional argument *name* specifies the object's name; this name will be " +"used to construct names for the returned :class:`DocTest`\\ s. If *name* is " +"not specified, then ``obj.__name__`` is used." +msgstr "" + +msgid "" +"The optional parameter *module* is the module that contains the given " +"object. If the module is not specified or is ``None``, then the test finder " +"will attempt to automatically determine the correct module. The object's " +"module is used:" +msgstr "" + +msgid "As a default namespace, if *globs* is not specified." +msgstr "" + +msgid "" +"To prevent the DocTestFinder from extracting DocTests from objects that are " +"imported from other modules. (Contained objects with modules other than " +"*module* are ignored.)" +msgstr "" + +msgid "To find the name of the file containing the object." +msgstr "" + +msgid "To help find the line number of the object within its file." +msgstr "" + +msgid "" +"If *module* is ``False``, no attempt to find the module will be made. This " +"is obscure, of use mostly in testing doctest itself: if *module* is " +"``False``, or is ``None`` but cannot be found automatically, then all " +"objects are considered to belong to the (non-existent) module, so all " +"contained objects will (recursively) be searched for doctests." +msgstr "" + +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 *__dict__*, if " +"specified, or ``{}`` otherwise. If *extraglobs* is not specified, then it " +"defaults to ``{}``." +msgstr "" + +msgid "DocTestParser objects" +msgstr "" + +msgid "" +"A processing class used to extract interactive examples from a string, and " +"use them to create a :class:`DocTest` object." +msgstr "" + +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." +msgstr "" + +msgid "" +"*globs*, *name*, *filename*, and *lineno* are attributes for the new :class:" +"`DocTest` object. See the documentation for :class:`DocTest` for more " +"information." +msgstr "" + +msgid "" +"Extract all doctest examples from the given string, and return them as a " +"list of :class:`Example` objects. Line numbers are 0-based. The optional " +"argument *name* is a name identifying this string, and is only used for " +"error messages." +msgstr "" + +msgid "" +"Divide the given string into examples and intervening text, and return them " +"as a list of alternating :class:`Example`\\ s and strings. Line numbers for " +"the :class:`Example`\\ s are 0-based. The optional argument *name* is a " +"name identifying this string, and is only used for error messages." +msgstr "" + +msgid "DocTestRunner objects" +msgstr "" + +msgid "" +"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 " +"customized by passing a subclass of :class:`OutputChecker` to the " +"constructor." +msgstr "" + +msgid "" +"The test runner's display output can be controlled in two ways. First, an " +"output function can be passed to :meth:`TestRunner.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`." +msgstr "" + +msgid "" +"The optional keyword argument *checker* specifies the :class:`OutputChecker` " +"object (or drop-in replacement) that should be used to compare the expected " +"outputs to the actual outputs of doctest examples." +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." +msgstr "" + +msgid "" +"The optional keyword argument *optionflags* can be used to control how the " +"test runner compares expected output to actual output, and how it displays " +"failures. For more information, see section :ref:`doctest-options`." +msgstr "" + +msgid ":class:`DocTestRunner` defines the following methods:" +msgstr "" + +msgid "" +"Report that the test runner is about to process the given example. This " +"method is provided to allow subclasses of :class:`DocTestRunner` to " +"customize their output; it should not be called directly." +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`." +msgstr "" + +msgid "" +"Report that the given example ran successfully. This method is provided to " +"allow subclasses of :class:`DocTestRunner` to customize their output; it " +"should not be called directly." +msgstr "" + +msgid "" +"*example* is the example about to be processed. *got* is the actual output " +"from the example. *test* is the test containing *example*. *out* is the " +"output function that was passed to :meth:`DocTestRunner.run`." +msgstr "" + +msgid "" +"Report that the given example failed. This method is provided to allow " +"subclasses of :class:`DocTestRunner` to customize their output; it should " +"not be called directly." +msgstr "" + +msgid "" +"Report that the given example raised an unexpected exception. This method is " +"provided to allow subclasses of :class:`DocTestRunner` to customize their " +"output; it should not be called directly." +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`." +msgstr "" + +msgid "" +"Run the examples in *test* (a :class:`DocTest` object), and display the " +"results using the writer function *out*." +msgstr "" + +msgid "" +"The examples are run in the namespace ``test.globs``. If *clear_globs* is " +"true (the default), then this namespace will be cleared after the test runs, " +"to help with garbage collection. If you would like to examine the namespace " +"after the test completes, then use *clear_globs=False*." +msgstr "" + +msgid "" +"*compileflags* gives the set of flags that should be used by the Python " +"compiler when running the examples. If not specified, then it will default " +"to the set of future-import flags that apply to *globs*." +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." +msgstr "" + +msgid "" +"Print a summary of all the test cases that have been run by this " +"DocTestRunner, and return a :term:`named tuple` ``TestResults(failed, " +"attempted)``." +msgstr "" + +msgid "" +"The optional *verbose* argument controls how detailed the summary is. If " +"the verbosity is not specified, then the :class:`DocTestRunner`'s verbosity " +"is used." +msgstr "" + +msgid "OutputChecker objects" +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." +msgstr "" + +msgid ":class:`OutputChecker` defines the following methods:" +msgstr "" + +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." +msgstr "" + +msgid "" +"Return a string describing the differences between the expected output for a " +"given example (*example*) and the actual output (*got*). *optionflags* is " +"the set of option flags used to compare *want* and *got*." +msgstr "" + +msgid "Debugging" +msgstr "" + +msgid "Doctest provides several mechanisms for debugging doctest examples:" +msgstr "" + +msgid "" +"Several functions convert doctests to executable Python programs, which can " +"be run under the Python debugger, :mod:`pdb`." +msgstr "" + +msgid "" +"The :class:`DebugRunner` class is a subclass of :class:`DocTestRunner` that " +"raises an exception for the first failing example, containing information " +"about that example. This information can be used to perform post-mortem " +"debugging on the example." +msgstr "" + +msgid "" +"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::" +msgstr "" + +msgid "Then an interactive Python session may look like this::" +msgstr "" + +msgid "" +"Functions that convert doctests to Python code, and possibly run the " +"synthesized code under the debugger:" +msgstr "" + +msgid "Convert text with examples to a script." +msgstr "" + +msgid "" +"Argument *s* is a string containing doctest examples. The string is " +"converted to a Python script, where doctest examples in *s* are converted to " +"regular code, and everything else is converted to Python comments. The " +"generated script is returned as a string. For example, ::" +msgstr "" + +msgid "displays::" +msgstr "" + +msgid "" +"This function is used internally by other functions (see below), but can " +"also be useful when you want to transform an interactive Python session into " +"a Python script." +msgstr "" + +msgid "Convert the doctest for an object to a script." +msgstr "" + +msgid "" +"Argument *module* is a module object, or dotted name of a module, containing " +"the object whose doctests are of interest. Argument *name* is the name " +"(within the module) of the object with the doctests of interest. The result " +"is a string, containing the object's docstring converted to a Python script, " +"as described for :func:`script_from_examples` above. For example, if " +"module :file:`a.py` contains a top-level function :func:`!f`, then ::" +msgstr "" + +msgid "" +"prints a script version of function :func:`!f`'s docstring, with doctests " +"converted to code, and the rest placed in comments." +msgstr "" + +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`." +msgstr "" + +msgid "" +"A shallow copy of ``module.__dict__`` is used for both local and global " +"execution context." +msgstr "" + +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 *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`." +msgstr "" + +msgid "Debug the doctests in a string." +msgstr "" + +msgid "" +"This is like function :func:`debug` above, except that a string containing " +"doctest examples is specified directly, via the *src* argument." +msgstr "" + +msgid "" +"Optional argument *pm* has the same meaning as in function :func:`debug` " +"above." +msgstr "" + +msgid "" +"Optional argument *globs* gives a dictionary to use as both local and global " +"execution context. If not specified, or ``None``, an empty dictionary is " +"used. If specified, a shallow copy of the dictionary is used." +msgstr "" + +msgid "" +"The :class:`DebugRunner` class, and the special exceptions it may raise, are " +"of most interest to testing framework authors, and will only be sketched " +"here. See the source code, and especially :class:`DebugRunner`'s docstring " +"(which is a doctest!) for more details:" +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." +msgstr "" + +msgid "" +"For information about the constructor parameters and methods, see the " +"documentation for :class:`DocTestRunner` in section :ref:`doctest-advanced-" +"api`." +msgstr "" + +msgid "" +"There are two exceptions that may be raised by :class:`DebugRunner` " +"instances:" +msgstr "" + +msgid "" +"An exception raised by :class:`DocTestRunner` to signal that a doctest " +"example's actual output did not match its expected output. The constructor " +"arguments are used to initialize the attributes of the same names." +msgstr "" + +msgid ":exc:`DocTestFailure` defines the following attributes:" +msgstr "" + +msgid "The :class:`DocTest` object that was being run when the example failed." +msgstr "" + +msgid "The :class:`Example` that failed." +msgstr "" + +msgid "The example's actual output." +msgstr "" + +msgid "" +"An exception raised by :class:`DocTestRunner` to signal that a doctest " +"example raised an unexpected exception. The constructor arguments are used " +"to initialize the attributes of the same names." +msgstr "" + +msgid ":exc:`UnexpectedException` defines the following attributes:" +msgstr "" + +msgid "" +"A tuple containing information about the unexpected exception, as returned " +"by :func:`sys.exc_info`." +msgstr "" + +msgid "Soapbox" +msgstr "" + +msgid "" +"As mentioned in the introduction, :mod:`doctest` has grown to have three " +"primary uses:" +msgstr "" + +msgid "Checking examples in docstrings." +msgstr "" + +msgid "Regression testing." +msgstr "" + +msgid "Executable documentation / literate testing." +msgstr "" + +msgid "" +"These uses have different requirements, and it is important to distinguish " +"them. In particular, filling your docstrings with obscure test cases makes " +"for bad documentation." +msgstr "" + +msgid "" +"When writing a docstring, choose docstring examples with care. There's an " +"art to this that needs to be learned---it may not be natural at first. " +"Examples should add genuine value to the documentation. A good example can " +"often be worth many words. If done with care, the examples will be " +"invaluable for your users, and will pay back the time it takes to collect " +"them many times over as the years go by and things change. I'm still amazed " +"at how often one of my :mod:`doctest` examples stops working after a " +"\"harmless\" change." +msgstr "" + +msgid "" +"Doctest also makes an excellent tool for regression testing, especially if " +"you don't skimp on explanatory text. By interleaving prose and examples, it " +"becomes much easier to keep track of what's actually being tested, and why. " +"When a test fails, good prose can make it much easier to figure out what the " +"problem is, and how it should be fixed. It's true that you could write " +"extensive comments in code-based testing, but few programmers do. Many have " +"found that using doctest approaches instead leads to much clearer tests. " +"Perhaps this is simply because doctest makes writing prose a little easier " +"than writing code, while writing comments in code is a little harder. I " +"think it goes deeper than just that: the natural attitude when writing a " +"doctest-based test is that you want to explain the fine points of your " +"software, and illustrate them with examples. This in turn naturally leads to " +"test files that start with the simplest features, and logically progress to " +"complications and edge cases. A coherent narrative is the result, instead " +"of a collection of isolated functions that test isolated bits of " +"functionality seemingly at random. It's a different attitude, and produces " +"different results, blurring the distinction between testing and explaining." +msgstr "" + +msgid "" +"Regression testing is best confined to dedicated objects or files. There " +"are several options for organizing tests:" +msgstr "" + +msgid "" +"Write text files containing test cases as interactive examples, and test the " +"files using :func:`testfile` or :func:`DocFileSuite`. This is recommended, " +"although is easiest to do for new projects, designed from the start to use " +"doctest." +msgstr "" + +msgid "" +"Define functions named ``_regrtest_topic`` that consist of single " +"docstrings, containing test cases for the named topics. These functions can " +"be included in the same file as the module, or separated out into a separate " +"test file." +msgstr "" + +msgid "" +"Define a ``__test__`` dictionary mapping from regression test topics to " +"docstrings containing test cases." +msgstr "" + +msgid "" +"When you have placed your tests in a module, the module can itself be the " +"test runner. When a test fails, you can arrange for your test runner to re-" +"run only the failing doctest while you debug the problem. Here is a minimal " +"example of such a test runner::" +msgstr "" + +msgid "Footnotes" +msgstr "Przypisy" + +msgid "" +"Examples containing both expected output and an exception are not supported. " +"Trying to guess where one ends and the other begins is too error-prone, and " +"that also makes for a confusing test." +msgstr "" + +msgid ">>>" +msgstr ">>>" + +msgid "interpreter prompt" +msgstr "" + +msgid "..." +msgstr "..." + +msgid "^ (caret)" +msgstr "" + +msgid "marker" +msgstr "" + +msgid "" +msgstr "" + +msgid "in doctests" +msgstr "" + +msgid "# (hash)" +msgstr "# (hash)" + +msgid "+ (plus)" +msgstr "" + +msgid "- (minus)" +msgstr "" diff --git a/library/email.charset.po b/library/email.charset.po new file mode 100644 index 0000000000..86388cefd7 --- /dev/null +++ b/library/email.charset.po @@ -0,0 +1,256 @@ +# 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:04+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:`email.charset`: Representing character sets" +msgstr "" + +msgid "**Source code:** :source:`Lib/email/charset.py`" +msgstr "" + +msgid "" +"This module is part of the legacy (``Compat32``) email API. In the new API " +"only the aliases table is used." +msgstr "" + +msgid "" +"The remaining text in this section is the original documentation of the " +"module." +msgstr "" + +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." +msgstr "" + +msgid "Import this class from the :mod:`email.charset` module." +msgstr "" + +msgid "Map character sets to their email properties." +msgstr "" + +msgid "" +"This class provides information about the requirements imposed on email for " +"a specific character set. It also provides convenience routines for " +"converting between character sets, given the availability of the applicable " +"codecs. Given a character set, it will do its best to provide information " +"on how to use that character set in an email message in an RFC-compliant way." +msgstr "" + +msgid "" +"Certain character sets must be encoded with quoted-printable or base64 when " +"used in email headers or bodies. Certain character sets must be converted " +"outright, and are not allowed in email." +msgstr "" + +msgid "" +"Optional *input_charset* is as described below; it is always coerced to " +"lower case. After being alias normalized it is also used as a lookup into " +"the registry of character sets to find out the header encoding, body " +"encoding, and output conversion codec to be used for the character set. For " +"example, if *input_charset* is ``iso-8859-1``, then headers and bodies will " +"be encoded using quoted-printable and no output conversion codec is " +"necessary. If *input_charset* is ``euc-jp``, then headers will be encoded " +"with base64, bodies will not be encoded, but output text will be converted " +"from the ``euc-jp`` character set to the ``iso-2022-jp`` character set." +msgstr "" + +msgid ":class:`Charset` instances have the following data attributes:" +msgstr "" + +msgid "" +"The initial character set specified. Common aliases are converted to their " +"*official* email names (e.g. ``latin_1`` is converted to ``iso-8859-1``). " +"Defaults to 7-bit ``us-ascii``." +msgstr "" + +msgid "" +"If the character set must be encoded before it can be used in an email " +"header, this attribute will be set to ``Charset.QP`` (for quoted-printable), " +"``Charset.BASE64`` (for base64 encoding), or ``Charset.SHORTEST`` for the " +"shortest of QP or BASE64 encoding. Otherwise, it will be ``None``." +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*." +msgstr "" + +msgid "" +"Some character sets must be converted before they can be used in email " +"headers or bodies. If the *input_charset* is one of them, this attribute " +"will contain the name of the character set output will be converted to. " +"Otherwise, it will be ``None``." +msgstr "" + +msgid "" +"The name of the Python codec used to convert the *input_charset* to " +"Unicode. If no conversion codec is necessary, this attribute will be " +"``None``." +msgstr "" + +msgid "" +"The name of the Python codec used to convert Unicode to the " +"*output_charset*. If no conversion codec is necessary, this attribute will " +"have the same value as the *input_codec*." +msgstr "" + +msgid ":class:`Charset` instances also have the following methods:" +msgstr "" + +msgid "Return the content transfer encoding used for body encoding." +msgstr "" + +msgid "" +"This is either the string ``quoted-printable`` or ``base64`` depending on " +"the encoding used, or it is a function, in which case you should call the " +"function with a single argument, the Message object being encoded. The " +"function should then set the :mailheader:`Content-Transfer-Encoding` header " +"itself to whatever is appropriate." +msgstr "" + +msgid "" +"Returns the string ``quoted-printable`` if *body_encoding* is ``QP``, " +"returns the string ``base64`` if *body_encoding* is ``BASE64``, and returns " +"the string ``7bit`` otherwise." +msgstr "" + +msgid "Return the output character set." +msgstr "" + +msgid "" +"This is the *output_charset* attribute if that is not ``None``, otherwise it " +"is *input_charset*." +msgstr "" + +msgid "Header-encode the string *string*." +msgstr "" + +msgid "" +"The type of encoding (base64 or quoted-printable) will be based on the " +"*header_encoding* attribute." +msgstr "" + +msgid "Header-encode a *string* by converting it first to bytes." +msgstr "" + +msgid "" +"This is similar to :meth:`header_encode` except that the string is fit into " +"maximum line lengths as given by the argument *maxlengths*, which must be an " +"iterator: each element returned from this iterator will provide the next " +"maximum line length." +msgstr "" + +msgid "Body-encode the string *string*." +msgstr "" + +msgid "" +"The type of encoding (base64 or quoted-printable) will be based on the " +"*body_encoding* attribute." +msgstr "" + +msgid "" +"The :class:`Charset` class also provides a number of methods to support " +"standard operations and built-in functions." +msgstr "" + +msgid "" +"Returns *input_charset* as a string coerced to lower case. :meth:`__repr__` " +"is an alias for :meth:`__str__`." +msgstr "" + +msgid "" +"This method allows you to compare two :class:`Charset` instances for " +"equality." +msgstr "" + +msgid "" +"This method allows you to compare two :class:`Charset` instances for " +"inequality." +msgstr "" + +msgid "" +"The :mod:`email.charset` module also provides the following functions for " +"adding new entries to the global character set, alias, and codec registries:" +msgstr "" + +msgid "Add character properties to the global registry." +msgstr "" + +msgid "" +"*charset* is the input character set, and must be the canonical name of a " +"character set." +msgstr "" + +msgid "" +"Optional *header_enc* and *body_enc* is either ``Charset.QP`` for quoted-" +"printable, ``Charset.BASE64`` for base64 encoding, ``Charset.SHORTEST`` for " +"the shortest of quoted-printable or base64 encoding, or ``None`` for no " +"encoding. ``SHORTEST`` is only valid for *header_enc*. The default is " +"``None`` for no encoding." +msgstr "" + +msgid "" +"Optional *output_charset* is the character set that the output should be in. " +"Conversions will proceed from input charset, to Unicode, to the output " +"charset when the method :meth:`Charset.convert` is called. The default is " +"to output in the same character set as the input." +msgstr "" + +msgid "" +"Both *input_charset* and *output_charset* must have Unicode codec entries in " +"the module's character set-to-codec mapping; use :func:`add_codec` to add " +"codecs the module does not know about. See the :mod:`codecs` module's " +"documentation for more information." +msgstr "" + +msgid "" +"The global character set registry is kept in the module global dictionary " +"``CHARSETS``." +msgstr "" + +msgid "" +"Add a character set alias. *alias* is the alias name, e.g. ``latin-1``. " +"*canonical* is the character set's canonical name, e.g. ``iso-8859-1``." +msgstr "" + +msgid "" +"The global charset alias registry is kept in the module global dictionary " +"``ALIASES``." +msgstr "" + +msgid "" +"Add a codec that map characters in the given character set to and from " +"Unicode." +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." +msgstr "" diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po new file mode 100644 index 0000000000..69b730c0fd --- /dev/null +++ b/library/email.compat32-message.po @@ -0,0 +1,726 @@ +# 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:04+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:`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." +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." +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 " +"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`." +msgstr "" + +msgid "" +"The conceptual model provided by a :class:`Message` object is that of an " +"ordered dictionary of headers with additional methods for accessing both " +"specialized information from the headers, for accessing the payload, for " +"generating a serialized version of the message, and for recursively walking " +"over the object tree. Note that duplicate headers are supported but special " +"methods must be used to access them." +msgstr "" + +msgid "" +"The :class:`Message` pseudo-dictionary is indexed by the header names, which " +"must be ASCII values. The values of the dictionary are strings that are " +"supposed to contain only ASCII characters; there is some special handling " +"for non-ASCII input, but it doesn't always produce the correct results. " +"Headers are stored and returned in case-preserving form, but field names are " +"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`)." +msgstr "" + +msgid "Here are the methods of the :class:`Message` class:" +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." +msgstr "" + +msgid "The *policy* keyword argument was added." +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 reasons, *maxheaderlen* " +"defaults to ``0``, so if you want a different value you must override it " +"explicitly (the value specified for *max_line_length* in the policy will be " +"ignored by this method). 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 ``Generator``." +msgstr "" + +msgid "" +"Flattening the message may trigger changes to the :class:`Message` if " +"defaults need to be filled in to complete the transformation to a string " +"(for example, MIME boundaries may be generated or modified)." +msgstr "" + +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::" +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`.)" +msgstr "" + +msgid "the *policy* keyword argument was added." +msgstr "" + +msgid "" +"Equivalent to :meth:`.as_string()`. Allows ``str(msg)`` to produce a string " +"containing the formatted message." +msgstr "" + +msgid "" +"Return the entire message flattened as a bytes object. When optional " +"*unixfrom* is true, the envelope header is included in the returned string. " +"*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 ``BytesGenerator``." +msgstr "" + +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::" +msgstr "" + +msgid "" +"Equivalent to :meth:`.as_bytes()`. Allows ``bytes(msg)`` to produce a bytes " +"object containing the formatted message." +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``.)" +msgstr "" + +msgid "" +"Set the message's envelope header to *unixfrom*, which should be a string." +msgstr "" + +msgid "" +"Return the message's envelope header. Defaults to ``None`` if the envelope " +"header was never set." +msgstr "" + +msgid "" +"Add the given *payload* to the current payload, which must be ``None`` or a " +"list of :class:`Message` objects before the call. After the call, the " +"payload will always be a list of :class:`Message` objects. If you want to " +"set the payload to a scalar object (e.g. a string), use :meth:`set_payload` " +"instead." +msgstr "" + +msgid "" +"This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " +"class its functionality is replaced by :meth:`~email.message.EmailMessage." +"set_content` and the related ``make`` and ``add`` methods." +msgstr "" + +msgid "" +"Return the current payload, which will be a list of :class:`Message` objects " +"when :meth:`is_multipart` is ``True``, or a string when :meth:`is_multipart` " +"is ``False``. If the payload is a list and you mutate the list object, you " +"modify the message's payload in place." +msgstr "" + +msgid "" +"With optional argument *i*, :meth:`get_payload` will return the *i*-th " +"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." +msgstr "" + +msgid "" +"Optional *decode* is a flag indicating whether the payload should be decoded " +"or not, according to the :mailheader:`Content-Transfer-Encoding` header. " +"When ``True`` and the message is not a multipart, the payload will be " +"decoded if this header's value is ``quoted-printable`` or ``base64``. If " +"some other encoding is used, or :mailheader:`Content-Transfer-Encoding` " +"header is missing, the payload is returned as-is (undecoded). In all cases " +"the returned value is binary data. If the message is a multipart and the " +"*decode* flag is ``True``, then ``None`` is returned. If the payload is " +"base64 and it was not perfectly formed (missing padding, characters outside " +"the base64 alphabet), then an appropriate defect will be added to the " +"message's defect property (:class:`~email.errors.InvalidBase64PaddingDefect` " +"or :class:`~email.errors.InvalidBase64CharactersDefect`, respectively)." +msgstr "" + +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." +msgstr "" + +msgid "" +"This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " +"class its functionality is replaced by :meth:`~email.message.EmailMessage." +"get_content` and :meth:`~email.message.EmailMessage.iter_parts`." +msgstr "" + +msgid "" +"Set the entire message object's payload to *payload*. It is the client's " +"responsibility to ensure the payload invariants. Optional *charset* sets " +"the message's default character set; see :meth:`set_charset` for details." +msgstr "" + +msgid "" +"This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " +"class 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 " +"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`." +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." +msgstr "" + +msgid "" +"This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " +"class its functionality is replaced by the *charset* parameter of the :meth:" +"`email.emailmessage.EmailMessage.set_content` method." +msgstr "" + +msgid "" +"Return the :class:`~email.charset.Charset` instance associated with the " +"message's payload." +msgstr "" + +msgid "" +"This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " +"class it always returns ``None``." +msgstr "" + +msgid "" +"The following methods implement a mapping-like interface for accessing the " +"message's :rfc:`2822` headers. Note that there are some semantic " +"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." +msgstr "" + +msgid "" +"These semantic differences are intentional and are biased toward maximal " +"convenience." +msgstr "" + +msgid "" +"Note that in all cases, any envelope header present in the message is not " +"included in the mapping interface." +msgstr "" + +msgid "" +"In a model generated from bytes, any header values that (in contravention of " +"the RFCs) contain non-ASCII bytes will, when retrieved through this " +"interface, be represented as :class:`~email.header.Header` objects with a " +"charset of ``unknown-8bit``." +msgstr "" + +msgid "Return the total number of headers, including duplicates." +msgstr "" + +msgid "" +"Return ``True`` if the message object has a field named *name*. Matching is " +"done case-insensitively and *name* should not include the trailing colon. " +"Used for the ``in`` operator, e.g.::" +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." +msgstr "" + +msgid "" +"Note that if the named field appears more than once in the message's " +"headers, exactly which of those field values will be returned is undefined. " +"Use the :meth:`get_all` method to get the values of all the extant named " +"headers." +msgstr "" + +msgid "" +"Add a header to the message with field name *name* and value *val*. The " +"field is appended to the end of the message's existing fields." +msgstr "" + +msgid "" +"Note that this does *not* overwrite or delete any existing header with the " +"same name. If you want to ensure that the new header is the only one " +"present in the message with field name *name*, delete the field first, e.g.::" +msgstr "" + +msgid "" +"Delete all occurrences of the field with name *name* from the message's " +"headers. No exception is raised if the named field isn't present in the " +"headers." +msgstr "" + +msgid "Return a list of all the message's header field names." +msgstr "" + +msgid "Return a list of all the message's field values." +msgstr "" + +msgid "" +"Return a list of 2-tuples containing all the message's field headers and " +"values." +msgstr "" + +msgid "" +"Return the value of the named header field. This is identical to :meth:" +"`__getitem__` except that optional *failobj* is returned if the named header " +"is missing (defaults to ``None``)." +msgstr "" + +msgid "Here are some additional useful methods:" +msgstr "" + +msgid "" +"Return a list of all the values for the field named *name*. If there are no " +"such named headers in the message, *failobj* is returned (defaults to " +"``None``)." +msgstr "" + +msgid "" +"Extended header setting. This method is similar to :meth:`__setitem__` " +"except that additional header parameters can be provided as keyword " +"arguments. *_name* is the header field to add and *_value* is the *primary* " +"value for the header." +msgstr "" + +msgid "" +"For each item in the keyword argument dictionary *_params*, the key is taken " +"as the parameter name, with underscores converted to dashes (since dashes " +"are illegal in Python identifiers). Normally, the parameter will be added " +"as ``key=\"value\"`` unless the value is ``None``, in which case only the " +"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 " +"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 " +"``None``." +msgstr "" + +msgid "Here's an example::" +msgstr "" + +msgid "This will add a header that looks like ::" +msgstr "" + +msgid "An example with non-ASCII characters::" +msgstr "" + +msgid "Which produces ::" +msgstr "" + +msgid "" +"Replace a header. Replace the first header found in the message that " +"matches *_name*, retaining header order and field name case. If no matching " +"header was found, a :exc:`KeyError` is raised." +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." +msgstr "" + +msgid "" +":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 "" +"Return the message's main content type. This is the :mimetype:`maintype` " +"part of the string returned by :meth:`get_content_type`." +msgstr "" + +msgid "" +"Return the message's sub-content type. This is the :mimetype:`subtype` part " +"of the string returned by :meth:`get_content_type`." +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 " +"content type of :mimetype:`message/rfc822`." +msgstr "" + +msgid "" +"Set the default content type. *ctype* should either be :mimetype:`text/" +"plain` or :mimetype:`message/rfc822`, although this is not enforced. The " +"default content type is not stored in the :mailheader:`Content-Type` header." +msgstr "" + +msgid "" +"Return the message's :mailheader:`Content-Type` parameters, as a list. The " +"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)." +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`." +msgstr "" + +msgid "" +"This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " +"class its functionality is replaced by the *params* property of the " +"individual header objects returned by the header access methods." +msgstr "" + +msgid "" +"Return the value of the :mailheader:`Content-Type` header's parameter " +"*param* as a string. If the message has no :mailheader:`Content-Type` " +"header or if there is no such parameter, then *failobj* is returned " +"(defaults to ``None``)." +msgstr "" + +msgid "" +"Optional *header* if given, specifies the message header to use instead of :" +"mailheader:`Content-Type`." +msgstr "" + +msgid "" +"Parameter keys are always compared case insensitively. The return value can " +"either be a string, or a 3-tuple if the parameter was :rfc:`2231` encoded. " +"When it's a 3-tuple, the elements of the value are of the form ``(CHARSET, " +"LANGUAGE, VALUE)``. Note that both ``CHARSET`` and ``LANGUAGE`` can be " +"``None``, in which case you should consider ``VALUE`` to be encoded in the " +"``us-ascii`` charset. You can usually ignore ``LANGUAGE``." +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::" +msgstr "" + +msgid "" +"In any case, the parameter value (either the returned string, or the " +"``VALUE`` item in the 3-tuple) is always unquoted, unless *unquote* is set " +"to ``False``." +msgstr "" + +msgid "" +"Set a parameter in the :mailheader:`Content-Type` header. If the parameter " +"already exists in the header, its value will be replaced with *value*. If " +"the :mailheader:`Content-Type` header as not yet been defined for this " +"message, it will be set to :mimetype:`text/plain` and the new parameter " +"value will be appended as per :rfc:`2045`." +msgstr "" + +msgid "" +"Optional *header* specifies an alternative header to :mailheader:`Content-" +"Type`, and all parameters will be quoted as necessary unless optional " +"*requote* is ``False`` (the default is ``True``)." +msgstr "" + +msgid "" +"If optional *charset* is specified, the parameter will be encoded according " +"to :rfc:`2231`. Optional *language* specifies the RFC 2231 language, " +"defaulting to the empty string. Both *charset* and *language* should be " +"strings." +msgstr "" + +msgid "" +"If *replace* is ``False`` (the default) the header is moved to the end of " +"the list of headers. If *replace* is ``True``, the header will be updated " +"in place." +msgstr "" + +msgid "``replace`` keyword was added." +msgstr "" + +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`." +msgstr "" + +msgid "" +"Set the main type and subtype for the :mailheader:`Content-Type` header. " +"*type* must be a string in the form :mimetype:`maintype/subtype`, otherwise " +"a :exc:`ValueError` is raised." +msgstr "" + +msgid "" +"This method replaces the :mailheader:`Content-Type` header, keeping all the " +"parameters in place. If *requote* is ``False``, this leaves the existing " +"header's quoting as is, otherwise the parameters will be quoted (the " +"default)." +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." +msgstr "" + +msgid "" +"This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " +"class its functionality is replaced by the ``make_`` and ``add_`` methods." +msgstr "" + +msgid "" +"Return the value of the ``filename`` parameter of the :mailheader:`Content-" +"Disposition` header of the message. If the header does not have a " +"``filename`` parameter, this method falls back to looking for the ``name`` " +"parameter on the :mailheader:`Content-Type` header. If neither is found, or " +"the header is missing, then *failobj* is returned. The returned string will " +"always be unquoted as per :func:`email.utils.unquote`." +msgstr "" + +msgid "" +"Return the value of the ``boundary`` parameter of the :mailheader:`Content-" +"Type` header of the message, or *failobj* if either the header is missing, " +"or has no ``boundary`` parameter. The returned string will always be " +"unquoted as per :func:`email.utils.unquote`." +msgstr "" + +msgid "" +"Set the ``boundary`` parameter of the :mailheader:`Content-Type` header to " +"*boundary*. :meth:`set_boundary` will always quote *boundary* if " +"necessary. A :exc:`~email.errors.HeaderParseError` is raised if the message " +"object has no :mailheader:`Content-Type` header." +msgstr "" + +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." +msgstr "" + +msgid "" +"Return the ``charset`` parameter of the :mailheader:`Content-Type` header, " +"coerced to lower case. If there is no :mailheader:`Content-Type` header, or " +"if that header has no ``charset`` parameter, *failobj* is returned." +msgstr "" + +msgid "" +"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 "" + +msgid "" +"Return a list containing the character set names in the message. If the " +"message is a :mimetype:`multipart`, then the list will contain one element " +"for each subpart in the payload, otherwise, it will be a list of length 1." +msgstr "" + +msgid "" +"Each item in the list will be a string which is the value of the ``charset`` " +"parameter in the :mailheader:`Content-Type` header for the represented " +"subpart. However, if the subpart has no :mailheader:`Content-Type` header, " +"no ``charset`` parameter, or is not of the :mimetype:`text` main MIME type, " +"then that item in the returned list will be *failobj*." +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`." +msgstr "" + +msgid "" +"The :meth:`walk` method is an all-purpose generator which can be used to " +"iterate over all the parts and subparts of a message object tree, in depth-" +"first traversal order. You will typically use :meth:`walk` as the iterator " +"in a ``for`` loop; each iteration returns the next subpart." +msgstr "" + +msgid "" +"Here's an example that prints the MIME type of every part of a multipart " +"message structure:" +msgstr "" + +msgid "" +"``walk`` iterates over the subparts of any part where :meth:`is_multipart` " +"returns ``True``, even though ``msg.get_content_maintype() == 'multipart'`` " +"may return ``False``. We can see this in our example by making use of the " +"``_structure`` debug helper function:" +msgstr "" + +msgid "" +"Here the ``message`` parts are not ``multiparts``, but they do contain " +"subparts. ``is_multipart()`` returns ``True`` and ``walk`` descends into the " +"subparts." +msgstr "" + +msgid "" +":class:`Message` objects can also optionally contain two instance " +"attributes, which can be used when generating the plain text of a MIME " +"message." +msgstr "" + +msgid "" +"The format of a MIME document allows for some text between the blank line " +"following the headers, and the first multipart boundary string. Normally, " +"this text is never visible in a MIME-aware mail reader because it falls " +"outside the standard MIME armor. However, when viewing the raw text of the " +"message, or when viewing the message in a non-MIME aware reader, this text " +"can become visible." +msgstr "" + +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." +msgstr "" + +msgid "" +"Note that if the message object has no preamble, the *preamble* attribute " +"will be ``None``." +msgstr "" + +msgid "" +"The *epilogue* attribute acts the same way as the *preamble* attribute, " +"except that it contains text that appears between the last boundary and the " +"end of the message." +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." +msgstr "" + +msgid "" +"The *defects* attribute contains a list of all the problems found when " +"parsing this message. See :mod:`email.errors` for a detailed description of " +"the possible parsing defects." +msgstr "" diff --git a/library/email_contentmanager.po b/library/email.contentmanager.po similarity index 97% rename from library/email_contentmanager.po rename to library/email.contentmanager.po index 85a607c2cc..b670dabc8d 100644 --- a/library/email_contentmanager.po +++ b/library/email.contentmanager.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/email_encoders.po b/library/email.encoders.po similarity index 89% rename from library/email_encoders.po rename to library/email.encoders.po index f08c916c9c..535d30f250 100644 --- a/library/email_encoders.po +++ b/library/email.encoders.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -56,8 +56,8 @@ 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 " +"`~email.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. " diff --git a/library/email.errors.po b/library/email.errors.po new file mode 100644 index 0000000000..c77f06eb8d --- /dev/null +++ b/library/email.errors.po @@ -0,0 +1,160 @@ +# 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:05+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:`email.errors`: Exception and Defect classes" +msgstr "" + +msgid "**Source code:** :source:`Lib/email/errors.py`" +msgstr "" + +msgid "" +"The following exception classes are defined in the :mod:`email.errors` " +"module:" +msgstr "" + +msgid "" +"This is the base class for all exceptions that the :mod:`email` package can " +"raise. It is derived from the standard :exc:`Exception` class and defines " +"no additional methods." +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`." +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)." +msgstr "" + +msgid "Deprecated and no longer used." +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`." +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`)." +msgstr "" + +msgid "" +"Here is the list of the defects that the :class:`~email.parser.FeedParser` " +"can find while parsing messages. Note that the defects are added to the " +"message where the problem was found, so for example, if a message nested " +"inside a :mimetype:`multipart/alternative` had a malformed header, that " +"nested message object would have a defect, but the containing messages would " +"not." +msgstr "" + +msgid "" +"All defect classes are subclassed from :class:`email.errors.MessageDefect`." +msgstr "" + +msgid "" +":class:`NoBoundaryInMultipartDefect` -- A message claimed to be a multipart, " +"but had no :mimetype:`boundary` parameter." +msgstr "" + +msgid "" +":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in the :" +"mailheader:`Content-Type` header was never found." +msgstr "" + +msgid "" +":class:`CloseBoundaryNotFoundDefect` -- A start boundary was found, but no " +"corresponding close boundary was ever found." +msgstr "" + +msgid "" +":class:`FirstHeaderLineIsContinuationDefect` -- The message had a " +"continuation line as its first header line." +msgstr "" + +msgid "" +":class:`MisplacedEnvelopeHeaderDefect` - A \"Unix From\" header was found in " +"the middle of a header block." +msgstr "" + +msgid "" +":class:`MissingHeaderBodySeparatorDefect` - A line was found while parsing " +"headers that had no leading white space but contained no ':'. Parsing " +"continues assuming that the line represents the first line of the body." +msgstr "" + +msgid "" +":class:`MalformedHeaderDefect` -- A header was found that was missing a " +"colon, or was otherwise malformed." +msgstr "" + +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`." +msgstr "" + +msgid "" +":class:`InvalidBase64PaddingDefect` -- When decoding a block of base64 " +"encoded bytes, the padding was not correct. Enough padding is added to " +"perform the decode, but the resulting decoded bytes may be invalid." +msgstr "" + +msgid "" +":class:`InvalidBase64CharactersDefect` -- When decoding a block of base64 " +"encoded bytes, characters outside the base64 alphabet were encountered. The " +"characters are ignored, but the resulting decoded bytes may be invalid." +msgstr "" + +msgid "" +":class:`InvalidBase64LengthDefect` -- When decoding a block of base64 " +"encoded bytes, the number of non-padding base64 characters was invalid (1 " +"more than a multiple of 4). The encoded block was kept as-is." +msgstr "" + +msgid "" +":class:`InvalidDateDefect` -- When decoding an invalid or unparsable date " +"field. The original value is kept as-is." +msgstr "" diff --git a/library/email_examples.po b/library/email.examples.po similarity index 89% rename from library/email_examples.po rename to library/email.examples.po index a40071fc43..1fadc35f2f 100644 --- a/library/email_examples.po +++ b/library/email.examples.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/email_generator.po b/library/email.generator.po similarity index 96% rename from library/email_generator.po rename to library/email.generator.po index d514ba367a..3c64d860d1 100644 --- a/library/email_generator.po +++ b/library/email.generator.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:14+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -273,6 +273,7 @@ msgstr "" msgid "" "\"[Non-text (%(type)s) part of message omitted, filename %(filename)s]\"" msgstr "" +"\"[Non-text (%(type)s) part of message omitted, filename %(filename)s]\"" msgid "" "Optional *_mangle_from_* and *maxheaderlen* are as with the :class:" @@ -284,8 +285,8 @@ msgstr "Przypisy" msgid "" "This statement assumes that you use the appropriate setting for " -"``unixfrom``, and that there are no :mod:`policy` settings calling for " -"automatic adjustments (for example, :attr:`~email.policy.Policy." +"``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 " diff --git a/library/email.header.po b/library/email.header.po new file mode 100644 index 0000000000..d1a3e703c1 --- /dev/null +++ b/library/email.header.po @@ -0,0 +1,255 @@ +# 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:05+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:`email.header`: Internationalized headers" +msgstr "" + +msgid "**Source code:** :source:`Lib/email/header.py`" +msgstr "" + +msgid "" +"This module is part of the legacy (``Compat32``) email API. In the current " +"API encoding and decoding of headers is handled transparently by the " +"dictionary-like API of the :class:`~email.message.EmailMessage` class. In " +"addition to uses in legacy code, this module can be useful in applications " +"that need to completely control the character sets used when encoding " +"headers." +msgstr "" + +msgid "" +"The remaining text in this section is the original documentation of the " +"module." +msgstr "" + +msgid "" +":rfc:`2822` is the base standard that describes the format of email " +"messages. It derives from the older :rfc:`822` standard which came into " +"widespread use at a time when most email was composed of ASCII characters " +"only. :rfc:`2822` is a specification written assuming email contains only 7-" +"bit ASCII characters." +msgstr "" + +msgid "" +"Of course, as email has been deployed worldwide, it has become " +"internationalized, such that language specific character sets can now be " +"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." +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::" +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." +msgstr "" + +msgid "Here is the :class:`Header` class description:" +msgstr "" + +msgid "" +"Create a MIME-compliant header that can contain strings in different " +"character sets." +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." +msgstr "" + +msgid "" +"Optional *charset* serves two purposes: it has the same meaning as the " +"*charset* argument to the :meth:`append` method. It also sets the default " +"character set for all subsequent :meth:`append` calls that omit the " +"*charset* argument. If *charset* is not provided in the constructor (the " +"default), the ``us-ascii`` character set is used both as *s*'s initial " +"charset and as the default for subsequent :meth:`append` calls." +msgstr "" + +msgid "" +"The maximum line length can be specified explicitly via *maxlinelen*. For " +"splitting the first line to a shorter value (to account for the field header " +"which isn't included in *s*, e.g. :mailheader:`Subject`) pass in the name of " +"the field in *header_name*. The default *maxlinelen* is 76, and the default " +"value for *header_name* is ``None``, meaning it is not taken into account " +"for the first line of a long, split header." +msgstr "" + +msgid "" +"Optional *continuation_ws* must be :rfc:`2822`\\ -compliant folding " +"whitespace, and is usually either a space or a hard tab character. This " +"character will be prepended to continuation lines. *continuation_ws* " +"defaults to a single space character." +msgstr "" + +msgid "" +"Optional *errors* is passed straight through to the :meth:`append` method." +msgstr "" + +msgid "Append the string *s* to the MIME header." +msgstr "" + +msgid "" +"Optional *charset*, if given, should be a :class:`~email.charset.Charset` " +"instance (see :mod:`email.charset`) or the name of a character set, which " +"will be converted to a :class:`~email.charset.Charset` instance. A value of " +"``None`` (the default) means that the *charset* given in the constructor is " +"used." +msgstr "" + +msgid "" +"*s* may be an instance of :class:`bytes` or :class:`str`. If it is an " +"instance of :class:`bytes`, then *charset* is the encoding of that byte " +"string, and a :exc:`UnicodeError` will be raised if the string cannot be " +"decoded with that character set." +msgstr "" + +msgid "" +"If *s* is an instance of :class:`str`, then *charset* is a hint specifying " +"the character set of the characters in the string." +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 " +"UnicodeError will be raised." +msgstr "" + +msgid "" +"Optional *errors* is passed as the errors argument to the decode call if *s* " +"is a byte string." +msgstr "" + +msgid "" +"Encode a message header into an RFC-compliant format, possibly wrapping long " +"lines and encapsulating non-ASCII parts in base64 or quoted-printable " +"encodings." +msgstr "" + +msgid "" +"Optional *splitchars* is a string containing characters which should be " +"given extra weight by the splitting algorithm during normal header " +"wrapping. This is in very rough support of :RFC:`2822`\\'s 'higher level " +"syntactic breaks': split points preceded by a splitchar are preferred " +"during line splitting, with the characters preferred in the order in which " +"they appear in the string. Space and tab may be included in the string to " +"indicate whether preference should be given to one over the other as a split " +"point when other split chars do not appear in the line being split. " +"Splitchars does not affect :RFC:`2047` encoded lines." +msgstr "" + +msgid "" +"*maxlinelen*, if given, overrides the instance's value for the maximum line " +"length." +msgstr "" + +msgid "" +"*linesep* specifies the characters used to separate the lines of the folded " +"header. It defaults to the most useful value for Python application code " +"(``\\n``), but ``\\r\\n`` can be specified in order to produce headers with " +"RFC-compliant line separators." +msgstr "" + +msgid "Added the *linesep* argument." +msgstr "" + +msgid "" +"The :class:`Header` class also provides a number of methods to support " +"standard operators and built-in functions." +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." +msgstr "" + +msgid "Added handling for the ``'unknown-8bit'`` charset." +msgstr "" + +msgid "" +"This method allows you to compare two :class:`Header` instances for equality." +msgstr "" + +msgid "" +"This method allows you to compare two :class:`Header` instances for " +"inequality." +msgstr "" + +msgid "" +"The :mod:`email.header` module also provides the following convenient " +"functions." +msgstr "" + +msgid "" +"Decode a message header value without converting the character set. The " +"header value is in *header*." +msgstr "" + +msgid "" +"This function returns a list of ``(decoded_string, charset)`` pairs " +"containing each of the decoded parts of the header. *charset* is ``None`` " +"for non-encoded parts of the header, otherwise a lower case string " +"containing the name of the character set specified in the encoded string." +msgstr "" + +msgid "Here's an example::" +msgstr "" + +msgid "" +"Create a :class:`Header` instance from a sequence of pairs as returned by :" +"func:`decode_header`." +msgstr "" + +msgid "" +":func:`decode_header` takes a header value string and returns a sequence of " +"pairs of the format ``(decoded_string, charset)`` where *charset* is the " +"name of the character set." +msgstr "" + +msgid "" +"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 similarity index 98% rename from library/email_headerregistry.po rename to library/email.headerregistry.po index 6dc0ca35db..3f2f2f64fb 100644 --- a/library/email_headerregistry.po +++ b/library/email.headerregistry.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/email.iterators.po b/library/email.iterators.po new file mode 100644 index 0000000000..e6a5318112 --- /dev/null +++ b/library/email.iterators.po @@ -0,0 +1,83 @@ +# 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:05+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:`email.iterators`: Iterators" +msgstr "" + +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." +msgstr "" + +msgid "" +"This iterates over all the payloads in all the subparts of *msg*, returning " +"the string payloads line-by-line. It skips over all the subpart headers, " +"and it skips over any subpart with a payload that isn't a Python string. " +"This is somewhat equivalent to reading the flat text representation of the " +"message from a file using :meth:`~io.TextIOBase.readline`, skipping over all " +"the intervening headers." +msgstr "" + +msgid "" +"Optional *decode* is passed through to :meth:`Message.get_payload `." +msgstr "" + +msgid "" +"This iterates over all the subparts of *msg*, returning only those subparts " +"that match the MIME type specified by *maintype* and *subtype*." +msgstr "" + +msgid "" +"Note that *subtype* is optional; if omitted, then subpart MIME type matching " +"is done only with the main type. *maintype* is optional too; it defaults " +"to :mimetype:`text`." +msgstr "" + +msgid "" +"Thus, by default :func:`typed_subpart_iterator` returns each subpart that " +"has a MIME type of :mimetype:`text/\\*`." +msgstr "" + +msgid "" +"The following function has been added as a useful debugging tool. It should " +"*not* be considered part of the supported public interface for the package." +msgstr "" + +msgid "" +"Prints an indented representation of the content types of the message object " +"structure. For example:" +msgstr "" + +msgid "" +"Optional *fp* is a file-like object to print the output to. It must be " +"suitable for Python's :func:`print` function. *level* is used internally. " +"*include_default*, if true, prints the default type as well." +msgstr "" diff --git a/library/email_message.po b/library/email.message.po similarity index 94% rename from library/email_message.po rename to library/email.message.po index 4cc2e2e199..617a64d698 100644 --- a/library/email_message.po +++ b/library/email.message.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -67,10 +67,9 @@ msgid "" "The :class:`EmailMessage` dictionary-like interface is indexed by the header " "names, which must be ASCII values. The values of the dictionary are strings " "with some extra methods. Headers are stored and returned in case-preserving " -"form, but field names are matched case-insensitively. Unlike a real dict, " -"there is an ordering to the keys, and there can be duplicate keys. " -"Additional methods are provided for working with headers that have duplicate " -"keys." +"form, but field names are matched case-insensitively. The keys are ordered, " +"but unlike a real dict, there can be duplicates. Addtional methods are " +"provided for working with headers that have duplicate keys." msgstr "" msgid "" @@ -95,9 +94,9 @@ msgid "" "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.EmailPolicy.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 " +"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 "" @@ -240,11 +239,11 @@ msgid "" msgstr "" msgid "" -"If the :mod:`policy` defines certain headers to be unique (as the standard " -"policies do), this method may raise a :exc:`ValueError` when an attempt is " -"made to assign a value to such a header when one already exists. This " -"behavior is intentional for consistency's sake, but do not depend on it as " -"we may choose to make such assignments do an automatic deletion of the " +"If the :mod:`policy ` defines certain headers to be unique (as " +"the standard policies do), this method may raise a :exc:`ValueError` when an " +"attempt is made to assign a value to such a header when one already exists. " +"This behavior is intentional for consistency's sake, but do not depend on it " +"as we may choose to make such assignments do an automatic deletion of the " "existing header in the future." msgstr "" @@ -267,8 +266,8 @@ msgstr "" msgid "" "Return the value of the named header field. This is identical to :meth:" -"`__getitem__` except that optional *failobj* is returned if the named header " -"is missing (*failobj* defaults to ``None``)." +"`~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:" @@ -396,8 +395,8 @@ msgstr "" msgid "" "Note that existing parameter values of headers may be accessed through the :" -"attr:`~email.headerregistry.BaseHeader.params` attribute of the header value " -"(for example, ``msg['Content-Type'].params['charset']``)." +"attr:`~email.headerregistry.ParameterizedMIMEHeader.params` attribute of the " +"header value (for example, ``msg['Content-Type'].params['charset']``)." msgstr "" msgid "``replace`` keyword was added." @@ -661,8 +660,8 @@ msgid "Remove the payload and all of the headers." msgstr "" msgid "" -"Remove the payload and all of the :exc:`Content-` headers, leaving all other " -"headers intact and in their original order." +"Remove the payload and all of the :mailheader:`!Content-` headers, leaving " +"all other headers intact and in their original order." msgstr "" msgid ":class:`EmailMessage` objects have the following instance attributes:" diff --git a/library/email.mime.po b/library/email.mime.po new file mode 100644 index 0000000000..3ab18d1a50 --- /dev/null +++ b/library/email.mime.po @@ -0,0 +1,265 @@ +# 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:05+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:`email.mime`: Creating email and MIME objects from scratch" +msgstr "" + +msgid "**Source code:** :source:`Lib/email/mime/`" +msgstr "" + +msgid "" +"This module is part of the legacy (``Compat32``) email API. Its " +"functionality is partially replaced by the :mod:`~email.contentmanager` in " +"the new API, but in certain applications these classes may still be useful, " +"even in non-legacy code." +msgstr "" + +msgid "" +"Ordinarily, you get a message object structure by passing a file or some " +"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." +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." +msgstr "" + +msgid "Here are the classes:" +msgstr "" + +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 " +"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 `." +msgstr "" + +msgid "" +"If *policy* is specified, (defaults to the :class:`compat32 ` policy) it will be passed to :class:`~email.message.Message`." +msgstr "" + +msgid "" +"The :class:`MIMEBase` class always adds a :mailheader:`Content-Type` header " +"(based on *_maintype*, *_subtype*, and *_params*), and a :mailheader:`MIME-" +"Version` header (always set to ``1.0``)." +msgstr "" + +msgid "Added *policy* keyword-only parameter." +msgstr "" + +msgid "Module: :mod:`email.mime.nonmultipart`" +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, " +"a :exc:`~email.errors.MultipartConversionError` exception is raised." +msgstr "" + +msgid "Module: :mod:`email.mime.multipart`" +msgstr "" + +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." +msgstr "" + +msgid "" +"Optional *boundary* is the multipart boundary string. When ``None`` (the " +"default), the boundary is calculated when needed (for example, when the " +"message is serialized)." +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." +msgstr "" + +msgid "" +"Optional *policy* argument defaults to :class:`compat32 `." +msgstr "" + +msgid "" +"Additional parameters for the :mailheader:`Content-Type` header are taken " +"from the keyword arguments, or passed into the *_params* argument, which is " +"a keyword dictionary." +msgstr "" + +msgid "Module: :mod:`email.mime.application`" +msgstr "" + +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 " +"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." +msgstr "" + +msgid "*_params* are passed straight through to the base class constructor." +msgstr "" + +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." +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." +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 " +"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." +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." +msgstr "" + +msgid "" +"*_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." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"Unless the *_charset* argument is explicitly set to ``None``, the MIMEText " +"object created will have both a :mailheader:`Content-Type` header with a " +"``charset`` parameter, and a :mailheader:`Content-Transfer-Encoding` " +"header. This means that a subsequent ``set_payload`` call will not result " +"in an encoded payload, even if a charset is passed in the ``set_payload`` " +"command. You can \"reset\" this behavior by deleting the ``Content-Transfer-" +"Encoding`` header, after which a ``set_payload`` call will automatically " +"encode the new payload (and add a new :mailheader:`Content-Transfer-" +"Encoding` header)." +msgstr "" + +msgid "*_charset* also accepts :class:`~email.charset.Charset` instances." +msgstr "" diff --git a/library/email.parser.po b/library/email.parser.po new file mode 100644 index 0000000000..19b5a47307 --- /dev/null +++ b/library/email.parser.po @@ -0,0 +1,329 @@ +# 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:05+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:`email.parser`: Parsing email messages" +msgstr "" + +msgid "**Source code:** :source:`Lib/email/parser.py`" +msgstr "" + +msgid "" +"Message object structures can be created in one of two ways: they can be " +"created from whole cloth by creating an :class:`~email.message.EmailMessage` " +"object, adding headers using the dictionary interface, and adding payload(s) " +"using :meth:`~email.message.EmailMessage.set_content` and related methods, " +"or they can be created by parsing a serialized representation of the email " +"message." +msgstr "" + +msgid "" +"The :mod:`email` package provides a standard parser that understands most " +"email document structures, including MIME documents. You can pass the " +"parser a bytes, string or file object, and the parser will return to you the " +"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`." +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." +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 :mod:`policy` class, so a " +"custom parser can create message object trees any way it finds necessary by " +"implementing custom versions of the appropriate :mod:`policy` methods." +msgstr "" + +msgid "FeedParser API" +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"The :class:`BytesFeedParser`'s API is simple; you create an instance, feed " +"it a bunch of bytes until there's no more to feed it, then close the parser " +"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." +msgstr "" + +msgid "Here is the API for the :class:`BytesFeedParser`:" +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." +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." +msgstr "" + +msgid "" +"Note: **The policy keyword should always be specified**; The default will " +"change to :data:`email.policy.default` in a future version of Python." +msgstr "" + +msgid "Added the *policy* keyword." +msgstr "" + +msgid "*_factory* defaults to the policy ``message_factory``." +msgstr "" + +msgid "" +"Feed the parser some more data. *data* should be a :term:`bytes-like " +"object` containing one or more lines. The lines can be partial and the " +"parser will stitch such partial lines together properly. The lines can have " +"any of the three common line endings: carriage return, newline, or carriage " +"return and newline (they can even be mixed)." +msgstr "" + +msgid "" +"Complete the parsing of all previously fed data and return the root message " +"object. It is undefined what happens if :meth:`~feed` is called after this " +"method has been called." +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.Policy.utf8` is " +"``True``, no binary attachments." +msgstr "" + +msgid "Parser API" +msgstr "" + +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." +msgstr "" + +msgid "" +"Create a :class:`BytesParser` instance. The *_class* and *policy* arguments " +"have the same meaning and semantics as the *_factory* and *policy* arguments " +"of :class:`BytesFeedParser`." +msgstr "" + +msgid "" +"Removed the *strict* argument that was deprecated in 2.4. Added the " +"*policy* keyword." +msgstr "" + +msgid "*_class* defaults to the policy ``message_factory``." +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.IOBase.read` methods." +msgstr "" + +msgid "" +"The bytes contained in *fp* must be formatted as a block of :rfc:`5322` (or, " +"if :attr:`~email.policy.Policy.utf8` is ``True``, :rfc:`6532`) style 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``)." +msgstr "" + +msgid "" +"Optional *headersonly* is a flag specifying whether to stop parsing after " +"reading the headers or not. The default is ``False``, meaning it parses the " +"entire contents of the file." +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`." +msgstr "" + +msgid "Optional *headersonly* is as with the :meth:`parse` method." +msgstr "" + +msgid "" +"Exactly like :class:`BytesParser`, except that *headersonly* defaults to " +"``True``." +msgstr "" + +msgid "" +"This class is parallel to :class:`BytesParser`, but handles string input." +msgstr "" + +msgid "Removed the *strict* argument. Added the *policy* keyword." +msgstr "" + +msgid "" +"Read all the data from the text-mode file-like object *fp*, parse the " +"resulting text, and return the root message object. *fp* must support both " +"the :meth:`~io.TextIOBase.readline` and the :meth:`~io.TextIOBase.read` " +"methods on file-like objects." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "" +"Exactly like :class:`Parser`, except that *headersonly* defaults to ``True``." +msgstr "" + +msgid "" +"Since creating a message object structure from a string or a file object is " +"such a common task, four functions are provided as a convenience. They are " +"available in the top-level :mod:`email` package namespace." +msgstr "" + +msgid "" +"Return a message object structure from a :term:`bytes-like object`. This is " +"equivalent to ``BytesParser().parsebytes(s)``. Optional *_class* and " +"*policy* are interpreted as with the :class:`~email.parser.BytesParser` " +"class constructor." +msgstr "" + +msgid "" +"Return a message object structure tree from an open binary :term:`file " +"object`. This is equivalent to ``BytesParser().parse(fp)``. *_class* and " +"*policy* are interpreted as with the :class:`~email.parser.BytesParser` " +"class constructor." +msgstr "" + +msgid "" +"Return a message object structure from a string. This is equivalent to " +"``Parser().parsestr(s)``. *_class* and *policy* are interpreted as with " +"the :class:`~email.parser.Parser` class constructor." +msgstr "" + +msgid "" +"Return a message object structure tree from an open :term:`file object`. " +"This is equivalent to ``Parser().parse(fp)``. *_class* and *policy* are " +"interpreted as with the :class:`~email.parser.Parser` class constructor." +msgstr "" + +msgid "" +"Here's an example of how you might use :func:`message_from_bytes` at an " +"interactive Python prompt::" +msgstr "" + +msgid "Additional notes" +msgstr "" + +msgid "Here are some notes on the parsing semantics:" +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." +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." +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." +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." +msgstr "" diff --git a/library/email_policy.po b/library/email.policy.po similarity index 96% rename from library/email_policy.po rename to library/email.policy.po index 865c4d2cae..e9213a785c 100644 --- a/library/email_policy.po +++ b/library/email.policy.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2021, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# m_aciek , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.10\n" +"Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-06-29 12:56+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: m_aciek , 2021\n" -"Language-Team: Polish (https://www.transifex.com/python-doc/teams/5390/pl/)\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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" @@ -179,7 +179,7 @@ msgid "" msgstr "" msgid "``7bit``" -msgstr "" +msgstr "``7bit``" msgid "" "all data must be \"7 bit clean\" (ASCII-only). This means that where " @@ -188,7 +188,7 @@ msgid "" msgstr "" msgid "``8bit``" -msgstr "" +msgstr "``8bit``" msgid "" "data is not constrained to be 7 bit clean. Data in headers is still " @@ -216,15 +216,26 @@ msgid "" "being serialized by a generator. Default: :const:`False`." msgstr "" -msgid "The *mangle_from_* parameter." -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." 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." +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." +msgstr "" + msgid "" "The following :class:`Policy` method is intended to be called by code using " "the email library to create policy instances with custom settings:" @@ -406,13 +417,13 @@ msgid "" msgstr "" msgid "``none``" -msgstr "" +msgstr "``none``" msgid "all source values use original folding" msgstr "" msgid "``long``" -msgstr "" +msgstr "``long``" msgid "" "source values that have any line that is longer than ``max_line_length`` " @@ -420,7 +431,7 @@ msgid "" msgstr "" msgid "``all``" -msgstr "" +msgstr "``all``" msgid "all values are refolded." msgstr "" diff --git a/library/email_utils.po b/library/email.utils.po similarity index 94% rename from library/email_utils.po rename to library/email.utils.po index b514e5744a..dda44ce017 100644 --- a/library/email_utils.po +++ b/library/email.utils.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -85,6 +85,13 @@ msgid "" "unless the parse fails, in which case a 2-tuple of ``('', '')`` is returned." msgstr "" +msgid "" +"If *strict* is true, use a strict parser which rejects malformed inputs." +msgstr "" + +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 :" @@ -105,8 +112,10 @@ 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 `. " -"Here's a simple example that gets all the recipients of a message::" +"be returned by :meth:`Message.get_all `." +msgstr "" + +msgid "Here's a simple example that gets all the recipients of a message::" msgstr "" msgid "" diff --git a/library/email_util.po b/library/email_util.po deleted file mode 100644 index c7b8a5ac4e..0000000000 --- a/library/email_util.po +++ /dev/null @@ -1,222 +0,0 @@ -# SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2018, Python Software Foundation -# This file is distributed under the same license as the Python package. -# FIRST AUTHOR , YEAR. -# -# Translators: -# m_aciek , 2019 -# -#, fuzzy -msgid "" -msgstr "" -"Project-Id-Version: Python 3.7\n" -"Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2018-06-30 05:56+0900\n" -"PO-Revision-Date: 2017-02-16 23:09+0000\n" -"Last-Translator: m_aciek , 2019\n" -"Language-Team: Polish (https://www.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:`email.utils`: Miscellaneous utilities" -msgstr "" - -msgid "**Source code:** :source:`Lib/email/utils.py`" -msgstr "" - -msgid "" -"There are a couple of useful utilities provided in the :mod:`email.utils` " -"module:" -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. In this case, a positive or " -"zero value for *isdst* causes ``localtime`` to presume initially that summer " -"time (for example, Daylight Saving Time) is or is not (respectively) in " -"effect for the specified time. A negative value for *isdst* causes the " -"``localtime`` to attempt to divine whether summer time is in effect for the " -"specified time." -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." -msgstr "" - -msgid "Added the *domain* keyword." -msgstr "" - -msgid "" -"The remaining functions are part of the legacy (``Compat32``) email API. " -"There is no need to directly use these with the new API, since the parsing " -"and formatting they provide is done automatically by the header parsing " -"machinery of the new API." -msgstr "" - -msgid "" -"Return a new string with backslashes in *str* replaced by two backslashes, " -"and double quotes replaced by backslash-double quote." -msgstr "" - -msgid "" -"Return a new string which is an *unquoted* version of *str*. If *str* ends " -"and begins with double quotes, they are stripped off. Likewise if *str* " -"ends and begins with angle brackets, they are stripped off." -msgstr "" - -msgid "" -"Parse address -- which should be the value of some address-containing field " -"such as :mailheader:`To` or :mailheader:`Cc` -- into its constituent " -"*realname* and *email address* parts. Returns a tuple of that information, " -"unless the parse fails, in which case a 2-tuple of ``('', '')`` is returned." -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." -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``." -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 `. " -"Here's a simple example that gets all the recipients of a message::" -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." -msgstr "" - -msgid "" -"Performs the same function as :func:`parsedate`, but returns either ``None`` " -"or a 10-tuple; the first 9 elements make up a tuple that can be passed " -"directly to :func:`time.mktime`, and the tenth is the offset of the date's " -"timezone from UTC (which is the official term for Greenwich Mean Time) " -"[#]_. If the input string has no timezone, the last element of the tuple " -"returned is ``None``. Note that indexes 6, 7, and 8 of the result tuple are " -"not usable." -msgstr "" - -msgid "" -"The inverse of :func:`format_datetime`. Performs the same function as :func:" -"`parsedate`, but on success returns a :mod:`~datetime.datetime`. 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`." -msgstr "" - -msgid "" -"Turn a 10-tuple as returned by :func:`parsedate_tz` into a UTC timestamp " -"(seconds since the Epoch). If the timezone item in the tuple is ``None``, " -"assume local time." -msgstr "" - -msgid "Returns a date string as per :rfc:`2822`, e.g.::" -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." -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 " -"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``. " -"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." -msgstr "" - -msgid "Decode the string *s* according to :rfc:`2231`." -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* 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'``." -msgstr "" - -msgid "" -"For convenience, if the *value* passed to :func:`collapse_rfc2231_value` is " -"not a tuple, it should be a string and it is returned unquoted." -msgstr "" - -msgid "" -"Decode parameters list according to :rfc:`2231`. *params* is a sequence of " -"2-tuples containing elements of the form ``(content-type, string-value)``." -msgstr "" - -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`." -msgstr "" diff --git a/library/ensurepip.po b/library/ensurepip.po new file mode 100644 index 0000000000..52d9fb56ae --- /dev/null +++ b/library/ensurepip.po @@ -0,0 +1,200 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`ensurepip` --- Bootstrapping the ``pip`` installer" +msgstr "" + +msgid "**Source code:** :source:`Lib/ensurepip`" +msgstr "" + +msgid "" +"The :mod:`ensurepip` package provides support for bootstrapping the ``pip`` " +"installer into an existing Python installation or virtual environment. This " +"bootstrapping approach reflects the fact that ``pip`` is an independent " +"project with its own release cycle, and the latest available stable version " +"is bundled with maintenance and feature releases of the CPython reference " +"interpreter." +msgstr "" + +msgid "" +"In most cases, end users of Python shouldn't need to invoke this module " +"directly (as ``pip`` should be bootstrapped by default), but it may be " +"needed if installing ``pip`` was skipped when installing Python (or when " +"creating a virtual environment) or after explicitly uninstalling ``pip``." +msgstr "" + +msgid "" +"This module *does not* access the internet. All of the components needed to " +"bootstrap ``pip`` are included as internal parts of the package." +msgstr "" + +msgid ":ref:`installing-index`" +msgstr ":ref:`installing-index`" + +msgid "The end user guide for installing Python packages" +msgstr "" +"Podręcznik użytkownika końcowego dotyczący instalowania pakietów języka " +"Python" + +msgid ":pep:`453`: Explicit bootstrapping of pip in Python installations" +msgstr "" + +msgid "The original rationale and specification for this module." +msgstr "Oryginalne uzasadnienie i specyfikacja tego modułu." + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + +msgid "Command line interface" +msgstr "Interfejs wiersza poleceń" + +msgid "" +"The command line interface is invoked using the interpreter's ``-m`` switch." +msgstr "" + +msgid "The simplest possible invocation is::" +msgstr "Najprostszym możliwym wywołaniem jest:" + +msgid "" +"This invocation will install ``pip`` if it is not already installed, but " +"otherwise does nothing. To ensure the installed version of ``pip`` is at " +"least as recent as the one available in ``ensurepip``, pass the ``--" +"upgrade`` option::" +msgstr "" + +msgid "" +"By default, ``pip`` is installed into the current virtual environment (if " +"one is active) or into the system site packages (if there is no active " +"virtual environment). The installation location can be controlled through " +"two additional command line options:" +msgstr "" + +msgid "" +":samp:`--root {dir}`: Installs ``pip`` relative to the given root directory " +"rather than the root of the currently active virtual environment (if any) or " +"the default root for the current Python installation." +msgstr "" + +msgid "" +"``--user``: Installs ``pip`` into the user site packages directory rather " +"than globally for the current Python installation (this option is not " +"permitted inside an active virtual environment)." +msgstr "" + +msgid "" +"By default, the scripts ``pipX`` and ``pipX.Y`` will be installed (where X.Y " +"stands for the version of Python used to invoke ``ensurepip``). The scripts " +"installed can be controlled through two additional command line options:" +msgstr "" + +msgid "" +"``--altinstall``: if an alternate installation is requested, the ``pipX`` " +"script will *not* be installed." +msgstr "" + +msgid "" +"``--default-pip``: if a \"default pip\" installation is requested, the " +"``pip`` script will be installed in addition to the two regular scripts." +msgstr "" + +msgid "" +"Providing both of the script selection options will trigger an exception." +msgstr "Podanie obu opcji wyboru skryptu spowoduje wyzwolenie wyjątku." + +msgid "Module API" +msgstr "" + +msgid ":mod:`ensurepip` exposes two functions for programmatic use:" +msgstr "" + +msgid "" +"Returns a string specifying the available version of pip that will be " +"installed when bootstrapping an environment." +msgstr "" + +msgid "Bootstraps ``pip`` into the current or designated environment." +msgstr "" + +msgid "" +"*root* specifies an alternative root directory to install relative to. If " +"*root* is ``None``, then installation uses the default install location for " +"the current environment." +msgstr "" + +msgid "" +"*upgrade* indicates whether or not to upgrade an existing installation of an " +"earlier version of ``pip`` to the available version." +msgstr "" + +msgid "" +"*user* indicates whether to use the user scheme rather than installing " +"globally." +msgstr "" + +msgid "" +"By default, the scripts ``pipX`` and ``pipX.Y`` will be installed (where X.Y " +"stands for the current version of Python)." +msgstr "" + +msgid "If *altinstall* is set, then ``pipX`` will *not* be installed." +msgstr "" + +msgid "" +"If *default_pip* is set, then ``pip`` will be installed in addition to the " +"two regular scripts." +msgstr "" + +msgid "" +"Setting both *altinstall* and *default_pip* will trigger :exc:`ValueError`." +msgstr "" + +msgid "" +"*verbosity* controls the level of output to :data:`sys.stdout` from the " +"bootstrapping operation." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``ensurepip.bootstrap`` with " +"argument ``root``." +msgstr "" + +msgid "" +"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 "" + +msgid "" +"The bootstrapping process may install additional modules required by " +"``pip``, but other software should not assume those dependencies will always " +"be present by default (as the dependencies may be removed in a future " +"version of ``pip``)." +msgstr "" diff --git a/library/enum.po b/library/enum.po index 914bd779b3..fffe41679f 100644 --- a/library/enum.po +++ b/library/enum.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,19 +91,19 @@ msgid "Module Contents" msgstr "" msgid ":class:`EnumType`" -msgstr "" +msgstr ":class:`EnumType`" msgid "The ``type`` for Enum and its subclasses." msgstr "" msgid ":class:`Enum`" -msgstr "" +msgstr ":class:`Enum`" msgid "Base class for creating enumerated constants." msgstr "" msgid ":class:`IntEnum`" -msgstr "" +msgstr ":class:`IntEnum`" msgid "" "Base class for creating enumerated constants that are also subclasses of :" @@ -111,7 +111,7 @@ msgid "" msgstr "" msgid ":class:`StrEnum`" -msgstr "" +msgstr ":class:`StrEnum`" msgid "" "Base class for creating enumerated constants that are also subclasses of :" @@ -119,7 +119,7 @@ msgid "" msgstr "" msgid ":class:`Flag`" -msgstr "" +msgstr ":class:`Flag`" msgid "" "Base class for creating enumerated constants that can be combined using the " @@ -127,7 +127,7 @@ msgid "" msgstr "" msgid ":class:`IntFlag`" -msgstr "" +msgstr ":class:`IntFlag`" msgid "" "Base class for creating enumerated constants that can be combined using the " @@ -136,7 +136,7 @@ msgid "" msgstr "" msgid ":class:`ReprEnum`" -msgstr "" +msgstr ":class:`ReprEnum`" msgid "" "Used by :class:`IntEnum`, :class:`StrEnum`, and :class:`IntFlag` to keep " @@ -144,7 +144,7 @@ msgid "" msgstr "" msgid ":class:`EnumCheck`" -msgstr "" +msgstr ":class:`EnumCheck`" msgid "" "An enumeration with the values ``CONTINUOUS``, ``NAMED_FLAGS``, and " @@ -153,7 +153,7 @@ msgid "" msgstr "" msgid ":class:`FlagBoundary`" -msgstr "" +msgstr ":class:`FlagBoundary`" msgid "" "An enumeration with the values ``STRICT``, ``CONFORM``, ``EJECT``, and " @@ -162,7 +162,7 @@ msgid "" msgstr "" msgid ":class:`auto`" -msgstr "" +msgstr ":class:`auto`" msgid "" "Instances are replaced with an appropriate value for Enum members. :class:" @@ -171,7 +171,7 @@ msgid "" msgstr "" msgid ":func:`~enum.property`" -msgstr "" +msgstr ":func:`~enum.property`" msgid "" "Allows :class:`Enum` members to have attributes without conflicting with " @@ -179,14 +179,14 @@ msgid "" msgstr "" msgid ":func:`unique`" -msgstr "" +msgstr ":func:`unique`" msgid "" "Enum class decorator that ensures only one name is bound to any one value." msgstr "" msgid ":func:`verify`" -msgstr "" +msgstr ":func:`verify`" msgid "" "Enum class decorator that checks user-selectable constraints on an " @@ -194,19 +194,19 @@ msgid "" msgstr "" msgid ":func:`member`" -msgstr "" +msgstr ":func:`member`" msgid "Make ``obj`` a member. Can be used as a decorator." msgstr "" msgid ":func:`nonmember`" -msgstr "" +msgstr ":func:`nonmember`" msgid "Do not make ``obj`` a member. Can be used as a decorator." msgstr "" msgid ":func:`global_enum`" -msgstr "" +msgstr ":func:`global_enum`" msgid "" "Modify the :class:`str() ` and :func:`repr` of an enum to show its " @@ -215,7 +215,7 @@ msgid "" msgstr "" msgid ":func:`show_flag_values`" -msgstr "" +msgstr ":func:`show_flag_values`" msgid "Return a list of all power-of-two integers contained in a flag." msgstr "" @@ -289,7 +289,7 @@ msgid "The actual location in the module where this Enum can be found." msgstr "" msgid "type" -msgstr "" +msgstr "typ" msgid "A mix-in type for the new Enum." msgstr "" @@ -340,6 +340,9 @@ msgstr "" msgid "Returns each member in *cls* in reverse definition order::" msgstr "" +msgid "Before 3.11 ``enum`` used ``EnumMeta`` type, which is kept as an alias." +msgstr "" + msgid "*Enum* is the base class for all *enum* enumerations." msgstr "" @@ -349,6 +352,9 @@ msgstr "" msgid "The value given to the ``Enum`` member::" msgstr "" +msgid "Value of the member, can be set in :meth:`~object.__new__`." +msgstr "" + msgid "Enum member values" msgstr "" @@ -358,6 +364,21 @@ msgid "" "appropriate value will be chosen for you. See :class:`auto` for the details." msgstr "" +msgid "" +"While mutable/unhashable values, such as :class:`dict`, :class:`list` or a " +"mutable :class:`~dataclasses.dataclass`, can be used, they will have a " +"quadratic performance impact during creation relative to the total number of " +"mutable/unhashable values in the enum." +msgstr "" + +msgid "Name of the member." +msgstr "" + +msgid "" +"No longer used, kept for backward compatibility. (class attribute, removed " +"during class creation)." +msgstr "" + msgid "" "``_ignore_`` is only used during creation and is removed from the " "enumeration once creation is complete." @@ -375,7 +396,7 @@ msgid "" msgstr "" msgid "name" -msgstr "" +msgstr "nazwa" msgid "The name of the member being defined (e.g. 'RED')." msgstr "" @@ -485,9 +506,6 @@ msgstr "" msgid "Returns all contained non-alias members::" msgstr "" -msgid "Aliases are no longer returned during iteration." -msgstr "" - msgid "Returns number of members in flag::" msgstr "" @@ -640,32 +658,31 @@ msgstr "" msgid "Supported ``_sunder_`` names" msgstr "" -msgid "``_name_`` -- name of the member" +msgid ":attr:`~Enum._name_` -- name of the member" msgstr "" -msgid "" -"``_value_`` -- value of the member; can be set / modified in ``__new__``" +msgid ":attr:`~Enum._value_` -- value of the member; can be set in ``__new__``" msgstr "" msgid "" -"``_missing_`` -- a lookup function used when a value is not found; may be " -"overridden" +":meth:`~Enum._missing_` -- a lookup function used when a value is not found; " +"may be overridden" msgstr "" msgid "" -"``_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 "" -"``_order_`` -- used in Python 2/3 code to ensure member order is consistent " +":attr:`~Enum._order_` -- no longer used, kept for backward compatibility " "(class attribute, removed during class creation)" msgstr "" msgid "" -"``_generate_next_value_`` -- used to get an appropriate value for an enum " -"member; may be overridden" +":meth:`~Enum._generate_next_value_` -- used to get an appropriate value for " +"an enum member; may be overridden" msgstr "" msgid "" @@ -679,10 +696,10 @@ msgid "" msgstr "" msgid "``_missing_``, ``_order_``, ``_generate_next_value_``" -msgstr "" +msgstr "``_missing_``, ``_order_``, ``_generate_next_value_``" msgid "``_ignore_``" -msgstr "" +msgstr "``_ignore_``" msgid "Utilities and Decorators" msgstr "" @@ -706,10 +723,7 @@ msgstr "" msgid "" "``SECOND = auto(), -2`` will work (auto is replaced with ``2``, so ``2, -2`` " -"is" -msgstr "" - -msgid "used to create the ``SECOND`` enum member;" +"is used to create the ``SECOND`` enum member;" msgstr "" msgid "" diff --git a/library/exceptions.po b/library/exceptions.po index 3ef353846b..786fdff612 100644 --- a/library/exceptions.po +++ b/library/exceptions.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -36,12 +36,12 @@ msgid "" msgstr "" msgid "" -"The built-in exceptions listed below 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." +"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 "" @@ -63,9 +63,14 @@ 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 " +"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." @@ -78,21 +83,21 @@ 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 " +"``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 " +"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." +"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 "" @@ -154,6 +159,11 @@ msgid "" "it to propagate to the caller. ::" 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 " @@ -235,10 +245,14 @@ msgid "" msgstr "" msgid "" -"The :attr:`name` and :attr:`path` attributes can be set using keyword-only " -"arguments to the constructor. When set they represent the name of the module " -"that was attempted to be imported and the path to any file which triggered " -"the exception, respectively." +"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." @@ -316,9 +330,9 @@ msgid "" msgstr "" msgid "" -"``NotImplementedError`` and ``NotImplemented`` are not interchangeable, even " -"though they have similar names and purposes. See :data:`NotImplemented` for " -"details on when to use it." +"``NotImplementedError`` and :data:`NotImplemented` are not interchangeable, " +"even though they have similar names and purposes. See :data:`!" +"NotImplemented` for details on when to use it." msgstr "" msgid "" @@ -424,8 +438,9 @@ msgid "" 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`." +"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 "" @@ -456,7 +471,7 @@ msgid "" msgstr "" msgid "" -"Must be raised by :meth:`__anext__` method of an :term:`asynchronous " +"Must be raised by :meth:`~object.__anext__` method of an :term:`asynchronous " "iterator` object to stop the iteration." msgstr "" @@ -656,9 +671,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:data:`~errno." -"EAGAIN`, :py:data:`~errno.EALREADY`, :py:data:`~errno.EWOULDBLOCK` and :py:" -"data:`~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 "" @@ -674,7 +689,7 @@ msgstr "" msgid "" "Raised when an operation on a child process failed. Corresponds to :c:data:" -"`errno` :py:data:`~errno.ECHILD`." +"`errno` :py:const:`~errno.ECHILD`." msgstr "" msgid "A base class for connection-related issues." @@ -688,40 +703,40 @@ 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:data:" -"`~errno.EPIPE` and :py:data:`~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:data:`~errno." +"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:data:`~errno." +"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:data:`~errno.ECONNRESET`." +"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:data:`~errno.EEXIST`." +"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:data:`~errno.ENOENT`." +"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:data:`~errno.EINTR`." +"to :c:data:`errno` :py:const:`~errno.EINTR`." msgstr "" msgid "" @@ -732,35 +747,37 @@ msgstr "" msgid "" "Raised when a file operation (such as :func:`os.remove`) is requested on a " -"directory. Corresponds to :c:data:`errno` :py:data:`~errno.EISDIR`." +"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:data:`~errno." +"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:data:" -"`~errno.EACCES`, :py:data:`~errno.EPERM`, and :py:data:`~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:data:`~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:data:`~errno.ESRCH`." +"py:const:`~errno.ESRCH`." msgstr "" msgid "" "Raised when a system function timed out at the system level. Corresponds to :" -"c:data:`errno` :py:data:`~errno.ETIMEDOUT`." +"c:data:`errno` :py:const:`~errno.ETIMEDOUT`." msgstr "" msgid "All the above :exc:`OSError` subclasses were added." @@ -894,8 +911,9 @@ msgstr "" msgid "" "The nesting structure of the current exception is preserved in the result, " -"as are the values of its :attr:`message`, :attr:`__traceback__`, :attr:" -"`__cause__`, :attr:`__context__` and :attr:`__notes__` fields. Empty nested " +"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 "" @@ -923,18 +941,19 @@ msgid "" msgstr "" msgid "" -":meth:`subgroup` and :meth:`split` copy the :attr:`__traceback__`, :attr:" -"`__cause__`, :attr:`__context__` and :attr:`__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 "" -"Note that :exc:`BaseExceptionGroup` defines :meth:`__new__`, so subclasses " -"that need a different constructor signature need to override that rather " -"than :meth:`__init__`. For example, the following defines an exception group " -"subclass which accepts an exit_code and and constructs the group's message " -"from it. ::" +"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 and constructs the " +"group's message from it. ::" msgstr "" msgid "" @@ -961,6 +980,21 @@ 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 "" diff --git a/library/faulthandler.po b/library/faulthandler.po new file mode 100644 index 0000000000..1cf2b0551b --- /dev/null +++ b/library/faulthandler.po @@ -0,0 +1,216 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`faulthandler` --- Dump the Python traceback" +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:`SIGSEGV`, :const:" +"`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS`, and :const:`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 "" + +msgid "" +"The fault handler is compatible with system fault handlers like Apport or " +"the Windows fault handler. The module uses an alternative stack for signal " +"handlers if the :c:func:`sigaltstack` function is available. This allows it " +"to dump the traceback even on a stack overflow." +msgstr "" + +msgid "" +"The fault handler is called on catastrophic cases and therefore can only use " +"signal-safe functions (e.g. it cannot allocate memory on the heap). Because " +"of this limitation traceback dumping is minimal compared to normal Python " +"tracebacks:" +msgstr "" + +msgid "" +"Only ASCII is supported. The ``backslashreplace`` error handler is used on " +"encoding." +msgstr "" + +msgid "Each string is limited to 500 characters." +msgstr "" + +msgid "" +"Only the filename, the function name and the line number are displayed. (no " +"source code)" +msgstr "" + +msgid "It is limited to 100 frames and 100 threads." +msgstr "" + +msgid "The order is reversed: the most recent call is shown first." +msgstr "" + +msgid "" +"By default, the Python traceback is written to :data:`sys.stderr`. To see " +"tracebacks, applications must be run in the terminal. A log file can " +"alternatively be passed to :func:`faulthandler.enable`." +msgstr "" + +msgid "" +"The module is implemented in C, so tracebacks can be dumped on a crash or " +"when Python is deadlocked." +msgstr "" + +msgid "" +"The :ref:`Python Development Mode ` calls :func:`faulthandler." +"enable` at Python startup." +msgstr "" + +msgid "Module :mod:`pdb`" +msgstr "" + +msgid "Interactive source code debugger for Python programs." +msgstr "" + +msgid "Module :mod:`traceback`" +msgstr "" + +msgid "" +"Standard interface to extract, format and print stack traces of Python " +"programs." +msgstr "" + +msgid "Dumping the traceback" +msgstr "" + +msgid "" +"Dump the tracebacks of all threads into *file*. If *all_threads* is " +"``False``, dump only the current thread." +msgstr "" + +msgid "" +":func:`traceback.print_tb`, which can be used to print a traceback object." +msgstr "" + +msgid "Added support for passing file descriptor to this function." +msgstr "" + +msgid "Fault handler state" +msgstr "" + +msgid "" +"Enable the fault handler: install handlers for the :const:`SIGSEGV`, :const:" +"`SIGFPE`, :const:`SIGABRT`, :const:`SIGBUS` and :const:`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 `." +msgstr "" + +msgid "On Windows, a handler for Windows exception is also installed." +msgstr "" + +msgid "" +"The dump now mentions if a garbage collector collection is running if " +"*all_threads* is true." +msgstr "" + +msgid "" +"Disable the fault handler: uninstall the signal handlers installed by :func:" +"`enable`." +msgstr "" + +msgid "Check if the fault handler is enabled." +msgstr "" + +msgid "Dumping the tracebacks after a timeout" +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." +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 " +"descriptors `." +msgstr "" + +msgid "This function is implemented using a watchdog thread." +msgstr "" + +msgid "This function is now always available." +msgstr "" + +msgid "Cancel the last call to :func:`dump_traceback_later`." +msgstr "" + +msgid "Dumping the traceback on a user signal" +msgstr "" + +msgid "" +"Register a user signal: install a handler for the *signum* signal to dump " +"the traceback of all threads, or of the current thread if *all_threads* is " +"``False``, into *file*. Call the previous handler if chain is ``True``." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"Unregister a user signal: uninstall the handler of the *signum* signal " +"installed by :func:`register`. Return ``True`` if the signal was registered, " +"``False`` otherwise." +msgstr "" + +msgid "Issue with file descriptors" +msgstr "" + +msgid "" +":func:`enable`, :func:`dump_traceback_later` and :func:`register` keep the " +"file descriptor of their *file* argument. If the file is closed and its file " +"descriptor is reused by a new file, or if :func:`os.dup2` is used to replace " +"the file descriptor, the traceback will be written into a different file. " +"Call these functions again each time that the file is replaced." +msgstr "" + +msgid "Example" +msgstr "Przykład" + +msgid "" +"Example of a segmentation fault on Linux with and without enabling the fault " +"handler:" +msgstr "" diff --git a/library/fcntl.po b/library/fcntl.po new file mode 100644 index 0000000000..48bccc308d --- /dev/null +++ b/library/fcntl.po @@ -0,0 +1,261 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`fcntl` --- The ``fcntl`` and ``ioctl`` system calls" +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 " +"details." +msgstr "" + +msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." +msgstr "" + +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." +msgstr "" + +msgid "" +"Operations in this module used to raise an :exc:`IOError` where they now " +"raise an :exc:`OSError`." +msgstr "" + +msgid "" +"The fcntl module now contains ``F_ADD_SEALS``, ``F_GET_SEALS``, and " +"``F_SEAL_*`` constants for sealing of :func:`os.memfd_create` file " +"descriptors." +msgstr "" + +msgid "" +"On macOS, the fcntl module exposes the ``F_GETPATH`` constant, which obtains " +"the path of a file from a file descriptor. On Linux(>=3.15), the 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 "" + +msgid "" +"On Linux >= 2.6.11, the fcntl module exposes the ``F_GETPIPE_SZ`` and " +"``F_SETPIPE_SZ`` constants, which allow to check and modify a pipe's size " +"respectively." +msgstr "" + +msgid "" +"On FreeBSD, the fcntl module exposes the ``F_DUP2FD`` and " +"``F_DUP2FD_CLOEXEC`` constants, which allow to duplicate a file descriptor, " +"the latter setting ``FD_CLOEXEC`` flag in addition." +msgstr "" + +msgid "The module defines the following functions:" +msgstr "" + +msgid "" +"Perform the operation *cmd* on file descriptor *fd* (file objects providing " +"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, or a :class:" +"`bytes` object. With an integer value, the return value of this function is " +"the integer return value of the C :c:func:`fcntl` call. When the argument " +"is bytes it represents a binary structure, e.g. created by :func:`struct." +"pack`. The binary data is copied to a buffer whose address is passed to the " +"C :c:func:`fcntl` call. The return value after a successful call is the " +"contents of the buffer, converted to a :class:`bytes` object. The length of " +"the returned object will be the same as the length of the *arg* argument. " +"This is limited to 1024 bytes. If the information returned in the buffer by " +"the operating system is larger than 1024 bytes, this is most likely to " +"result in a segmentation violation or a more subtle data corruption." +msgstr "" + +msgid "If the :c:func:`fcntl` call fails, an :exc:`OSError` is raised." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``fcntl.fcntl`` with arguments " +"``fd``, ``cmd``, ``arg``." +msgstr "" + +msgid "" +"This function is identical to the :func:`~fcntl.fcntl` function, except that " +"the argument handling is even more complicated." +msgstr "" + +msgid "" +"The *request* parameter is limited to values that can fit in 32-bits. " +"Additional constants of interest for use as the *request* argument can be " +"found in the :mod:`termios` module, under the same names as used in the " +"relevant C header files." +msgstr "" + +msgid "" +"The parameter *arg* can be one of an integer, an object supporting the read-" +"only buffer interface (like :class:`bytes`) or an object supporting the read-" +"write buffer interface (like :class:`bytearray`)." +msgstr "" + +msgid "" +"In all but the last case, behaviour is as for the :func:`~fcntl.fcntl` " +"function." +msgstr "" + +msgid "" +"If a mutable buffer is passed, then the behaviour is determined by the value " +"of the *mutate_flag* parameter." +msgstr "" + +msgid "" +"If it is false, the buffer's mutability is ignored and behaviour is as for a " +"read-only buffer, except that the 1024 byte limit mentioned above is avoided " +"-- so long as the buffer you pass is at least as long as what the operating " +"system wants to put there, things should work." +msgstr "" + +msgid "" +"If *mutate_flag* is true (the default), then the buffer is (in effect) " +"passed to the underlying :func:`ioctl` system call, the latter's return code " +"is passed back to the calling Python, and the buffer's new contents reflect " +"the action of the :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." +msgstr "" + +msgid "" +"If the :c:func:`ioctl` call fails, an :exc:`OSError` exception is raised." +msgstr "" + +msgid "An example::" +msgstr "Przykład::" + +msgid "" +"Raises an :ref:`auditing event ` ``fcntl.ioctl`` with arguments " +"``fd``, ``request``, ``arg``." +msgstr "" + +msgid "" +"Perform the lock operation *operation* on file descriptor *fd* (file objects " +"providing a :meth:`~io.IOBase.fileno` method are accepted as well). See the " +"Unix manual :manpage:`flock(2)` for details. (On some systems, this " +"function is emulated using :c:func:`fcntl`.)" +msgstr "" + +msgid "" +"If the :c:func:`flock` call fails, an :exc:`OSError` exception is raised." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``fcntl.flock`` with arguments " +"``fd``, ``operation``." +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:" +msgstr "" + +msgid "Release an existing lock." +msgstr "" + +msgid "Acquire a shared lock." +msgstr "" + +msgid "Acquire an exclusive lock." +msgstr "" + +msgid "" +"Bitwise OR with any of the other three ``LOCK_*`` constants to make the " +"request non-blocking." +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." +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:" +msgstr "" + +msgid "``0`` -- relative to the start of the file (:const:`os.SEEK_SET`)" +msgstr "" + +msgid "``1`` -- relative to the current buffer position (:const:`os.SEEK_CUR`)" +msgstr "" + +msgid "``2`` -- relative to the end of the file (:const:`os.SEEK_END`)" +msgstr "" + +msgid "" +"The default for *start* is 0, which means to start at the beginning of the " +"file. The default for *len* is 0 which means to lock to the end of the " +"file. The default for *whence* is also 0." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``fcntl.lockf`` with arguments " +"``fd``, ``cmd``, ``len``, ``start``, ``whence``." +msgstr "" + +msgid "Examples (all on a SVR4 compliant system)::" +msgstr "" + +msgid "" +"Note that in the first example the return value variable *rv* will hold an " +"integer value; in the second example it will hold a :class:`bytes` object. " +"The structure lay-out for the *lockdata* variable is system dependent --- " +"therefore using the :func:`flock` call may be better." +msgstr "" + +msgid "Module :mod:`os`" +msgstr "" + +msgid "" +"If the locking flags :const:`~os.O_SHLOCK` and :const:`~os.O_EXLOCK` are " +"present in the :mod:`os` module (on BSD only), the :func:`os.open` function " +"provides an alternative to the :func:`lockf` and :func:`flock` functions." +msgstr "" + +msgid "UNIX" +msgstr "" + +msgid "file control" +msgstr "" + +msgid "I/O control" +msgstr "Kontrola I/O" diff --git a/library/fnmatch.po b/library/fnmatch.po index 0eccba9a86..606e283056 100644 --- a/library/fnmatch.po +++ b/library/fnmatch.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,25 +42,25 @@ msgid "Meaning" msgstr "Znaczenie" msgid "``*``" -msgstr "" +msgstr "``*``" msgid "matches everything" msgstr "" msgid "``?``" -msgstr "" +msgstr "``?``" msgid "matches any single character" msgstr "" msgid "``[seq]``" -msgstr "" +msgstr "``[seq]``" msgid "matches any character in *seq*" msgstr "" msgid "``[!seq]``" -msgstr "" +msgstr "``[!seq]``" msgid "matches any character not in *seq*" msgstr "" @@ -85,8 +85,8 @@ msgid "" msgstr "" msgid "" -"Test whether the *filename* string matches the *pattern* string, returning :" -"const:`True` or :const:`False`. Both parameters are case-normalized using :" +"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 " "operating system." @@ -98,24 +98,24 @@ msgid "" msgstr "" msgid "" -"Test whether *filename* matches *pattern*, returning :const:`True` or :const:" -"`False`; the comparison is case-sensitive and does not apply :func:`os.path." -"normcase`." +"Test whether the filename string *name* matches the pattern string *pat*, " +"returning ``True`` or ``False``; the comparison is case-sensitive and does " +"not apply :func:`os.path.normcase`." msgstr "" msgid "" -"Construct a list from those elements of the iterable *names* that match " -"*pattern*. It is the same as ``[n for n in names if fnmatch(n, pattern)]``, " -"but implemented more efficiently." +"Construct a list from those elements of the :term:`iterable` *names* that " +"match pattern *pat*. It is the same as ``[n for n in names if fnmatch(n, " +"pat)]``, but implemented more efficiently." msgstr "" msgid "" -"Return the shell-style *pattern* converted to a regular expression for using " -"with :func:`re.match`." +"Return the shell-style pattern *pat* converted to a regular expression for " +"using with :func:`re.match`." msgstr "" msgid "Example:" -msgstr "" +msgstr "Przykład:" msgid "Module :mod:`glob`" msgstr "" @@ -136,7 +136,7 @@ msgid "re" msgstr "" msgid "* (asterisk)" -msgstr "* (asterisk)" +msgstr "* (asterysk)" msgid "in glob-style wildcards" msgstr "" diff --git a/library/ftplib.po b/library/ftplib.po index d9f1de7e48..d39959e0c8 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,135 +53,108 @@ msgstr "" msgid "Here's a sample session using the :mod:`ftplib` module::" msgstr "" -msgid "The module defines the following items:" -msgstr "Moduł definiuje następujące pozycje:" - -msgid "" -"Return a new instance of the :class:`FTP` class. When *host* is given, the " -"method call ``connect(host)`` is made. When *user* is given, additionally " -"the method call ``login(user, passwd, acct)`` is made (where *passwd* and " -"*acct* default to the empty string when not given). The optional *timeout* " -"parameter specifies a timeout in seconds for blocking operations like the " -"connection attempt (if is not specified, the global default timeout setting " -"will be used). *source_address* is a 2-tuple ``(host, port)`` for the socket " -"to bind to as its source address before connecting. The *encoding* parameter " -"specifies the encoding for directories and filenames." +msgid "Reference" msgstr "" -msgid "The :class:`FTP` class supports the :keyword:`with` statement, e.g.:" +msgid "FTP objects" msgstr "" -msgid "Support for the :keyword:`with` statement was added." +msgid "Return a new instance of the :class:`FTP` class." msgstr "" -msgid "*source_address* parameter was added." -msgstr "" +msgid "Parameters" +msgstr "parametry" 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 " -"*encoding* parameter was added, and the default was changed from Latin-1 to " -"UTF-8 to follow :rfc:`2640`." +"The hostname to connect to. If given, :code:`connect(host)` is implicitly " +"called by the constructor." msgstr "" msgid "" -"A :class:`FTP` subclass which adds TLS support to FTP as described in :rfc:" -"`4217`. Connect as usual to port 21 implicitly securing the FTP control " -"connection before authenticating. Securing the data connection requires the " -"user to explicitly ask for it by calling the :meth:`prot_p` method. " -"*context* is a :class:`ssl.SSLContext` object which allows bundling SSL " -"configuration options, certificates and private keys into a single " -"(potentially long-lived) structure. Please read :ref:`ssl-security` for " -"best practices." +"|param_doc_user| If given, :code:`login(host, passwd, acct)` is implicitly " +"called by the constructor." msgstr "" -msgid "" -"*keyfile* and *certfile* are a legacy alternative to *context* -- they can " -"point to PEM-formatted private key and certificate chain files " -"(respectively) for the SSL connection." +msgid "|param_doc_passwd|" msgstr "" -msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)." +msgid "|param_doc_acct|" msgstr "" msgid "" -"*keyfile* and *certfile* are deprecated in favor of *context*. Please use :" -"meth:`ssl.SSLContext.load_cert_chain` instead, or let :func:`ssl." -"create_default_context` select the system's trusted CA certificates for you." +"A timeout in seconds for blocking operations like :meth:`connect` (default: " +"the global default timeout setting)." msgstr "" -msgid "Here's a sample session using the :class:`FTP_TLS` class::" +msgid "|param_doc_source_address|" +msgstr "|param_doc_source_address|" + +msgid "|param_doc_encoding|" msgstr "" -msgid "Exception raised when an unexpected reply is received from the server." +msgid "The :class:`FTP` class supports the :keyword:`with` statement, e.g.:" msgstr "" -msgid "" -"Exception raised when an error code signifying a temporary error (response " -"codes in the range 400--499) is received." +msgid "Support for the :keyword:`with` statement was added." +msgstr "" + +msgid "*source_address* parameter was added." msgstr "" msgid "" -"Exception raised when an error code signifying a permanent error (response " -"codes in the range 500--599) is received." +"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 "" msgid "" -"Exception raised when a reply is received from the server that does not fit " -"the response specifications of the File Transfer Protocol, i.e. begin with a " -"digit in the range 1--5." +"Several :class:`!FTP` methods are available in two flavors: one for handling " +"text files and another for binary files. The methods are named for the " +"command which is used followed by ``lines`` for the text version or " +"``binary`` for the binary version." +msgstr "" + +msgid ":class:`FTP` instances have the following methods:" msgstr "" msgid "" -"The set of all exceptions (as a tuple) that methods of :class:`FTP` " -"instances may raise as a result of problems with the FTP connection (as " -"opposed to programming errors made by the caller). This set includes the " -"four exceptions listed above as well as :exc:`OSError` and :exc:`EOFError`." +"Set the instance's debugging level as an :class:`int`. This controls the " +"amount of debugging output printed. The debug levels are:" msgstr "" -msgid "Module :mod:`netrc`" +msgid "``0`` (default): No debug output." msgstr "" msgid "" -"Parser for the :file:`.netrc` file format. The file :file:`.netrc` is " -"typically used by FTP clients to load user authentication information before " -"prompting the user." +"``1``: Produce a moderate amount of debug output, generally a single line " +"per request." msgstr "" -msgid "FTP Objects" +msgid "" +"``2`` or higher: Produce the maximum amount of debugging output, logging " +"each line sent and received on the control connection." msgstr "" msgid "" -"Several methods are available in two flavors: one for handling text files " -"and another for binary files. These are named for the command which is used " -"followed by ``lines`` for the text version or ``binary`` for the binary " -"version." +"Connect to the given host and port. This function should be called only once " +"for each instance; it should not be called if a *host* argument was given " +"when the :class:`FTP` instance was created. All other :class:`!FTP` methods " +"can only be called after a connection has successfully been made." msgstr "" -msgid ":class:`FTP` instances have the following methods:" +msgid "The host to connect to." msgstr "" msgid "" -"Set the instance's debugging level. This controls the amount of debugging " -"output printed. The default, ``0``, produces no debugging output. A value " -"of ``1`` produces a moderate amount of debugging output, generally a single " -"line per request. A value of ``2`` or higher produces the maximum amount of " -"debugging output, logging each line sent and received on the control " -"connection." +"The TCP port to connect to (default: ``21``, as specified by the FTP " +"protocol specification). It is rarely needed to specify a different port " +"number." msgstr "" msgid "" -"Connect to the given host and port. The default port number is ``21``, as " -"specified by the FTP protocol specification. It is rarely needed to specify " -"a different port number. This function should be called only once for each " -"instance; it should not be called at all if a host was given when the " -"instance was created. All other methods can only be used after a connection " -"has been made. The optional *timeout* parameter specifies a timeout in " -"seconds for the connection attempt. If no *timeout* is passed, the global " -"default timeout setting will be used. *source_address* is a 2-tuple ``(host, " -"port)`` for the socket to bind to as its source address before connecting." +"A timeout in seconds for the connection attempt (default: the global default " +"timeout setting)." msgstr "" msgid "" @@ -196,14 +169,14 @@ msgid "" msgstr "" msgid "" -"Log in as the given *user*. The *passwd* and *acct* parameters are optional " -"and default to the empty string. If no *user* is specified, it defaults to " -"``'anonymous'``. If *user* is ``'anonymous'``, the default *passwd* is " -"``'anonymous@'``. This function should be called only once for each " -"instance, after a connection has been established; it should not be called " -"at all if a host and user were given when the instance was created. Most " -"FTP commands are only allowed after the client has logged in. The *acct* " -"parameter supplies \"accounting information\"; few systems implement this." +"Log on to the connected FTP server. This function should be called only once " +"for each instance, after a connection has been established; it should not be " +"called if the *host* and *user* arguments were given when the :class:`FTP` " +"instance was created. Most FTP commands are only allowed after the client " +"has logged in." +msgstr "" + +msgid "|param_doc_user|" msgstr "" msgid "" @@ -222,19 +195,30 @@ msgstr "" msgid "" "Send a simple command string to the server and handle the response. Return " -"nothing if a response code corresponding to success (codes in the range " -"200--299) is received. Raise :exc:`error_reply` otherwise." +"the response string if the response code corresponds to success (codes in " +"the range 200--299). Raise :exc:`error_reply` otherwise." +msgstr "" + +msgid "Retrieve a file in binary transfer mode." +msgstr "" + +msgid "An appropriate ``STOR`` command: :samp:`\"STOR {filename}\"`." msgstr "" msgid "" -"Retrieve a file in binary transfer mode. *cmd* should be an appropriate " -"``RETR`` command: ``'RETR filename'``. The *callback* function is called for " -"each block of data received, with a single bytes argument giving the data " -"block. The optional *blocksize* argument specifies the maximum chunk size to " -"read on the low-level socket object created to do the actual transfer (which " -"will also be the largest size of the data blocks passed to *callback*). A " -"reasonable default is chosen. *rest* means the same thing as in the :meth:" -"`transfercmd` method." +"A single parameter callable that is called for each block of data received, " +"with its single argument being the data as :class:`bytes`." +msgstr "" + +msgid "" +"The maximum chunk size to read on the low-level :class:`~socket.socket` " +"object created to do the actual transfer. This also corresponds to the " +"largest size of data that will be passed to *callback*. Defaults to ``8192``." +msgstr "" + +msgid "" +"A ``REST`` command to be sent to the server. See the documentation for the " +"*rest* parameter of the :meth:`transfercmd` method." msgstr "" msgid "" @@ -245,7 +229,7 @@ msgid "" "files and information about those files. ``NLST`` retrieves a list of file " "names. The *callback* function is called for each line with a string " "argument containing the line with the trailing CRLF stripped. The default " -"*callback* prints the line to ``sys.stdout``." +"*callback* prints the line to :data:`sys.stdout`." msgstr "" msgid "" @@ -253,17 +237,24 @@ msgid "" "Passive mode is on by default." msgstr "" +msgid "Store a file in binary transfer mode." +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." +msgstr "" + +msgid "The read block size. Defaults to ``8192``." +msgstr "" + msgid "" -"Store a file in binary transfer mode. *cmd* should be an appropriate " -"``STOR`` command: ``\"STOR filename\"``. *fp* is a :term:`file object` " -"(opened in binary mode) which is read until EOF using its :meth:`~io.IOBase." -"read` method in blocks of size *blocksize* to provide the data to be stored. " -"The *blocksize* argument defaults to 8192. *callback* is an optional single " -"parameter callable that is called on each block of data after it is sent. " -"*rest* means the same thing as in the :meth:`transfercmd` method." +"A single parameter callable that is called for each block of data sent, with " +"its single argument being the data as :class:`bytes`." msgstr "" -msgid "*rest* parameter added." +msgid "The *rest* parameter was added." msgstr "" msgid "" @@ -328,7 +319,7 @@ msgid "" "is the current server directory). Multiple arguments can be used to pass " "non-standard options to the ``LIST`` command. If the last argument is a " "function, it is used as a *callback* function as for :meth:`retrlines`; the " -"default prints to ``sys.stdout``. This method returns ``None``." +"default prints to :data:`sys.stdout`. This method returns ``None``." msgstr "" msgid "Rename file *fromname* on the server to *toname*." @@ -375,15 +366,60 @@ msgid "" "connection by issuing another :meth:`login` method)." msgstr "" -msgid "FTP_TLS Objects" +msgid "FTP_TLS objects" msgstr "" msgid "" -":class:`FTP_TLS` class inherits from :class:`FTP`, defining these additional " -"objects:" +"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 SSL version to use (defaults to :attr:`ssl.PROTOCOL_SSLv23`)." +msgid "" +"The user must explicitly secure the data connection by calling the :meth:" +"`prot_p` method." +msgstr "" + +msgid "" +"An SSL context object which allows bundling SSL configuration options, " +"certificates and private keys into a single, potentially long-lived, " +"structure. Please read :ref:`ssl-security` for best practices." +msgstr "" + +msgid "" +"A timeout in seconds for blocking operations like :meth:`~FTP.connect` " +"(default: the global default timeout setting)." +msgstr "" + +msgid "" +"*keyfile* and *certfile* are a legacy alternative to *context* -- they can " +"point to PEM-formatted private key and certificate chain files " +"(respectively) for the SSL connection." +msgstr "" + +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`)." +msgstr "" + +msgid "" +"*keyfile* and *certfile* are deprecated in favor of *context*. Please use :" +"meth:`ssl.SSLContext.load_cert_chain` instead, or let :func:`ssl." +"create_default_context` select the system's trusted CA certificates for you." +msgstr "" + +msgid "Here's a sample session using the :class:`FTP_TLS` class::" +msgstr "" + +msgid "" +":class:`!FTP_TLS` class inherits from :class:`FTP`, defining these " +"additional methods and attributes:" +msgstr "" + +msgid "The SSL version to use (defaults to :data:`ssl.PROTOCOL_SSLv23`)." msgstr "" msgid "" @@ -393,7 +429,7 @@ msgstr "" msgid "" "The method now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :data:`ssl.HAS_SNI`)." +"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." msgstr "" msgid "" @@ -408,6 +444,44 @@ msgstr "" msgid "Set up clear text data connection." msgstr "" +msgid "Module variables" +msgstr "" + +msgid "Exception raised when an unexpected reply is received from the server." +msgstr "" + +msgid "" +"Exception raised when an error code signifying a temporary error (response " +"codes in the range 400--499) is received." +msgstr "" + +msgid "" +"Exception raised when an error code signifying a permanent error (response " +"codes in the range 500--599) is received." +msgstr "" + +msgid "" +"Exception raised when a reply is received from the server that does not fit " +"the response specifications of the File Transfer Protocol, i.e. begin with a " +"digit in the range 1--5." +msgstr "" + +msgid "" +"The set of all exceptions (as a tuple) that methods of :class:`FTP` " +"instances may raise as a result of problems with the FTP connection (as " +"opposed to programming errors made by the caller). This set includes the " +"four exceptions listed above as well as :exc:`OSError` and :exc:`EOFError`." +msgstr "" + +msgid "Module :mod:`netrc`" +msgstr "" + +msgid "" +"Parser for the :file:`.netrc` file format. The file :file:`.netrc` is " +"typically used by FTP clients to load user authentication information before " +"prompting the user." +msgstr "" + msgid "FTP" msgstr "" diff --git a/library/functional.po b/library/functional.po index c2383127a1..a6832a4c61 100644 --- a/library/functional.po +++ b/library/functional.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/functions.po b/library/functions.po index 8d379492b8..9de6e4983a 100644 --- a/library/functions.po +++ b/library/functions.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -25,7 +25,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Built-in Functions" -msgstr "Funkcje wbudowane" +msgstr "Wbudowane funkcje" msgid "" "The Python interpreter has a number of functions and types built into it " @@ -46,12 +46,12 @@ msgstr ":func:`aiter`" msgid ":func:`all`" msgstr ":func:`all`" -msgid ":func:`any`" -msgstr ":func:`any`" - msgid ":func:`anext`" msgstr ":func:`anext`" +msgid ":func:`any`" +msgstr ":func:`any`" + msgid ":func:`ascii`" msgstr ":func:`ascii`" @@ -309,19 +309,16 @@ 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:`__abs__`. If the " -"argument is a complex number, its magnitude is returned." +"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:`__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 `. Ewiwalent wywołania " +"`asynchronicznego iterable'a `. Ekwiwalent wywołania " "``x.__aiter__()``." msgid "Note: Unlike :func:`iter`, :func:`aiter` has no 2-argument variant." @@ -356,7 +353,7 @@ msgid "" "iterator. If *default* is given, it is returned if the iterator is " "exhausted, otherwise :exc:`StopAsyncIteration` is raised." msgstr "" -"Wywołuje to metodę :meth:`~object.__anext__` *async_iteratora*, zwracając :" +"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:" @@ -375,25 +372,31 @@ msgid "" "`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 *x* is not a Python :class:`int` " -"object, it has to define an :meth:`__index__` method that returns an " +"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 *x* nie jest pythonowym " -"obiektem :class:`int`, musi definiować metodę :meth:`__index__`, która " -"zwraca liczbę całkowitą. Kilka przykładów:" +"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:`format` for more information." -msgstr "Zobacz też :func:`format` po więcej informacji." +msgstr "Zobacz też :func:`format` by uzyskać więcej informacji." msgid "" "Return a Boolean value, i.e. one of ``True`` or ``False``. *x* is converted " @@ -424,11 +427,16 @@ msgid "" "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 " @@ -476,6 +484,9 @@ msgid "" "`, 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 " @@ -497,6 +508,10 @@ msgid "" "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`." @@ -515,14 +530,14 @@ msgid "" "`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:`__call__` method." +"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``, wciąż możliwe jest, że wywołanie " -"się nie powiedzie, ale jeśli jest ``False``, wywołanie *obiektu* nie " -"powiedzie się nigdy. Zwróć uwagę, że klasy są wywoływalne (wywołanie klasy " -"zwraca nową instancję); instancje są wywoływalne, jeśli ich klasy mają " -"metodę :meth:`__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 " @@ -549,13 +564,16 @@ msgstr "" "`ValueError`." msgid "Transform a method into a class method." -msgstr "Przekształć metodę w metodę klasową." +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 "" "The ``@classmethod`` form is a function :term:`decorator` -- see :ref:" @@ -570,10 +588,11 @@ msgid "" "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 (jak ``C.f()``) albo na " -"instancji (jak ``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." +"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 " @@ -601,6 +620,8 @@ 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 " @@ -608,10 +629,10 @@ msgid "" "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 *źródło* do obiektu kodu lub AST. Obiekty kodu mogą wyć wykonywane " -"przy użyciu :func:`exec` lub :func:`eval`. *źródło* 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." +"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; " @@ -630,7 +651,7 @@ msgid "" "evaluate to something other than ``None`` will be printed)." msgstr "" "Argument *mode* określa, jaki rodzaj kodu ma zostać skompilowany; może mieć " -"wartość ``'exec'`` jeśli *źródło* składa się z sekwencji instrukcji, " +"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``, " @@ -648,6 +669,16 @@ msgid "" "*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 " @@ -657,6 +688,12 @@ msgid "" "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; " @@ -665,16 +702,25 @@ msgid "" "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, " "and :exc:`ValueError` if the source contains null bytes." msgstr "" +"To funkcja rzuci :exc:`SyntaxError` jeśli skompilowane źródło jest " +"nieprawidłowe, a :exc:`ValueError` jeśli źródło zawiera bajty null." 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 " @@ -686,6 +732,9 @@ msgid "" "``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'`` " @@ -693,27 +742,42 @@ msgid "" "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 "" "Return a complex number with the value *real* + *imag*\\*1j or convert a " @@ -728,9 +792,9 @@ msgstr "" msgid "" "For a general Python object ``x``, ``complex(x)`` delegates to ``x." -"__complex__()``. If ``__complex__()`` is not defined then it falls back to :" -"meth:`__float__`. If ``__float__()`` is not defined then it falls back to :" -"meth:`__index__`." +"__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 "" @@ -740,15 +804,19 @@ msgid "" msgstr "" msgid "The complex type is described in :ref:`typesnumeric`." -msgstr "" +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:`__index__` if :meth:`__complex__` and :meth:`__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." msgid "" "This is a relative of :func:`setattr`. The arguments are an object and a " @@ -757,62 +825,94 @@ msgid "" "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 :class:`dict` and :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`." 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 argumentow, zwraca listę nazw w bieżącym zakresie lokalnym. Z " +"argumentów, próba zwraca listy prawidłowych atrybut dla tego obiektu." msgid "" -"If the object has a method named :meth:`__dir__`, this method will be called " -"and must return the list of attributes. This allows objects that implement a " -"custom :func:`__getattr__` or :func:`__getattribute__` function to customize " -"the way :func:`dir` reports their attributes." +"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:`__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:" -"`__getattr__`." +"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 "" +msgstr "Wynikowa lista jest posortowana alfabetycznie. Na przykład:" msgid "" "Because :func:`dir` is supplied primarily as a convenience for use at an " @@ -821,6 +921,12 @@ msgid "" "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 " @@ -840,9 +946,14 @@ msgid "" "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 "" +msgstr "Odpowiednik::" msgid "" "The arguments are a string and optional globals and locals. If provided, " @@ -877,6 +988,11 @@ msgid "" "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` " @@ -884,16 +1000,25 @@ 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`." 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 that can safely evaluate strings " "with expressions containing only literals." msgstr "" +"Zobacz :func:`ast.literal_eval` dla funkcj, którya może bezpiecznie ocenić " +"napis z wyrażeniami zawierającymi tylko literały." msgid "" "Raises an :ref:`auditing event ` ``exec`` with argument " @@ -904,6 +1029,8 @@ 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 "" "This function supports dynamic execution of Python code. *object* must be " @@ -936,6 +1063,11 @@ msgid "" "builtins are available to the executed code by inserting your own " "``__builtins__`` dictionary into *globals* before passing it to :func:`exec`." msgstr "" +"Jeśli *globals* słownik nie zawiera wartości dla klucza ``__builtins__``, " +"odwołanie do słownika z wbudowanego modułu :mod:`builtins` jest wstawiane " +"pod tym kluczem. W ten sposób można kontrolować, które wbudowane są " +"dostępne dla wykonywanego kodu, wstawiając własny ``__builtins__`` słownik " +"do *globals* przed przekazaniem go do :func:`exec`." msgid "" "The *closure* argument specifies a closure--a tuple of cellvars. It's only " @@ -958,7 +1090,7 @@ msgid "" msgstr "" msgid "Added the *closure* parameter." -msgstr "" +msgstr "Dodano parametr *zamknięcie*." msgid "" "Construct an iterator from those elements of *iterable* for which *function* " @@ -966,6 +1098,10 @@ msgid "" "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 " @@ -973,11 +1109,17 @@ msgid "" "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 string *x*." msgstr "" @@ -993,11 +1135,12 @@ msgid "" msgstr "" msgid "" -"Here ``digit`` is a Unicode decimal digit (character in the Unicode general " -"category ``Nd``). Case is not significant, so, for example, \"inf\", " -"\"Inf\", \"INFINITY\", and \"iNfINity\" are all acceptable spellings for " -"positive infinity." +"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 " @@ -1008,21 +1151,28 @@ msgstr "" msgid "" "For a general Python object ``x``, ``float(x)`` delegates to ``x." -"__float__()``. If ``__float__()`` is not defined then it falls back to :" -"meth:`__index__`." +"__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 "If no argument is given, ``0.0`` is returned." -msgstr "" +msgstr "Jeśli nie podano argumentu, zwracane jest ``0.0``." msgid "Examples::" -msgstr "" +msgstr "Przykłady::" msgid "The float type is described in :ref:`typesnumeric`." -msgstr "" +msgstr "Typ float został opisany na stronie :ref:`typesnumeric`." -msgid "Falls back to :meth:`__index__` if :meth:`__float__` is not defined." +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 " @@ -1030,36 +1180,55 @@ msgid "" "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:`__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." +"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*. ``frozenset`` is a built-in class. See :class:`frozenset` and :" "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`." 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 " @@ -1069,6 +1238,12 @@ msgid "" "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 " @@ -1076,12 +1251,19 @@ msgid "" "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 " @@ -1089,6 +1271,10 @@ msgid "" "(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 " @@ -1096,12 +1282,19 @@ msgid "" "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:`__hash__` methods, note that :func:`hash` " -"truncates the return value based on the bit width of the host machine. See :" -"meth:`__hash__` for details." +"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 " @@ -1111,6 +1304,13 @@ msgid "" "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 " @@ -1118,37 +1318,56 @@ msgid "" "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 *x* is not a Python :class:`int` object, it has to define an :" -"meth:`__index__` method that returns an integer. Some examples:" +"meth:`~object.__index__` method that returns an integer. Some examples:" msgstr "" +"Konwertuje liczbę liczba całkowita na zapis szesnastkowy z małymi literami " +"napis poprzedzony \"0x\". Jeśli *x* nie jest obiektem Python :class:`int` , " +"musi zdefiniować metodę :meth:`~object.__index__`, która zwraca liczbe " +"całkowita. 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 " @@ -1156,14 +1375,20 @@ msgid "" "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 "" +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 " @@ -1171,11 +1396,17 @@ msgid "" "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 "" "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 " @@ -1186,6 +1417,8 @@ 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 " @@ -1196,13 +1429,16 @@ 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 string *x*, or return " -"``0`` if no arguments are given. If *x* defines :meth:`__int__`, ``int(x)`` " -"returns ``x.__int__()``. If *x* defines :meth:`__index__`, it returns ``x." -"__index__()``. If *x* defines :meth:`__trunc__`, it returns ``x." -"__trunc__()``. For floating point numbers, this truncates towards zero." +"``0`` if no arguments are given. If *x* defines :meth:`~object.__int__`, " +"``int(x)`` returns ``x.__int__()``. If *x* defines :meth:`~object." +"__index__`, it returns ``x.__index__()``. If *x* defines :meth:`~object." +"__trunc__`, it returns ``x.__trunc__()``. For floating point numbers, this " +"truncates towards zero." msgstr "" msgid "" @@ -1225,9 +1461,21 @@ msgid "" "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 "" +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 :" @@ -1235,12 +1483,21 @@ msgid "" "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 "Falls back to :meth:`__index__` if :meth:`__int__` is not defined." +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 "The delegation to :meth:`__trunc__` is deprecated." -msgstr "" +msgid "The delegation to :meth:`~object.__trunc__` is deprecated." +msgstr "Delegacja do :meth:`~object.__trunc__` jest zdezaprobowana." msgid "" ":class:`int` string inputs and string representations can be limited to help " @@ -1262,9 +1519,19 @@ msgid "" "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 "" +msgstr "*classinfo* może być :ref:`types-union`." msgid "" "Return ``True`` if *class* is a subclass (direct, indirect, or :term:" @@ -1274,45 +1541,75 @@ msgid "" "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, *object* must be a collection object which supports the :" -"term:`iterable` protocol (the :meth:`__iter__` method), or it must support " -"the sequence protocol (the :meth:`__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 " -"*object* must be a callable object. The iterator created in this case will " -"call *object* 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 "" +"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 *object* must be a callable object. The iterator " +"created in this case will call *object* 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, *object* 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 *object* musi być obiektem " +"wywoływalnym. Utworzony w tym przypadku iterator będzie wywoływał *object* " +"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 "" +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 "" "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 "" "Update and return a dictionary representing the current local symbol table. " @@ -1334,17 +1631,29 @@ msgid "" "the shortest iterable is exhausted. For cases where the function inputs are " "already arranged into argument tuples, see :func:`itertools.starmap`\\." msgstr "" +"Zwraca iterator , który stosuje *funkcje* do każdego elementu *iterable*, " +"dając wyniki. Jeśli przekazane zostaną dodatkowe *iterable* argumenty, " +"*funkcja* musi przyjąć taką liczbę argumentow i jest stosowana do elementów " +"ze wszystkich iterable równolegle. W przypadku wielu iterables, iterator " +"zatrzymuje się, gdy najkrótszy iterable zostanie wyczerpany. Dla " +"przypadków, w których wejścia funkcji są już ułożone w argumentach krotka , " +"zobacz :func:`itertools.starmap` ." msgid "" "Return the largest item in an iterable or the largest of two or more " "arguments." msgstr "" +"Zwraca największy element w iterable lub największy z dwóch lub więcej " +"argumentow." 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 pozycjny argument, powinien to być :term:`iterable`. " +"Zwracany jest największy element w iterable. Jeśli podano dwa lub więcej " +"pozycyjne argumenty, zwracany jest największy z pozycyjnych argumentow." msgid "" "There are two optional keyword-only arguments. The *key* argument specifies " @@ -1353,6 +1662,11 @@ msgid "" "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 " @@ -1360,28 +1674,39 @@ msgid "" "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 "The *default* keyword-only argument." -msgstr "" +msgid "Added the *default* keyword-only parameter." +msgstr "Dodano *default* tylko słowo kluczowe parametr." msgid "The *key* can be ``None``." -msgstr "" +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 lub najmniejszy z dwóch lub więcej " +"argumentow." 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 " +"pozycyjne argumenty, zwracany jest najmniejszy z pozycyjnych argumentow." msgid "" "If multiple items are minimal, the function returns the first one " @@ -1389,12 +1714,20 @@ msgid "" "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 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 "" "Return a new featureless object. :class:`object` is a base for all classes. " @@ -1410,20 +1743,29 @@ msgstr "" msgid "" "Convert an integer number to an octal string prefixed with \"0o\". The " "result is a valid Python expression. If *x* is not a Python :class:`int` " -"object, it has to define an :meth:`__index__` method that returns an " +"object, it has to define an :meth:`~object.__index__` method that returns an " "integer. For example:" msgstr "" +"Konwertuje liczbę liczba całkowita na ósemkowy napis z prefiksem \"0o\". " +"Wynikiem jest poprawne wyrażenie Python. Jeśli *x* nie jest obiektem " +"Pythona :class:`int` , musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbe całkowita. 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 " @@ -1432,6 +1774,12 @@ msgid "" "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 " @@ -1447,58 +1795,62 @@ msgid "" msgstr "" msgid "Character" -msgstr "" +msgstr "Znak" msgid "Meaning" msgstr "Znaczenie" msgid "``'r'``" -msgstr "" +msgstr "``'r'``" msgid "open for reading (default)" -msgstr "" +msgstr "otwarte do czytania (domyślny)" msgid "``'w'``" -msgstr "" +msgstr "``'w'``" msgid "open for writing, truncating the file first" -msgstr "" +msgstr "otworzyć do zapisu, najpierw obcinając plik" msgid "``'x'``" -msgstr "" +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 "" +msgstr "``'a'``" msgid "open for writing, appending to the end of file if it exists" -msgstr "" +msgstr "otwarte do zapisu, dołączenie do końca pliku, jeśli istnieje" msgid "``'b'``" msgstr "``'b'``" msgid "binary mode" -msgstr "" +msgstr "tryb binarny" msgid "``'t'``" -msgstr "" +msgstr "``'t'``" msgid "text mode (default)" -msgstr "" +msgstr "tryb tekstowy (domyślny)" msgid "``'+'``" -msgstr "" +msgstr "``'+'``" msgid "open for updating (reading and writing)" -msgstr "" +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 " @@ -1509,37 +1861,65 @@ msgid "" "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 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 (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 " "chosen using a heuristic trying to determine the underlying device's \"block " -"size\" and falling back on :attr:`io.DEFAULT_BUFFER_SIZE`. On many systems, " -"the buffer will typically be 4096 or 8192 bytes long." +"size\" and falling back on :const:`io.DEFAULT_BUFFER_SIZE`. On many " +"systems, the buffer will typically be 4096 or 8192 bytes long." msgstr "" +"Pliki binarne są buforowane w kawałkach o stałym rozmiarze; rozmiar bufora " +"jest wybierany przy użyciu heurystyki próbującej określić \"rozmiar " +"urządzenia bazowego\" i powracając do :const:`io.DEFAULT_BUFFER_SIZE`. W " +"wielu systemach bufor ma długość 4096 lub 8192 bajtó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. " @@ -1548,6 +1928,11 @@ msgid "" "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 " @@ -1556,21 +1941,32 @@ msgid "" "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 " @@ -1579,28 +1975,44 @@ msgid "" "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 ``&#nnn;``." +"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 " @@ -1611,6 +2023,14 @@ msgid "" "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'`` " @@ -1619,6 +2039,12 @@ msgid "" "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 " @@ -1626,6 +2052,10 @@ msgid "" "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 " @@ -1634,14 +2064,21 @@ msgid "" "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 "" +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 "" "The type of :term:`file object` returned by the :func:`open` function " @@ -1656,12 +2093,27 @@ msgid "" "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 ``file``, " @@ -1672,43 +2124,53 @@ 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 "" +msgstr "Dodano *opener* parametr." msgid "The ``'x'`` mode was added." -msgstr "" +msgstr "Dodano tryb ``'x'``." msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." -msgstr "" +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 "" +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 "" +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 "" +msgstr "Tryb ``'U'`` został usunięty." msgid "" "Given a string representing one Unicode character, return an integer " @@ -1716,6 +2178,10 @@ msgid "" "``ord('a')`` returns the integer ``97`` and ``ord('€')`` (Euro sign) returns " "``8364``. This is the inverse of :func:`chr`." msgstr "" +"Biorąc pod uwagę napis reprezentujący jeden punkt kodowy Unicode znak, " +"zwracać i liczba całkowita reprezentujący punkt kodowy Unicode tego znaka. " +"Na przykład, ``ord('a')`` zwraca liczbe całkowita ``97`` i ``ord('€')`` " +"(znak euro) zwraca ``8364`` . Jest to odwrotność :func:`chr`." msgid "" "Return *base* to the power *exp*; if *mod* is present, return *base* to the " @@ -1723,6 +2189,10 @@ msgid "" "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óchargumentow ``pow(base, exp)`` jest równoważna " +"użyciu operatora potęgi: ``base**exp``." msgid "" "The arguments must have numeric types. With mixed operand types, the " @@ -1743,24 +2213,37 @@ msgid "" "``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 "" +msgstr "Oto przykład obliczania odwrotności dla ``38`` modulo ``97``::" 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-argumenty formy ``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 "" +"Zezwalaj na argument nazwany. Wcześniej obsługiwane były tylko pozycyjne " +"argument." 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 " @@ -1769,6 +2252,11 @@ msgid "" "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 " @@ -1776,31 +2264,44 @@ msgid "" "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 "" +msgstr "Dodano *flush* argument nazwany." msgid "Return a property attribute." -msgstr "" +msgstr "Zwraca atrybut właściwośći." 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 "" "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, " @@ -1808,38 +2309,56 @@ msgid "" "possible to create read-only properties easily using :func:`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`::" msgid "" -"The ``@property`` decorator turns the :meth:`voltage` method into a " +"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 :attr:`~property.getter`, :attr:`~property.setter`, " -"and :attr:`~property.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::" +"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 "" "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 "" +msgstr "Dokumentacja obiektów właściwości sa teraz zapisywalne." 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 " @@ -1848,23 +2367,42 @@ msgid "" "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:`__repr__` method. " -"If :func:`sys.displayhook` is not accessible, this function will raise :exc:" -"`RuntimeError`." +"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 "" "Return a reverse :term:`iterator`. *seq* must be an object which has a :" -"meth:`__reversed__` method or supports the sequence protocol (the :meth:" -"`__len__` method and the :meth:`__getitem__` method with integer arguments " -"starting at ``0``)." +"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 a reverse :term:`iterator`. *seq* 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 " +"liczba całkowita argument 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 " @@ -1875,11 +2413,21 @@ msgid "" "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, " @@ -1888,18 +2436,29 @@ msgid "" "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*. ``set`` is a built-in class. See :class:`set` and :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`." 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 " @@ -1908,6 +2467,10 @@ msgid "" "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` " @@ -1916,47 +2479,83 @@ msgid "" "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``. Slice objects have read-only data attributes :attr:`~slice." -"start`, :attr:`~slice.stop`, and :attr:`~slice.step` which merely return the " -"argument values (or their default). They have no other explicit " -"functionality; however, they are used by NumPy and other third-party " -"packages. Slice objects are also generated when extended indexing syntax is " -"used. For example: ``a[start:stop:step]`` or ``a[start:stop, i]``. See :" -"func:`itertools.islice` for an alternate version that returns an iterator." +"``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 "Return a new sorted list from the items in *iterable*." +msgid "" +"Slice objects have read-only data attributes :attr:`!start`, :attr:`!stop`, " +"and :attr:`!step` which merely return the argument values (or their " +"default). They have no other explicit functionality; however, they are used " +"by NumPy and other third-party packages." +msgstr "" +"Obiekty slice mają dane tylko do odczytu atrybut :attr:`!start` , :attr:`!" +"stop` i :attr:`!step`, które jedynie zwracać wartości argument (lub ich " +"domyślny). Nie mają one żadnej innej wyraźnej funkcjonalności; są jednak " +"używane przez NumPy i inne pakiety innych firm." + +msgid "" +"Slice objects are also generated when extended indexing syntax is used. For " +"example: ``a[start:stop:step]`` or ``a[start:stop, i]``. See :func:" +"`itertools.islice` for an alternate version that returns an :term:`iterator`." msgstr "" +"Obiekty Slice są również generowane, gdy używana jest rozszerzona składnia " +"indeksowania. Na przykład: ``a[start:stop:step]`` lub ``a[start:stop, i]``. " +"Zobacz :func:`itertools.islice` dla alternatywy, która zwraca :term:" +"`iterator`." + +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 " @@ -1964,6 +2563,11 @@ msgid "" "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 " @@ -1975,23 +2579,37 @@ msgid "" "mixed type comparisons which can call reflected the :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 "" +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 "" "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 " @@ -2004,6 +2622,9 @@ msgid "" "see :func:`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." msgid "" "Like all decorators, it is also possible to call ``staticmethod`` as a " @@ -2012,9 +2633,16 @@ msgid "" "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 "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 (``__module__``, " @@ -2025,17 +2653,24 @@ msgstr "" 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 " @@ -2046,18 +2681,23 @@ msgid "" msgstr "" msgid "The *start* parameter can be specified as a keyword argument." -msgstr "" +msgstr "Parametr *start* można określić jako argument nazwany." 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:`~class.__mro__` of *object_or_type* is ``D -> B -> C -" @@ -2078,6 +2718,10 @@ msgid "" "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 "" "There are two typical use cases for *super*. In a class hierarchy with " @@ -2085,6 +2729,11 @@ msgid "" "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 " @@ -2097,24 +2746,45 @@ msgid "" "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 "" +msgstr "W obu przypadkach typowe wywołanie superklasy wygląda następująco::" 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:`__getattribute__` method for " +"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 " @@ -2124,17 +2794,28 @@ msgid "" "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 "" "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 " @@ -2146,6 +2827,8 @@ msgid "" "The :func:`isinstance` built-in function is recommended for testing the type " "of an object, because it takes subclasses into account." msgstr "" +"Funckja wbudowana :func:`isinstance` jest zalecana do testowania typu " +"obiektu, ponieważ uwzględnia podklasa." msgid "" "With three arguments, return a new type object. This is essentially a " @@ -2168,9 +2851,13 @@ msgid "" "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 "See also :ref:`class-customization`." -msgstr "" +msgstr "Zobacz także :ref:`class-customization`." msgid "" "Subclasses of :class:`type` which don't override ``type.__new__`` may no " @@ -2200,31 +2887,44 @@ msgid "" "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 "" "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 "" +msgstr "Przykład::" 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 " @@ -2232,43 +2932,63 @@ msgid "" "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 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 "" ":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 "" "Unlike the default behavior, it raises a :exc:`ValueError` if one iterable " "is 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 " "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 "" +msgstr "Wskazówki i porady:" msgid "" "The left-to-right evaluation order of the iterables is guaranteed. This " @@ -2277,19 +2997,28 @@ msgid "" "``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 "Added the ``strict`` argument." -msgstr "" +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 " @@ -2301,6 +3030,14 @@ msgid "" "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 " @@ -2310,6 +3047,12 @@ msgid "" "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 " @@ -2318,6 +3061,10 @@ msgid "" "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 " @@ -2325,45 +3072,64 @@ msgid "" "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 "The statement ``import spam.ham`` results in this call::" -msgstr "" +msgstr "Instrukcja ``import spam.ham`` skutkuje następującym połączeniem::" 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 "" "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" @@ -2378,64 +3144,64 @@ msgstr "" "style końca linii Winows albo Mac." msgid "Boolean" -msgstr "" +msgstr "Wartość logiczna" msgid "type" -msgstr "" +msgstr "typ" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "exec" -msgstr "" +msgstr "exec" msgid "NaN" -msgstr "" +msgstr "NaN" msgid "Infinity" -msgstr "" +msgstr "Nieskończoność" msgid "__format__" -msgstr "" +msgstr "__format__" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "format() (built-in function)" -msgstr "" +msgstr "format() (wbudowana funkcja)" msgid "file object" -msgstr "" +msgstr "obiekt plik" msgid "open() built-in function" -msgstr "" +msgstr "open() wbudowana funkcja" msgid "file" -msgstr "" +msgstr "plik" msgid "modes" -msgstr "" +msgstr "tryby" msgid "universal newlines" -msgstr "" +msgstr "uniwersalne nowe linie" msgid "line-buffered I/O" -msgstr "" +msgstr "Buforowane liniowo I/O" msgid "unbuffered I/O" -msgstr "" +msgstr "niebuforowane I/O" msgid "buffer size, I/O" -msgstr "" +msgstr "rozmiar bufora, I/O" msgid "I/O control" -msgstr "" +msgstr "Kontrola I/O" msgid "buffering" -msgstr "" +msgstr "buforowanie" msgid "text mode" -msgstr "" +msgstr "tryb tekstowy" msgid "module" msgstr "moduł" @@ -2444,16 +3210,16 @@ msgid "sys" msgstr "sys" msgid "str() (built-in function)" -msgstr "" +msgstr "str() (wbudowana funkcja)" msgid "object" -msgstr "" +msgstr "obiekt" msgid "statement" msgstr "instrukcja" msgid "import" -msgstr "" +msgstr "import" msgid "builtins" msgstr "builtins" diff --git a/library/functools.po b/library/functools.po index 7c2e73a14b..42dedfd08a 100644 --- a/library/functools.po +++ b/library/functools.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -75,7 +75,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "" "The mechanics of :func:`cached_property` are somewhat different from :func:" @@ -138,6 +138,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`." msgid "" "Decorator to wrap a function with a memoizing callable that saves up to the " @@ -184,7 +186,7 @@ msgid "" msgstr "" msgid "" -"The wrapped function is instrumented with a :func:`cache_parameters` " +"The wrapped function is instrumented with a :func:`!cache_parameters` " "function that returns a new :class:`dict` showing the values for *maxsize* " "and *typed*. This is for information purposes only. Mutating the values " "has no effect." @@ -231,7 +233,8 @@ msgid "" "In general, the LRU cache should only be used when you want to reuse " "previously computed values. Accordingly, it doesn't make sense to cache " "functions with side-effects, functions that need to create distinct mutable " -"objects on each call, or impure functions such as time() or random()." +"objects on each call (such as generators and async functions), or impure " +"functions such as time() or random()." msgstr "" msgid "Example of an LRU cache for static web content::" @@ -249,7 +252,7 @@ msgstr "" msgid "Added the *user_function* option." msgstr "" -msgid "Added the function :func:`cache_parameters`" +msgid "Added the function :func:`!cache_parameters`" msgstr "" msgid "" @@ -483,13 +486,10 @@ msgid "" "wrapper function itself is missing any attributes named in *updated*." msgstr "" -msgid "Automatic addition of the ``__wrapped__`` attribute." -msgstr "" - -msgid "Copying of the ``__annotations__`` attribute by default." -msgstr "" - -msgid "Missing attributes no longer trigger an :exc:`AttributeError`." +msgid "" +"The ``__wrapped__`` attribute is now automatically added. The " +"``__annotations__`` attribute is now copied by default. Missing attributes " +"no longer trigger an :exc:`AttributeError`." msgstr "" msgid "" @@ -536,7 +536,7 @@ msgstr "" msgid "" ":class:`partial` objects are like :class:`function` objects in that they are " -"callable, weak referencable, and can have attributes. There are some " +"callable, weak referenceable, and can have attributes. There are some " "important differences. For instance, the :attr:`~definition.__name__` and :" "attr:`__doc__` attributes are not created automatically. Also, :class:" "`partial` objects defined in classes behave like static methods and do not " diff --git a/library/gettext.po b/library/gettext.po index 729730f393..09e8b63d00 100644 --- a/library/gettext.po +++ b/library/gettext.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +79,7 @@ msgstr "" msgid "" "Return the localized translation of *message*, based on the current global " "domain, language, and locale directory. This function is usually aliased " -"as :func:`_` in the local namespace (see examples below)." +"as :func:`!_` in the local namespace (see examples below)." msgstr "" msgid "" @@ -113,7 +113,7 @@ msgid "" msgstr "" msgid "" -"Note that GNU :program:`gettext` also defines a :func:`dcgettext` method, " +"Note that GNU :program:`gettext` also defines a :func:`!dcgettext` method, " "but this was deemed not useful and so it is currently unimplemented." msgstr "" @@ -130,7 +130,7 @@ msgid "" "gettext` defines a :class:`GNUTranslations` class which implements the " "parsing of GNU :file:`.mo` format files, and has methods for returning " "strings. Instances of this class can also install themselves in the built-in " -"namespace as the function :func:`_`." +"namespace as the function :func:`!_`." msgstr "" msgid "" @@ -156,7 +156,7 @@ msgid "" msgstr "" msgid ":file:`{localedir}/{language}/LC_MESSAGES/{domain}.mo`" -msgstr "" +msgstr ":file:`{localedir}/{language}/LC_MESSAGES/{domain}.mo`" msgid "" "The first such file name that exists is returned by :func:`find`. If no such " @@ -166,14 +166,12 @@ msgid "" msgstr "" msgid "" -"Return a :class:`*Translations` instance based on the *domain*, *localedir*, " -"and *languages*, which are first passed to :func:`find` to get a list of the " +"Return a ``*Translations`` instance based on the *domain*, *localedir*, and " +"*languages*, which are first passed to :func:`find` to get a list of the " "associated :file:`.mo` file paths. Instances with identical :file:`.mo` " "file names are cached. The actual class instantiated is *class_* if " "provided, otherwise :class:`GNUTranslations`. The class's constructor must " -"take a single :term:`file object` argument. If provided, *codeset* will " -"change the charset used to encode translated strings in the :meth:" -"`~NullTranslations.lgettext` and :meth:`~NullTranslations.lngettext` methods." +"take a single :term:`file object` argument." msgstr "" msgid "" @@ -189,14 +187,14 @@ msgid "" "`NullTranslations` instance if *fallback* is true." msgstr "" -msgid ":exc:`IOError` used to be raised instead of :exc:`OSError`." -msgstr "" +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 "*codeset* parameter is removed." msgstr "" msgid "" -"This installs the function :func:`_` in Python's builtins namespace, based " +"This installs the function :func:`!_` in Python's builtins namespace, based " "on *domain* and *localedir* which are passed to the function :func:" "`translation`." msgstr "" @@ -208,14 +206,14 @@ msgstr "" msgid "" "As seen below, you usually mark the strings in your application that are " -"candidates for translation, by wrapping them in a call to the :func:`_` " +"candidates for translation, by wrapping them in a call to the :func:`!_` " "function, like this::" msgstr "" msgid "" -"For convenience, you want the :func:`_` function to be installed in Python's " -"builtins namespace, so it is easily accessible in all modules of your " -"application." +"For convenience, you want the :func:`!_` function to be installed in " +"Python's builtins namespace, so it is easily accessible in all modules of " +"your application." msgstr "" msgid "*names* is now a keyword-only parameter." @@ -275,8 +273,8 @@ msgid "" msgstr "" msgid "" -"Return the \"protected\" :attr:`_info` variable, a dictionary containing the " -"metadata found in the message catalog file." +"Return a dictionary containing the metadata found in the message catalog " +"file." msgstr "" msgid "Return the encoding of the message catalog file." @@ -290,20 +288,20 @@ msgstr "" msgid "" "If the *names* parameter is given, it must be a sequence containing the " "names of functions you want to install in the builtins namespace in addition " -"to :func:`_`. Supported names are ``'gettext'``, ``'ngettext'``, " -"``'pgettext'``, ``'npgettext'``, ``'lgettext'``, and ``'lngettext'``." +"to :func:`!_`. Supported names are ``'gettext'``, ``'ngettext'``, " +"``'pgettext'``, and ``'npgettext'``." 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 " +"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::" +"localized modules should never install :func:`!_`. Instead, they should use " +"this code to make :func:`!_` available to their module::" msgstr "" msgid "" -"This puts :func:`_` only in the module's global namespace and so only " +"This puts :func:`!_` only in the module's global namespace and so only " "affects calls within this module." msgstr "" @@ -314,10 +312,10 @@ 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 "" @@ -326,20 +324,20 @@ msgid "" "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, " +"used to initialize the \"protected\" :attr:`!_charset` instance variable, " "defaulting to ``None`` if not found. If the charset encoding is specified, " "then all message ids and message strings read from the catalog are converted " "to Unicode using this encoding, else ASCII is assumed." msgstr "" msgid "" -"Since message ids are read as Unicode strings too, all :meth:`*gettext` " +"Since message ids are read as Unicode strings too, all ``*gettext()`` " "methods will assume message ids as Unicode strings, not byte strings." msgstr "" msgid "" "The entire set of key/value pairs are placed into a dictionary and set as " -"the \"protected\" :attr:`_info` instance variable." +"the \"protected\" :attr:`!_info` instance variable." msgstr "" msgid "" @@ -415,8 +413,8 @@ msgid "" msgstr "" msgid "" -"For compatibility with this older module, the function :func:`Catalog` is an " -"alias for the :func:`translation` function described above." +"For compatibility with this older module, the function :func:`!Catalog` is " +"an alias for the :func:`translation` function described above." msgstr "" msgid "" @@ -454,8 +452,8 @@ msgstr "" 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::" +"wrapping it in ``_('...')`` --- that is, a call to the function :func:`_ " +"`. For example::" msgstr "" msgid "" @@ -531,7 +529,7 @@ msgid "Localizing your application" msgstr "" msgid "" -"If you are localizing your application, you can install the :func:`_` " +"If you are localizing your application, you can install the :func:`!_` " "function globally into the built-in namespace, usually in the main driver " "file of your application. This will let all your application-specific files " "just use ``_('...')`` without having to explicitly install it in each file." @@ -575,15 +573,15 @@ msgid "Here is one way you can handle this situation::" msgstr "" msgid "" -"This works because the dummy definition of :func:`_` simply returns the " +"This works because the dummy definition of :func:`!_` simply returns the " "string unchanged. And this dummy definition will temporarily override any " -"definition of :func:`_` in the built-in namespace (until the :keyword:`del` " -"command). Take care, though if you have a previous definition of :func:`_` " +"definition of :func:`!_` in the built-in namespace (until the :keyword:`del` " +"command). Take care, though if you have a previous definition of :func:`!_` " "in the local namespace." msgstr "" msgid "" -"Note that the second use of :func:`_` will not identify \"a\" as being " +"Note that the second use of :func:`!_` will not identify \"a\" as being " "translatable to the :program:`gettext` program, because the parameter is not " "a string literal." msgstr "" @@ -592,14 +590,14 @@ msgid "Another way to handle this is with the following example::" msgstr "" msgid "" -"In this case, you are marking translatable strings with the function :func:" -"`N_`, which won't conflict with any definition of :func:`_`. However, you " +"In this case, you are marking translatable strings with the function :func:`!" +"N_`, which won't conflict with any definition of :func:`!_`. However, you " "will need to teach your message extraction program to look for translatable " -"strings marked with :func:`N_`. :program:`xgettext`, :program:`pygettext`, " +"strings marked with :func:`!N_`. :program:`xgettext`, :program:`pygettext`, " "``pybabel extract``, and :program:`xpot` all support this through the use of " -"the :option:`!-k` command-line switch. The choice of :func:`N_` here is " -"totally arbitrary; it could have just as easily been :func:" -"`MarkThisStringForTranslation`." +"the :option:`!-k` command-line switch. The choice of :func:`!N_` here is " +"totally arbitrary; it could have just as easily been :func:`!" +"MarkThisStringForTranslation`." msgstr "" msgid "Acknowledgements" @@ -639,9 +637,9 @@ msgid "Footnotes" msgstr "Przypisy" msgid "" -"The default locale directory is system dependent; for example, on RedHat " +"The default locale directory is system dependent; for example, on Red Hat " "Linux it is :file:`/usr/share/locale`, but on Solaris it is :file:`/usr/lib/" -"locale`. The :mod:`gettext` module does not try to support these system " +"locale`. The :mod:`!gettext` module does not try to support these system " "dependent defaults; instead its default is :file:`{sys.base_prefix}/share/" "locale` (see :data:`sys.base_prefix`). For this reason, it is always best to " "call :func:`bindtextdomain` with an explicit absolute path at the start of " diff --git a/library/glob.po b/library/glob.po index 8b1d55149d..ca7ff7b896 100644 --- a/library/glob.po +++ b/library/glob.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:15+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -152,7 +152,7 @@ msgid "pathname expansion" msgstr "" msgid "* (asterisk)" -msgstr "* (asterisk)" +msgstr "* (asterysk)" msgid "in glob-style wildcards" msgstr "" diff --git a/library/graphlib.po b/library/graphlib.po index 99554548fb..8001842990 100644 --- a/library/graphlib.po +++ b/library/graphlib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -126,8 +126,8 @@ msgid "" msgstr "" msgid "" -"The :meth:`~TopologicalSorter.__bool__` method of this class defers to this " -"function, so instead of::" +"The :meth:`~object.__bool__` method of this class defers to this function, " +"so instead of::" msgstr "" msgid "it is possible to simply do::" @@ -196,7 +196,7 @@ msgstr "" msgid "" "The detected cycle can be accessed via the second element in the :attr:" -"`~CycleError.args` attribute of the exception instance and consists in a " +"`~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." diff --git a/library/grp.po b/library/grp.po index 95f843bec6..d830b17d81 100644 --- a/library/grp.po +++ b/library/grp.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,13 +32,7 @@ msgid "" "all Unix versions." msgstr "" -msgid ":ref:`Availability `: not Emscripten, not WASI." -msgstr "" - -msgid "" -"This module does not work or is not available on WebAssembly platforms " -"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " -"more information." +msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." msgstr "" msgid "" @@ -50,7 +45,7 @@ msgid "Index" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Meaning" msgstr "Znaczenie" @@ -83,7 +78,7 @@ msgid "the numerical group ID" msgstr "" msgid "3" -msgstr "" +msgstr "3" msgid "gr_mem" msgstr "" diff --git a/library/gzip.po b/library/gzip.po index 7b4fab5fff..b7b9e390fe 100644 --- a/library/gzip.po +++ b/library/gzip.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -99,16 +99,16 @@ msgid "Accepts a :term:`path-like object`." msgstr "" msgid "" -"An exception raised for invalid gzip files. It inherits :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:`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 "" @@ -156,7 +156,7 @@ msgid "" msgstr "" msgid "" -"Calling a :class:`GzipFile` object's :meth:`close` method does not close " +"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 :" @@ -165,8 +165,8 @@ msgstr "" msgid "" ":class:`GzipFile` supports the :class:`io.BufferedIOBase` interface, " -"including iteration and the :keyword:`with` statement. Only the :meth:" -"`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:" @@ -243,7 +243,9 @@ 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." +"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 "" @@ -301,8 +303,8 @@ msgstr "" msgid "Command line options" msgstr "Opcje wiersza poleceń" -msgid "If *file* is not specified, read from :attr:`sys.stdin`." -msgstr "Jeśli nie określono *pliku*, odczytaj z :attr:`sys.stdin`." +msgid "If *file* is not specified, read from :data:`sys.stdin`." +msgstr "" msgid "Indicates the fastest compression method (less compression)." msgstr "Wskazuje najszybszą metodę kompresji (mniejsza kompresja)." diff --git a/library/hashlib.po b/library/hashlib.po index e6be7689d8..16d3abe030 100644 --- a/library/hashlib.po +++ b/library/hashlib.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Michał Biliński , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Michał Biliński , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +32,11 @@ msgstr "" msgid "" "This module implements a common interface to many different secure hash and " "message digest algorithms. Included are the FIPS secure hash algorithms " -"SHA1, SHA224, SHA256, SHA384, and SHA512 (defined in FIPS 180-2) as well as " -"RSA's MD5 algorithm (defined in internet :rfc:`1321`). The terms \"secure " -"hash\" and \"message digest\" are interchangeable. Older algorithms were " -"called message digests. The modern term is secure hash." +"SHA1, SHA224, SHA256, SHA384, SHA512, (defined in `the FIPS 180-4 " +"standard`_), the SHA-3 series (defined in `the FIPS 202 standard`_) as well " +"as RSA's MD5 algorithm (defined in internet :rfc:`1321`). The terms " +"\"secure hash\" and \"message digest\" are interchangeable. Older " +"algorithms were called message digests. The modern term is secure hash." msgstr "" msgid "" @@ -44,11 +44,6 @@ msgid "" "mod:`zlib` module." msgstr "" -msgid "" -"Some algorithms have known hash collision weaknesses, refer to the \"See " -"also\" section at the end." -msgstr "" - msgid "Hash algorithms" msgstr "" @@ -57,39 +52,45 @@ msgid "" "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." +"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 "" -"For better multithreading performance, the Python :term:`GIL` is released " -"for data larger than 2047 bytes at object creation or on update." +"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." msgstr "" msgid "" -"Feeding string objects into :meth:`update` is not supported, as hashes work " -"on bytes, not on characters." +"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 "" -"Constructors for hash algorithms that are always present in this module are :" -"func:`sha1`, :func:`sha224`, :func:`sha256`, :func:`sha384`, :func:" -"`sha512`, :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. Additional algorithms may also be " -"available depending upon the OpenSSL library that Python uses on your " -"platform. On most platforms the :func:`sha3_224`, :func:`sha3_256`, :func:" -"`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256` are also " -"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 "" -"SHA3 (Keccak) and SHAKE constructors :func:`sha3_224`, :func:`sha3_256`, :" -"func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256`." +"Some algorithms have known hash collision weaknesses (including MD5 and " +"SHA1). Refer to `Attacks on cryptographic hash algorithms`_ and the `hashlib-" +"seealso`_ section at the end of this document." msgstr "" -msgid ":func:`blake2b` and :func:`blake2s` were added." +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." msgstr "" msgid "" @@ -100,29 +101,42 @@ msgid "" "cryptographic one-way compression function." msgstr "" -msgid "Hashlib now uses SHA3 and SHAKE from OpenSSL 1.1.1 and newer." +msgid "Hashlib now uses SHA3 and SHAKE from OpenSSL if it provides it." +msgstr "" + +msgid "Usage" msgstr "" msgid "" -"For example, to obtain the digest of the byte string ``b\"Nobody inspects " -"the spammish repetition\"``::" +"To obtain the digest of the byte string ``b\"Nobody inspects the spammish " +"repetition\"``::" msgstr "" msgid "More condensed:" msgstr "" +msgid "Constructors" +msgstr "" + msgid "" "Is a generic constructor that takes the string *name* of the desired " "algorithm as its first parameter. It also exists to allow access to the " "above listed hashes as well as any other algorithms that your OpenSSL " -"library may offer. The named constructors are much faster than :func:`new` " -"and should be preferred." +"library may offer." +msgstr "" + +msgid "Using :func:`new` with an algorithm name:" msgstr "" -msgid "Using :func:`new` with an algorithm provided by OpenSSL:" +msgid "" +"Named constructors such as these are faster than passing an algorithm name " +"to :func:`new`." +msgstr "" + +msgid "Attributes" msgstr "" -msgid "Hashlib provides the following constant attributes:" +msgid "Hashlib provides the following constant module attributes:" msgstr "" msgid "" @@ -140,6 +154,9 @@ msgid "" "(thanks to OpenSSL)." msgstr "" +msgid "Hash Objects" +msgstr "" + msgid "" "The following values are provided as constant attributes of the hash objects " "returned by the constructors:" @@ -208,9 +225,18 @@ msgid "" msgstr "" msgid "" -"Return the digest of the data passed to the :meth:`update` method so far. " -"This is a bytes object of size *length* which may contain bytes in the whole " -"range from 0 to 255." +"Return the digest of the data passed to the :meth:`~hash.update` method so " +"far. This is a bytes object of size *length* which may contain bytes in the " +"whole range from 0 to 255." +msgstr "" + +msgid "" +"Like :meth:`digest` except the digest is returned as a string object of " +"double length, containing only hexadecimal digits. This may be used to " +"exchange the value in email or other non-binary environments." +msgstr "" + +msgid "Example use:" msgstr "" msgid "File hashing" @@ -241,7 +267,7 @@ msgid "" msgstr "" msgid "Example:" -msgstr "" +msgstr "Przykład:" msgid "Key derivation" msgstr "" @@ -488,9 +514,9 @@ 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:`update` on the " -"object, and, finally, get the digest out of the object by calling :meth:" -"`digest` (or :meth:`hexdigest` for hex-encoded string)." +"`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 "" @@ -693,32 +719,34 @@ msgstr "" msgid "Another way to encode binary hashes for non-binary environments." msgstr "" -msgid "https://www.blake2.net" -msgstr "" +msgid "https://nvlpubs.nist.gov/nistpubs/fips/nist.fips.180-4.pdf" +msgstr "https://nvlpubs.nist.gov/nistpubs/fips/nist.fips.180-4.pdf" -msgid "Official BLAKE2 website." +msgid "The FIPS 180-4 publication on Secure Hash Algorithms." msgstr "" -msgid "" -"https://csrc.nist.gov/csrc/media/publications/fips/180/2/archive/2002-08-01/" -"documents/fips180-2.pdf" +msgid "https://csrc.nist.gov/publications/detail/fips/202/final" msgstr "" -msgid "The FIPS 180-2 publication on Secure Hash Algorithms." +msgid "The FIPS 202 publication on the SHA-3 Standard." msgstr "" -msgid "" -"https://en.wikipedia.org/wiki/" -"Cryptographic_hash_function#Cryptographic_hash_algorithms" +msgid "https://www.blake2.net/" +msgstr "https://www.blake2.net/" + +msgid "Official BLAKE2 website." msgstr "" +msgid "https://en.wikipedia.org/wiki/Cryptographic_hash_function" +msgstr "https://en.wikipedia.org/wiki/Cryptographic_hash_function" + msgid "" "Wikipedia article with information on which algorithms have known issues and " "what that means regarding their use." msgstr "" msgid "https://www.ietf.org/rfc/rfc8018.txt" -msgstr "" +msgstr "https://www.ietf.org/rfc/rfc8018.txt" msgid "PKCS #5: Password-Based Cryptography Specification Version 2.1" msgstr "" @@ -726,6 +754,7 @@ msgstr "" msgid "" "https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-132.pdf" msgstr "" +"https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-132.pdf" msgid "NIST Recommendation for Password-Based Key Derivation." msgstr "" @@ -733,11 +762,13 @@ msgstr "" msgid "message digest, MD5" msgstr "" -msgid "secure hash algorithm, SHA1, SHA224, SHA256, SHA384, SHA512" +msgid "" +"secure hash algorithm, SHA1, SHA2, SHA224, SHA256, SHA384, SHA512, SHA3, " +"Shake, Blake2" msgstr "" msgid "OpenSSL" -msgstr "" +msgstr "OpenSSL" msgid "(use in module hashlib)" msgstr "" diff --git a/library/heapq.po b/library/heapq.po index 8624e078c0..3a4c91d472 100644 --- a/library/heapq.po +++ b/library/heapq.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -123,6 +123,8 @@ msgstr "" 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 :term:`key function` of one argument that is used to " @@ -271,7 +273,7 @@ msgid "" "above) into the 0 position, and then percolate this new 0 down the tree, " "exchanging values, until the invariant is re-established. This is clearly " "logarithmic on the total number of items in the tree. By iterating over all " -"items, you get an O(n log n) sort." +"items, you get an *O*\\ (*n* log *n*) sort." msgstr "" msgid "" diff --git a/library/html_entities.po b/library/html.entities.po similarity index 87% rename from library/html_entities.po rename to library/html.entities.po index 8fc57ac4e0..3058bfe9f0 100644 --- a/library/html_entities.po +++ b/library/html.entities.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/html_parser.po b/library/html.parser.po similarity index 93% rename from library/html_parser.po rename to library/html.parser.po index c9d236ce20..e0f472acbe 100644 --- a/library/html_parser.po +++ b/library/html.parser.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,10 +168,10 @@ msgstr "" msgid "" "This method is called to process decimal and hexadecimal numeric character " -"references of the form ``&#NNN;`` and ``&#xNNN;``. For example, the decimal " -"equivalent for ``>`` is ``>``, whereas the hexadecimal is ``>``; " -"in this case the method will receive ``'62'`` or ``'x3E'``. This method is " -"never called if *convert_charrefs* is ``True``." +"references of the form :samp:`&#{NNN};` and :samp:`&#x{NNN};`. For example, " +"the decimal equivalent for ``>`` is ``>``, whereas the hexadecimal is " +"``>``; in this case the method will receive ``'62'`` or ``'x3E'``. " +"This method is never called if *convert_charrefs* is ``True``." msgstr "" msgid "" @@ -262,7 +262,7 @@ msgid "Parsing invalid HTML (e.g. unquoted attributes) also works::" msgstr "" msgid "HTML" -msgstr "" +msgstr "HTML" msgid "XHTML" msgstr "" diff --git a/library/http_client.po b/library/http.client.po similarity index 96% rename from library/http_client.po rename to library/http.client.po index 1e6d193fca..7114f13db3 100644 --- a/library/http_client.po +++ b/library/http.client.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -100,7 +100,7 @@ msgid "*source_address*, *context* and *check_hostname* were added." msgstr "" msgid "" -"This class now supports HTTPS virtual hosts if possible (that is, if :data:" +"This class now supports HTTPS virtual hosts if possible (that is, if :const:" "`ssl.HAS_SNI` is true)." msgstr "" @@ -111,7 +111,7 @@ msgstr "" msgid "" "This class now performs all the necessary certificate and hostname checks by " -"default. To revert to the previous, unverified, behavior :func:`ssl." +"default. To revert to the previous, unverified, behavior :func:`!ssl." "_create_unverified_context` can be passed to the *context* parameter." msgstr "" @@ -124,7 +124,7 @@ 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_protocol`." +"meth:`~ssl.SSLContext.set_alpn_protocols`." msgstr "" msgid "" @@ -153,7 +153,7 @@ msgstr "" msgid "" "Parse the headers from a file pointer *fp* representing a HTTP request/" -"response. The file has to be a :class:`BufferedIOBase` reader (i.e. not " +"response. The file has to be a :class:`~io.BufferedIOBase` reader (i.e. not " "text) and must provide a valid :rfc:`2822` style header." msgstr "" @@ -371,8 +371,9 @@ msgid "Buffer size in bytes for sending a file-like message body." msgstr "" msgid "" -"As an alternative to using the :meth:`request` method described above, you " -"can also send your request step by step, by using the four functions below." +"As an alternative to using the :meth:`~HTTPConnection.request` method " +"described above, you can also send your request step by step, by using the " +"four functions below." msgstr "" msgid "" @@ -416,7 +417,7 @@ msgid "" "malformed encoding." msgstr "" -msgid "Chunked encoding support. The *encode_chunked* parameter was added." +msgid "Added chunked encoding support and the *encode_chunked* parameter." msgstr "" msgid "" diff --git a/library/http.cookiejar.po b/library/http.cookiejar.po new file mode 100644 index 0000000000..f44f28eb43 --- /dev/null +++ b/library/http.cookiejar.po @@ -0,0 +1,788 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`http.cookiejar` --- Cookie handling for HTTP clients" +msgstr "" + +msgid "**Source code:** :source:`Lib/http/cookiejar.py`" +msgstr "" + +msgid "" +"The :mod:`http.cookiejar` module defines classes for automatic handling of " +"HTTP cookies. It is useful for accessing web sites that require small " +"pieces of data -- :dfn:`cookies` -- to be set on the client machine by an " +"HTTP response from a web server, and then returned to the server in later " +"HTTP requests." +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 " +"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`` " +"and ``port`` cookie-attributes introduced with RFC 2965." +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." +msgstr "" + +msgid "The module defines the following exception:" +msgstr "" + +msgid "" +"Instances of :class:`FileCookieJar` raise this exception on failure to load " +"cookies from a file. :exc:`LoadError` is a subclass of :exc:`OSError`." +msgstr "" + +msgid "" +":exc:`LoadError` used to be a subtype of :exc:`IOError`, which is now an " +"alias of :exc:`OSError`." +msgstr "" + +msgid "The following classes are provided:" +msgstr "" + +msgid "*policy* is an object implementing the :class:`CookiePolicy` interface." +msgstr "" + +msgid "" +"The :class:`CookieJar` class stores HTTP cookies. It extracts cookies from " +"HTTP requests, and returns them in HTTP responses. :class:`CookieJar` " +"instances automatically expire contained cookies when necessary. Subclasses " +"are also responsible for storing and retrieving cookies from a file or " +"database." +msgstr "" + +msgid "" +"*policy* is an object implementing the :class:`CookiePolicy` interface. For " +"the other arguments, see the documentation for the corresponding attributes." +msgstr "" + +msgid "" +"A :class:`CookieJar` which can load cookies from, and perhaps save cookies " +"to, a file on disk. Cookies are **NOT** loaded from the named file until " +"either the :meth:`load` or :meth:`revert` method is called. Subclasses of " +"this class are documented in section :ref:`file-cookie-jar-classes`." +msgstr "" + +msgid "" +"This should not be initialized directly – use its subclasses below instead." +msgstr "" + +msgid "The filename parameter supports a :term:`path-like object`." +msgstr "" + +msgid "" +"This class is responsible for deciding whether each cookie should be " +"accepted from / returned to the server." +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. " +"*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." +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." +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." +msgstr "" + +msgid "Module :mod:`urllib.request`" +msgstr "" + +msgid "URL opening with automatic cookie handling." +msgstr "" + +msgid "Module :mod:`http.cookies`" +msgstr "" + +msgid "" +"HTTP cookie classes, principally useful for server-side code. The :mod:" +"`http.cookiejar` and :mod:`http.cookies` modules do not depend on each other." +msgstr "" + +msgid "https://curl.se/rfc/cookie_spec.html" +msgstr "https://curl.se/rfc/cookie_spec.html" + +msgid "" +"The specification of the original Netscape cookie protocol. Though this is " +"still the dominant protocol, the 'Netscape cookie protocol' implemented by " +"all the major browsers (and :mod:`http.cookiejar`) only bears a passing " +"resemblance to the one sketched out in ``cookie_spec.html``." +msgstr "" + +msgid ":rfc:`2109` - HTTP State Management Mechanism" +msgstr "" + +msgid "Obsoleted by :rfc:`2965`. Uses :mailheader:`Set-Cookie` with version=1." +msgstr "" + +msgid ":rfc:`2965` - HTTP State Management Mechanism" +msgstr "" + +msgid "" +"The Netscape protocol with the bugs fixed. Uses :mailheader:`Set-Cookie2` " +"in place of :mailheader:`Set-Cookie`. Not widely used." +msgstr "" + +msgid "http://kristol.org/cookie/errata.html" +msgstr "" + +msgid "Unfinished errata to :rfc:`2965`." +msgstr "" + +msgid ":rfc:`2964` - Use of HTTP State Management" +msgstr "" + +msgid "CookieJar and FileCookieJar Objects" +msgstr "" + +msgid "" +":class:`CookieJar` objects support the :term:`iterator` protocol for " +"iterating over contained :class:`Cookie` objects." +msgstr "" + +msgid ":class:`CookieJar` has the following methods:" +msgstr "" + +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." +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`." +msgstr "" + +msgid "" +"*request* object needs :attr:`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." +msgstr "" + +msgid "" +"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 " +"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." +msgstr "" + +msgid "Set the :class:`CookiePolicy` instance to be used." +msgstr "" + +msgid "" +"Return sequence of :class:`Cookie` objects extracted from *response* object." +msgstr "" + +msgid "" +"See the documentation for :meth:`extract_cookies` for the interfaces " +"required of the *response* and *request* arguments." +msgstr "" + +msgid "Set a :class:`Cookie` if policy says it's OK to do so." +msgstr "" + +msgid "" +"Set a :class:`Cookie`, without checking with policy to see whether or not it " +"should be set." +msgstr "" + +msgid "Clear some cookies." +msgstr "" + +msgid "" +"If invoked without arguments, clear all cookies. If given a single " +"argument, only cookies belonging to that *domain* will be removed. If given " +"two arguments, cookies belonging to the specified *domain* and URL *path* " +"are removed. If given three arguments, then the cookie with the specified " +"*domain*, *path* and *name* is removed." +msgstr "" + +msgid "Raises :exc:`KeyError` if no matching cookie exists." +msgstr "" + +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." +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." +msgstr "" + +msgid ":class:`FileCookieJar` implements the following additional methods:" +msgstr "" + +msgid "Save cookies to a file." +msgstr "" + +msgid "" +"This base class raises :exc:`NotImplementedError`. Subclasses may leave " +"this method unimplemented." +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." +msgstr "" + +msgid "" +"*ignore_discard*: save even cookies set to be discarded. *ignore_expires*: " +"save even cookies that have expired" +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." +msgstr "" + +msgid "Load cookies from a file." +msgstr "" + +msgid "Old cookies are kept unless overwritten by newly loaded ones." +msgstr "" + +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." +msgstr "" + +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 "Clear all cookies and reload cookies from a saved file." +msgstr "" + +msgid "" +":meth:`revert` can raise the same exceptions as :meth:`load`. If there is a " +"failure, the object's state will not be altered." +msgstr "" + +msgid ":class:`FileCookieJar` instances have the following public attributes:" +msgstr "" + +msgid "" +"Filename of default file in which to keep cookies. This attribute may be " +"assigned to." +msgstr "" + +msgid "" +"If true, load cookies lazily from disk. This attribute should not be " +"assigned to. This is only a hint, since this only affects performance, not " +"behaviour (unless the cookies on disk are changing). A :class:`CookieJar` " +"object may ignore it. None of the :class:`FileCookieJar` classes included " +"in the standard library lazily loads cookies." +msgstr "" + +msgid "FileCookieJar subclasses and co-operation with web browsers" +msgstr "" + +msgid "" +"The following :class:`CookieJar` subclasses are provided for reading and " +"writing." +msgstr "" + +msgid "" +"A :class:`FileCookieJar` that can load from and save cookies to disk in the " +"Mozilla ``cookies.txt`` file format (which is also used by curl and the Lynx " +"and Netscape browsers)." +msgstr "" + +msgid "" +"This loses information about :rfc:`2965` cookies, and also about newer or " +"non-standard cookie-attributes such as ``port``." +msgstr "" + +msgid "" +"Back up your cookies before saving if you have cookies whose loss / " +"corruption would be inconvenient (there are some subtleties which may lead " +"to slight changes in the file over a load / save round-trip)." +msgstr "" + +msgid "" +"Also note that cookies saved while Mozilla is running will get clobbered by " +"Mozilla." +msgstr "" + +msgid "" +"A :class:`FileCookieJar` that can load from and save cookies to disk in " +"format compatible with the libwww-perl library's ``Set-Cookie3`` file " +"format. This is convenient if you want to store cookies in a human-readable " +"file." +msgstr "" + +msgid "CookiePolicy Objects" +msgstr "" + +msgid "" +"Objects implementing the :class:`CookiePolicy` interface have the following " +"methods:" +msgstr "" + +msgid "" +"Return boolean value indicating whether cookie should be accepted from " +"server." +msgstr "" + +msgid "" +"*cookie* is a :class:`Cookie` instance. *request* is an object implementing " +"the interface defined by the documentation for :meth:`CookieJar." +"extract_cookies`." +msgstr "" + +msgid "" +"Return boolean value indicating whether cookie should be returned to server." +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`." +msgstr "" + +msgid "" +"Return ``False`` if cookies should not be returned, given cookie domain." +msgstr "" + +msgid "" +"This method is an optimization. It removes the need for checking every " +"cookie with a particular domain (which might involve reading many files). " +"Returning true from :meth:`domain_return_ok` and :meth:`path_return_ok` " +"leaves all the work to :meth:`return_ok`." +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." +msgstr "" + +msgid "" +"Note that :meth:`domain_return_ok` is called for every *cookie* domain, not " +"just for the *request* domain. For example, the function might be called " +"with both ``\".example.com\"`` and ``\"www.example.com\"`` if the request " +"domain is ``\"www.example.com\"``. The same goes for :meth:`path_return_ok`." +msgstr "" + +msgid "The *request* argument is as documented for :meth:`return_ok`." +msgstr "" + +msgid "Return ``False`` if cookies should not be returned, given cookie path." +msgstr "" + +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." +msgstr "" + +msgid "Implement Netscape protocol." +msgstr "" + +msgid "Implement :rfc:`2965` protocol." +msgstr "" + +msgid "" +"Don't add :mailheader:`Cookie2` header to requests (the presence of this " +"header indicates to the server that we understand :rfc:`2965` cookies)." +msgstr "" + +msgid "" +"The most useful way to define a :class:`CookiePolicy` class is by " +"subclassing from :class:`DefaultCookiePolicy` and overriding some or all of " +"the methods above. :class:`CookiePolicy` itself may be used as a 'null " +"policy' to allow setting and receiving any and all cookies (this is unlikely " +"to be useful)." +msgstr "" + +msgid "DefaultCookiePolicy Objects" +msgstr "" + +msgid "Implements the standard rules for accepting and returning cookies." +msgstr "" + +msgid "" +"Both :rfc:`2965` and Netscape cookies are covered. RFC 2965 handling is " +"switched off by default." +msgstr "" + +msgid "" +"The easiest way to provide your own policy is to override this class and " +"call its methods in your overridden implementations before adding your own " +"additional checks::" +msgstr "" + +msgid "" +"In addition to the features required to implement the :class:`CookiePolicy` " +"interface, this class allows you to block and allow domains from setting and " +"receiving cookies. There are also some strictness switches that allow you " +"to tighten up the rather loose Netscape protocol rules a little bit (at the " +"cost of blocking some benign cookies)." +msgstr "" + +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`." +msgstr "" + +msgid "" +"Domains in block or allow lists that do not start with a dot must equal the " +"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." +msgstr "" + +msgid "" +":class:`DefaultCookiePolicy` implements the following additional methods:" +msgstr "" + +msgid "Return the sequence of blocked domains (as a tuple)." +msgstr "" + +msgid "Set the sequence of blocked domains." +msgstr "" + +msgid "" +"Return ``True`` if *domain* is on the blocklist for setting or receiving " +"cookies." +msgstr "" + +msgid "Return :const:`None`, or the sequence of allowed domains (as a tuple)." +msgstr "" + +msgid "Set the sequence of allowed domains, or :const:`None`." +msgstr "" + +msgid "" +"Return ``True`` if *domain* is not on the allowlist for setting or receiving " +"cookies." +msgstr "" + +msgid "" +":class:`DefaultCookiePolicy` instances have the following attributes, which " +"are all initialised from the constructor arguments of the same name, and " +"which may all be assigned to." +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." +msgstr "" + +msgid "General strictness switches:" +msgstr "" + +msgid "" +"Don't allow sites to set two-component domains with country-code top-level " +"domains like ``.co.uk``, ``.gov.uk``, ``.co.nz``.etc. This is far from " +"perfect and isn't guaranteed to work!" +msgstr "" + +msgid ":rfc:`2965` protocol strictness switches:" +msgstr "" + +msgid "" +"Follow :rfc:`2965` rules on unverifiable transactions (usually, an " +"unverifiable transaction is one resulting from a redirect or a request for " +"an image hosted on another site). If this is false, cookies are *never* " +"blocked on the basis of verifiability" +msgstr "" + +msgid "Netscape protocol strictness switches:" +msgstr "" + +msgid "" +"Apply :rfc:`2965` rules on unverifiable transactions even to Netscape " +"cookies." +msgstr "" + +msgid "" +"Flags indicating how strict to be with domain-matching rules for Netscape " +"cookies. See below for acceptable values." +msgstr "" + +msgid "" +"Ignore cookies in Set-Cookie: headers that have names starting with ``'$'``." +msgstr "" + +msgid "Don't allow setting cookies whose path doesn't path-match request URI." +msgstr "" + +msgid "" +":attr:`strict_ns_domain` is a collection of flags. Its value is constructed " +"by or-ing together (for example, ``DomainStrictNoDots|" +"DomainStrictNonDomain`` means both flags are set)." +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`` " +"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)." +msgstr "" + +msgid "When setting cookies, require a full :rfc:`2965` domain-match." +msgstr "" + +msgid "" +"The following attributes are provided for convenience, and are the most " +"useful combinations of the above flags:" +msgstr "" + +msgid "" +"Equivalent to 0 (ie. all of the above Netscape domain strictness flags " +"switched off)." +msgstr "" + +msgid "Equivalent to ``DomainStrictNoDots|DomainStrictNonDomain``." +msgstr "" + +msgid "Cookie Objects" +msgstr "" + +msgid "" +":class:`Cookie` instances have Python attributes roughly corresponding to " +"the standard cookie-attributes specified in the various cookie standards. " +"The correspondence is not one-to-one, because there are complicated rules " +"for assigning default values, because the ``max-age`` and ``expires`` cookie-" +"attributes contain equivalent information, and because :rfc:`2109` cookies " +"may be 'downgraded' by :mod:`http.cookiejar` from version 1 to version 0 " +"(Netscape) cookies." +msgstr "" + +msgid "" +"Assignment to these attributes should not be necessary other than in rare " +"circumstances in a :class:`CookiePolicy` method. The class does not enforce " +"internal consistency, so you should know what you're doing if you do that." +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." +msgstr "" + +msgid "Cookie name (a string)." +msgstr "" + +msgid "Cookie value (a string), or :const:`None`." +msgstr "" + +msgid "" +"String representing a port or a set of ports (eg. '80', or '80,8080'), or :" +"const:`None`." +msgstr "" + +msgid "Cookie domain (a string)." +msgstr "" + +msgid "Cookie path (a string, eg. ``'/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." +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`." +msgstr "" + +msgid "" +"URL linking to a comment from the server explaining the function of this " +"cookie, or :const:`None`." +msgstr "" + +msgid "" +"``True`` if this cookie was received as an :rfc:`2109` cookie (ie. 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 " +"cookies, in which case :attr:`version` is 0." +msgstr "" + +msgid "" +"``True`` if a port or set of ports was explicitly specified by the server " +"(in the :mailheader:`Set-Cookie` / :mailheader:`Set-Cookie2` header)." +msgstr "" + +msgid "``True`` if a domain was explicitly specified by the server." +msgstr "" + +msgid "" +"``True`` if the domain explicitly specified by the server began with a dot " +"(``'.'``)." +msgstr "" + +msgid "" +"Cookies may have additional non-standard cookie-attributes. These may be " +"accessed using the following methods:" +msgstr "" + +msgid "Return ``True`` if cookie has the named cookie-attribute." +msgstr "" + +msgid "" +"If cookie has the named cookie-attribute, return its value. Otherwise, " +"return *default*." +msgstr "" + +msgid "Set the value of the named cookie-attribute." +msgstr "" + +msgid "The :class:`Cookie` class also defines the following method:" +msgstr "" + +msgid "" +"``True`` if cookie has passed the time at which the server requested it " +"should expire. If *now* is given (in seconds since the epoch), return " +"whether the cookie has expired at the specified time." +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid "" +"The first example shows the most common usage of :mod:`http.cookiejar`::" +msgstr "" + +msgid "" +"This example illustrates how to open a URL using your Netscape, Mozilla, or " +"Lynx cookies (assumes Unix/Netscape convention for location of the cookies " +"file)::" +msgstr "" + +msgid "" +"The next example illustrates the use of :class:`DefaultCookiePolicy`. Turn " +"on :rfc:`2965` cookies, be more strict about domains when setting and " +"returning Netscape cookies, and block some domains from setting cookies or " +"having them returned::" +msgstr "" diff --git a/library/http_cookies.po b/library/http.cookies.po similarity index 83% rename from library/http_cookies.po rename to library/http.cookies.po index 25904c91fd..c2ad8fcc61 100644 --- a/library/http_cookies.po +++ b/library/http.cookies.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,19 +39,19 @@ 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 doesn't follow the character rules outlined in those specs and " -"also many current day browsers and servers have relaxed parsing rules when " -"comes to Cookie handling. As a result, the parsing rules used are a bit " -"less strict." +"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 "" "The character set, :data:`string.ascii_letters`, :data:`string.digits` and " "``!#$%&'*+-.^_`|~:`` denote the set of valid characters allowed by this " -"module in Cookie name (as :attr:`~Morsel.key`)." +"module in a cookie name (as :attr:`~Morsel.key`)." msgstr "" -msgid "Allowed ':' as a valid Cookie name character." +msgid "Allowed ':' as a valid cookie name character." msgstr "" msgid "" @@ -76,11 +76,11 @@ msgid "If *input* is given, it is passed to the :meth:`load` method." msgstr "" msgid "" -"This class derives from :class:`BaseCookie` and overrides :meth:" -"`value_decode` and :meth:`value_encode`. SimpleCookie supports strings as " -"cookie values. When setting the value, 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`" @@ -146,34 +146,7 @@ msgstr "" msgid "" "Morsels are dictionary-like objects, whose set of keys is constant --- the " -"valid :rfc:`2109` attributes, which are" -msgstr "" - -msgid "``expires``" -msgstr "" - -msgid "``path``" -msgstr "" - -msgid "``comment``" -msgstr "" - -msgid "``domain``" -msgstr "" - -msgid "``max-age``" -msgstr "" - -msgid "``secure``" -msgstr "" - -msgid "``version``" -msgstr "``wersja``" - -msgid "``httponly``" -msgstr "" - -msgid "``samesite``" +"valid :rfc:`2109` attributes, which are:" msgstr "" msgid "" @@ -192,8 +165,8 @@ msgid "The keys are case-insensitive and their default value is ``''``." msgstr "" msgid "" -":meth:`~Morsel.__eq__` now takes :attr:`~Morsel.key` and :attr:`~Morsel." -"value` into account." +":meth:`!__eq__` now takes :attr:`~Morsel.key` and :attr:`~Morsel.value` into " +"account." msgstr "" msgid "" @@ -257,7 +230,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "" "The following example demonstrates how to use the :mod:`http.cookies` module." diff --git a/library/http.po b/library/http.po new file mode 100644 index 0000000000..25671ecde8 --- /dev/null +++ b/library/http.po @@ -0,0 +1,735 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`http` --- HTTP modules" +msgstr "" + +msgid "**Source code:** :source:`Lib/http/__init__.py`" +msgstr "" + +msgid "" +":mod:`http` is a package that collects several modules for working with the " +"HyperText Transfer Protocol:" +msgstr "" + +msgid "" +":mod:`http.client` is a low-level HTTP protocol client; for high-level URL " +"opening use :mod:`urllib.request`" +msgstr "" + +msgid "" +":mod:`http.server` contains basic HTTP server classes based on :mod:" +"`socketserver`" +msgstr "" + +msgid "" +":mod:`http.cookies` has utilities for implementing state management with " +"cookies" +msgstr "" + +msgid ":mod:`http.cookiejar` provides persistence of cookies" +msgstr "" + +msgid "" +"The :mod:`http` module also defines the following enums that help you work " +"with http related code:" +msgstr "" + +msgid "" +"A subclass of :class:`enum.IntEnum` that defines a set of HTTP status codes, " +"reason phrases and long descriptions written in English." +msgstr "" + +msgid "Usage::" +msgstr "" + +msgid "HTTP status codes" +msgstr "" + +msgid "" +"Supported, `IANA-registered status codes `_ available in :class:`http." +"HTTPStatus` are:" +msgstr "" + +msgid "Code" +msgstr "" + +msgid "Enum Name" +msgstr "" + +msgid "Details" +msgstr "Szczegóły" + +msgid "``100``" +msgstr "``100``" + +msgid "``CONTINUE``" +msgstr "``CONTINUE``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.2.1" +msgstr "" + +msgid "``101``" +msgstr "``101``" + +msgid "``SWITCHING_PROTOCOLS``" +msgstr "``SWITCHING_PROTOCOLS``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.2.2" +msgstr "" + +msgid "``102``" +msgstr "``102``" + +msgid "``PROCESSING``" +msgstr "``PROCESSING``" + +msgid "WebDAV :rfc:`2518`, Section 10.1" +msgstr "" + +msgid "``103``" +msgstr "``103``" + +msgid "``EARLY_HINTS``" +msgstr "``EARLY_HINTS``" + +msgid "An HTTP Status Code for Indicating Hints :rfc:`8297`" +msgstr "" + +msgid "``200``" +msgstr "``200``" + +msgid "``OK``" +msgstr "``OK``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.3.1" +msgstr "" + +msgid "``201``" +msgstr "``201``" + +msgid "``CREATED``" +msgstr "``CREATED``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.3.2" +msgstr "" + +msgid "``202``" +msgstr "``202``" + +msgid "``ACCEPTED``" +msgstr "``ACCEPTED``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.3.3" +msgstr "" + +msgid "``203``" +msgstr "``203``" + +msgid "``NON_AUTHORITATIVE_INFORMATION``" +msgstr "``NON_AUTHORITATIVE_INFORMATION``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.3.4" +msgstr "" + +msgid "``204``" +msgstr "``204``" + +msgid "``NO_CONTENT``" +msgstr "``NO_CONTENT``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.3.5" +msgstr "" + +msgid "``205``" +msgstr "``205``" + +msgid "``RESET_CONTENT``" +msgstr "``RESET_CONTENT``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.3.6" +msgstr "" + +msgid "``206``" +msgstr "``206``" + +msgid "``PARTIAL_CONTENT``" +msgstr "``PARTIAL_CONTENT``" + +msgid "HTTP/1.1 :rfc:`7233`, Section 4.1" +msgstr "" + +msgid "``207``" +msgstr "``207``" + +msgid "``MULTI_STATUS``" +msgstr "``MULTI_STATUS``" + +msgid "WebDAV :rfc:`4918`, Section 11.1" +msgstr "" + +msgid "``208``" +msgstr "``208``" + +msgid "``ALREADY_REPORTED``" +msgstr "" + +msgid "WebDAV Binding Extensions :rfc:`5842`, Section 7.1 (Experimental)" +msgstr "" + +msgid "``226``" +msgstr "``226``" + +msgid "``IM_USED``" +msgstr "``IM_USED``" + +msgid "Delta Encoding in HTTP :rfc:`3229`, Section 10.4.1" +msgstr "" + +msgid "``300``" +msgstr "``300``" + +msgid "``MULTIPLE_CHOICES``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.4.1" +msgstr "" + +msgid "``301``" +msgstr "``301``" + +msgid "``MOVED_PERMANENTLY``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.4.2" +msgstr "" + +msgid "``302``" +msgstr "``302``" + +msgid "``FOUND``" +msgstr "``FOUND``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.4.3" +msgstr "" + +msgid "``303``" +msgstr "``303``" + +msgid "``SEE_OTHER``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.4.4" +msgstr "" + +msgid "``304``" +msgstr "``304``" + +msgid "``NOT_MODIFIED``" +msgstr "``NOT_MODIFIED``" + +msgid "HTTP/1.1 :rfc:`7232`, Section 4.1" +msgstr "" + +msgid "``305``" +msgstr "``305``" + +msgid "``USE_PROXY``" +msgstr "``USE_PROXY``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.4.5" +msgstr "" + +msgid "``307``" +msgstr "``307``" + +msgid "``TEMPORARY_REDIRECT``" +msgstr "``TEMPORARY_REDIRECT``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.4.7" +msgstr "" + +msgid "``308``" +msgstr "``308``" + +msgid "``PERMANENT_REDIRECT``" +msgstr "``PERMANENT_REDIRECT``" + +msgid "Permanent Redirect :rfc:`7238`, Section 3 (Experimental)" +msgstr "" + +msgid "``400``" +msgstr "``400``" + +msgid "``BAD_REQUEST``" +msgstr "``BAD_REQUEST``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.1" +msgstr "" + +msgid "``401``" +msgstr "``401``" + +msgid "``UNAUTHORIZED``" +msgstr "``UNAUTHORIZED``" + +msgid "HTTP/1.1 Authentication :rfc:`7235`, Section 3.1" +msgstr "" + +msgid "``402``" +msgstr "``402``" + +msgid "``PAYMENT_REQUIRED``" +msgstr "``PAYMENT_REQUIRED``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.2" +msgstr "" + +msgid "``403``" +msgstr "``403``" + +msgid "``FORBIDDEN``" +msgstr "``FORBIDDEN``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.3" +msgstr "" + +msgid "``404``" +msgstr "``404``" + +msgid "``NOT_FOUND``" +msgstr "``NOT_FOUND``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.4" +msgstr "" + +msgid "``405``" +msgstr "``405``" + +msgid "``METHOD_NOT_ALLOWED``" +msgstr "``METHOD_NOT_ALLOWED``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.5" +msgstr "" + +msgid "``406``" +msgstr "``406``" + +msgid "``NOT_ACCEPTABLE``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.6" +msgstr "" + +msgid "``407``" +msgstr "``407``" + +msgid "``PROXY_AUTHENTICATION_REQUIRED``" +msgstr "``PROXY_AUTHENTICATION_REQUIRED``" + +msgid "HTTP/1.1 Authentication :rfc:`7235`, Section 3.2" +msgstr "" + +msgid "``408``" +msgstr "``408``" + +msgid "``REQUEST_TIMEOUT``" +msgstr "``REQUEST_TIMEOUT``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.7" +msgstr "" + +msgid "``409``" +msgstr "``409``" + +msgid "``CONFLICT``" +msgstr "``CONFLICT``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.8" +msgstr "" + +msgid "``410``" +msgstr "``410``" + +msgid "``GONE``" +msgstr "``GONE``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.9" +msgstr "" + +msgid "``411``" +msgstr "``411``" + +msgid "``LENGTH_REQUIRED``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.10" +msgstr "" + +msgid "``412``" +msgstr "``412``" + +msgid "``PRECONDITION_FAILED``" +msgstr "``PRECONDITION_FAILED``" + +msgid "HTTP/1.1 :rfc:`7232`, Section 4.2" +msgstr "" + +msgid "``413``" +msgstr "``413``" + +msgid "``REQUEST_ENTITY_TOO_LARGE``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.11" +msgstr "" + +msgid "``414``" +msgstr "``414``" + +msgid "``REQUEST_URI_TOO_LONG``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.12" +msgstr "" + +msgid "``415``" +msgstr "``415``" + +msgid "``UNSUPPORTED_MEDIA_TYPE``" +msgstr "``UNSUPPORTED_MEDIA_TYPE``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.13" +msgstr "" + +msgid "``416``" +msgstr "``416``" + +msgid "``REQUESTED_RANGE_NOT_SATISFIABLE``" +msgstr "" + +msgid "HTTP/1.1 Range Requests :rfc:`7233`, Section 4.4" +msgstr "" + +msgid "``417``" +msgstr "``417``" + +msgid "``EXPECTATION_FAILED``" +msgstr "``EXPECTATION_FAILED``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.14" +msgstr "" + +msgid "``418``" +msgstr "``418``" + +msgid "``IM_A_TEAPOT``" +msgstr "``IM_A_TEAPOT``" + +msgid "HTCPCP/1.0 :rfc:`2324`, Section 2.3.2" +msgstr "" + +msgid "``421``" +msgstr "``421``" + +msgid "``MISDIRECTED_REQUEST``" +msgstr "" + +msgid "HTTP/2 :rfc:`7540`, Section 9.1.2" +msgstr "" + +msgid "``422``" +msgstr "``422``" + +msgid "``UNPROCESSABLE_ENTITY``" +msgstr "" + +msgid "WebDAV :rfc:`4918`, Section 11.2" +msgstr "" + +msgid "``423``" +msgstr "``423``" + +msgid "``LOCKED``" +msgstr "``LOCKED``" + +msgid "WebDAV :rfc:`4918`, Section 11.3" +msgstr "" + +msgid "``424``" +msgstr "``424``" + +msgid "``FAILED_DEPENDENCY``" +msgstr "``FAILED_DEPENDENCY``" + +msgid "WebDAV :rfc:`4918`, Section 11.4" +msgstr "" + +msgid "``425``" +msgstr "``425``" + +msgid "``TOO_EARLY``" +msgstr "``TOO_EARLY``" + +msgid "Using Early Data in HTTP :rfc:`8470`" +msgstr "" + +msgid "``426``" +msgstr "``426``" + +msgid "``UPGRADE_REQUIRED``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.5.15" +msgstr "" + +msgid "``428``" +msgstr "``428``" + +msgid "``PRECONDITION_REQUIRED``" +msgstr "``PRECONDITION_REQUIRED``" + +msgid "Additional HTTP Status Codes :rfc:`6585`" +msgstr "" + +msgid "``429``" +msgstr "``429``" + +msgid "``TOO_MANY_REQUESTS``" +msgstr "``TOO_MANY_REQUESTS``" + +msgid "``431``" +msgstr "``431``" + +msgid "``REQUEST_HEADER_FIELDS_TOO_LARGE``" +msgstr "``REQUEST_HEADER_FIELDS_TOO_LARGE``" + +msgid "``451``" +msgstr "``451``" + +msgid "``UNAVAILABLE_FOR_LEGAL_REASONS``" +msgstr "``UNAVAILABLE_FOR_LEGAL_REASONS``" + +msgid "An HTTP Status Code to Report Legal Obstacles :rfc:`7725`" +msgstr "" + +msgid "``500``" +msgstr "``500``" + +msgid "``INTERNAL_SERVER_ERROR``" +msgstr "``INTERNAL_SERVER_ERROR``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.6.1" +msgstr "" + +msgid "``501``" +msgstr "``501``" + +msgid "``NOT_IMPLEMENTED``" +msgstr "``NOT_IMPLEMENTED``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.6.2" +msgstr "" + +msgid "``502``" +msgstr "``502``" + +msgid "``BAD_GATEWAY``" +msgstr "``BAD_GATEWAY``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.6.3" +msgstr "" + +msgid "``503``" +msgstr "``503``" + +msgid "``SERVICE_UNAVAILABLE``" +msgstr "``SERVICE_UNAVAILABLE``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.6.4" +msgstr "" + +msgid "``504``" +msgstr "``504``" + +msgid "``GATEWAY_TIMEOUT``" +msgstr "``GATEWAY_TIMEOUT``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.6.5" +msgstr "" + +msgid "``505``" +msgstr "``505``" + +msgid "``HTTP_VERSION_NOT_SUPPORTED``" +msgstr "``HTTP_VERSION_NOT_SUPPORTED``" + +msgid "HTTP/1.1 :rfc:`7231`, Section 6.6.6" +msgstr "" + +msgid "``506``" +msgstr "``506``" + +msgid "``VARIANT_ALSO_NEGOTIATES``" +msgstr "" + +msgid "" +"Transparent Content Negotiation in HTTP :rfc:`2295`, Section 8.1 " +"(Experimental)" +msgstr "" + +msgid "``507``" +msgstr "``507``" + +msgid "``INSUFFICIENT_STORAGE``" +msgstr "" + +msgid "WebDAV :rfc:`4918`, Section 11.5" +msgstr "" + +msgid "``508``" +msgstr "``508``" + +msgid "``LOOP_DETECTED``" +msgstr "``LOOP_DETECTED``" + +msgid "WebDAV Binding Extensions :rfc:`5842`, Section 7.2 (Experimental)" +msgstr "" + +msgid "``510``" +msgstr "``510``" + +msgid "``NOT_EXTENDED``" +msgstr "``NOT_EXTENDED``" + +msgid "An HTTP Extension Framework :rfc:`2774`, Section 7 (Experimental)" +msgstr "" + +msgid "``511``" +msgstr "``511``" + +msgid "``NETWORK_AUTHENTICATION_REQUIRED``" +msgstr "``NETWORK_AUTHENTICATION_REQUIRED``" + +msgid "Additional HTTP Status Codes :rfc:`6585`, Section 6" +msgstr "" + +msgid "" +"In order to preserve backwards compatibility, enum values are also present " +"in the :mod:`http.client` module in the form of constants. The enum name is " +"equal to the constant name (i.e. ``http.HTTPStatus.OK`` is also available as " +"``http.client.OK``)." +msgstr "" + +msgid "Added ``421 MISDIRECTED_REQUEST`` status code." +msgstr "" + +msgid "Added ``451 UNAVAILABLE_FOR_LEGAL_REASONS`` status code." +msgstr "" + +msgid "" +"Added ``103 EARLY_HINTS``, ``418 IM_A_TEAPOT`` and ``425 TOO_EARLY`` status " +"codes." +msgstr "" + +msgid "" +"A subclass of :class:`enum.StrEnum` that defines a set of HTTP methods and " +"descriptions written in English." +msgstr "" + +msgid "HTTP methods" +msgstr "" + +msgid "" +"Supported, `IANA-registered methods `_ available in :class:`http.HTTPMethod` are:" +msgstr "" + +msgid "Method" +msgstr "" + +msgid "``GET``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.1" +msgstr "" + +msgid "``HEAD``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.2" +msgstr "" + +msgid "``POST``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.3" +msgstr "" + +msgid "``PUT``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.4" +msgstr "" + +msgid "``DELETE``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.5" +msgstr "" + +msgid "``CONNECT``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.6" +msgstr "" + +msgid "``OPTIONS``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.7" +msgstr "" + +msgid "``TRACE``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`7231`, Section 4.3.8" +msgstr "" + +msgid "``PATCH``" +msgstr "" + +msgid "HTTP/1.1 :rfc:`5789`" +msgstr "" + +msgid "HTTP" +msgstr "" + +msgid "protocol" +msgstr "" + +msgid "http (standard module)" +msgstr "" diff --git a/library/http.server.po b/library/http.server.po new file mode 100644 index 0000000000..52fc68a486 --- /dev/null +++ b/library/http.server.po @@ -0,0 +1,575 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`http.server` --- HTTP servers" +msgstr "" + +msgid "**Source code:** :source:`Lib/http/server.py`" +msgstr "" + +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 `." +msgstr "" + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + +msgid "" +"One class, :class:`HTTPServer`, is a :class:`socketserver.TCPServer` " +"subclass. It creates and listens at the HTTP socket, dispatching the " +"requests to a handler. Code to create and run the server looks like this::" +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." +msgstr "" + +msgid "" +"This class is identical to HTTPServer but uses threads to handle requests by " +"using the :class:`~socketserver.ThreadingMixIn`. This is useful to handle " +"web browsers pre-opening sockets, on which :class:`HTTPServer` would wait " +"indefinitely." +msgstr "" + +msgid "" +"The :class:`HTTPServer` and :class:`ThreadingHTTPServer` must be given a " +"*RequestHandlerClass* on instantiation, of which this module provides three " +"different variants:" +msgstr "" + +msgid "" +"This class is used to handle the HTTP requests that arrive at the server. " +"By itself, it cannot respond to any actual HTTP requests; it must be " +"subclassed to handle each request method (e.g. GET or POST). :class:" +"`BaseHTTPRequestHandler` provides a number of class and instance variables, " +"and methods for use by subclasses." +msgstr "" + +msgid "" +"The handler will parse the request and the headers, then call a method " +"specific to the request type. The method name is constructed from the " +"request. For example, for the request method ``SPAM``, the :meth:`!do_SPAM` " +"method will be called with no arguments. All of the relevant information is " +"stored in instance variables of the handler. Subclasses should not need to " +"override or extend the :meth:`!__init__` method." +msgstr "" + +msgid ":class:`BaseHTTPRequestHandler` has the following instance variables:" +msgstr "" + +msgid "" +"Contains a tuple of the form ``(host, port)`` referring to the client's " +"address." +msgstr "" + +msgid "Contains the server instance." +msgstr "" + +msgid "" +"Boolean that should be set before :meth:`handle_one_request` returns, " +"indicating if another request may be expected, or if the connection should " +"be shut down." +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." +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``." +msgstr "" + +msgid "" +"Contains the version string from the request. For example, ``'HTTP/1.0'``." +msgstr "" + +msgid "" +"Holds an instance of the class specified by the :attr:`MessageClass` class " +"variable. This instance parses and manages the headers in the HTTP request. " +"The :func:`~http.client.parse_headers` function from :mod:`http.client` is " +"used to parse the headers and it requires that the HTTP request provide a " +"valid :rfc:`2822` style header." +msgstr "" + +msgid "" +"An :class:`io.BufferedIOBase` input stream, ready to read from the start of " +"the optional input data." +msgstr "" + +msgid "" +"Contains the output stream for writing a response back to the client. Proper " +"adherence to the HTTP protocol must be used when writing to this stream in " +"order to achieve successful interoperation with HTTP clients." +msgstr "" + +msgid "This is an :class:`io.BufferedIOBase` stream." +msgstr "" + +msgid ":class:`BaseHTTPRequestHandler` has the following attributes:" +msgstr "" + +msgid "" +"Specifies the server software version. You may want to override this. The " +"format is multiple whitespace-separated strings, where each string is of the " +"form name[/version]. For example, ``'BaseHTTP/0.2'``." +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'``." +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 " +"passed to :meth:`send_error`." +msgstr "" + +msgid "" +"Specifies the Content-Type HTTP header of error responses sent to the " +"client. The default value is ``'text/html'``." +msgstr "" + +msgid "" +"Specifies the HTTP version to which the server is conformant. It is sent in " +"responses to let the client know the server's communication capabilities for " +"future requests. If set to ``'HTTP/1.1'``, the server will permit HTTP " +"persistent connections; however, your server *must* then include an accurate " +"``Content-Length`` header (using :meth:`send_header`) in all of its " +"responses to clients. For backwards compatibility, the setting defaults to " +"``'HTTP/1.0'``." +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`." +msgstr "" + +msgid "" +"This attribute contains a mapping of error code integers to two-element " +"tuples containing a short and long message. For example, ``{code: " +"(shortmessage, longmessage)}``. The *shortmessage* is usually used as the " +"*message* key in an error response, and *longmessage* as the *explain* key. " +"It is used by :meth:`send_response_only` and :meth:`send_error` methods." +msgstr "" + +msgid "A :class:`BaseHTTPRequestHandler` instance has the following methods:" +msgstr "" + +msgid "" +"Calls :meth:`handle_one_request` once (or, if persistent connections are " +"enabled, multiple times) to handle incoming HTTP requests. You should never " +"need to override it; instead, implement appropriate :meth:`!do_\\*` methods." +msgstr "" + +msgid "" +"This method will parse and dispatch the request to the appropriate :meth:`!" +"do_\\*` method. You should never need to override it." +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 e.g. server can choose to send " +"``417 Expectation Failed`` as a response header and ``return False``." +msgstr "" + +msgid "" +"Sends and logs a complete error reply to the client. The numeric *code* " +"specifies the HTTP error code, with *message* as an optional, short, human " +"readable description of the error. The *explain* argument can be used to " +"provide more detailed information about the error; it will be formatted " +"using the :attr:`error_message_format` attribute and emitted, after a " +"complete set of headers, as the response body. The :attr:`responses` " +"attribute holds the default values for *message* and *explain* that will be " +"used if no value is provided; for unknown codes the default value for both " +"is the string ``???``. The body will be empty if the method is HEAD or the " +"response code is one of the following: :samp:`1{xx}`, ``204 No Content``, " +"``205 Reset Content``, ``304 Not Modified``." +msgstr "" + +msgid "" +"The error response includes a Content-Length header. Added the *explain* " +"argument." +msgstr "" + +msgid "" +"Adds a response header to the headers buffer and logs the accepted request. " +"The HTTP response line is written to the internal buffer, followed by " +"*Server* and *Date* headers. The values for these two headers are picked up " +"from the :meth:`version_string` and :meth:`date_time_string` methods, " +"respectively. If the server does not intend to send any other headers using " +"the :meth:`send_header` method, then :meth:`send_response` should be " +"followed by an :meth:`end_headers` call." +msgstr "" + +msgid "" +"Headers are stored to an internal buffer and :meth:`end_headers` needs to be " +"called explicitly." +msgstr "" + +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." +msgstr "" + +msgid "Headers are stored in an internal buffer." +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." +msgstr "" + +msgid "" +"Adds a blank line (indicating the end of the HTTP headers in the response) " +"to the headers buffer and calls :meth:`flush_headers()`." +msgstr "" + +msgid "The buffered headers are written to the output stream." +msgstr "" + +msgid "" +"Finally send the headers to the output stream and flush the internal headers " +"buffer." +msgstr "" + +msgid "" +"Logs an accepted (successful) request. *code* should specify the numeric " +"HTTP code associated with the response. If a size of the response is " +"available, then it should be passed as the *size* parameter." +msgstr "" + +msgid "" +"Logs an error when a request cannot be fulfilled. By default, it passes the " +"message to :meth:`log_message`, so it takes the same arguments (*format* and " +"additional values)." +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." +msgstr "" + +msgid "" +"Returns the server software's version string. This is a combination of the :" +"attr:`server_version` and :attr:`sys_version` attributes." +msgstr "" + +msgid "" +"Returns the date and time given by *timestamp* (which must be ``None`` or in " +"the format returned by :func:`time.time`), formatted for a message header. " +"If *timestamp* is omitted, it uses the current date and time." +msgstr "" + +msgid "The result looks like ``'Sun, 06 Nov 1994 08:49:37 GMT'``." +msgstr "" + +msgid "Returns the current date and time, formatted for logging." +msgstr "" + +msgid "Returns the client address." +msgstr "" + +msgid "" +"Previously, a name lookup was performed. To avoid name resolution delays, it " +"now always returns the IP address." +msgstr "" + +msgid "" +"This class serves files from the directory *directory* and below, or the " +"current directory if *directory* is not provided, directly mapping the " +"directory structure to HTTP requests." +msgstr "" + +msgid "Added the *directory* parameter." +msgstr "" + +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." +msgstr "" + +msgid "" +"The following are defined as class-level attributes of :class:" +"`SimpleHTTPRequestHandler`:" +msgstr "" + +msgid "" +"This will be ``\"SimpleHTTP/\" + __version__``, where ``__version__`` is " +"defined at the module level." +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 " +"should contain only lower-cased keys." +msgstr "" + +msgid "" +"This dictionary is no longer filled with the default system mappings, but " +"only contains overrides." +msgstr "" + +msgid "" +"The :class:`SimpleHTTPRequestHandler` class defines the following methods:" +msgstr "" + +msgid "" +"This method serves the ``'HEAD'`` request type: it sends the headers it " +"would send for the equivalent ``GET`` request. See the :meth:`do_GET` method " +"for a more complete explanation of the possible headers." +msgstr "" + +msgid "" +"The request is mapped to a local file by interpreting the request as a path " +"relative to the current working directory." +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." +msgstr "" + +msgid "" +"If the request was mapped to a file, it is opened. Any :exc:`OSError` " +"exception in opening the requested file is mapped to a ``404``, ``'File not " +"found'`` error. If there was a ``'If-Modified-Since'`` header in the " +"request, and the file was not modified after this time, a ``304``, ``'Not " +"Modified'`` response is sent. Otherwise, the content type is guessed by " +"calling the :meth:`guess_type` method, which in turn uses the " +"*extensions_map* variable, and the file contents are returned." +msgstr "" + +msgid "" +"A ``'Content-type:'`` header with the guessed content type is output, " +"followed by a ``'Content-Length:'`` header with the file's size and a " +"``'Last-Modified:'`` header with the file's modification time." +msgstr "" + +msgid "" +"Then follows a blank line signifying the end of the headers, and then the " +"contents of the file are output. If the file's MIME type starts with ``text/" +"`` the file is opened in text mode; otherwise binary mode is used." +msgstr "" + +msgid "" +"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 "" +"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::" +msgstr "" + +msgid "" +":mod:`http.server` can also be invoked directly using the :option:`-m` " +"switch of the interpreter. Similar to the previous example, this serves " +"files relative to the current directory::" +msgstr "" + +msgid "" +"The server listens to port 8000 by default. The default can be overridden by " +"passing the desired port number as an argument::" +msgstr "" + +msgid "" +"By default, the server binds itself to all interfaces. The option ``-b/--" +"bind`` specifies a specific address to which it should bind. Both IPv4 and " +"IPv6 addresses are supported. For example, the following command causes the " +"server to bind to localhost only::" +msgstr "" + +msgid "Added the ``--bind`` option." +msgstr "" + +msgid "Support IPv6 in the ``--bind`` option." +msgstr "" + +msgid "" +"By default, the server uses the current directory. The option ``-d/--" +"directory`` specifies a directory to which it should serve the files. For " +"example, the following command uses a specific directory::" +msgstr "" + +msgid "Added the ``--directory`` option." +msgstr "" + +msgid "" +"By default, the server is conformant to HTTP/1.0. The option ``-p/--" +"protocol`` specifies the HTTP version to which the server is conformant. For " +"example, the following command runs an HTTP/1.1 conformant server::" +msgstr "" + +msgid "Added the ``--protocol`` option." +msgstr "" + +msgid "" +"This class is used to serve either files or output of CGI scripts from the " +"current directory and below. Note that mapping HTTP hierarchic structure to " +"local directory structure is exactly as in :class:`SimpleHTTPRequestHandler`." +msgstr "" + +msgid "" +"CGI scripts run by the :class:`CGIHTTPRequestHandler` class cannot execute " +"redirects (HTTP code 302), because code 200 (script output follows) is sent " +"prior to execution of the CGI script. This pre-empts the status code." +msgstr "" + +msgid "" +"The class will however, run the CGI script, instead of serving it as a file, " +"if it guesses it to be a CGI script. Only directory-based CGI are used --- " +"the other common server configuration is to treat special extensions as " +"denoting CGI scripts." +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." +msgstr "" + +msgid "The :class:`CGIHTTPRequestHandler` defines the following data member:" +msgstr "" + +msgid "" +"This defaults to ``['/cgi-bin', '/htbin']`` and describes directories to " +"treat as containing CGI scripts." +msgstr "" + +msgid "The :class:`CGIHTTPRequestHandler` defines the following method:" +msgstr "" + +msgid "" +"This method serves the ``'POST'`` request type, only allowed for CGI " +"scripts. Error 501, \"Can only POST to CGI scripts\", is output when trying " +"to POST to a non-CGI url." +msgstr "" + +msgid "" +"Note that CGI scripts will be run with UID of user nobody, for security " +"reasons. Problems with the CGI script will be translated to error 403." +msgstr "" + +msgid "" +":class:`CGIHTTPRequestHandler` can be enabled in the command line by passing " +"the ``--cgi`` option::" +msgstr "" + +msgid "" +":class:`CGIHTTPRequestHandler` and the ``--cgi`` command line option are not " +"intended for use by untrusted clients and may be vulnerable to exploitation. " +"Always use within a secure environment." +msgstr "" + +msgid "Security Considerations" +msgstr "" + +msgid "" +":class:`SimpleHTTPRequestHandler` will follow symbolic links when handling " +"requests, this makes it possible for files outside of the specified " +"directory to be served." +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." +msgstr "" + +msgid "Control characters are scrubbed in stderr logs." +msgstr "" + +msgid "WWW" +msgstr "WWW" + +msgid "server" +msgstr "" + +msgid "HTTP" +msgstr "" + +msgid "protocol" +msgstr "" + +msgid "URL" +msgstr "URL" + +msgid "httpd" +msgstr "" + +msgid "http.server" +msgstr "" + +msgid "security" +msgstr "" diff --git a/library/imghdr.po b/library/imghdr.po index d60c044312..a59942b307 100644 --- a/library/imghdr.po +++ b/library/imghdr.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,4 +160,4 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" diff --git a/library/imp.po b/library/imp.po index 332484226a..9c052acc45 100644 --- a/library/imp.po +++ b/library/imp.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -400,10 +400,10 @@ msgid "statement" msgstr "instrukcja" msgid "import" -msgstr "" +msgstr "import" msgid "file" -msgstr "" +msgstr "plik" msgid "byte-code" msgstr "" diff --git a/library/importlib_metadata.po b/library/importlib.metadata.po similarity index 95% rename from library/importlib_metadata.po rename to library/importlib.metadata.po index b3d553a6f2..a25c79c941 100644 --- a/library/importlib_metadata.po +++ b/library/importlib.metadata.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 "Using :mod:`!importlib.metadata`" +msgid ":mod:`!importlib.metadata` -- Accessing package metadata" msgstr "" msgid "``importlib.metadata`` is no longer provisional." @@ -33,7 +33,7 @@ msgid "**Source code:** :source:`Lib/importlib/metadata/__init__.py`" msgstr "" msgid "" -"``importlib_metadata`` is a library that provides access to the metadata of " +"``importlib.metadata`` is a library that provides access to the metadata of " "an installed `Distribution Package `_, such as its entry points or its top-" "level names (`Import Package `_. Specifically, it works with distributions " "with discoverable ``dist-info`` or ``egg-info`` directories, and metadata " @@ -71,7 +71,7 @@ msgid "" msgstr "" msgid "https://importlib-metadata.readthedocs.io/" -msgstr "" +msgstr "https://importlib-metadata.readthedocs.io/" msgid "" "The documentation for ``importlib_metadata``, which supplies a backport of " @@ -333,7 +333,7 @@ msgid "" msgstr "" msgid "" -"By default ``importlib_metadata`` installs a finder for distribution " +"By default ``importlib.metadata`` installs a finder for distribution " "packages found on the file system. This finder doesn't actually find any " "*distributions*, but it can find their metadata." msgstr "" diff --git a/library/importlib.po b/library/importlib.po index 532d412c99..ab8e708c8e 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-14 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +67,7 @@ msgid "" msgstr "" msgid ":ref:`import`" -msgstr "" +msgstr ":ref:`import`" msgid "The language reference for the :keyword:`import` statement." msgstr "" @@ -76,6 +75,7 @@ msgstr "" msgid "" "`Packages specification `__" msgstr "" +"`Specyfikacja pakietów `__" msgid "" "Original specification of packages. Some semantics have changed since the " @@ -90,79 +90,79 @@ msgid "The :keyword:`import` statement is syntactic sugar for this function." msgstr "" msgid ":ref:`sys-path-init`" -msgstr "" +msgstr ":ref:`sys-path-init`" msgid "The initialization of :data:`sys.path`." msgstr "" msgid ":pep:`235`" -msgstr "" +msgstr ":pep:`235`" msgid "Import on Case-Insensitive Platforms" msgstr "" msgid ":pep:`263`" -msgstr "" +msgstr ":pep:`263`" msgid "Defining Python Source Code Encodings" msgstr "" msgid ":pep:`302`" -msgstr "" +msgstr ":pep:`302`" msgid "New Import Hooks" msgstr "" msgid ":pep:`328`" -msgstr "" +msgstr ":pep:`328`" msgid "Imports: Multi-Line and Absolute/Relative" msgstr "" msgid ":pep:`366`" -msgstr "" +msgstr ":pep:`366`" msgid "Main module explicit relative imports" msgstr "" msgid ":pep:`420`" -msgstr "" +msgstr ":pep:`420`" msgid "Implicit namespace packages" msgstr "" msgid ":pep:`451`" -msgstr "" +msgstr ":pep:`451`" msgid "A ModuleSpec Type for the Import System" msgstr "" msgid ":pep:`488`" -msgstr "" +msgstr ":pep:`488`" msgid "Elimination of PYO files" msgstr "" msgid ":pep:`489`" -msgstr "" +msgstr ":pep:`489`" msgid "Multi-phase extension module initialization" msgstr "" msgid ":pep:`552`" -msgstr "" +msgstr ":pep:`552`" msgid "Deterministic pycs" msgstr "" msgid ":pep:`3120`" -msgstr "" +msgstr ":pep:`3120`" msgid "Using UTF-8 as the Default Source Encoding" msgstr "" msgid ":pep:`3147`" -msgstr "" +msgstr ":pep:`3147`" msgid "PYC Repository Directories" msgstr "" @@ -400,7 +400,7 @@ msgid "" "invalidating the caches of all finders on :data:`sys.meta_path`." msgstr "" -msgid "Returns ``None`` when called instead of ``NotImplemented``." +msgid "Returns ``None`` when called instead of :data:`NotImplemented`." msgstr "" msgid "" @@ -537,7 +537,7 @@ msgstr "" msgid "" "The list of locations where the package's submodules will be found. Most of " "the time this is a single directory. The import system passes this attribute " -"to ``__import__()`` and to finders in the same way as :attr:`sys.path` but " +"to ``__import__()`` and to finders in the same way as :data:`sys.path` but " "just for the package. It is not set on non-package modules so it can be used " "as an indicator that the module is a package." msgstr "" @@ -724,10 +724,10 @@ msgid "" msgstr "" msgid ":meth:`ResourceLoader.get_data`" -msgstr "" +msgstr ":meth:`ResourceLoader.get_data`" msgid ":meth:`ExecutionLoader.get_filename`" -msgstr "" +msgstr ":meth:`ExecutionLoader.get_filename`" msgid "" "Should only return the path to the source file; sourceless loading is not " @@ -784,7 +784,7 @@ msgid "" msgstr "" msgid "" -"When writing to the path fails because the path is read-only (:attr:`errno." +"When writing to the path fails because the path is read-only (:const:`errno." "EACCES`/:exc:`PermissionError`), do not propagate the exception." msgstr "" @@ -983,7 +983,7 @@ msgid "Clear out the internal cache." msgstr "" msgid "" -"A class method which returns a closure for use on :attr:`sys.path_hooks`. An " +"A class method which returns a closure for use on :data:`sys.path_hooks`. An " "instance of :class:`FileFinder` is returned by the closure using the path " "argument given to the closure directly and *loader_details* indirectly." msgstr "" @@ -1265,10 +1265,10 @@ msgstr "" msgid "" "Find the :term:`spec ` for a module, optionally relative to the " -"specified **package** name. If the module is in :attr:`sys.modules`, then " +"specified **package** name. If the module is in :data:`sys.modules`, then " "``sys.modules[name].__spec__`` is returned (unless the spec would be " "``None`` or is not set, in which case :exc:`ValueError` is raised). " -"Otherwise a search using :attr:`sys.meta_path` is done. ``None`` is returned " +"Otherwise a search using :data:`sys.meta_path` is done. ``None`` is returned " "if no spec is found." msgstr "" @@ -1397,7 +1397,7 @@ msgid "" "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 :attr:" +"<__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." @@ -1466,9 +1466,9 @@ msgid "" "`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 :attr:`sys.meta_path` while the latter " -"is what you create using a :term:`path entry hook` on :attr:`sys.path_hooks` " -"which works with :attr:`sys.path` entries to potentially create a 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)::" @@ -1483,3 +1483,9 @@ msgid "" "illustrate the various APIs that importlib exposes by providing an " "approximate implementation of :func:`importlib.import_module`::" msgstr "" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "importlib.abc.InspectLoader.get_source method" +msgstr "" diff --git a/library/importlib.resources.abc.po b/library/importlib.resources.abc.po new file mode 100644 index 0000000000..c607c46fb9 --- /dev/null +++ b/library/importlib.resources.abc.po @@ -0,0 +1,164 @@ +# 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: 2022-11-05 19:49+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:`importlib.resources.abc` -- Abstract base classes for resources" +msgstr "" + +msgid "**Source code:** :source:`Lib/importlib/resources/abc.py`" +msgstr "" + +msgid "*Superseded by TraversableResources*" +msgstr "" + +msgid "" +"An :term:`abstract base class` to provide the ability to read *resources*." +msgstr "" + +msgid "" +"From the perspective of this ABC, a *resource* is a binary artifact that is " +"shipped within a package. Typically this is something like a data file that " +"lives next to the ``__init__.py`` file of the package. The purpose of this " +"class is to help abstract out the accessing of such data files so that it " +"does not matter if the package and its data file(s) are stored in a e.g. zip " +"file versus on the file system." +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* " +"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 "" + +msgid "" +"Loaders that wish to support resource reading are expected to provide a " +"method called ``get_resource_reader(fullname)`` which returns an object " +"implementing this ABC's interface. If the module specified by fullname is " +"not a package, this method should return :const:`None`. An object compatible " +"with this ABC should only be returned when the specified module is a package." +msgstr "" + +msgid "" +"Returns an opened, :term:`file-like object` for binary reading of the " +"*resource*." +msgstr "" + +msgid "If the resource cannot be found, :exc:`FileNotFoundError` is raised." +msgstr "" + +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`." +msgstr "" + +msgid "" +"Returns ``True`` if the named *name* is considered a resource. :exc:" +"`FileNotFoundError` is raised if *name* does not exist." +msgstr "" + +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." +msgstr "" + +msgid "" +"Allowing non-resource names to be returned is to allow for situations where " +"how a package and its resources are stored are known a priori and the non-" +"resource names would be useful. For instance, returning subdirectory names " +"is allowed so that when it is known that the package and resources are " +"stored on the file system then those subdirectory names can be used directly." +msgstr "" + +msgid "The abstract method returns an iterable of no items." +msgstr "" + +msgid "" +"An object with a subset of :class:`pathlib.Path` methods suitable for " +"traversing directories and opening files." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "Yield Traversable objects in self." +msgstr "" + +msgid "Return True if self is a directory." +msgstr "" + +msgid "Return True if self is a file." +msgstr "" + +msgid "Return Traversable child in self." +msgstr "" + +msgid "" +"*mode* may be 'r' or 'rb' to open as text or binary. Return a handle " +"suitable for reading (same as :attr:`pathlib.Path.open`)." +msgstr "" + +msgid "" +"When opening as text, accepts encoding parameters such as those accepted by :" +"attr:`io.TextIOWrapper`." +msgstr "" + +msgid "Read contents of self as bytes." +msgstr "" + +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:`importlib." +"resources.abc.ResourceReader` and provides concrete implementations of the :" +"class:`importlib.resources.abc.ResourceReader`'s abstract methods. " +"Therefore, any loader supplying :class:`importlib.abc.TraversableResources` " +"also supplies ResourceReader." +msgstr "" + +msgid "" +"Loaders that wish to support resource reading are expected to implement this " +"interface." +msgstr "" + +msgid "" +"Returns a :class:`importlib.resources.abc.Traversable` object for the loaded " +"package." +msgstr "" diff --git a/library/importlib.resources.po b/library/importlib.resources.po new file mode 100644 index 0000000000..d811af5474 --- /dev/null +++ b/library/importlib.resources.po @@ -0,0 +1,221 @@ +# 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: 2022-11-05 19:49+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:`importlib.resources` -- Resources" +msgstr "" + +msgid "**Source code:** :source:`Lib/importlib/resources/__init__.py`" +msgstr "" + +msgid "" +"This module leverages Python's import system to provide access to " +"*resources* within *packages*. If you can import a package, you can access " +"resources within that package. Resources can be opened or read, in either " +"binary or text mode." +msgstr "" + +msgid "" +"Resources are roughly akin to files inside directories, though it's " +"important to keep in mind that this is just a metaphor. Resources and " +"packages **do not** have to exist as physical files and directories on the " +"file system: for example, a package and its resources can be imported from a " +"zip file using :py:mod:`zipimport`." +msgstr "" + +msgid "" +"This module provides functionality similar to `pkg_resources `_ `Basic Resource " +"Access `_ without the performance overhead of that package. This " +"makes reading resources included in packages easier, with more stable and " +"consistent semantics." +msgstr "" + +msgid "" +"The standalone backport of this module provides more information on `using " +"importlib.resources `_ and `migrating from pkg_resources to importlib.resources " +"`_." +msgstr "" + +msgid "" +":class:`Loaders ` that wish to support resource " +"reading should implement a ``get_resource_reader(fullname)`` method as " +"specified by :class:`importlib.resources.abc.ResourceReader`." +msgstr "" + +msgid "" +"Whenever a function accepts a ``Package`` argument, you can pass in either " +"a :class:`module object ` or a module name as a string. " +"You can only pass module objects whose ``__spec__." +"submodule_search_locations`` is not ``None``." +msgstr "" + +msgid "The ``Package`` type is defined as ``Union[str, ModuleType]``." +msgstr "" + +msgid "" +"Returns a :class:`~importlib.resources.abc.Traversable` object representing " +"the resource container for the package (think directory) and its resources " +"(think files). A Traversable may contain other containers (think " +"subdirectories)." +msgstr "" + +msgid "" +"*package* is either a name or a module object which conforms to the :data:" +"`Package` requirements." +msgstr "" + +msgid "" +"Given a :class:`~importlib.resources.abc.Traversable` object representing a " +"file, typically from :func:`importlib.resources.files`, return a context " +"manager for use in a :keyword:`with` statement. The context manager provides " +"a :class:`pathlib.Path` object." +msgstr "" + +msgid "" +"Exiting the context manager cleans up any temporary file created when the " +"resource was extracted from e.g. a zip file." +msgstr "" + +msgid "" +"Use ``as_file`` when the Traversable methods (``read_text``, etc) are " +"insufficient and an actual file on the file system is required." +msgstr "" + +msgid "Deprecated functions" +msgstr "" + +msgid "" +"An older, deprecated set of functions is still available, but is scheduled " +"for removal in a future version of Python. The main drawback of these " +"functions is that they do not support directories: they assume all resources " +"are located directly within a *package*." +msgstr "" + +msgid "" +"For *resource* arguments of the functions below, you can pass in the name of " +"a resource as a string or a :class:`path-like object `." +msgstr "" + +msgid "The ``Resource`` type is defined as ``Union[str, os.PathLike]``." +msgstr "" + +msgid "Open for binary reading the *resource* within *package*." +msgstr "" + +msgid "" +"*package* is either a name or a module object which conforms to the " +"``Package`` requirements. *resource* is the name of the resource to open " +"within *package*; it may not contain path separators and it may not have sub-" +"resources (i.e. it cannot be a directory). This function returns a ``typing." +"BinaryIO`` instance, a binary I/O stream open for reading." +msgstr "" + +msgid "Calls to this function can be replaced by::" +msgstr "" + +msgid "" +"Open for text reading the *resource* within *package*. By default, the " +"resource is opened for reading as UTF-8." +msgstr "" + +msgid "" +"*package* is either a name or a module object which conforms to the " +"``Package`` requirements. *resource* is the name of the resource to open " +"within *package*; it may not contain path separators and it may not have sub-" +"resources (i.e. it cannot be a directory). *encoding* and *errors* have the " +"same meaning as with built-in :func:`open`." +msgstr "" + +msgid "" +"This function returns a ``typing.TextIO`` instance, a text I/O stream open " +"for reading." +msgstr "" + +msgid "" +"Read and return the contents of the *resource* within *package* as ``bytes``." +msgstr "" + +msgid "" +"*package* is either a name or a module object which conforms to the " +"``Package`` requirements. *resource* is the name of the resource to open " +"within *package*; it may not contain path separators and it may not have sub-" +"resources (i.e. it cannot be a directory). This function returns the " +"contents of the resource as :class:`bytes`." +msgstr "" + +msgid "" +"Read and return the contents of *resource* within *package* as a ``str``. By " +"default, the contents are read as strict UTF-8." +msgstr "" + +msgid "" +"*package* is either a name or a module object which conforms to the " +"``Package`` requirements. *resource* is the name of the resource to open " +"within *package*; it may not contain path separators and it may not have sub-" +"resources (i.e. it cannot be a directory). *encoding* and *errors* have the " +"same meaning as with built-in :func:`open`. This function returns the " +"contents of the resource as :class:`str`." +msgstr "" + +msgid "" +"Return the path to the *resource* as an actual file system path. This " +"function returns a context manager for use in a :keyword:`with` statement. " +"The context manager provides a :class:`pathlib.Path` object." +msgstr "" + +msgid "" +"Exiting the context manager cleans up any temporary file created when the " +"resource needs to be extracted from e.g. a zip file." +msgstr "" + +msgid "" +"*package* is either a name or a module object which conforms to the " +"``Package`` requirements. *resource* is the name of the resource to open " +"within *package*; it may not contain path separators and it may not have sub-" +"resources (i.e. it cannot be a directory)." +msgstr "" + +msgid "Calls to this function can be replaced using :func:`as_file`::" +msgstr "" + +msgid "" +"Return ``True`` if there is a resource named *name* in the package, " +"otherwise ``False``. This function does not consider directories to be " +"resources. *package* is either a name or a module object which conforms to " +"the ``Package`` requirements." +msgstr "" + +msgid "" +"Return an iterable over the named items within the package. The iterable " +"returns :class:`str` resources (e.g. files) and non-resources (e.g. " +"directories). The iterable does not recurse into subdirectories." +msgstr "" + +msgid "" +"*package* is either a name or a module object which conforms to the " +"``Package`` requirements." +msgstr "" diff --git a/library/index.po b/library/index.po index 62479a8121..1f104d5b74 100644 --- a/library/index.po +++ b/library/index.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,6 +68,12 @@ msgid "" "packages, so it may be necessary to use the packaging tools provided with " "the operating system to obtain some or all of the optional components." msgstr "" +"Instalatory Python dla platformy Windows zazwyczaj zawierają całą bibliotekę " +"standardową, a często także wiele dodatkowych komponentów. W przypadku " +"systemów operacyjnych podobnych do Unix Python jest zwykle dostarczany jako " +"zbiór pakietów, więc może być konieczne użycie narzędzi do pakowania " +"dostarczonych z systemem operacyjnym w celu uzyskania niektórych lub " +"wszystkich składników opcjonalnych." msgid "" "In addition to the standard library, there is an active collection of " @@ -75,3 +81,7 @@ msgid "" "packages and entire application development frameworks), available from the " "`Python Package Index `_." msgstr "" +"Oprócz biblioteki standardowej, istnieje aktywna kolekcja setek tysięcy " +"komponentów (od pojedynczych programów i moduł do pakietów i całych " +"programistycznych aplikacji ), dostępnych w `Python Pakiet indeks `_ ." diff --git a/library/inspect.po b/library/inspect.po index 8e6b7dc536..ede1970b80 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,55 +57,55 @@ msgid "" msgstr "" msgid "Type" -msgstr "" +msgstr "Typ" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Description" msgstr "Opis" msgid "class" -msgstr "" +msgstr "klasa" msgid "__doc__" -msgstr "" +msgstr "__doc__" msgid "documentation string" msgstr "" msgid "__name__" -msgstr "" +msgstr "__name__" msgid "name with which this class was defined" msgstr "" msgid "__qualname__" -msgstr "" +msgstr "__qualname__" msgid "qualified name" msgstr "" msgid "__module__" -msgstr "" +msgstr "__module__" msgid "name of module in which this class was defined" msgstr "" msgid "method" -msgstr "" +msgstr "metoda" msgid "name with which this method was defined" msgstr "" msgid "__func__" -msgstr "" +msgstr "__func__" msgid "function object containing implementation of method" msgstr "" msgid "__self__" -msgstr "" +msgstr "__self__" msgid "instance to which this method is bound, or ``None``" msgstr "" @@ -121,37 +120,37 @@ msgid "name with which this function was defined" msgstr "" msgid "__code__" -msgstr "" +msgstr "__code__" msgid "code object containing compiled function :term:`bytecode`" msgstr "" msgid "__defaults__" -msgstr "" +msgstr "__defaults__" msgid "tuple of any default values for positional or keyword parameters" msgstr "" msgid "__kwdefaults__" -msgstr "" +msgstr "__kwdefaults__" msgid "mapping of any default values for keyword-only parameters" msgstr "" msgid "__globals__" -msgstr "" +msgstr "__globals__" msgid "global namespace in which this function was defined" msgstr "" msgid "__builtins__" -msgstr "" +msgstr "__builtins__" msgid "builtins namespace" msgstr "" msgid "__annotations__" -msgstr "" +msgstr "__annotations__" msgid "" "mapping of parameters names to annotations; ``\"return\"`` key is reserved " @@ -342,10 +341,10 @@ msgid "tuple of names of arguments and local variables" msgstr "" msgid "generator" -msgstr "" +msgstr "generator" msgid "name" -msgstr "" +msgstr "nazwa" msgid "gi_frame" msgstr "" @@ -425,7 +424,7 @@ msgstr "" msgid "" ":func:`getmembers` will only return class attributes defined in the " "metaclass when the argument is a class and those attributes have been listed " -"in the metaclass' custom :meth:`__dir__`." +"in the metaclass' custom :meth:`~object.__dir__`." msgstr "" msgid "" @@ -508,12 +507,12 @@ msgstr "" msgid "" "Can also be used to distinguish generator-based coroutines from regular " -"generators::" +"generators:" msgstr "" msgid "" "Return ``True`` if the object is an :term:`asynchronous generator` function, " -"for example::" +"for example:" msgstr "" msgid "" @@ -567,14 +566,14 @@ msgid "" "This, for example, is true of ``int.__add__``. An object passing this test " "has a :meth:`~object.__get__` method but not a :meth:`~object.__set__` " "method, but beyond that the set of attributes varies. A :attr:`~definition." -"__name__` attribute is usually sensible, and :attr:`__doc__` often is." +"__name__` attribute is usually sensible, and :attr:`!__doc__` often is." 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:" -"`__func__` attribute (etc) when an object passes :func:`ismethod`." +"`~method.__func__` attribute (etc) when an object passes :func:`ismethod`." msgstr "" msgid "Return ``True`` if the object is a data descriptor." @@ -586,7 +585,7 @@ msgid "" "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, " +"`~definition.__name__` and :attr:`!__doc__` attributes (properties, getsets, " "and members have both of these attributes), but this is not guaranteed." msgstr "" @@ -686,12 +685,12 @@ msgid "Introspecting callables with the Signature object" msgstr "" msgid "" -"The Signature object represents the call signature of a callable object and " -"its return annotation. To retrieve a Signature object, use the :func:" -"`signature` function." +"The :class:`Signature` object represents the call signature of a callable " +"object and its return annotation. To retrieve a :class:`!Signature` object, " +"use the :func:`!signature` function." msgstr "" -msgid "Return a :class:`Signature` object for the given ``callable``::" +msgid "Return a :class:`Signature` object for the given *callable*:" msgstr "" msgid "" @@ -702,19 +701,18 @@ msgstr "" msgid "" "For objects defined in modules using stringized annotations (``from " "__future__ import annotations``), :func:`signature` will attempt to " -"automatically un-stringize the annotations using :func:`inspect." -"get_annotations()`. The ``global``, ``locals``, and ``eval_str`` parameters " -"are passed into :func:`inspect.get_annotations()` when resolving the " -"annotations; see the documentation for :func:`inspect.get_annotations()` for " -"instructions on how to use these parameters." +"automatically un-stringize the annotations using :func:`get_annotations`. " +"The *globals*, *locals*, and *eval_str* parameters are passed into :func:" +"`get_annotations` when resolving the annotations; see the documentation for :" +"func:`get_annotations` for instructions on how to use these parameters." 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 " -"annotations are stringized, and ``eval_str`` is not false, the ``eval()`` " -"call(s) to un-stringize the annotations could potentially raise any kind of " -"exception." +"annotations are stringized, and *eval_str* is not false, the ``eval()`` " +"call(s) to un-stringize the annotations in :func:`get_annotations` could " +"potentially raise any kind of exception." msgstr "" msgid "" @@ -724,12 +722,12 @@ msgid "" msgstr "" msgid "" -"``follow_wrapped`` parameter. Pass ``False`` to get a signature of " -"``callable`` specifically (``callable.__wrapped__`` will not be used to " +"The *follow_wrapped* parameter was added. Pass ``False`` to get a signature " +"of *callable* specifically (``callable.__wrapped__`` will not be used to " "unwrap decorated callables.)" msgstr "" -msgid "``globals``, ``locals``, and ``eval_str`` parameters." +msgid "The *globals*, *locals*, and *eval_str* parameters were added." msgstr "" msgid "" @@ -739,9 +737,16 @@ msgid "" msgstr "" msgid "" -"A Signature object represents the call signature of a function and its " -"return annotation. For each parameter accepted by the function it stores a :" -"class:`Parameter` object in its :attr:`parameters` collection." +"If the passed object has a :attr:`!__signature__` attribute, we may use it " +"to create the signature. The exact semantics are an implementation detail " +"and are subject to unannounced changes. Consult the source code for current " +"semantics." +msgstr "" + +msgid "" +"A :class:`!Signature` object represents the call signature of a function and " +"its return annotation. For each parameter accepted by the function it " +"stores a :class:`Parameter` object in its :attr:`parameters` collection." msgstr "" msgid "" @@ -753,16 +758,16 @@ msgid "" msgstr "" msgid "" -"The optional *return_annotation* argument, can be an arbitrary Python " -"object, is the \"return\" annotation of the callable." +"The optional *return_annotation* argument can be an arbitrary Python object. " +"It represents the \"return\" annotation of the callable." msgstr "" msgid "" -"Signature objects are *immutable*. Use :meth:`Signature.replace` to make a " -"modified copy." +":class:`!Signature` objects are *immutable*. Use :meth:`Signature.replace` " +"to make a modified copy." msgstr "" -msgid "Signature objects are picklable and :term:`hashable`." +msgid ":class:`!Signature` objects are now picklable and :term:`hashable`." msgstr "" msgid "A special class-level marker to specify absence of a return annotation." @@ -799,32 +804,31 @@ msgid "" msgstr "" msgid "" -"Create a new Signature instance based on the instance 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 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 "" "Return a :class:`Signature` (or its subclass) object for a given callable " -"``obj``. Pass ``follow_wrapped=False`` to get a signature of ``obj`` " -"without unwrapping its ``__wrapped__`` chain. ``globalns`` and ``localns`` " -"will be used as the namespaces when resolving annotations." +"*obj*." msgstr "" -msgid "This method simplifies subclassing of :class:`Signature`::" +msgid "This method simplifies subclassing of :class:`Signature`:" msgstr "" -msgid "``globalns`` and ``localns`` parameters." +msgid "Its behavior is otherwise identical to that of :func:`signature`." msgstr "" msgid "" -"Parameter objects are *immutable*. Instead of modifying a Parameter object, " -"you can use :meth:`Parameter.replace` to create a modified copy." +":class:`!Parameter` objects are *immutable*. Instead of modifying a :class:`!" +"Parameter` object, you can use :meth:`Parameter.replace` to create a " +"modified copy." msgstr "" -msgid "Parameter objects are picklable and :term:`hashable`." +msgid "Parameter objects are now picklable and :term:`hashable`." msgstr "" msgid "" @@ -843,7 +847,8 @@ msgid "" msgstr "" msgid "" -"These parameter names are exposed by this module as names like ``implicit0``." +"These parameter names are now exposed by this module as names like " +"``implicit0``." msgstr "" msgid "" @@ -910,26 +915,26 @@ msgid "" "corresponds to a ``**kwargs`` parameter in a Python function definition." msgstr "" -msgid "Example: print all keyword-only arguments without default values::" +msgid "Example: print all keyword-only arguments without default values:" msgstr "" -msgid "Describes a enum value of Parameter.kind." +msgid "Describes a enum value of :attr:`Parameter.kind`." msgstr "" -msgid "Example: print all descriptions of arguments::" +msgid "Example: print all descriptions of arguments:" msgstr "" msgid "" -"Create a new Parameter instance based on the instance replaced was invoked " -"on. To override a :class:`Parameter` attribute, pass the corresponding " -"argument. To remove a default value or/and an annotation from a Parameter, " -"pass :attr:`Parameter.empty`." +"Create a new :class:`Parameter` instance based on the instance replaced was " +"invoked on. To override a :class:`!Parameter` attribute, pass the " +"corresponding argument. To remove a default value or/and an annotation from " +"a :class:`!Parameter`, pass :attr:`Parameter.empty`." msgstr "" msgid "" -"In Python 3.3 Parameter objects were allowed to have ``name`` set to " -"``None`` if their ``kind`` was set to ``POSITIONAL_ONLY``. This is no longer " -"permitted." +"In Python 3.3 :class:`Parameter` objects were allowed to have ``name`` set " +"to ``None`` if their ``kind`` was set to ``POSITIONAL_ONLY``. This is no " +"longer permitted." msgstr "" msgid "" @@ -985,7 +990,7 @@ msgstr "" msgid "" "The :attr:`args` and :attr:`kwargs` properties can be used to invoke " -"functions::" +"functions:" msgstr "" msgid ":pep:`362` - Function Signature Object." @@ -1086,7 +1091,7 @@ msgid "" "In case of invoking *func* incorrectly, i.e. whenever ``func(*args, " "**kwds)`` would raise an exception because of incompatible signature, an " "exception of the same type and the same or similar message is raised. For " -"example::" +"example:" msgstr "" msgid "Use :meth:`Signature.bind` and :meth:`Signature.bind_partial` instead." @@ -1198,9 +1203,9 @@ msgid "" msgstr "" msgid "" -"If ``obj`` is a callable, ``globals`` defaults to ``obj.__globals__``, " -"although if ``obj`` is a wrapped function (using ``functools." -"update_wrapper()``) it is first unwrapped." +"If ``obj`` is a callable, ``globals`` defaults to :attr:`obj.__globals__ " +"`, although if ``obj`` is a wrapped function (using :" +"func:`functools.update_wrapper`) it is first unwrapped." msgstr "" msgid "" @@ -1381,8 +1386,8 @@ 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:`__getattr__` and :meth:" -"`__getattribute__` may be called." +"properties, will be invoked and :meth:`~object.__getattr__` and :meth:" +"`~object.__getattribute__` may be called." msgstr "" msgid "" @@ -1393,7 +1398,7 @@ msgstr "" msgid "" "Retrieve attributes without triggering dynamic lookup via the descriptor " -"protocol, :meth:`__getattr__` or :meth:`__getattribute__`." +"protocol, :meth:`~object.__getattr__` or :meth:`~object.__getattribute__`." msgstr "" msgid "" @@ -1503,16 +1508,16 @@ msgid "Code Objects Bit Flags" msgstr "" msgid "" -"Python code objects have a ``co_flags`` attribute, which is a bitmap of the " -"following flags:" +"Python code objects have a :attr:`~codeobject.co_flags` attribute, which is " +"a bitmap of the following flags:" msgstr "" msgid "The code object is optimized, using fast locals." msgstr "" msgid "" -"If set, a new dict will be created for the frame's ``f_locals`` when the " -"code object is executed." +"If set, a new dict will be created for the frame's :attr:`~frame.f_locals` " +"when the code object is executed." msgstr "" msgid "The code object has a variable positional parameter (``*args``-like)." diff --git a/library/internet.po b/library/internet.po index 6f0b617957..e9060ae235 100644 --- a/library/internet.po +++ b/library/internet.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +35,7 @@ msgid "" msgstr "" msgid "WWW" -msgstr "" +msgstr "WWW" msgid "Internet" msgstr "" diff --git a/library/intro.po b/library/intro.po index 25e31ee5b5..fcdced117c 100644 --- a/library/intro.po +++ b/library/intro.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/io.po b/library/io.po new file mode 100644 index 0000000000..ce062d88a3 --- /dev/null +++ b/library/io.po @@ -0,0 +1,1365 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`io` --- Core tools for working with streams" +msgstr "" + +msgid "**Source code:** :source:`Lib/io.py`" +msgstr "" + +msgid "Overview" +msgstr "Skorowidz" + +msgid "" +"The :mod:`io` module provides Python's main facilities for dealing with " +"various types of I/O. There are three main types of I/O: *text I/O*, " +"*binary I/O* and *raw I/O*. These are generic categories, and various " +"backing stores can be used for each of them. A concrete object belonging to " +"any of these categories is called a :term:`file object`. Other common terms " +"are *stream* and *file-like object*." +msgstr "" + +msgid "" +"Independent of its category, each concrete stream object will also have " +"various capabilities: it can be read-only, write-only, or read-write. It can " +"also allow arbitrary random access (seeking forwards or backwards to any " +"location), or only sequential access (for example in the case of a socket or " +"pipe)." +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." +msgstr "" + +msgid "" +"Operations that used to raise :exc:`IOError` now raise :exc:`OSError`, " +"since :exc:`IOError` is now an alias of :exc:`OSError`." +msgstr "" + +msgid "Text I/O" +msgstr "" + +msgid "" +"Text I/O expects and produces :class:`str` objects. This means that " +"whenever the backing store is natively made of bytes (such as in the case of " +"a file), encoding and decoding of data is made transparently as well as " +"optional translation of platform-specific newline characters." +msgstr "" + +msgid "" +"The easiest way to create a text stream is with :meth:`open()`, optionally " +"specifying an encoding::" +msgstr "" + +msgid "" +"In-memory text streams are also available as :class:`StringIO` objects::" +msgstr "" + +msgid "" +"The text stream API is described in detail in the documentation of :class:" +"`TextIOBase`." +msgstr "" + +msgid "Binary I/O" +msgstr "" + +msgid "" +"Binary I/O (also called *buffered I/O*) expects :term:`bytes-like objects " +"` and produces :class:`bytes` objects. No encoding, " +"decoding, or newline translation is performed. This category of streams can " +"be used for all kinds of non-text data, and also when manual control over " +"the handling of text data is desired." +msgstr "" + +msgid "" +"The easiest way to create a binary stream is with :meth:`open()` with " +"``'b'`` in the mode string::" +msgstr "" + +msgid "" +"In-memory binary streams are also available as :class:`BytesIO` objects::" +msgstr "" + +msgid "" +"The binary stream API is described in detail in the docs of :class:" +"`BufferedIOBase`." +msgstr "" + +msgid "" +"Other library modules may provide additional ways to create text or binary " +"streams. See :meth:`socket.socket.makefile` for example." +msgstr "" + +msgid "Raw I/O" +msgstr "" + +msgid "" +"Raw I/O (also called *unbuffered I/O*) is generally used as a low-level " +"building-block for binary and text streams; it is rarely useful to directly " +"manipulate a raw stream from user code. Nevertheless, you can create a raw " +"stream by opening a file in binary mode with buffering disabled::" +msgstr "" + +msgid "" +"The raw stream API is described in detail in the docs of :class:`RawIOBase`." +msgstr "" + +msgid "Text Encoding" +msgstr "" + +msgid "" +"The default encoding of :class:`TextIOWrapper` and :func:`open` is locale-" +"specific (:func:`locale.getencoding`)." +msgstr "" + +msgid "" +"However, many developers forget to specify the encoding when opening text " +"files encoded in UTF-8 (e.g. JSON, TOML, Markdown, etc...) since most Unix " +"platforms use UTF-8 locale by default. This causes bugs because the locale " +"encoding is not UTF-8 for most Windows users. For example::" +msgstr "" + +msgid "" +"Accordingly, it is highly recommended that you specify the encoding " +"explicitly when opening text files. If you want to use UTF-8, pass " +"``encoding=\"utf-8\"``. To use the current locale encoding, " +"``encoding=\"locale\"`` is supported since Python 3.10." +msgstr "" + +msgid ":ref:`utf8-mode`" +msgstr ":ref:`utf8-mode`" + +msgid "" +"Python UTF-8 Mode can be used to change the default encoding to UTF-8 from " +"locale-specific encoding." +msgstr "" + +msgid ":pep:`686`" +msgstr ":pep:`686`" + +msgid "Python 3.15 will make :ref:`utf8-mode` default." +msgstr "" + +msgid "Opt-in EncodingWarning" +msgstr "" + +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." +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." +msgstr "" + +msgid "High-level Module Interface" +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." +msgstr "" + +msgid "This is an alias for the builtin :func:`open` function." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " +"``mode``, ``flags``." +msgstr "" +"Rzuca :ref:`auditing event ` ``open`` z argumentami ``path`` , " +"``mode``, ``flags``." + +msgid "" +"This function raises an :ref:`auditing event ` ``open`` with " +"arguments *path*, *mode* and *flags*. The *mode* and *flags* arguments may " +"have been modified or inferred from the original call." +msgstr "" + +msgid "" +"Opens the provided file with mode ``'rb'``. This function should be used " +"when the intent is to treat the contents as executable code." +msgstr "" + +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." +msgstr "" + +msgid "" +"This is a helper function for callables that use :func:`open` or :class:" +"`TextIOWrapper` and have an ``encoding=None`` parameter." +msgstr "" + +msgid "" +"This function returns *encoding* if it is not ``None``. Otherwise, it " +"returns ``\"locale\"`` or ``\"utf-8\"`` depending on :ref:`UTF-8 Mode `." +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::" +msgstr "" + +msgid "" +"In this example, an :class:`EncodingWarning` is emitted for the caller of " +"``read_text()``." +msgstr "" + +msgid "See :ref:`io-text-encoding` for more information." +msgstr "" + +msgid "" +":func:`text_encoding` returns \"utf-8\" when UTF-8 mode is enabled and " +"*encoding* is ``None``." +msgstr "" + +msgid "" +"This is a compatibility alias for the builtin :exc:`BlockingIOError` " +"exception." +msgstr "" + +msgid "" +"An exception inheriting :exc:`OSError` and :exc:`ValueError` that is raised " +"when an unsupported operation is called on a stream." +msgstr "" + +msgid ":mod:`sys`" +msgstr ":mod:`sys`" + +msgid "" +"contains the standard IO streams: :data:`sys.stdin`, :data:`sys.stdout`, " +"and :data:`sys.stderr`." +msgstr "" + +msgid "Class hierarchy" +msgstr "" + +msgid "" +"The implementation of I/O streams is organized as a hierarchy of classes. " +"First :term:`abstract base classes ` (ABCs), which are " +"used to specify the various categories of streams, then concrete classes " +"providing the standard stream implementations." +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`." +msgstr "" + +msgid "" +"At the top of the I/O hierarchy is the abstract base class :class:`IOBase`. " +"It defines the basic interface to a stream. Note, however, that there is no " +"separation between reading and writing to streams; implementations are " +"allowed to raise :exc:`UnsupportedOperation` if they do not support a given " +"operation." +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." +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." +msgstr "" + +msgid "" +"The :class:`TextIOBase` ABC extends :class:`IOBase`. It deals with streams " +"whose bytes represent text, and handles encoding and decoding to and from " +"strings. :class:`TextIOWrapper`, which extends :class:`TextIOBase`, is a " +"buffered text interface to a buffered raw stream (:class:`BufferedIOBase`). " +"Finally, :class:`StringIO` is an in-memory stream for text." +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." +msgstr "" + +msgid "" +"The following table summarizes the ABCs provided by the :mod:`io` module:" +msgstr "" + +msgid "ABC" +msgstr "" + +msgid "Inherits" +msgstr "" + +msgid "Stub Methods" +msgstr "" + +msgid "Mixin Methods and Properties" +msgstr "" + +msgid ":class:`IOBase`" +msgstr ":class:`IOBase`" + +msgid "``fileno``, ``seek``, and ``truncate``" +msgstr "" + +msgid "" +"``close``, ``closed``, ``__enter__``, ``__exit__``, ``flush``, ``isatty``, " +"``__iter__``, ``__next__``, ``readable``, ``readline``, ``readlines``, " +"``seekable``, ``tell``, ``writable``, and ``writelines``" +msgstr "" + +msgid ":class:`RawIOBase`" +msgstr ":class:`RawIOBase`" + +msgid "``readinto`` and ``write``" +msgstr "" + +msgid "Inherited :class:`IOBase` methods, ``read``, and ``readall``" +msgstr "" + +msgid ":class:`BufferedIOBase`" +msgstr ":class:`BufferedIOBase`" + +msgid "``detach``, ``read``, ``read1``, and ``write``" +msgstr "" + +msgid "Inherited :class:`IOBase` methods, ``readinto``, and ``readinto1``" +msgstr "" + +msgid ":class:`TextIOBase`" +msgstr ":class:`TextIOBase`" + +msgid "``detach``, ``read``, ``readline``, and ``write``" +msgstr "" + +msgid "" +"Inherited :class:`IOBase` methods, ``encoding``, ``errors``, and ``newlines``" +msgstr "" + +msgid "I/O Base Classes" +msgstr "" + +msgid "The abstract base class for all I/O classes." +msgstr "" + +msgid "" +"This class provides empty abstract implementations for many methods that " +"derived classes can override selectively; the default implementations " +"represent a file that cannot be read, written or seeked." +msgstr "" + +msgid "" +"Even though :class:`IOBase` does not declare :meth:`!read` or :meth:`!write` " +"because their signatures will vary, implementations and clients should " +"consider those methods part of the interface. Also, implementations may " +"raise a :exc:`ValueError` (or :exc:`UnsupportedOperation`) when operations " +"they do not support are called." +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." +msgstr "" + +msgid "" +"Note that calling any method (even inquiries) on a closed stream is " +"undefined. Implementations may raise :exc:`ValueError` in this case." +msgstr "" + +msgid "" +":class:`IOBase` (and its subclasses) supports the iterator protocol, meaning " +"that an :class:`IOBase` object can be iterated over yielding the lines in a " +"stream. Lines are defined slightly differently depending on whether the " +"stream is a binary stream (yielding bytes), or a text stream (yielding " +"character strings). See :meth:`~IOBase.readline` below." +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::" +msgstr "" + +msgid ":class:`IOBase` provides these data attributes and methods:" +msgstr "" + +msgid "" +"Flush and close this stream. This method has no effect if the file is " +"already closed. Once the file is closed, any operation on the file (e.g. " +"reading or writing) will raise a :exc:`ValueError`." +msgstr "" + +msgid "" +"As a convenience, it is allowed to call this method more than once; only the " +"first call, however, will have an effect." +msgstr "" + +msgid "``True`` if the stream is closed." +msgstr "" + +msgid "" +"Return the underlying file descriptor (an integer) of the stream if it " +"exists. An :exc:`OSError` is raised if the IO object does not use a file " +"descriptor." +msgstr "" + +msgid "" +"Flush the write buffers of the stream if applicable. This does nothing for " +"read-only and non-blocking streams." +msgstr "" + +msgid "" +"Return ``True`` if the stream is interactive (i.e., connected to a terminal/" +"tty device)." +msgstr "" + +msgid "" +"Return ``True`` if the stream can be read from. If ``False``, :meth:`!read` " +"will raise :exc:`OSError`." +msgstr "" + +msgid "" +"Read and return one line from the stream. If *size* is specified, at most " +"*size* bytes will be read." +msgstr "" + +msgid "" +"The line terminator is always ``b'\\n'`` for binary files; for text files, " +"the *newline* argument to :func:`open` can be used to select the line " +"terminator(s) recognized." +msgstr "" + +msgid "" +"Read and return a list of lines from the stream. *hint* can be specified to " +"control the number of lines read: no more lines will be read if the total " +"size (in bytes/characters) of all lines so far exceeds *hint*." +msgstr "" + +msgid "" +"*hint* values of ``0`` or less, as well as ``None``, are treated as no hint." +msgstr "" + +msgid "" +"Note that it's already possible to iterate on file objects using ``for line " +"in file: ...`` without calling :meth:`!file.readlines`." +msgstr "" + +msgid "" +"Change the stream position to the given byte *offset*, interpreted relative " +"to the position indicated by *whence*, and return the new absolute position. " +"Values for *whence* are:" +msgstr "" + +msgid "" +":data:`os.SEEK_SET` or ``0`` -- start of the stream (the default); *offset* " +"should be zero or positive" +msgstr "" + +msgid "" +":data:`os.SEEK_CUR` or ``1`` -- current stream position; *offset* may be " +"negative" +msgstr "" + +msgid "" +":data:`os.SEEK_END` or ``2`` -- end of the stream; *offset* is usually " +"negative" +msgstr "" + +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." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"Resize the stream to the given *size* in bytes (or the current position if " +"*size* is not specified). The current stream position isn't changed. This " +"resizing can extend or reduce the current file size. In case of extension, " +"the contents of the new file area depend on the platform (on most systems, " +"additional bytes are zero-filled). The new file size is returned." +msgstr "" + +msgid "Windows will now zero-fill files when extending." +msgstr "" + +msgid "" +"Return ``True`` if the stream supports writing. If ``False``, :meth:`!" +"write` and :meth:`truncate` will raise :exc:`OSError`." +msgstr "" + +msgid "" +"Write a list of lines to the stream. Line separators are not added, so it " +"is usual for each of the lines provided to have a line separator at the end." +msgstr "" + +msgid "" +"Prepare for object destruction. :class:`IOBase` provides a default " +"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`." +msgstr "" + +msgid "" +"Raw binary streams typically provide low-level access to an underlying OS " +"device or API, and do not try to encapsulate it in high-level primitives " +"(this functionality is done at a higher-level in buffered binary streams and " +"text streams, described later in this page)." +msgstr "" + +msgid "" +":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." +msgstr "" + +msgid "" +"If 0 bytes are returned, and *size* was 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 "" +"The default implementation defers to :meth:`readall` and :meth:`readinto`." +msgstr "" + +msgid "" +"Read and return all the bytes from the stream until EOF, using multiple " +"calls to the stream if necessary." +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." +msgstr "" + +msgid "" +"Write the given :term:`bytes-like object`, *b*, to the underlying raw " +"stream, and return the number of bytes written. This can be less than the " +"length of *b* in bytes, depending on specifics of the underlying raw stream, " +"and especially if it is in non-blocking mode. ``None`` is returned if the " +"raw stream is set not to block and no single byte could be readily written " +"to it. The caller may release or mutate *b* after this method returns, so " +"the implementation should only access *b* during the method call." +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 consume all given output, at the expense of making " +"perhaps more than one system call." +msgstr "" + +msgid "" +"In addition, those methods can raise :exc:`BlockingIOError` if the " +"underlying raw stream is in non-blocking mode and cannot take or give enough " +"data; unlike their :class:`RawIOBase` counterparts, they will never return " +"``None``." +msgstr "" + +msgid "" +"Besides, the :meth:`read` method does not have a default implementation that " +"defers to :meth:`readinto`." +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." +msgstr "" + +msgid "" +":class:`BufferedIOBase` provides or overrides these data attributes and " +"methods in addition to those from :class:`IOBase`:" +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." +msgstr "" + +msgid "Separate the underlying raw stream from the buffer and return it." +msgstr "" + +msgid "" +"After the raw stream has been detached, the buffer is in an unusable state." +msgstr "" + +msgid "" +"Some buffers, like :class:`BytesIO`, do not have the concept of a single raw " +"stream to return from this method. They raise :exc:`UnsupportedOperation`." +msgstr "" + +msgid "" +"Read and return up to *size* bytes. If the argument is omitted, ``None``, " +"or negative, data is read and returned until EOF is reached. An empty :" +"class:`bytes` object is returned if the stream is already at EOF." +msgstr "" + +msgid "" +"If the argument is positive, and the underlying raw stream is not " +"interactive, multiple raw reads may be issued to satisfy the byte count " +"(unless EOF is reached first). But for interactive raw streams, at most one " +"raw read will be issued, and a short result does not imply that EOF is " +"imminent." +msgstr "" + +msgid "" +"A :exc:`BlockingIOError` is raised if the underlying raw stream is in non " +"blocking-mode, and has no data available at the moment." +msgstr "" + +msgid "" +"Read and return up to *size* bytes, with at most one call to the underlying " +"raw stream's :meth:`~RawIOBase.read` (or :meth:`~RawIOBase.readinto`) " +"method. This can be useful if you are implementing your own buffering on " +"top of a :class:`BufferedIOBase` object." +msgstr "" + +msgid "" +"If *size* is ``-1`` (the default), an arbitrary number of bytes are returned " +"(more than zero unless EOF is reached)." +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`." +msgstr "" + +msgid "" +"Like :meth:`read`, multiple reads may be issued to the underlying raw " +"stream, unless the latter is interactive." +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." +msgstr "" + +msgid "" +"Write the given :term:`bytes-like object`, *b*, and return the number of " +"bytes written (always equal to the length of *b* in bytes, since if the " +"write fails an :exc:`OSError` will be raised). Depending on the actual " +"implementation, these bytes may be readily written to the underlying stream, " +"or held in a buffer for performance and latency reasons." +msgstr "" + +msgid "" +"When in non-blocking mode, a :exc:`BlockingIOError` is raised if the data " +"needed to be written to the raw stream but it couldn't accept all the data " +"without blocking." +msgstr "" + +msgid "" +"The caller may release or mutate *b* after this method returns, so the " +"implementation should only access *b* during the method call." +msgstr "" + +msgid "Raw File I/O" +msgstr "" + +msgid "" +"A raw binary stream representing an OS-level file containing bytes data. It " +"inherits from :class:`RawIOBase`." +msgstr "" + +msgid "The *name* can be one of two things:" +msgstr "" + +msgid "" +"a character string or :class:`bytes` object representing the path to the " +"file which will be opened. In this case closefd must be ``True`` (the " +"default) otherwise an error will be raised." +msgstr "" + +msgid "" +"an integer representing the number of an existing OS-level file descriptor " +"to which the resulting :class:`FileIO` object will give access. When the " +"FileIO object is closed this fd will be closed as well, unless *closefd* is " +"set to ``False``." +msgstr "" + +msgid "" +"The *mode* can be ``'r'``, ``'w'``, ``'x'`` or ``'a'`` for reading " +"(default), writing, exclusive creation or appending. The file will be " +"created if it doesn't exist when opened for writing or appending; it will be " +"truncated when opened for writing. :exc:`FileExistsError` will be raised if " +"it already exists when opened for creating. Opening a file for creating " +"implies writing, so this mode behaves in a similar way to ``'w'``. Add a " +"``'+'`` 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 " +"*opener* with (*name*, *flags*). *opener* must return an open file " +"descriptor (passing :mod:`os.open` as *opener* results in functionality " +"similar to passing ``None``)." +msgstr "" + +msgid "The newly created file is :ref:`non-inheritable `." +msgstr "Nowo utworzony plik jest :ref:`non-inheritable `." + +msgid "" +"See the :func:`open` built-in function for examples on using the *opener* " +"parameter." +msgstr "" + +msgid "The *opener* parameter was added. The ``'x'`` mode was added." +msgstr "" + +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`:" +msgstr "" + +msgid "The mode as given in the constructor." +msgstr "" + +msgid "" +"The file name. This is the file descriptor of the file when no name is " +"given in the constructor." +msgstr "" + +msgid "Buffered Streams" +msgstr "" + +msgid "" +"Buffered I/O streams provide a higher-level interface to an I/O device than " +"raw I/O does." +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." +msgstr "" + +msgid "" +"The optional argument *initial_bytes* is a :term:`bytes-like object` that " +"contains initial data." +msgstr "" + +msgid "" +":class:`BytesIO` provides or overrides these methods in addition to those " +"from :class:`BufferedIOBase` and :class:`IOBase`:" +msgstr "" + +msgid "" +"Return a readable and writable view over the contents of the buffer without " +"copying them. Also, mutating the view will transparently update the " +"contents of the buffer::" +msgstr "" + +msgid "" +"As long as the view exists, the :class:`BytesIO` object cannot be resized or " +"closed." +msgstr "" + +msgid "Return :class:`bytes` containing the entire contents of the buffer." +msgstr "" + +msgid "In :class:`BytesIO`, this is the same as :meth:`~BufferedIOBase.read`." +msgstr "" + +msgid "The *size* argument is now optional." +msgstr "" + +msgid "" +"In :class:`BytesIO`, this is the same as :meth:`~BufferedIOBase.readinto`." +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`." +msgstr "" + +msgid "" +"When reading data from this object, a larger amount of data may be requested " +"from the underlying raw stream, and kept in an internal buffer. The buffered " +"data can then be returned directly on subsequent reads." +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." +msgstr "" + +msgid "" +":class:`BufferedReader` provides or overrides these methods in addition to " +"those from :class:`BufferedIOBase` and :class:`IOBase`:" +msgstr "" + +msgid "" +"Return bytes from the stream without advancing the position. At most one " +"single read on the raw stream is done to satisfy the call. The number of " +"bytes returned may be less or more than requested." +msgstr "" + +msgid "" +"Read and return *size* bytes, or if *size* is not given or negative, until " +"EOF or if the read call would block in non-blocking mode." +msgstr "" + +msgid "" +"Read and return up to *size* bytes with only one call on the raw stream. If " +"at least one byte is buffered, only buffered bytes are returned. Otherwise, " +"one raw stream read call is made." +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`." +msgstr "" + +msgid "" +"When writing to this object, data is normally placed into an internal " +"buffer. The buffer will be written out to the underlying :class:`RawIOBase` " +"object under various conditions, including:" +msgstr "" + +msgid "when the buffer gets too small for all pending data;" +msgstr "" + +msgid "when :meth:`flush` is called;" +msgstr "" + +msgid "" +"when a :meth:`~IOBase.seek` is requested (for :class:`BufferedRandom` " +"objects);" +msgstr "" + +msgid "when the :class:`BufferedWriter` object is closed or destroyed." +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`." +msgstr "" + +msgid "" +":class:`BufferedWriter` provides or overrides these methods in addition to " +"those from :class:`BufferedIOBase` and :class:`IOBase`:" +msgstr "" + +msgid "" +"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` 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`." +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`." +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." +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`." +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`." +msgstr "" + +msgid "" +":class:`BufferedRWPair` implements all of :class:`BufferedIOBase`\\'s " +"methods except for :meth:`~BufferedIOBase.detach`, which raises :exc:" +"`UnsupportedOperation`." +msgstr "" + +msgid "" +":class:`BufferedRWPair` does not attempt to synchronize accesses to its " +"underlying raw streams. You should not pass it the same object as reader " +"and writer; use :class:`BufferedRandom` instead." +msgstr "" + +msgid "" +"Base class for text streams. This class provides a character and line based " +"interface to stream I/O. It inherits from :class:`IOBase`." +msgstr "" + +msgid "" +":class:`TextIOBase` provides or overrides these data attributes and methods " +"in addition to those from :class:`IOBase`:" +msgstr "" + +msgid "" +"The name of the encoding used to decode the stream's bytes into strings, and " +"to encode strings into bytes." +msgstr "" + +msgid "The error setting of the decoder or encoder." +msgstr "" + +msgid "" +"A string, a tuple of strings, or ``None``, indicating the newlines " +"translated so far. Depending on the implementation and the initial " +"constructor flags, this may not be available." +msgstr "" + +msgid "" +"The underlying binary buffer (a :class:`BufferedIOBase` instance) that :" +"class:`TextIOBase` deals with. This is not part of the :class:`TextIOBase` " +"API and may not exist in some implementations." +msgstr "" + +msgid "" +"Separate the underlying binary buffer from the :class:`TextIOBase` and " +"return it." +msgstr "" + +msgid "" +"After the underlying buffer has been detached, the :class:`TextIOBase` is in " +"an unusable state." +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`." +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." +msgstr "" + +msgid "" +"Read until newline or EOF and return a single :class:`str`. If the stream " +"is already at EOF, an empty string is returned." +msgstr "" + +msgid "If *size* is specified, at most *size* characters will be read." +msgstr "" + +msgid "" +"Change the stream position to the given *offset*. Behaviour depends on the " +"*whence* parameter. The default value for *whence* is :data:`!SEEK_SET`." +msgstr "" + +msgid "" +":data:`!SEEK_SET` or ``0``: seek from the start of the stream (the default); " +"*offset* must either be a number returned by :meth:`TextIOBase.tell`, or " +"zero. Any other *offset* value produces undefined behaviour." +msgstr "" + +msgid "" +":data:`!SEEK_CUR` or ``1``: \"seek\" to the current position; *offset* must " +"be zero, which is a no-operation (all other values are unsupported)." +msgstr "" + +msgid "" +":data:`!SEEK_END` or ``2``: seek to the end of the stream; *offset* must be " +"zero (all other values are unsupported)." +msgstr "" + +msgid "Return the new absolute position as an opaque number." +msgstr "" + +msgid "" +"Return the current stream position as an opaque number. The number does not " +"usually represent a number of bytes in the underlying binary storage." +msgstr "" + +msgid "" +"Write the string *s* to the stream and return the number of characters " +"written." +msgstr "" + +msgid "" +"A buffered text stream providing higher-level access to a :class:" +"`BufferedIOBase` buffered binary stream. It inherits from :class:" +"`TextIOBase`." +msgstr "" + +msgid "" +"*encoding* gives the name of the encoding that the stream will be decoded or " +"encoded with. It defaults to :func:`locale.getencoding()`. " +"``encoding=\"locale\"`` can be used to specify the current locale's encoding " +"explicitly. See :ref:`io-text-encoding` for more information." +msgstr "" + +msgid "" +"*errors* is an optional string that specifies how encoding and decoding " +"errors are to be handled. Pass ``'strict'`` to raise a :exc:`ValueError` " +"exception if there is an encoding error (the default of ``None`` has the " +"same effect), or pass ``'ignore'`` to ignore errors. (Note that ignoring " +"encoding errors can lead to data loss.) ``'replace'`` causes a replacement " +"marker (such as ``'?'``) to be inserted where there is malformed data. " +"``'backslashreplace'`` causes malformed data to be replaced by a backslashed " +"escape sequence. When writing, ``'xmlcharrefreplace'`` (replace with the " +"appropriate XML character reference) or ``'namereplace'`` (replace with " +"``\\N{...}`` escape sequences) can be used. Any other error handling name " +"that has been registered with :func:`codecs.register_error` is also valid." +msgstr "" + +msgid "" +"*newline* controls how line endings are handled. It can be ``None``, " +"``''``, ``'\\n'``, ``'\\r'``, and ``'\\r\\n'``. It works as follows:" +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 ``''``, " +"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 " +"returned to the caller untranslated." +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." +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 *line_buffering* is ``True``, :meth:`~IOBase.flush` is implied when a " +"call to write contains a newline character or a carriage return." +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*." +msgstr "" + +msgid "The *write_through* argument has been added." +msgstr "" + +msgid "" +"The default *encoding* is now ``locale.getpreferredencoding(False)`` instead " +"of ``locale.getpreferredencoding()``. Don't change temporary the locale " +"encoding using :func:`locale.setlocale`, use the current locale encoding " +"instead of the user preferred encoding." +msgstr "" + +msgid "" +"The *encoding* argument now supports the ``\"locale\"`` dummy encoding name." +msgstr "" + +msgid "" +":class:`TextIOWrapper` provides these data attributes and methods in " +"addition to those from :class:`TextIOBase` and :class:`IOBase`:" +msgstr "" + +msgid "Whether line buffering is enabled." +msgstr "" + +msgid "Whether writes are passed immediately to the underlying binary buffer." +msgstr "" + +msgid "" +"Reconfigure this text stream using new settings for *encoding*, *errors*, " +"*newline*, *line_buffering* and *write_through*." +msgstr "" + +msgid "" +"Parameters not specified keep current settings, except ``errors='strict'`` " +"is used when *encoding* is specified but *errors* is not specified." +msgstr "" + +msgid "" +"It is not possible to change the encoding or newline if some data has " +"already been read from the stream. On the other hand, changing encoding " +"after write is possible." +msgstr "" + +msgid "" +"This method does an implicit stream flush before setting the new parameters." +msgstr "" + +msgid "The method supports ``encoding=\"locale\"`` option." +msgstr "" + +msgid "" +"Set the stream position. Return the new stream position as an :class:`int`." +msgstr "" + +msgid "" +"Four operations are supported, given by the following argument combinations:" +msgstr "" + +msgid "``seek(0, SEEK_SET)``: Rewind to the start of the stream." +msgstr "" + +msgid "" +"``seek(cookie, SEEK_SET)``: Restore a previous position; *cookie* **must " +"be** a number returned by :meth:`tell`." +msgstr "" + +msgid "``seek(0, SEEK_END)``: Fast-forward to the end of the stream." +msgstr "" + +msgid "``seek(0, SEEK_CUR)``: Leave the current stream position unchanged." +msgstr "" + +msgid "Any other argument combinations are invalid, and may raise exceptions." +msgstr "" + +msgid ":data:`os.SEEK_SET`, :data:`os.SEEK_CUR`, and :data:`os.SEEK_END`." +msgstr "" + +msgid "" +"Return the stream position as an opaque number. The return value of :meth:`!" +"tell` can be given as input to :meth:`seek`, to restore a previous stream " +"position." +msgstr "" + +msgid "" +"A text stream using an in-memory text buffer. It inherits from :class:" +"`TextIOBase`." +msgstr "" + +msgid "" +"The text buffer is discarded when the :meth:`~IOBase.close` method is called." +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 " +"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." +msgstr "" + +msgid "" +"The *newline* argument works like that of :class:`TextIOWrapper`, except " +"that when writing output to the stream, if *newline* is ``None``, newlines " +"are written as ``\\n`` on all platforms." +msgstr "" + +msgid "" +":class:`StringIO` provides this method in addition to those from :class:" +"`TextIOBase` and :class:`IOBase`:" +msgstr "" + +msgid "" +"Return a :class:`str` containing the entire contents of the buffer. Newlines " +"are decoded as if by :meth:`~TextIOBase.read`, although the stream position " +"is not changed." +msgstr "" + +msgid "Example usage::" +msgstr "" + +msgid "" +"A helper codec that decodes newlines for :term:`universal newlines` mode. It " +"inherits from :class:`codecs.IncrementalDecoder`." +msgstr "" + +msgid "Performance" +msgstr "Wydajność" + +msgid "" +"This section discusses the performance of the provided concrete I/O " +"implementations." +msgstr "" + +msgid "" +"By reading and writing only large chunks of data even when the user asks for " +"a single byte, buffered I/O hides any inefficiency in calling and executing " +"the operating system's unbuffered I/O routines. The gain depends on the OS " +"and the kind of I/O which is performed. For example, on some modern OSes " +"such as Linux, unbuffered disk I/O can be as fast as buffered I/O. The " +"bottom line, however, is that buffered I/O offers predictable performance " +"regardless of the platform and the backing device. Therefore, it is almost " +"always preferable to use buffered I/O rather than unbuffered I/O for binary " +"data." +msgstr "" + +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." +msgstr "" + +msgid "" +":class:`StringIO`, however, is a native in-memory unicode container and will " +"exhibit similar speed to :class:`BytesIO`." +msgstr "" + +msgid "Multi-threading" +msgstr "Wielowątkowość" + +msgid "" +":class:`FileIO` objects are thread-safe to the extent that the operating " +"system calls (such as :manpage:`read(2)` under Unix) they wrap are thread-" +"safe too." +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." +msgstr "" + +msgid ":class:`TextIOWrapper` objects are not thread-safe." +msgstr "" + +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." +msgstr "" + +msgid "" +"The above implicitly extends to text files, since the :func:`open()` " +"function will wrap a buffered object inside a :class:`TextIOWrapper`. This " +"includes standard streams and therefore affects the built-in :func:`print()` " +"function as well." +msgstr "" + +msgid "file object" +msgstr "obiekt plik" + +msgid "io module" +msgstr "" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "io.TextIOWrapper class" +msgstr "" + +msgid "io.IncrementalNewlineDecoder class" +msgstr "" diff --git a/library/itertools.po b/library/itertools.po new file mode 100644 index 0000000000..5646d9b6c6 --- /dev/null +++ b/library/itertools.po @@ -0,0 +1,695 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:16+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`itertools` --- Functions creating iterators for efficient looping" +msgstr "" + +msgid "" +"This module implements a number of :term:`iterator` building blocks inspired " +"by constructs from APL, Haskell, and SML. Each has been recast in a form " +"suitable for Python." +msgstr "" + +msgid "" +"The module standardizes a core set of fast, memory efficient tools that are " +"useful by themselves or in combination. Together, they form an \"iterator " +"algebra\" making it possible to construct specialized tools succinctly and " +"efficiently in pure Python." +msgstr "" + +msgid "" +"For instance, SML provides a tabulation tool: ``tabulate(f)`` which produces " +"a sequence ``f(0), f(1), ...``. The same effect can be achieved in Python " +"by combining :func:`map` and :func:`count` to form ``map(f, count())``." +msgstr "" + +msgid "" +"These tools and their built-in counterparts also work well with the high-" +"speed functions in the :mod:`operator` module. For example, the " +"multiplication operator can be mapped across two vectors to form an " +"efficient dot-product: ``sum(starmap(operator.mul, zip(vec1, vec2, " +"strict=True)))``." +msgstr "" + +msgid "**Infinite iterators:**" +msgstr "" + +msgid "Iterator" +msgstr "" + +msgid "Arguments" +msgstr "" + +msgid "Results" +msgstr "" + +msgid "Example" +msgstr "Przykład" + +msgid ":func:`count`" +msgstr ":func:`count`" + +msgid "start, [step]" +msgstr "" + +msgid "start, start+step, start+2*step, ..." +msgstr "" + +msgid "``count(10) --> 10 11 12 13 14 ...``" +msgstr "" + +msgid ":func:`cycle`" +msgstr ":func:`cycle`" + +msgid "p" +msgstr "" + +msgid "p0, p1, ... plast, p0, p1, ..." +msgstr "" + +msgid "``cycle('ABCD') --> A B C D A B C D ...``" +msgstr "" + +msgid ":func:`repeat`" +msgstr ":func:`repeat`" + +msgid "elem [,n]" +msgstr "" + +msgid "elem, elem, elem, ... endlessly or up to n times" +msgstr "" + +msgid "``repeat(10, 3) --> 10 10 10``" +msgstr "" + +msgid "**Iterators terminating on the shortest input sequence:**" +msgstr "" + +msgid ":func:`accumulate`" +msgstr ":func:`accumulate`" + +msgid "p [,func]" +msgstr "" + +msgid "p0, p0+p1, p0+p1+p2, ..." +msgstr "" + +msgid "``accumulate([1,2,3,4,5]) --> 1 3 6 10 15``" +msgstr "" + +msgid ":func:`chain`" +msgstr ":func:`chain`" + +msgid "p, q, ..." +msgstr "" + +msgid "p0, p1, ... plast, q0, q1, ..." +msgstr "" + +msgid "``chain('ABC', 'DEF') --> A B C D E F``" +msgstr "" + +msgid ":func:`chain.from_iterable`" +msgstr ":func:`chain.from_iterable`" + +msgid "iterable" +msgstr "" + +msgid "``chain.from_iterable(['ABC', 'DEF']) --> A B C D E F``" +msgstr "" + +msgid ":func:`compress`" +msgstr ":func:`compress`" + +msgid "data, selectors" +msgstr "" + +msgid "(d[0] if s[0]), (d[1] if s[1]), ..." +msgstr "" + +msgid "``compress('ABCDEF', [1,0,1,0,1,1]) --> A C E F``" +msgstr "" + +msgid ":func:`dropwhile`" +msgstr ":func:`dropwhile`" + +msgid "pred, seq" +msgstr "" + +msgid "seq[n], seq[n+1], starting when pred fails" +msgstr "" + +msgid "``dropwhile(lambda x: x<5, [1,4,6,4,1]) --> 6 4 1``" +msgstr "" + +msgid ":func:`filterfalse`" +msgstr ":func:`filterfalse`" + +msgid "elements of seq where pred(elem) is false" +msgstr "" + +msgid "``filterfalse(lambda x: x%2, range(10)) --> 0 2 4 6 8``" +msgstr "" + +msgid ":func:`groupby`" +msgstr ":func:`groupby`" + +msgid "iterable[, key]" +msgstr "" + +msgid "sub-iterators grouped by value of key(v)" +msgstr "" + +msgid ":func:`islice`" +msgstr ":func:`islice`" + +msgid "seq, [start,] stop [, step]" +msgstr "" + +msgid "elements from seq[start:stop:step]" +msgstr "" + +msgid "``islice('ABCDEFG', 2, None) --> C D E F G``" +msgstr "" + +msgid ":func:`pairwise`" +msgstr ":func:`pairwise`" + +msgid "(p[0], p[1]), (p[1], p[2])" +msgstr "" + +msgid "``pairwise('ABCDEFG') --> AB BC CD DE EF FG``" +msgstr "" + +msgid ":func:`starmap`" +msgstr ":func:`starmap`" + +msgid "func, seq" +msgstr "" + +msgid "func(\\*seq[0]), func(\\*seq[1]), ..." +msgstr "" + +msgid "``starmap(pow, [(2,5), (3,2), (10,3)]) --> 32 9 1000``" +msgstr "" + +msgid ":func:`takewhile`" +msgstr ":func:`takewhile`" + +msgid "seq[0], seq[1], until pred fails" +msgstr "" + +msgid "``takewhile(lambda x: x<5, [1,4,6,4,1]) --> 1 4``" +msgstr "" + +msgid ":func:`tee`" +msgstr ":func:`tee`" + +msgid "it, n" +msgstr "" + +msgid "it1, it2, ... itn splits one iterator into n" +msgstr "" + +msgid ":func:`zip_longest`" +msgstr ":func:`zip_longest`" + +msgid "(p[0], q[0]), (p[1], q[1]), ..." +msgstr "" + +msgid "``zip_longest('ABCD', 'xy', fillvalue='-') --> Ax By C- D-``" +msgstr "" + +msgid "**Combinatoric iterators:**" +msgstr "" + +msgid ":func:`product`" +msgstr ":func:`product`" + +msgid "p, q, ... [repeat=1]" +msgstr "" + +msgid "cartesian product, equivalent to a nested for-loop" +msgstr "" + +msgid ":func:`permutations`" +msgstr ":func:`permutations`" + +msgid "p[, r]" +msgstr "" + +msgid "r-length tuples, all possible orderings, no repeated elements" +msgstr "" + +msgid ":func:`combinations`" +msgstr ":func:`combinations`" + +msgid "p, r" +msgstr "" + +msgid "r-length tuples, in sorted order, no repeated elements" +msgstr "" + +msgid ":func:`combinations_with_replacement`" +msgstr ":func:`combinations_with_replacement`" + +msgid "r-length tuples, in sorted order, with repeated elements" +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid "``product('ABCD', repeat=2)``" +msgstr "" + +msgid "``AA AB AC AD BA BB BC BD CA CB CC CD DA DB DC DD``" +msgstr "" + +msgid "``permutations('ABCD', 2)``" +msgstr "" + +msgid "``AB AC AD BA BC BD CA CB CD DA DB DC``" +msgstr "" + +msgid "``combinations('ABCD', 2)``" +msgstr "" + +msgid "``AB AC AD BC BD CD``" +msgstr "" + +msgid "``combinations_with_replacement('ABCD', 2)``" +msgstr "" + +msgid "``AA AB AC AD BB BC BD CC CD DD``" +msgstr "" + +msgid "Itertool functions" +msgstr "" + +msgid "" +"The following module functions all construct and return iterators. Some " +"provide streams of infinite length, so they should only be accessed by " +"functions or loops that truncate the stream." +msgstr "" + +msgid "" +"Make an iterator that returns accumulated sums, or accumulated results of " +"other binary functions (specified via the optional *func* argument)." +msgstr "" + +msgid "" +"If *func* is supplied, it should be a function of two arguments. Elements of " +"the input *iterable* may be any type that can be accepted as arguments to " +"*func*. (For example, with the default operation of addition, elements may " +"be any addable type including :class:`~decimal.Decimal` or :class:" +"`~fractions.Fraction`.)" +msgstr "" + +msgid "" +"Usually, the number of elements output matches the input iterable. However, " +"if the keyword argument *initial* is provided, the accumulation leads off " +"with the *initial* value so that the output has one more element than the " +"input iterable." +msgstr "" + +msgid "Roughly equivalent to::" +msgstr "" + +msgid "" +"There are a number of uses for the *func* argument. It can be set to :func:" +"`min` for a running minimum, :func:`max` for a running maximum, or :func:" +"`operator.mul` for a running product. Amortization tables can be built by " +"accumulating interest and applying payments:" +msgstr "" + +msgid "" +"See :func:`functools.reduce` for a similar function that returns only the " +"final accumulated value." +msgstr "" + +msgid "Added the optional *func* parameter." +msgstr "" + +msgid "Added the optional *initial* parameter." +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. Used for treating consecutive sequences as a single " +"sequence. Roughly equivalent to::" +msgstr "" + +msgid "" +"Alternate constructor for :func:`chain`. Gets chained inputs from a single " +"iterable argument that is evaluated lazily. Roughly equivalent to::" +msgstr "" + +msgid "Return *r* length subsequences of elements from the input *iterable*." +msgstr "" + +msgid "" +"The combination tuples are emitted in lexicographic ordering according to " +"the order of the input *iterable*. So, if the input *iterable* is sorted, " +"the output tuples will be produced in sorted order." +msgstr "" + +msgid "" +"Elements are treated as unique based on their position, not on their value. " +"So if the input elements are unique, there will be no repeated values in " +"each combination." +msgstr "" + +msgid "" +"The code for :func:`combinations` can be also expressed as a subsequence of :" +"func:`permutations` after filtering entries where the elements are not in " +"sorted order (according to their position in the input pool)::" +msgstr "" + +msgid "" +"The number of items returned is ``n! / r! / (n-r)!`` when ``0 <= r <= n`` or " +"zero when ``r > n``." +msgstr "" + +msgid "" +"Return *r* length subsequences of elements from the input *iterable* " +"allowing individual elements to be repeated more than once." +msgstr "" + +msgid "" +"Elements are treated as unique based on their position, not on their value. " +"So if the input elements are unique, the generated combinations will also be " +"unique." +msgstr "" + +msgid "" +"The code for :func:`combinations_with_replacement` can be also expressed as " +"a subsequence of :func:`product` after filtering entries where the elements " +"are not in sorted order (according to their position in the input pool)::" +msgstr "" + +msgid "" +"The number of items returned is ``(n+r-1)! / r! / (n-1)!`` when ``n > 0``." +msgstr "" + +msgid "" +"Make an iterator that filters elements from *data* returning only those that " +"have a corresponding element in *selectors* that evaluates to ``True``. " +"Stops when either the *data* or *selectors* iterables has been exhausted. " +"Roughly equivalent to::" +msgstr "" + +msgid "" +"Make an iterator that returns evenly spaced values starting with number " +"*start*. Often used as an argument to :func:`map` to generate consecutive " +"data points. Also, used with :func:`zip` to add sequence numbers. Roughly " +"equivalent to::" +msgstr "" + +msgid "" +"When counting with floating point numbers, better accuracy can sometimes be " +"achieved by substituting multiplicative code such as: ``(start + step * i " +"for i in count())``." +msgstr "" + +msgid "Added *step* argument and allowed non-integer arguments." +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::" +msgstr "" + +msgid "" +"Note, this member of the toolkit may require significant auxiliary storage " +"(depending on the length of the iterable)." +msgstr "" + +msgid "" +"Make an iterator that drops elements from the iterable as long as the " +"predicate is true; afterwards, returns every element. Note, the iterator " +"does not produce *any* output until the predicate first becomes false, so it " +"may have a lengthy start-up time. Roughly equivalent to::" +msgstr "" + +msgid "" +"Make an iterator that filters elements from iterable returning only those " +"for which the predicate is false. If *predicate* is ``None``, return the " +"items that are false. Roughly equivalent to::" +msgstr "" + +msgid "" +"Make an iterator that returns consecutive keys and groups from the " +"*iterable*. The *key* is a function computing a key value for each element. " +"If not specified or is ``None``, *key* defaults to an identity function and " +"returns the element unchanged. Generally, the iterable needs to already be " +"sorted on the same key function." +msgstr "" + +msgid "" +"The operation of :func:`groupby` is similar to the ``uniq`` filter in Unix. " +"It generates a break or new group every time the value of the key function " +"changes (which is why it is usually necessary to have sorted the data using " +"the same key function). That behavior differs from SQL's GROUP BY which " +"aggregates common elements regardless of their input order." +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::" +msgstr "" + +msgid ":func:`groupby` is roughly equivalent to::" +msgstr "" + +msgid "" +"Make an iterator that returns selected elements from the iterable. If " +"*start* is non-zero, then elements from the iterable are skipped until start " +"is reached. Afterward, elements are returned consecutively unless *step* is " +"set higher than one which results in items being skipped. If *stop* is " +"``None``, then iteration continues until the iterator is exhausted, if at " +"all; otherwise, it stops at the specified position." +msgstr "" + +msgid "" +"If *start* is ``None``, then iteration starts at zero. If *step* is " +"``None``, then the step defaults to one." +msgstr "" + +msgid "" +"Unlike regular slicing, :func:`islice` does not support negative values for " +"*start*, *stop*, or *step*. Can be used to extract related fields from data " +"where the internal structure has been flattened (for example, a multi-line " +"report may list a name field on every third line)." +msgstr "" + +msgid "Return successive overlapping pairs taken from the input *iterable*." +msgstr "" + +msgid "" +"The number of 2-tuples in the output iterator will be one fewer than the " +"number of inputs. It will be empty if the input iterable has fewer than two " +"values." +msgstr "" + +msgid "" +"Return successive *r* length permutations of elements in the *iterable*." +msgstr "" + +msgid "" +"If *r* is not specified or is ``None``, then *r* defaults to the length of " +"the *iterable* and all possible full-length permutations are generated." +msgstr "" + +msgid "" +"The permutation tuples are emitted in lexicographic order according to the " +"order of the input *iterable*. So, if the input *iterable* is sorted, the " +"output tuples will be produced in sorted order." +msgstr "" + +msgid "" +"Elements are treated as unique based on their position, not on their value. " +"So if the input elements are unique, there will be no repeated values within " +"a permutation." +msgstr "" + +msgid "" +"The code for :func:`permutations` can be also expressed as a subsequence of :" +"func:`product`, filtered to exclude entries with repeated elements (those " +"from the same position in the input pool)::" +msgstr "" + +msgid "" +"The number of items returned is ``n! / (n-r)!`` when ``0 <= r <= n`` or zero " +"when ``r > n``." +msgstr "" + +msgid "Cartesian product of input iterables." +msgstr "" + +msgid "" +"Roughly equivalent to nested for-loops in a generator expression. For " +"example, ``product(A, B)`` returns the same as ``((x,y) for x in A for y in " +"B)``." +msgstr "" + +msgid "" +"The nested loops cycle like an odometer with the rightmost element advancing " +"on every iteration. This pattern creates a lexicographic ordering so that " +"if the input's iterables are sorted, the product tuples are emitted in " +"sorted order." +msgstr "" + +msgid "" +"To compute the product of an iterable with itself, specify the number of " +"repetitions with the optional *repeat* keyword argument. For example, " +"``product(A, repeat=4)`` means the same as ``product(A, A, A, A)``." +msgstr "" + +msgid "" +"This function is roughly equivalent to the following code, except that the " +"actual implementation does not build up intermediate results in memory::" +msgstr "" + +msgid "" +"Before :func:`product` runs, it completely consumes the input iterables, " +"keeping pools of values in memory to generate the products. Accordingly, it " +"is only useful with finite inputs." +msgstr "" + +msgid "" +"Make an iterator that returns *object* over and over again. Runs " +"indefinitely unless the *times* argument is specified." +msgstr "" + +msgid "" +"A common use for *repeat* is to supply a stream of constant values to *map* " +"or *zip*:" +msgstr "" + +msgid "" +"Make an iterator that computes the function using arguments obtained from " +"the iterable. Used instead of :func:`map` when argument parameters are " +"already grouped in tuples from a single iterable (when the data has been " +"\"pre-zipped\")." +msgstr "" + +msgid "" +"The difference between :func:`map` and :func:`starmap` parallels the " +"distinction between ``function(a,b)`` and ``function(*c)``. Roughly " +"equivalent to::" +msgstr "" + +msgid "" +"Make an iterator that returns elements from the iterable as long as the " +"predicate is true. Roughly equivalent to::" +msgstr "" + +msgid "Return *n* independent iterators from a single iterable." +msgstr "" + +msgid "" +"The following Python code helps explain what *tee* does (although the actual " +"implementation is more complex and uses only a single underlying :abbr:`FIFO " +"(first-in, first-out)` queue)::" +msgstr "" + +msgid "" +"Once a :func:`tee` has been created, the original *iterable* should not be " +"used anywhere else; otherwise, the *iterable* could get advanced without the " +"tee objects being informed." +msgstr "" + +msgid "" +"``tee`` iterators are not threadsafe. A :exc:`RuntimeError` may be raised " +"when using simultaneously iterators returned by the same :func:`tee` call, " +"even if the original *iterable* is threadsafe." +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`." +msgstr "" + +msgid "" +"Make an iterator that aggregates elements from each of the iterables. If the " +"iterables are of uneven length, missing values are filled-in with " +"*fillvalue*. Iteration continues until the longest iterable is exhausted. " +"Roughly equivalent to::" +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 not " +"specified, *fillvalue* defaults to ``None``." +msgstr "" + +msgid "Itertools Recipes" +msgstr "" + +msgid "" +"This section shows recipes for creating an extended toolset using the " +"existing itertools as building blocks." +msgstr "" + +msgid "" +"The primary purpose of the itertools recipes is educational. The recipes " +"show various ways of thinking about individual tools — for example, that " +"``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 ``compress()`` and ``range()`` 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()``." +msgstr "" + +msgid "" +"A secondary purpose of the recipes is to serve as an incubator. The " +"``accumulate()``, ``compress()``, and ``pairwise()`` itertools started out " +"as recipes. Currently, the ``iter_index()`` recipe is being tested to see " +"whether it proves its worth." +msgstr "" + +msgid "" +"Substantially all of these recipes and many, many others can be installed " +"from the `more-itertools project `_ found on the Python Package Index::" +msgstr "" + +msgid "" +"Many of the recipes offer the same high performance as the underlying " +"toolset. Superior memory performance is kept by processing elements one at a " +"time rather than bringing the whole iterable into memory all at once. Code " +"volume is kept small by linking the tools together in a functional style " +"which helps eliminate temporary variables. High speed is retained by " +"preferring \"vectorized\" building blocks over the use of for-loops and :" +"term:`generator`\\s which incur interpreter overhead." +msgstr "" diff --git a/library/json.po b/library/json.po index 8a9268372f..ac8c40d3f0 100644 --- a/library/json.po +++ b/library/json.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2021 # Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,8 +162,8 @@ msgstr "" msgid "" "To use a custom :class:`JSONEncoder` subclass (e.g. one that overrides the :" -"meth:`default` method to serialize additional types), specify it with the " -"*cls* kwarg; otherwise :class:`JSONEncoder` is used." +"meth:`~JSONEncoder.default` method to serialize additional types), specify " +"it with the *cls* kwarg; otherwise :class:`JSONEncoder` is used." msgstr "" msgid "" @@ -294,7 +293,7 @@ msgid "Python" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "dict" msgstr "" @@ -303,10 +302,10 @@ msgid "array" msgstr "" msgid "list" -msgstr "" +msgstr "lista" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "str" msgstr "" @@ -412,9 +411,9 @@ msgstr "" msgid "" "To extend this to recognize other objects, subclass and implement a :meth:" -"`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`)." +"`~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 "" @@ -451,7 +450,7 @@ msgstr "" msgid "" "For example, to support arbitrary iterators, you could implement :meth:" -"`default` like this::" +"`~JSONEncoder.default` like this::" msgstr "" msgid "" @@ -644,7 +643,7 @@ msgstr "" msgid "" "If the optional ``infile`` and ``outfile`` arguments are not specified, :" -"attr:`sys.stdin` and :attr:`sys.stdout` will be used respectively:" +"data:`sys.stdin` and :data:`sys.stdout` will be used respectively:" msgstr "" msgid "" @@ -658,12 +657,12 @@ msgstr "Opcje wiersza poleceń" msgid "The JSON file to be validated or pretty-printed:" msgstr "" -msgid "If *infile* is not specified, read from :attr:`sys.stdin`." +msgid "If *infile* is not specified, read from :data:`sys.stdin`." msgstr "" msgid "" "Write the output of the *infile* to the given *outfile*. Otherwise, write it " -"to :attr:`sys.stdout`." +"to :data:`sys.stdout`." msgstr "" msgid "Sort the output of dictionaries alphabetically by key." diff --git a/library/linecache.po b/library/linecache.po index b331d3f4fc..e0bd7a573d 100644 --- a/library/linecache.po +++ b/library/linecache.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +80,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "module" msgstr "moduł" diff --git a/library/locale.po b/library/locale.po index f22d4b345d..59e00b15d2 100644 --- a/library/locale.po +++ b/library/locale.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 "" -"The :mod:`locale` module is implemented on top of the :mod:`_locale` module, " -"which in turn uses an ANSI C locale implementation if available." +"The :mod:`locale` module is implemented on top of the :mod:`!_locale` " +"module, which in turn uses an ANSI C locale implementation if available." msgstr "" msgid "The :mod:`locale` module defines the following exception and functions:" @@ -92,10 +92,10 @@ msgid "Meaning" msgstr "Znaczenie" msgid ":const:`LC_NUMERIC`" -msgstr "" +msgstr ":const:`LC_NUMERIC`" msgid "``'decimal_point'``" -msgstr "" +msgstr "``'decimal_point'``" msgid "Decimal point character." msgstr "" @@ -111,13 +111,13 @@ msgid "" msgstr "" msgid "``'thousands_sep'``" -msgstr "" +msgstr "``'thousands_sep'``" msgid "Character used between groups." msgstr "" msgid ":const:`LC_MONETARY`" -msgstr "" +msgstr ":const:`LC_MONETARY`" msgid "``'int_curr_symbol'``" msgstr "" @@ -161,7 +161,7 @@ msgid "" msgstr "" msgid "``'int_frac_digits'``" -msgstr "" +msgstr "``'int_frac_digits'``" msgid "" "Number of fractional digits used in international formatting of monetary " @@ -181,7 +181,7 @@ msgid "Equivalent to ``'grouping'``, used for monetary values." msgstr "" msgid "``'positive_sign'``" -msgstr "" +msgstr "``'positive_sign'``" msgid "Symbol used to annotate a positive monetary value." msgstr "" @@ -216,37 +216,37 @@ msgid "Explanation" msgstr "Wytłumaczenie" msgid "``0``" -msgstr "" +msgstr "``0``" msgid "Currency and value are surrounded by parentheses." msgstr "" msgid "``1``" -msgstr "" +msgstr "``1``" msgid "The sign should precede the value and currency symbol." msgstr "" msgid "``2``" -msgstr "" +msgstr "``2``" msgid "The sign should follow the value and currency symbol." msgstr "" msgid "``3``" -msgstr "" +msgstr "``3``" msgid "The sign should immediately precede the value." msgstr "" msgid "``4``" -msgstr "" +msgstr "``4``" msgid "The sign should immediately follow the value." msgstr "" msgid "``CHAR_MAX``" -msgstr "" +msgstr "``CHAR_MAX``" msgid "Nothing is specified in this locale." msgstr "" @@ -329,14 +329,14 @@ msgid "" msgstr "" msgid "" -"Get a regular expression that can be used with the regex(3) function to " +"Get a regular expression that can be used with the ``regex(3)`` function to " "recognize a negative response to a yes/no question." msgstr "" msgid "" "The regular expressions for :const:`YESEXPR` and :const:`NOEXPR` use syntax " -"suitable for the :c:func:`regex` function from the C library, which might " -"differ from the syntax used in :mod:`re`." +"suitable for the ``regex`` function from the C library, which might differ " +"from the syntax used in :mod:`re`." msgstr "" msgid "" @@ -414,7 +414,7 @@ msgstr "" msgid "" "Returns the current setting for the given locale category as sequence " "containing *language code*, *encoding*. *category* may be one of the :const:" -"`LC_\\*` values except :const:`LC_ALL`. It defaults to :const:`LC_CTYPE`." +"`!LC_\\*` values except :const:`LC_ALL`. It defaults to :const:`LC_CTYPE`." msgstr "" msgid "" @@ -575,9 +575,18 @@ msgid "" msgstr "" msgid "" -"Locale category for the character type functions. Depending on the settings " -"of this category, the functions of module :mod:`string` dealing with case " -"change their behaviour." +"Locale category for the character type functions. Most importantly, this " +"category defines the text encoding, i.e. how bytes are interpreted as " +"Unicode codepoints. See :pep:`538` and :pep:`540` for how this variable " +"might be automatically coerced to ``C.UTF-8`` to avoid issues created by " +"invalid settings in containers or incompatible settings passed over remote " +"SSH connections." +msgstr "" + +msgid "" +"Python doesn't internally use locale-dependent character transformation " +"functions from ``ctype.h``. Instead, an internal ``pyctype.h`` provides " +"locale-independent equivalents like :c:macro:`!Py_TOLOWER`." msgstr "" msgid "" @@ -629,7 +638,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "Background, details, hints, tips and caveats" msgstr "" @@ -696,9 +705,9 @@ msgstr "" 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 " +"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 " +"file:`config.c` file, and make sure that the :mod:`!_locale` module is not " "accessible as a shared library." msgstr "" @@ -707,19 +716,19 @@ 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`, 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 locating message catalogs." +"provide this interface. It consists of the functions :func:`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 " +"locating message catalogs." msgstr "" msgid "" "Python applications should normally find no need to invoke these functions, " "and should use :mod:`gettext` instead. A known exception to this rule are " -"applications that link with additional C libraries which internally invoke :" -"c:func:`gettext` or :c:func:`dcgettext`. For these applications, it may be " +"applications that link with additional C libraries which internally invoke C " +"functions ``gettext`` or ``dcgettext``. For these applications, it may be " "necessary to bind the text domain, so that the libraries can properly locate " "their message catalogs." msgstr "" @@ -729,6 +738,3 @@ msgstr "moduł" msgid "_locale" msgstr "" - -msgid "string" -msgstr "" diff --git a/library/logging.config.po b/library/logging.config.po new file mode 100644 index 0000000000..ca30d5d1f0 --- /dev/null +++ b/library/logging.config.po @@ -0,0 +1,861 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`logging.config` --- Logging configuration" +msgstr "" + +msgid "**Source code:** :source:`Lib/logging/config.py`" +msgstr "" + +msgid "" +"This page contains only reference information. For tutorials, please see" +msgstr "" + +msgid ":ref:`Basic Tutorial `" +msgstr "" + +msgid ":ref:`Advanced Tutorial `" +msgstr "" + +msgid ":ref:`Logging Cookbook `" +msgstr "" + +msgid "This section describes the API for configuring the logging module." +msgstr "" + +msgid "Configuration functions" +msgstr "" + +msgid "" +"The following functions configure the logging module. They are located in " +"the :mod:`logging.config` module. Their use is optional --- you can " +"configure the logging module using these functions or by making calls to the " +"main API (defined in :mod:`logging` itself) and defining handlers which are " +"declared either in :mod:`logging` or :mod:`logging.handlers`." +msgstr "" + +msgid "" +"Takes the logging configuration from a dictionary. The contents of this " +"dictionary are described in :ref:`logging-config-dictschema` below." +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:" +msgstr "" + +msgid "" +"A ``level`` which is not a string or which is a string not corresponding to " +"an actual logging level." +msgstr "" + +msgid "A ``propagate`` value which is not a boolean." +msgstr "" + +msgid "An id which does not have a corresponding destination." +msgstr "" + +msgid "A non-existent handler id found during an incremental call." +msgstr "" + +msgid "An invalid logger name." +msgstr "" + +msgid "Inability to resolve to an internal or external object." +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." +msgstr "" + +msgid "" +":func:`dictConfig` calls :attr:`dictConfigClass` passing the specified " +"dictionary, and then calls the :meth:`configure` method on the returned " +"object to put the configuration into effect::" +msgstr "" + +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." +msgstr "" + +msgid "" +"Reads the logging configuration from a :mod:`configparser`\\-format file. " +"The format of the file should be as described in :ref:`logging-config-" +"fileformat`. This function can be called several times from an application, " +"allowing an end user to select from various pre-canned configurations (if " +"the developer provides a mechanism to present the choices and load the " +"chosen configuration)." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "" +"Defaults to be passed to the :class:`!ConfigParser` can be specified in this " +"argument." +msgstr "" + +msgid "" +"If specified as ``False``, loggers which exist when this call is made are " +"left enabled. The default is ``True`` because this enables old behaviour in " +"a backward-compatible way. This behaviour is to disable any existing non-" +"root loggers unless they or their ancestors are explicitly named in the " +"logging configuration." +msgstr "" + +msgid "The encoding used to open file when *fname* is filename." +msgstr "" + +msgid "" +"An instance of a subclass of :class:`~configparser.RawConfigParser` is now " +"accepted as a value for ``fname``. This facilitates:" +msgstr "" + +msgid "" +"Use of a configuration file where logging configuration is just part of the " +"overall application configuration." +msgstr "" + +msgid "" +"Use of a configuration read from a file, and then modified by the using " +"application (e.g. based on command-line parameters or other aspects of the " +"runtime environment) before being passed to ``fileConfig``." +msgstr "" + +msgid "Added the *encoding* parameter." +msgstr "" + +msgid "" +"An exception will be thrown if the provided file doesn't exist or is invalid " +"or empty." +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`." +msgstr "" + +msgid "" +"The ``verify`` argument, if specified, should be a callable which should " +"verify whether bytes received across the socket are valid and should be " +"processed. This could be done by encrypting and/or signing what is sent " +"across the socket, such that the ``verify`` callable can perform signature " +"verification and/or decryption. The ``verify`` callable is called with a " +"single argument - the bytes received across the socket - and should return " +"the bytes to be processed, or ``None`` to indicate that the bytes should be " +"discarded. The returned bytes could be the same as the passed in bytes (e.g. " +"when only verification is done), or they could be completely different " +"(perhaps if decryption were performed)." +msgstr "" + +msgid "" +"To send a configuration to the socket, read in the configuration file and " +"send it to the socket as a sequence of bytes preceded by a four-byte length " +"string packed in binary using ``struct.pack('>L', n)``." +msgstr "" + +msgid "" +"Because portions of the configuration are passed through :func:`eval`, use " +"of this function may open its users to a security risk. While the function " +"only binds to a socket on ``localhost``, and so does not accept connections " +"from remote machines, there are scenarios where untrusted code could be run " +"under the account of the process which calls :func:`listen`. Specifically, " +"if the process calling :func:`listen` runs on a multi-user machine where " +"users cannot trust each other, then a malicious user could arrange to run " +"essentially arbitrary code in a victim user's process, simply by connecting " +"to the victim's :func:`listen` socket and sending a configuration which runs " +"whatever code the attacker wants to have executed in the victim's process. " +"This is especially easy to do if the default port is used, but not hard even " +"if a different port is used. To avoid the risk of this happening, use the " +"``verify`` argument to :func:`listen` to prevent unrecognised configurations " +"from being applied." +msgstr "" + +msgid "The ``verify`` argument was added." +msgstr "" + +msgid "" +"If you want to send configurations to the listener which don't disable " +"existing loggers, you will need to use a JSON format for the configuration, " +"which will use :func:`dictConfig` for configuration. This method allows you " +"to specify ``disable_existing_loggers`` as ``False`` in the configuration " +"you send." +msgstr "" + +msgid "" +"Stops the listening server which was created with a call to :func:`listen`. " +"This is typically called before calling :meth:`join` on the return value " +"from :func:`listen`." +msgstr "" + +msgid "Security considerations" +msgstr "" + +msgid "" +"The logging configuration functionality tries to offer convenience, and in " +"part this is done by offering the ability to convert text in configuration " +"files into Python objects used in logging configuration - for example, as " +"described in :ref:`logging-config-dict-userdef`. However, these same " +"mechanisms (importing callables from user-defined modules and calling them " +"with parameters from the configuration) could be used to invoke any code you " +"like, and for this reason you should treat configuration files from " +"untrusted sources with *extreme caution* and satisfy yourself that nothing " +"bad can happen if you load them, before actually loading them." +msgstr "" + +msgid "Configuration dictionary schema" +msgstr "" + +msgid "" +"Describing a logging configuration requires listing the various objects to " +"create and the connections between them; for example, you may create a " +"handler named 'console' and then say that the logger named 'startup' will " +"send its messages to the 'console' handler. These objects aren't limited to " +"those provided by the :mod:`logging` module because you might write your own " +"formatter or handler class. The parameters to these classes may also need to " +"include external objects such as ``sys.stderr``. The syntax for describing " +"these objects and connections is defined in :ref:`logging-config-dict-" +"connections` below." +msgstr "" + +msgid "Dictionary Schema Details" +msgstr "" + +msgid "" +"The dictionary passed to :func:`dictConfig` must contain the following keys:" +msgstr "" + +msgid "" +"*version* - to be set to an integer value representing the schema version. " +"The only valid value at present is 1, but having this key allows the schema " +"to evolve while still preserving backwards compatibility." +msgstr "" + +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; " +"otherwise, the context is used to determine what to instantiate." +msgstr "" + +msgid "" +"*formatters* - the corresponding value will be a dict in which each key is a " +"formatter id and each value is a dict describing how to configure the " +"corresponding :class:`~logging.Formatter` instance." +msgstr "" + +msgid "" +"The configuring dict is searched for the following optional keys which " +"correspond to the arguments passed to create a :class:`~logging.Formatter` " +"object:" +msgstr "" + +msgid "``format``" +msgstr "``format``" + +msgid "``datefmt``" +msgstr "``datefmt``" + +msgid "``style``" +msgstr "``style``" + +msgid "``validate`` (since version >=3.8)" +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 " +"configuration keys, you should use :ref:`logging-config-dict-userdef`." +msgstr "" + +msgid "" +"*filters* - the corresponding value will be a dict in which each key is a " +"filter id and each value is a dict describing how to configure the " +"corresponding Filter instance." +msgstr "" + +msgid "" +"The configuring dict is searched for the key ``name`` (defaulting to the " +"empty string) and this is used to construct a :class:`logging.Filter` " +"instance." +msgstr "" + +msgid "" +"*handlers* - the corresponding value will be a dict in which each key is a " +"handler id and each value is a dict describing how to configure the " +"corresponding Handler instance." +msgstr "" + +msgid "The configuring dict is searched for the following keys:" +msgstr "" + +msgid "" +"``class`` (mandatory). This is the fully qualified name of the handler " +"class." +msgstr "" + +msgid "``level`` (optional). The level of the handler." +msgstr "" + +msgid "``formatter`` (optional). The id of the formatter for this handler." +msgstr "" + +msgid "``filters`` (optional). A list of ids of the filters for this handler." +msgstr "" + +msgid "``filters`` can take filter instances in addition to ids." +msgstr "" + +msgid "" +"All *other* keys are passed through as keyword arguments to the handler's " +"constructor. For example, given the snippet:" +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``." +msgstr "" + +msgid "" +"*loggers* - the corresponding value will be a dict in which each key is a " +"logger name and each value is a dict describing how to configure the " +"corresponding Logger instance." +msgstr "" + +msgid "``level`` (optional). The level of the logger." +msgstr "" + +msgid "``propagate`` (optional). The propagation setting of the logger." +msgstr "" + +msgid "``filters`` (optional). A list of ids of the filters for this logger." +msgstr "" + +msgid "" +"``handlers`` (optional). A list of ids of the handlers for this logger." +msgstr "" + +msgid "" +"The specified loggers will be configured according to the level, " +"propagation, filters and handlers specified." +msgstr "" + +msgid "" +"*root* - this will be the configuration for the root logger. Processing of " +"the configuration will be as for any logger, except that the ``propagate`` " +"setting will not be applicable." +msgstr "" + +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." +msgstr "" + +msgid "" +"If the specified value is ``True``, the configuration is processed as " +"described in the section on :ref:`logging-config-dict-incremental`." +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``." +msgstr "" + +msgid "Incremental Configuration" +msgstr "" + +msgid "" +"It is difficult to provide complete flexibility for incremental " +"configuration. For example, because objects such as filters and formatters " +"are anonymous, once a configuration is set up, it is not possible to refer " +"to such anonymous objects when augmenting a configuration." +msgstr "" + +msgid "" +"Furthermore, there is not a compelling case for arbitrarily altering the " +"object graph of loggers, handlers, filters, formatters at run-time, once a " +"configuration is set up; the verbosity of loggers and handlers can be " +"controlled just by setting levels (and, in the case of loggers, propagation " +"flags). Changing the object graph arbitrarily in a safe way is problematic " +"in a multi-threaded environment; while not impossible, the benefits are not " +"worth the complexity it adds to the implementation." +msgstr "" + +msgid "" +"Thus, when the ``incremental`` key of a configuration dict is present and is " +"``True``, the system will completely ignore any ``formatters`` and " +"``filters`` entries, and process only the ``level`` settings in the " +"``handlers`` entries, and the ``level`` and ``propagate`` settings in the " +"``loggers`` and ``root`` entries." +msgstr "" + +msgid "" +"Using a value in the configuration dict lets configurations to be sent over " +"the wire as pickled dicts to a socket listener. Thus, the logging verbosity " +"of a long-running application can be altered over time with no need to stop " +"and restart the application." +msgstr "" + +msgid "Object connections" +msgstr "" + +msgid "" +"The schema describes a set of logging objects - loggers, handlers, " +"formatters, filters - which are connected to each other in an object graph. " +"Thus, the schema needs to represent connections between the objects. For " +"example, say that, once configured, a particular logger has attached to it a " +"particular handler. For the purposes of this discussion, we can say that " +"the logger represents the source, and the handler the destination, of a " +"connection between the two. Of course in the configured objects this is " +"represented by the logger holding a reference to the handler. In the " +"configuration dict, this is done by giving each destination object an id " +"which identifies it unambiguously, and then using the id in the source " +"object's configuration to indicate that a connection exists between the " +"source and the destination object with that id." +msgstr "" + +msgid "So, for example, consider the following YAML snippet:" +msgstr "" + +msgid "" +"(Note: YAML used here because it's a little more readable than the " +"equivalent Python source form for the dictionary.)" +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." +msgstr "" + +msgid "" +"The above snippet indicates that logger named ``foo.bar.baz`` should have " +"two handlers attached to it, which are described by the handler ids ``h1`` " +"and ``h2``. The formatter for ``h1`` is that described by id ``brief``, and " +"the formatter for ``h2`` is that described by id ``precise``." +msgstr "" + +msgid "User-defined objects" +msgstr "" + +msgid "" +"The schema supports user-defined objects for handlers, filters and " +"formatters. (Loggers do not need to have different types for different " +"instances, so there is no support in this configuration schema for user-" +"defined logger classes.)" +msgstr "" + +msgid "" +"Objects to be configured are described by dictionaries which detail their " +"configuration. In some places, the logging system will be able to infer " +"from the context how an object is to be instantiated, but when a user-" +"defined object is to be instantiated, the system will not know how to do " +"this. In order to provide complete flexibility for user-defined object " +"instantiation, the user needs to provide a 'factory' - a callable which is " +"called with a configuration dictionary and which returns the instantiated " +"object. This is signalled by an absolute import path to the factory being " +"made available under the special key ``'()'``. Here's a concrete example:" +msgstr "" + +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 " +"configuration sub-dictionaries::" +msgstr "" + +msgid "and::" +msgstr "" + +msgid "" +"respectively, and as these dictionaries do not contain the special key " +"``'()'``, the instantiation is inferred from the context: as a result, " +"standard :class:`logging.Formatter` instances are created. The " +"configuration sub-dictionary for the third formatter, with id ``custom``, " +"is::" +msgstr "" + +msgid "" +"and this contains the special key ``'()'``, which means that user-defined " +"instantiation is wanted. In this case, the specified factory callable will " +"be used. If it is an actual callable it will be used directly - otherwise, " +"if you specify a string (as in the example) the actual callable will be " +"located using normal import mechanisms. The callable will be called with the " +"**remaining** items in the configuration sub-dictionary as keyword " +"arguments. In the above example, the formatter with id ``custom`` will be " +"assumed to be returned by the call::" +msgstr "" + +msgid "" +"The values for keys such as ``bar``, ``spam`` and ``answer`` in the above " +"example should not be configuration dictionaries or references such as " +"``cfg://foo`` or ``ext://bar``, because they will not be processed by the " +"configuration machinery, but passed to the callable as-is." +msgstr "" + +msgid "" +"The key ``'()'`` has been used as the special key because it is not a valid " +"keyword parameter name, and so will not clash with the names of the keyword " +"arguments used in the call. The ``'()'`` also serves as a mnemonic that the " +"corresponding value is a callable." +msgstr "" + +msgid "" +"The ``filters`` member of ``handlers`` and ``loggers`` can take filter " +"instances in addition to ids." +msgstr "" + +msgid "" +"You can also specify a special key ``'.'`` whose value is a dictionary is a " +"mapping of attribute names to values. If found, the specified attributes " +"will be set on the user-defined object before it is returned. Thus, with the " +"following configuration::" +msgstr "" + +msgid "" +"the returned formatter will have attribute ``foo`` set to ``'bar'`` and " +"attribute ``baz`` set to ``'bozz'``." +msgstr "" + +msgid "" +"The values for attributes such as ``foo`` and ``baz`` in the above example " +"should not be configuration dictionaries or references such as ``cfg://foo`` " +"or ``ext://bar``, because they will not be processed by the configuration " +"machinery, but set as attribute values as-is." +msgstr "" + +msgid "Handler configuration order" +msgstr "" + +msgid "" +"Handlers are configured in alphabetical order of their keys, and a " +"configured handler replaces the configuration dictionary in (a working copy " +"of) the ``handlers`` dictionary in the schema. If you use a construct such " +"as ``cfg://handlers.foo``, then initially ``handlers['foo']`` points to the " +"configuration dictionary for the handler named ``foo``, and later (once that " +"handler has been configured) it points to the configured handler instance. " +"Thus, ``cfg://handlers.foo`` could resolve to either a dictionary or a " +"handler instance. In general, it is wise to name handlers in a way such that " +"dependent handlers are configured _after_ any handlers they depend on; that " +"allows something like ``cfg://handlers.foo`` to be used in configuring a " +"handler that depends on handler ``foo``. If that dependent handler were " +"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." +msgstr "" + +msgid "Access to external objects" +msgstr "" + +msgid "" +"There are times where a configuration needs to refer to objects external to " +"the configuration, for example ``sys.stderr``. If the configuration dict is " +"constructed using Python code, this is straightforward, but a problem arises " +"when the configuration is provided via a text file (e.g. JSON, YAML). In a " +"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." +msgstr "" + +msgid "" +"The handling of such prefixes is done in a way analogous to protocol " +"handling: there is a generic mechanism to look for prefixes which match the " +"regular expression ``^(?P[a-z]+)://(?P.*)$`` whereby, if the " +"``prefix`` is recognised, the ``suffix`` is processed in a prefix-dependent " +"manner and the result of the processing replaces the string value. If the " +"prefix is not recognised, then the string value will be left as-is." +msgstr "" + +msgid "Access to internal objects" +msgstr "" + +msgid "" +"As well as external objects, there is sometimes also a need to refer to " +"objects in the configuration. This will be done implicitly by the " +"configuration system for things that it knows about. For example, the " +"string value ``'DEBUG'`` for a ``level`` in a logger or handler will " +"automatically be converted to the value ``logging.DEBUG``, and the " +"``handlers``, ``filters`` and ``formatter`` entries will take an object id " +"and resolve to the appropriate destination object." +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:" +msgstr "" + +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:" +msgstr "" + +msgid "" +"in the configuration, the string ``'cfg://handlers'`` would resolve to the " +"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. 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 "" +"Given a string ``cfg://handlers.myhandler.mykey.123``, this will resolve to " +"``config_dict['handlers']['myhandler']['mykey']['123']``. If the string is " +"specified as ``cfg://handlers.myhandler.mykey[123]``, the system will " +"attempt to retrieve the value from ``config_dict['handlers']['myhandler']" +"['mykey'][123]``, and fall back to ``config_dict['handlers']['myhandler']" +"['mykey']['123']`` if that fails." +msgstr "" + +msgid "Import resolution and custom importers" +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::" +msgstr "" + +msgid "" +"You don't need to wrap with :func:`staticmethod` if you're setting the " +"import callable on a configurator *instance*." +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 " +"``[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 " +"configured. Thus, for a logger named ``log01`` in the ``[loggers]`` " +"section, the relevant configuration details are held in a section " +"``[logger_log01]``. Similarly, a handler called ``hand01`` in the " +"``[handlers]`` section will have its configuration held in a section called " +"``[handler_hand01]``, while a formatter called ``form01`` in the " +"``[formatters]`` section will have its configuration specified in a section " +"called ``[formatter_form01]``. The root logger configuration must be " +"specified in a section called ``[logger_root]``." +msgstr "" + +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." +msgstr "" + +msgid "Examples of these sections in the file are given below." +msgstr "" + +msgid "" +"The root logger must specify a level and a list of handlers. An example of a " +"root logger section is given below." +msgstr "" + +msgid "" +"The ``level`` entry can be one of ``DEBUG, INFO, WARNING, ERROR, CRITICAL`` " +"or ``NOTSET``. For the root logger only, ``NOTSET`` means that all messages " +"will be logged. Level values are :ref:`evaluated ` in the context " +"of the ``logging`` package's namespace." +msgstr "" + +msgid "" +"The ``handlers`` entry is a comma-separated list of handler names, which " +"must appear in the ``[handlers]`` section. These names must appear in the " +"``[handlers]`` section and have corresponding sections in the configuration " +"file." +msgstr "" + +msgid "" +"For loggers other than the root logger, some additional information is " +"required. This is illustrated by the following example." +msgstr "" + +msgid "" +"The ``level`` and ``handlers`` entries are interpreted as for the root " +"logger, except that if a non-root logger's level is specified as ``NOTSET``, " +"the system consults loggers higher up the hierarchy to determine the " +"effective level of the logger. The ``propagate`` entry is set to 1 to " +"indicate that messages must propagate to handlers higher up the logger " +"hierarchy from this logger, or 0 to indicate that messages are **not** " +"propagated to handlers up the hierarchy. The ``qualname`` entry is the " +"hierarchical channel name of the logger, that is to say the name used by the " +"application to get the logger." +msgstr "" + +msgid "" +"Sections which specify handler configuration are exemplified by the " +"following." +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'." +msgstr "" + +msgid "" +"The ``formatter`` entry indicates the key name of the formatter for this " +"handler. If blank, a default formatter (``logging._defaultFormatter``) is " +"used. If a name is specified, it must appear in the ``[formatters]`` section " +"and have a corresponding section in the configuration file." +msgstr "" + +msgid "" +"The ``args`` entry, when :ref:`evaluated ` in the context of the " +"``logging`` package's namespace, is the list of arguments to the constructor " +"for the handler class. Refer to the constructors for the relevant handlers, " +"or to the examples below, to see how typical entries are constructed. If not " +"provided, it defaults to ``()``." +msgstr "" + +msgid "" +"The optional ``kwargs`` entry, when :ref:`evaluated ` in the " +"context of the ``logging`` package's namespace, is the keyword argument dict " +"to the constructor for the handler class. If not provided, it defaults to " +"``{}``." +msgstr "" + +msgid "" +"Sections which specify formatter configuration are typified by the following." +msgstr "" + +msgid "" +"The arguments for the formatter configuration are the same as the keys in " +"the dictionary schema :ref:`formatters section `." +msgstr "" + +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." +msgstr "" + +msgid "Module :mod:`logging`" +msgstr "" + +msgid "API reference for the logging module." +msgstr "" + +msgid "Module :mod:`logging.handlers`" +msgstr "" + +msgid "Useful handlers included with the logging module." +msgstr "" diff --git a/library/logging.handlers.po b/library/logging.handlers.po new file mode 100644 index 0000000000..a7b7fee33e --- /dev/null +++ b/library/logging.handlers.po @@ -0,0 +1,1349 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`logging.handlers` --- Logging handlers" +msgstr "" + +msgid "**Source code:** :source:`Lib/logging/handlers.py`" +msgstr "" + +msgid "" +"This page contains only reference information. For tutorials, please see" +msgstr "" + +msgid ":ref:`Basic Tutorial `" +msgstr "" + +msgid ":ref:`Advanced Tutorial `" +msgstr "" + +msgid ":ref:`Logging Cookbook `" +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." +msgstr "" + +msgid "StreamHandler" +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)." +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." +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." +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." +msgstr "" + +msgid "" +"Sets the instance's stream to the specified value, if it is different. The " +"old stream is flushed before the new stream is set." +msgstr "" + +msgid "Parameters" +msgstr "parametry" + +msgid "The stream that the handler should use." +msgstr "" + +msgid "Returns" +msgstr "Zwraca" + +msgid "the old stream, if the stream was changed, or *None* if it wasn't." +msgstr "" + +msgid "" +"String used as the terminator when writing a formatted record to a stream. " +"Default value is ``'\\n'``." +msgstr "" + +msgid "" +"If you don't want a newline termination, you can set the handler instance's " +"``terminator`` attribute to the empty string." +msgstr "" + +msgid "In earlier versions, the terminator was hardcoded as ``'\\n'``." +msgstr "" + +msgid "FileHandler" +msgstr "" + +msgid "" +"The :class:`FileHandler` class, located in the core :mod:`logging` package, " +"sends logging output to a disk file. It inherits the output functionality " +"from :class:`StreamHandler`." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`FileHandler` class. The specified file " +"is opened and used as the stream for logging. If *mode* is not specified, " +"``'a'`` is used. If *encoding* is not ``None``, it is used to open the file " +"with that encoding. If *delay* is true, then file opening is deferred until " +"the first call to :meth:`emit`. By default, the file grows indefinitely. If " +"*errors* is specified, it's used to determine how encoding errors are " +"handled." +msgstr "" + +msgid "" +"As well as string values, :class:`~pathlib.Path` objects are also accepted " +"for the *filename* argument." +msgstr "" + +msgid "The *errors* parameter was added." +msgstr "" + +msgid "Closes the file." +msgstr "" + +msgid "Outputs the record to the file." +msgstr "" + +msgid "" +"Note that if the file was closed due to logging shutdown at exit and the " +"file mode is 'w', the record will not be emitted (see :issue:`42378`)." +msgstr "" + +msgid "NullHandler" +msgstr "" + +msgid "" +"The :class:`NullHandler` class, located in the core :mod:`logging` package, " +"does not do any formatting or output. It is essentially a 'no-op' handler " +"for use by library developers." +msgstr "" + +msgid "Returns a new instance of the :class:`NullHandler` class." +msgstr "" + +msgid "This method does nothing." +msgstr "" + +msgid "" +"This method returns ``None`` for the lock, since there is no underlying I/O " +"to which access needs to be serialized." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"A file change can happen because of usage of programs such as *newsyslog* " +"and *logrotate* which perform log file rotation. This handler, intended for " +"use under Unix/Linux, watches the file to see if it has changed since the " +"last emit. (A file is deemed to have changed if its device or inode have " +"changed.) If the file has changed, the old file stream is closed, and the " +"file opened to get a new stream." +msgstr "" + +msgid "" +"This handler is not appropriate for use under Windows, because under Windows " +"open log files cannot be moved or renamed - logging opens the files with " +"exclusive locks - and so there is no need for such a handler. Furthermore, " +"*ST_INO* is not supported under Windows; :func:`~os.stat` always returns " +"zero for this value." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`WatchedFileHandler` class. The " +"specified file is opened and used as the stream for logging. If *mode* is " +"not specified, ``'a'`` is used. If *encoding* is not ``None``, it is used " +"to open the file with that encoding. If *delay* is true, then file opening " +"is deferred until the first call to :meth:`emit`. By default, the file " +"grows indefinitely. If *errors* is provided, it determines how encoding " +"errors are handled." +msgstr "" + +msgid "" +"Checks to see if the file has changed. If it has, the existing stream is " +"flushed and closed and the file opened again, typically as a precursor to " +"outputting the record to the file." +msgstr "" + +msgid "" +"Outputs the record to the file, but first calls :meth:`reopenIfNeeded` to " +"reopen the file if it has changed." +msgstr "" + +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." +msgstr "" + +msgid "The parameters are as for :class:`FileHandler`. The attributes are:" +msgstr "" + +msgid "" +"If this attribute is set to a callable, the :meth:`rotation_filename` method " +"delegates to this callable. The parameters passed to the callable are those " +"passed to :meth:`rotation_filename`." +msgstr "" + +msgid "" +"The namer function is called quite a few times during rollover, so it should " +"be as simple and as fast as possible. It should also return the same output " +"every time for a given input, otherwise the rollover behaviour may not work " +"as expected." +msgstr "" + +msgid "" +"It's also worth noting that care should be taken when using a namer to " +"preserve certain attributes in the filename which are used during rotation. " +"For example, :class:`RotatingFileHandler` expects to have a set of log files " +"whose names contain successive integers, so that rotation works as expected, " +"and :class:`TimedRotatingFileHandler` deletes old log files (based on the " +"``backupCount`` parameter passed to the handler's initializer) by " +"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.)" +msgstr "" + +msgid "" +"If this attribute is set to a callable, the :meth:`rotate` method delegates " +"to this callable. The parameters passed to the callable are those passed " +"to :meth:`rotate`." +msgstr "" + +msgid "Modify the filename of a log file when rotating." +msgstr "" + +msgid "This is provided so that a custom filename can be provided." +msgstr "" + +msgid "" +"The default implementation calls the 'namer' attribute of the handler, if " +"it's callable, passing the default name to it. If the attribute isn't " +"callable (the default is ``None``), the name is returned unchanged." +msgstr "" + +msgid "The default name for the log file." +msgstr "" + +msgid "When rotating, rotate the current log." +msgstr "" + +msgid "" +"The default implementation calls the 'rotator' attribute of the handler, if " +"it's callable, passing the source and dest arguments to it. If the attribute " +"isn't callable (the default is ``None``), the source is simply renamed to " +"the destination." +msgstr "" + +msgid "" +"The source filename. This is normally the base filename, e.g. 'test.log'." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"If you need to make more significant changes to rotation processing, you can " +"override the methods." +msgstr "" + +msgid "For an example, see :ref:`cookbook-rotator-namer`." +msgstr "" + +msgid "RotatingFileHandler" +msgstr "" + +msgid "" +"The :class:`RotatingFileHandler` class, located in the :mod:`logging." +"handlers` module, supports rotation of disk log files." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`RotatingFileHandler` class. The " +"specified file is opened and used as the stream for logging. If *mode* is " +"not specified, ``'a'`` is used. If *encoding* is not ``None``, it is used " +"to open the file with that encoding. If *delay* is true, then file opening " +"is deferred until the first call to :meth:`emit`. By default, the file " +"grows indefinitely. If *errors* is provided, it determines how encoding " +"errors are handled." +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 " +"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." +msgstr "" + +msgid "Does a rollover, as described above." +msgstr "" + +msgid "" +"Outputs the record to the file, catering for rollover as described " +"previously." +msgstr "" + +msgid "TimedRotatingFileHandler" +msgstr "" + +msgid "" +"The :class:`TimedRotatingFileHandler` class, located in the :mod:`logging." +"handlers` module, supports rotation of disk log files at certain timed " +"intervals." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`TimedRotatingFileHandler` class. The " +"specified file is opened and used as the stream for logging. On rotating it " +"also sets the filename suffix. Rotating happens based on the product of " +"*when* and *interval*." +msgstr "" + +msgid "" +"You can use the *when* to specify the type of *interval*. The list of " +"possible values is below. Note that they are not case sensitive." +msgstr "" + +msgid "Value" +msgstr "Wartość" + +msgid "Type of interval" +msgstr "" + +msgid "If/how *atTime* is used" +msgstr "" + +msgid "``'S'``" +msgstr "``'S'``" + +msgid "Seconds" +msgstr "" + +msgid "Ignored" +msgstr "" + +msgid "``'M'``" +msgstr "``'M'``" + +msgid "Minutes" +msgstr "" + +msgid "``'H'``" +msgstr "``'H'``" + +msgid "Hours" +msgstr "" + +msgid "``'D'``" +msgstr "``'D'``" + +msgid "Days" +msgstr "" + +msgid "``'W0'-'W6'``" +msgstr "``'W0'-'W6'``" + +msgid "Weekday (0=Monday)" +msgstr "" + +msgid "Used to compute initial rollover time" +msgstr "" + +msgid "``'midnight'``" +msgstr "" + +msgid "Roll over at midnight, if *atTime* not specified, else at time *atTime*" +msgstr "" + +msgid "" +"When using weekday-based rotation, specify 'W0' for Monday, 'W1' for " +"Tuesday, and so on up to 'W6' for Sunday. In this case, the value passed for " +"*interval* isn't used." +msgstr "" + +msgid "" +"The system will save old log files by appending extensions to the filename. " +"The extensions are date-and-time based, using the strftime format ``%Y-%m-" +"%d_%H-%M-%S`` or a leading portion thereof, depending on the rollover " +"interval." +msgstr "" + +msgid "" +"When computing the next rollover time for the first time (when the handler " +"is created), the last modification time of an existing log file, or else the " +"current time, is used to compute when the next rotation will occur." +msgstr "" + +msgid "" +"If the *utc* argument is true, times in UTC will be used; otherwise local " +"time is used." +msgstr "" + +msgid "" +"If *backupCount* is nonzero, at most *backupCount* files will be kept, and " +"if more would be created when rollover occurs, the oldest one is deleted. " +"The deletion logic uses the interval to determine which files to delete, so " +"changing the interval may leave old files lying around." +msgstr "" + +msgid "" +"If *delay* is true, then file opening is deferred until the first call to :" +"meth:`emit`." +msgstr "" + +msgid "" +"If *atTime* is not ``None``, it must be a ``datetime.time`` instance which " +"specifies the time of day when rollover occurs, for the cases where rollover " +"is set to happen \"at midnight\" or \"on a particular weekday\". Note that " +"in these cases, the *atTime* value is effectively used to compute the " +"*initial* rollover, and subsequent rollovers would be calculated via the " +"normal interval calculation." +msgstr "" + +msgid "" +"If *errors* is specified, it's used to determine how encoding errors are " +"handled." +msgstr "" + +msgid "" +"Calculation of the initial rollover time is done when the handler is " +"initialised. Calculation of subsequent rollover times is done only when " +"rollover occurs, and rollover occurs only when emitting output. If this is " +"not kept in mind, it might lead to some confusion. For example, if an " +"interval of \"every minute\" is set, that does not mean you will always see " +"log files with times (in the filename) separated by a minute; if, during " +"application execution, logging output is generated more frequently than once " +"a minute, *then* you can expect to see log files with times separated by a " +"minute. If, on the other hand, logging messages are only output once every " +"five minutes (say), then there will be gaps in the file times corresponding " +"to the minutes where no output (and hence no rollover) occurred." +msgstr "" + +msgid "*atTime* parameter was added." +msgstr "" + +msgid "" +"Outputs the record to the file, catering for rollover as described above." +msgstr "" + +msgid "" +"Returns a list of filenames which should be deleted as part of rollover. " +"These are the absolute paths of the oldest backup log files written by the " +"handler." +msgstr "" + +msgid "SocketHandler" +msgstr "" + +msgid "" +"The :class:`SocketHandler` class, located in the :mod:`logging.handlers` " +"module, sends logging output to a network socket. The base class uses a TCP " +"socket." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`SocketHandler` class intended to " +"communicate with a remote machine whose address is given by *host* and " +"*port*." +msgstr "" + +msgid "" +"If ``port`` is specified as ``None``, a Unix domain socket is created using " +"the value in ``host`` - otherwise, a TCP socket is created." +msgstr "" + +msgid "Closes the socket." +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. 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." +msgstr "" + +msgid "" +"Handles an error which has occurred during :meth:`emit`. The most likely " +"cause is a lost connection. Closes the socket so that we can retry on the " +"next event." +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`)." +msgstr "" + +msgid "" +"Pickles the record's attribute dictionary in binary format with a length " +"prefix, and returns it ready for transmission across the socket. The details " +"of this operation are equivalent to::" +msgstr "" + +msgid "" +"Note that pickles aren't completely secure. If you are concerned about " +"security, you may want to override this method to implement a more secure " +"mechanism. For example, you can sign pickles using HMAC and then verify them " +"on the receiving end, or alternatively you can disable unpickling of global " +"objects on the receiving end." +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`." +msgstr "" + +msgid "" +"This function allows for partial sends, which can happen when the network is " +"busy." +msgstr "" + +msgid "" +"Tries to create a socket; on failure, uses an exponential back-off " +"algorithm. On initial failure, the handler will drop the message it was " +"trying to send. When subsequent messages are handled by the same instance, " +"it will not try connecting until some time has passed. The default " +"parameters are such that the initial delay is one second, and if after that " +"delay the connection still can't be made, the handler will double the delay " +"each time up to a maximum of 30 seconds." +msgstr "" + +msgid "This behaviour is controlled by the following handler attributes:" +msgstr "" + +msgid "``retryStart`` (initial delay, defaulting to 1.0 seconds)." +msgstr "" + +msgid "``retryFactor`` (multiplier, defaulting to 2.0)." +msgstr "" + +msgid "``retryMax`` (maximum delay, defaulting to 30.0 seconds)." +msgstr "" + +msgid "" +"This means that if the remote listener starts up *after* the handler has " +"been used, you could lose messages (since the handler won't even attempt a " +"connection until the delay has elapsed, but just silently drop messages " +"during the delay period)." +msgstr "" + +msgid "DatagramHandler" +msgstr "" + +msgid "" +"The :class:`DatagramHandler` class, located in the :mod:`logging.handlers` " +"module, inherits from :class:`SocketHandler` to support sending logging " +"messages over UDP sockets." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`DatagramHandler` class intended to " +"communicate with a remote machine whose address is given by *host* and " +"*port*." +msgstr "" + +msgid "" +"As UDP is not a streaming protocol, there is no persistent connection " +"between an instance of this handler and *host*. For this reason, when using " +"a network socket, a DNS lookup might have to be made each time an event is " +"logged, which can introduce some latency into the system. If this affects " +"you, you can do a lookup yourself and initialize this handler using the " +"looked-up IP address rather than the hostname." +msgstr "" + +msgid "" +"If ``port`` is specified as ``None``, a Unix domain socket is created using " +"the value in ``host`` - otherwise, a UDP socket is created." +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." +msgstr "" + +msgid "" +"The factory method of :class:`SocketHandler` is here overridden to create a " +"UDP socket (:const:`socket.SOCK_DGRAM`)." +msgstr "" + +msgid "" +"Send a pickled byte-string to a socket. The format of the sent byte-string " +"is as described in the documentation for :meth:`SocketHandler.makePickle`." +msgstr "" + +msgid "SysLogHandler" +msgstr "" + +msgid "" +"The :class:`SysLogHandler` class, located in the :mod:`logging.handlers` " +"module, supports sending logging messages to a remote or local Unix syslog." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`SysLogHandler` class intended to " +"communicate with a remote Unix machine whose address is given by *address* " +"in the form of a ``(host, port)`` tuple. If *address* is not specified, " +"``('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`." +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." +msgstr "" + +msgid "" +"On macOS 12.x (Monterey), Apple has changed the behaviour of their syslog " +"daemon - it no longer listens on a domain socket. Therefore, you cannot " +"expect :class:`SysLogHandler` to work on this system." +msgstr "" + +msgid "See :gh:`91070` for more information." +msgstr "" + +msgid "*socktype* was added." +msgstr "" + +msgid "Closes the socket to the remote host." +msgstr "" + +msgid "" +"Tries to create a socket and, if it's not a datagram socket, connect it to " +"the other end. This method is called during handler initialization, but it's " +"not regarded as an error if the other end isn't listening at this point - " +"the method will be called again when emitting an event, if there is no " +"socket at that point." +msgstr "" + +msgid "" +"The record is formatted, and then sent to the syslog server. If exception " +"information is present, it is *not* sent to the server." +msgstr "" + +msgid "" +"(See: :issue:`12168`.) In earlier versions, the message sent to the syslog " +"daemons was always terminated with a NUL byte, because early versions of " +"these daemons expected a NUL terminated message - even though it's not in " +"the relevant specification (:rfc:`5424`). More recent versions of these " +"daemons don't expect the NUL byte but strip it off if it's there, and even " +"more recent daemons (which adhere more closely to RFC 5424) pass the NUL " +"byte on as part of the message." +msgstr "" + +msgid "" +"To enable easier handling of syslog messages in the face of all these " +"differing daemon behaviours, the appending of the NUL byte has been made " +"configurable, through the use of a class-level attribute, ``append_nul``. " +"This defaults to ``True`` (preserving the existing behaviour) but can be set " +"to ``False`` on a ``SysLogHandler`` instance in order for that instance to " +"*not* append the NUL terminator." +msgstr "" + +msgid "" +"(See: :issue:`12419`.) In earlier versions, there was no facility for an " +"\"ident\" or \"tag\" prefix to identify the source of the message. This can " +"now be specified using a class-level attribute, defaulting to ``\"\"`` to " +"preserve existing behaviour, but which can be overridden on a " +"``SysLogHandler`` instance in order for that instance to prepend the ident " +"to every message handled. Note that the provided ident must be text, not " +"bytes, and is prepended to the message exactly as is." +msgstr "" + +msgid "" +"Encodes the facility and priority into an integer. You can pass in strings " +"or integers - if strings are passed, internal mapping dictionaries are used " +"to convert them to integers." +msgstr "" + +msgid "" +"The symbolic ``LOG_`` values are defined in :class:`SysLogHandler` and " +"mirror the values defined in the ``sys/syslog.h`` header file." +msgstr "" + +msgid "**Priorities**" +msgstr "" + +msgid "Name (string)" +msgstr "" + +msgid "Symbolic value" +msgstr "" + +msgid "``alert``" +msgstr "" + +msgid "LOG_ALERT" +msgstr "" + +msgid "``crit`` or ``critical``" +msgstr "" + +msgid "LOG_CRIT" +msgstr "" + +msgid "``debug``" +msgstr "" + +msgid "LOG_DEBUG" +msgstr "" + +msgid "``emerg`` or ``panic``" +msgstr "" + +msgid "LOG_EMERG" +msgstr "" + +msgid "``err`` or ``error``" +msgstr "" + +msgid "LOG_ERR" +msgstr "" + +msgid "``info``" +msgstr "``info``" + +msgid "LOG_INFO" +msgstr "" + +msgid "``notice``" +msgstr "" + +msgid "LOG_NOTICE" +msgstr "" + +msgid "``warn`` or ``warning``" +msgstr "" + +msgid "LOG_WARNING" +msgstr "" + +msgid "**Facilities**" +msgstr "" + +msgid "``auth``" +msgstr "``auth``" + +msgid "LOG_AUTH" +msgstr "" + +msgid "``authpriv``" +msgstr "``authpriv``" + +msgid "LOG_AUTHPRIV" +msgstr "" + +msgid "``cron``" +msgstr "``cron``" + +msgid "LOG_CRON" +msgstr "" + +msgid "``daemon``" +msgstr "" + +msgid "LOG_DAEMON" +msgstr "" + +msgid "``ftp``" +msgstr "``ftp``" + +msgid "LOG_FTP" +msgstr "" + +msgid "``kern``" +msgstr "``kern``" + +msgid "LOG_KERN" +msgstr "" + +msgid "``lpr``" +msgstr "``lpr``" + +msgid "LOG_LPR" +msgstr "" + +msgid "``mail``" +msgstr "``mail``" + +msgid "LOG_MAIL" +msgstr "" + +msgid "``news``" +msgstr "``news``" + +msgid "LOG_NEWS" +msgstr "" + +msgid "``syslog``" +msgstr "" + +msgid "LOG_SYSLOG" +msgstr "" + +msgid "``user``" +msgstr "" + +msgid "LOG_USER" +msgstr "" + +msgid "``uucp``" +msgstr "``uucp``" + +msgid "LOG_UUCP" +msgstr "" + +msgid "``local0``" +msgstr "``local0``" + +msgid "LOG_LOCAL0" +msgstr "" + +msgid "``local1``" +msgstr "``local1``" + +msgid "LOG_LOCAL1" +msgstr "" + +msgid "``local2``" +msgstr "" + +msgid "LOG_LOCAL2" +msgstr "" + +msgid "``local3``" +msgstr "``local3``" + +msgid "LOG_LOCAL3" +msgstr "" + +msgid "``local4``" +msgstr "``local4``" + +msgid "LOG_LOCAL4" +msgstr "" + +msgid "``local5``" +msgstr "``local5``" + +msgid "LOG_LOCAL5" +msgstr "" + +msgid "``local6``" +msgstr "``local6``" + +msgid "LOG_LOCAL6" +msgstr "" + +msgid "``local7``" +msgstr "``local7``" + +msgid "LOG_LOCAL7" +msgstr "" + +msgid "" +"Maps a logging level name to a syslog priority name. You may need to " +"override this if you are using custom levels, or if the default algorithm is " +"not suitable for your needs. The default algorithm maps ``DEBUG``, ``INFO``, " +"``WARNING``, ``ERROR`` and ``CRITICAL`` to the equivalent syslog names, and " +"all other level names to 'warning'." +msgstr "" + +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." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`NTEventLogHandler` class. The " +"*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'``." +msgstr "" + +msgid "" +"At this point, you can remove the application name from the registry as a " +"source of event log entries. However, if you do this, you will not be able " +"to see the events as you intended in the Event Log Viewer - it needs to be " +"able to access the registry to get the .dll name. The current version does " +"not do this." +msgstr "" + +msgid "" +"Determines the message ID, event category and event type, and then logs the " +"message in the NT event log." +msgstr "" + +msgid "" +"Returns the event category for the record. Override this if you want to " +"specify your own categories. This version returns 0." +msgstr "" + +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." +msgstr "" + +msgid "" +"Returns the message ID for the record. If you are using your own messages, " +"you could do this by having the *msg* passed to the logger being an ID " +"rather than a format string. Then, in here, you could use a dictionary " +"lookup to get the message ID. This version returns 1, which is the base " +"message ID in :file:`win32service.pyd`." +msgstr "" + +msgid "SMTPHandler" +msgstr "" + +msgid "" +"The :class:`SMTPHandler` class, located in the :mod:`logging.handlers` " +"module, supports sending logging messages to an email address via SMTP." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`SMTPHandler` class. The instance is " +"initialized with the from and to addresses and subject line of the email. " +"The *toaddrs* should be a list of strings. To specify a non-standard SMTP " +"port, use the (host, port) tuple format for the *mailhost* argument. If you " +"use a string, the standard SMTP port is used. If your SMTP server requires " +"authentication, you can specify a (username, password) tuple for the " +"*credentials* argument." +msgstr "" + +msgid "" +"To specify the use of a secure protocol (TLS), pass in a tuple to the " +"*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.)" +msgstr "" + +msgid "" +"A timeout can be specified for communication with the SMTP server using the " +"*timeout* argument." +msgstr "" + +msgid "Added the *timeout* parameter." +msgstr "" + +msgid "Formats the record and sends it to the specified addressees." +msgstr "" + +msgid "" +"If you want to specify a subject line which is record-dependent, override " +"this method." +msgstr "" + +msgid "MemoryHandler" +msgstr "" + +msgid "" +"The :class:`MemoryHandler` class, located in the :mod:`logging.handlers` " +"module, supports buffering of logging records in memory, periodically " +"flushing them to a :dfn:`target` handler. Flushing occurs whenever the " +"buffer is full, or when an event of a certain severity or greater is seen." +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." +msgstr "" + +msgid "" +"Initializes the handler with a buffer of the specified capacity. Here, " +"*capacity* means the number of logging records buffered." +msgstr "" + +msgid "" +"Append the record to the buffer. If :meth:`shouldFlush` returns true, call :" +"meth:`flush` to process the buffer." +msgstr "" + +msgid "" +"For a :class:`BufferingHandler` instance, flushing means that it sets the " +"buffer to an empty list. This method can be overwritten to implement more " +"useful flushing behavior." +msgstr "" + +msgid "" +"Return ``True`` if the buffer is up to capacity. This method can be " +"overridden to implement custom flushing strategies." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`MemoryHandler` class. The instance is " +"initialized with a buffer size of *capacity* (number of records buffered). " +"If *flushLevel* is not specified, :const:`ERROR` is used. If no *target* is " +"specified, the target will need to be set using :meth:`setTarget` before " +"this handler does anything useful. If *flushOnClose* is specified as " +"``False``, then the buffer is *not* flushed when the handler is closed. If " +"not specified or specified as ``True``, the previous behaviour of flushing " +"the buffer will occur when the handler is closed." +msgstr "" + +msgid "The *flushOnClose* parameter was added." +msgstr "" + +msgid "Calls :meth:`flush`, sets the target to ``None`` and clears the buffer." +msgstr "" + +msgid "" +"For a :class:`MemoryHandler` instance, flushing means just sending the " +"buffered records to the target, if there is one. The buffer is also cleared " +"when buffered records are sent to the target. Override if you want different " +"behavior." +msgstr "" + +msgid "Sets the target handler for this handler." +msgstr "" + +msgid "Checks for buffer full or a record at the *flushLevel* or higher." +msgstr "" + +msgid "HTTPHandler" +msgstr "" + +msgid "" +"The :class:`HTTPHandler` class, located in the :mod:`logging.handlers` " +"module, supports sending logging messages to a web server, using either " +"``GET`` or ``POST`` semantics." +msgstr "" + +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." +msgstr "" + +msgid "The *context* parameter was added." +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." +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." +msgstr "" + +msgid "" +"Since preparing a record for sending it to a web server is not the same as a " +"generic formatting operation, using :meth:`~logging.Handler.setFormatter` to " +"specify a :class:`~logging.Formatter` for a :class:`HTTPHandler` has no " +"effect. Instead of calling :meth:`~logging.Handler.format`, this handler " +"calls :meth:`mapLogRecord` and then :func:`urllib.parse.urlencode` to encode " +"the dictionary in a form suitable for sending to a web server." +msgstr "" + +msgid "QueueHandler" +msgstr "" + +msgid "" +"The :class:`QueueHandler` class, located in the :mod:`logging.handlers` " +"module, supports sending logging messages to a queue, such as those " +"implemented in the :mod:`queue` or :mod:`multiprocessing` modules." +msgstr "" + +msgid "" +"Along with the :class:`QueueListener` class, :class:`QueueHandler` can be " +"used to let handlers do their work on a separate thread from the one which " +"does the logging. This is important in web applications and also other " +"service applications where threads servicing clients need to respond as " +"quickly as possible, while any potentially slow operations (such as sending " +"an email via :class:`SMTPHandler`) are done on a separate thread." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`QueueHandler` class. The instance is " +"initialized with the queue to send messages to. The *queue* can be any queue-" +"like object; it's used as-is by the :meth:`enqueue` method, which needs to " +"know how to send messages to it. The queue is not *required* to have the " +"task tracking API, which means that you can use :class:`~queue.SimpleQueue` " +"instances for *queue*." +msgstr "" + +msgid "" +"If you are using :mod:`multiprocessing`, you should avoid using :class:" +"`~queue.SimpleQueue` and instead use :class:`multiprocessing.Queue`." +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``)." +msgstr "" + +msgid "" +"Prepares a record for queuing. The object returned by this method is " +"enqueued." +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``." +msgstr "" + +msgid "" +"You might want to override this method if you want to convert the record to " +"a dict or JSON string, or send a modified copy of the record while leaving " +"the original intact." +msgstr "" + +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 " +"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 " +"ensuring the record is pickleable, and you might or might not be able to " +"avoid doing that depending on whether your ``args`` are pickleable. (Note " +"that you may have to consider not only your own code but also code in any " +"libraries that you use.)" +msgstr "" + +msgid "" +"Enqueues the record on the queue using ``put_nowait()``; you may want to " +"override this if you want to use blocking behaviour, or a timeout, or a " +"customized queue implementation." +msgstr "" + +msgid "QueueListener" +msgstr "" + +msgid "" +"The :class:`QueueListener` class, located in the :mod:`logging.handlers` " +"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`." +msgstr "" + +msgid "" +"Along with the :class:`QueueHandler` class, :class:`QueueListener` can be " +"used to let handlers do their work on a separate thread from the one which " +"does the logging. This is important in web applications and also other " +"service applications where threads servicing clients need to respond as " +"quickly as possible, while any potentially slow operations (such as sending " +"an email via :class:`SMTPHandler`) are done on a separate thread." +msgstr "" + +msgid "" +"Returns a new instance of the :class:`QueueListener` class. The instance is " +"initialized with the queue to send messages to and a list of handlers which " +"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*." +msgstr "" + +msgid "" +"If ``respect_handler_level`` is ``True``, a handler's level is respected " +"(compared with the level for the message) when deciding whether to pass " +"messages to that handler; otherwise, the behaviour is as in previous Python " +"versions - to always pass each message to each handler." +msgstr "" + +msgid "The ``respect_handler_level`` argument was added." +msgstr "" + +msgid "Dequeues a record and return it, optionally blocking." +msgstr "" + +msgid "" +"The base implementation uses ``get()``. You may want to override this method " +"if you want to use timeouts or work with custom queue implementations." +msgstr "" + +msgid "Prepare a record for handling." +msgstr "" + +msgid "" +"This implementation just returns the passed-in record. You may want to " +"override this method if you need to do any custom marshalling or " +"manipulation of the record before passing it to the handlers." +msgstr "" + +msgid "Handle a record." +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`." +msgstr "" + +msgid "Starts the listener." +msgstr "" + +msgid "" +"This starts up a background thread to monitor the queue for LogRecords to " +"process." +msgstr "" + +msgid "Stops the listener." +msgstr "" + +msgid "" +"This asks the thread to terminate, and then waits for it to do so. Note that " +"if you don't call this before your application exits, there may be some " +"records still left on the queue, which won't be processed." +msgstr "" + +msgid "" +"Writes a sentinel to the queue to tell the listener to quit. This " +"implementation uses ``put_nowait()``. You may want to override this method " +"if you want to use timeouts or work with custom queue implementations." +msgstr "" + +msgid "Module :mod:`logging`" +msgstr "" + +msgid "API reference for the logging module." +msgstr "" + +msgid "Module :mod:`logging.config`" +msgstr "" + +msgid "Configuration API for the logging module." +msgstr "" diff --git a/library/logging.po b/library/logging.po index 25de21f7ab..733f68a995 100644 --- a/library/logging.po +++ b/library/logging.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +55,30 @@ msgid "" "third-party modules." msgstr "" -msgid "The simplest example:" +msgid "Here's a simple example of idiomatic usage: ::" +msgstr "" + +msgid "If you run *myapp.py*, you should see this in *myapp.log*:" +msgstr "" + +msgid "" +"The key features of this idiomatic usage is that the majority of code is " +"simply creating a module level logger with ``getLogger(__name__)``, and " +"using that logger to do any needed logging. This is concise while allowing " +"downstream code fine grained control if needed. Logged messages to the " +"module-level logger get forwarded up to handlers of loggers in higher-level " +"modules, all the way up to the root logger; for this reason this approach is " +"known as hierarchical logging." +msgstr "" + +msgid "" +"For logging to be useful, it needs to be configured: setting the levels and " +"destinations for each logger, potentially changing how specific modules log, " +"often based on command-line arguments or application configuration. In most " +"cases, like the one above, only the root logger needs to be so configured, " +"since all the lower level loggers at module level eventually forward their " +"messages to its handlers. :func:`~logging.basicConfig` provides a quick way " +"to configure the root logger that handles many use cases." msgstr "" msgid "" @@ -108,6 +131,30 @@ msgid "" "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." +msgstr "" + +msgid "This attribute should be treated as read-only." +msgstr "" + +msgid "The threshold of this logger, as set by the :meth:`setLevel` method." +msgstr "" + +msgid "" +"Do not set this attribute directly - always use :meth:`setLevel`, which has " +"checks for the level passed to it." +msgstr "" + +msgid "" +"The parent logger of this logger. It may change based on later instantiation " +"of loggers which are higher up in the namespace hierarchy." +msgstr "" + +msgid "This value should be treated as read-only." +msgstr "" + msgid "" "If this attribute evaluates to true, events logged to this logger will be " "passed to the handlers of higher level (ancestor) loggers, in addition to " @@ -147,6 +194,20 @@ msgid "" "rest." msgstr "" +msgid "The list of handlers directly attached to this logger instance." +msgstr "" + +msgid "" +"This attribute should be treated as read-only; it is normally changed via " +"the :meth:`addHandler` and :meth:`removeHandler` methods, which use locks to " +"ensure thread-safe operation." +msgstr "" + +msgid "" +"This attribute disables handling of any events. It is set to ``False`` in " +"the initializer, and only changed by logging configuration code." +msgstr "" + msgid "" "Sets the threshold for this logger to *level*. Logging messages which are " "less severe than *level* will be ignored; logging messages which have " @@ -357,6 +418,10 @@ msgid "" "interpreted as for :meth:`debug`. Exception info is added to the logging " "message. This method should only be called from an exception handler." msgstr "" +"Loguje wiadomość z poziomem :const:`ERROR` na tym loggerze. Argumenty są " +"interpretowane jak dla :meth:`debug`. Informacje o wyjątku są dodawane do " +"komunikatu logowania. Ta metoda powinna być wywoływana tylko wewnątrz " +"klauzuli ``except``." msgid "Adds the specified filter *filter* to this logger." msgstr "" @@ -435,49 +500,64 @@ msgstr "" msgid "Numeric value" msgstr "" -msgid "``CRITICAL``" +msgid "What it means / When to use it" msgstr "" -msgid "50" -msgstr "" +msgid "0" +msgstr "0" -msgid "``ERROR``" +msgid "" +"When set on a logger, indicates that ancestor loggers are to be consulted to " +"determine the effective level. If that still resolves to :const:`!NOTSET`, " +"then all events are logged. When set on a handler, all events are handled." msgstr "" -msgid "40" +msgid "10" +msgstr "10" + +msgid "" +"Detailed information, typically only of interest to a developer trying to " +"diagnose a problem." msgstr "" -msgid "``WARNING``" +msgid "20" +msgstr "20" + +msgid "Confirmation that things are working as expected." msgstr "" msgid "30" -msgstr "" +msgstr "30" -msgid "``INFO``" +msgid "" +"An indication that something unexpected happened, or that a problem might " +"occur in the near future (e.g. 'disk space low'). The software is still " +"working as expected." msgstr "" -msgid "20" -msgstr "" +msgid "40" +msgstr "40" -msgid "``DEBUG``" +msgid "" +"Due to a more serious problem, the software has not been able to perform " +"some function." msgstr "" -msgid "10" -msgstr "" +msgid "50" +msgstr "50" -msgid "``NOTSET``" +msgid "" +"A serious error, indicating that the program itself may be unable to " +"continue running." msgstr "" -msgid "0" -msgstr "0" - 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 " +"useful subclasses. However, the :meth:`!__init__` method in subclasses needs " "to call :meth:`Handler.__init__`." msgstr "" @@ -546,14 +626,14 @@ msgstr "" msgid "" "This method should be called from handlers when an exception is encountered " -"during an :meth:`emit` call. If the module-level attribute " -"``raiseExceptions`` is ``False``, exceptions get silently ignored. This is " +"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 ``raiseExceptions`` is ``True``, as that is " -"more useful during development)." +"occurred. (The default value of :data:`raiseExceptions` is ``True``, as that " +"is more useful during development)." msgstr "" msgid "" @@ -835,7 +915,7 @@ msgid "" msgstr "" msgid "Parameters" -msgstr "" +msgstr "parametry" msgid "" "The name of the logger used to log the event represented by this :class:`!" @@ -932,7 +1012,7 @@ msgstr "" msgid "" "In the case of {}-formatting, you can specify formatting flags by placing " "them after the attribute name, separated from it with a colon. For example: " -"a placeholder of ``{msecs:03d}`` would format a millisecond value of ``4`` " +"a placeholder of ``{msecs:03.0f}`` would format a millisecond value of ``4`` " "as ``004``. Refer to the :meth:`str.format` documentation for full details " "on the options available to you." msgstr "" @@ -962,7 +1042,7 @@ msgid "asctime" msgstr "" msgid "``%(asctime)s``" -msgstr "" +msgstr "``%(asctime)s``" msgid "" "Human-readable time when the :class:`LogRecord` was created. By default " @@ -974,7 +1054,7 @@ msgid "created" msgstr "" msgid "``%(created)f``" -msgstr "" +msgstr "``%(created)f``" msgid "" "Time when the :class:`LogRecord` was created (as returned by :func:`time." @@ -993,7 +1073,7 @@ msgid "filename" msgstr "" msgid "``%(filename)s``" -msgstr "" +msgstr "``%(filename)s``" msgid "Filename portion of ``pathname``." msgstr "" @@ -1002,7 +1082,7 @@ msgid "funcName" msgstr "" msgid "``%(funcName)s``" -msgstr "" +msgstr "``%(funcName)s``" msgid "Name of function containing the logging call." msgstr "" @@ -1011,7 +1091,7 @@ msgid "levelname" msgstr "" msgid "``%(levelname)s``" -msgstr "" +msgstr "``%(levelname)s``" msgid "" "Text logging level for the message (``'DEBUG'``, ``'INFO'``, ``'WARNING'``, " @@ -1022,7 +1102,7 @@ msgid "levelno" msgstr "" msgid "``%(levelno)s``" -msgstr "" +msgstr "``%(levelno)s``" msgid "" "Numeric logging level for the message (:const:`DEBUG`, :const:`INFO`, :const:" @@ -1033,7 +1113,7 @@ msgid "lineno" msgstr "" msgid "``%(lineno)d``" -msgstr "" +msgstr "``%(lineno)d``" msgid "Source line number where the logging call was issued (if available)." msgstr "" @@ -1042,7 +1122,7 @@ msgid "message" msgstr "" msgid "``%(message)s``" -msgstr "" +msgstr "``%(message)s``" msgid "" "The logged message, computed as ``msg % args``. This is set when :meth:" @@ -1053,7 +1133,7 @@ msgid "module" msgstr "moduł" msgid "``%(module)s``" -msgstr "" +msgstr "``%(module)s``" msgid "Module (name portion of ``filename``)." msgstr "" @@ -1062,7 +1142,7 @@ msgid "msecs" msgstr "" msgid "``%(msecs)d``" -msgstr "" +msgstr "``%(msecs)d``" msgid "" "Millisecond portion of the time when the :class:`LogRecord` was created." @@ -1078,10 +1158,10 @@ msgid "" msgstr "" msgid "name" -msgstr "" +msgstr "nazwa" msgid "``%(name)s``" -msgstr "" +msgstr "``%(name)s``" msgid "Name of the logger used to log the call." msgstr "" @@ -1090,7 +1170,7 @@ msgid "pathname" msgstr "" msgid "``%(pathname)s``" -msgstr "" +msgstr "``%(pathname)s``" msgid "" "Full pathname of the source file where the logging call was issued (if " @@ -1101,7 +1181,7 @@ msgid "process" msgstr "" msgid "``%(process)d``" -msgstr "" +msgstr "``%(process)d``" msgid "Process ID (if available)." msgstr "" @@ -1110,7 +1190,7 @@ msgid "processName" msgstr "" msgid "``%(processName)s``" -msgstr "" +msgstr "``%(processName)s``" msgid "Process name (if available)." msgstr "" @@ -1119,7 +1199,7 @@ msgid "relativeCreated" msgstr "" msgid "``%(relativeCreated)d``" -msgstr "" +msgstr "``%(relativeCreated)d``" msgid "" "Time in milliseconds when the LogRecord was created, relative to the time " @@ -1139,7 +1219,7 @@ msgid "thread" msgstr "" msgid "``%(thread)d``" -msgstr "" +msgstr "``%(thread)d``" msgid "Thread ID (if available)." msgstr "" @@ -1148,7 +1228,7 @@ msgid "threadName" msgstr "" msgid "``%(threadName)s``" -msgstr "" +msgstr "``%(threadName)s``" msgid "Thread name (if available)." msgstr "" @@ -1178,6 +1258,12 @@ msgid "" "(possibly modified) versions of the arguments passed in." msgstr "" +msgid "Delegates to the underlying :attr:`!manager`` on *logger*." +msgstr "" + +msgid "Delegates to the underlying :meth:`!_log`` method on *logger*." +msgstr "" + msgid "" "In addition to the above, :class:`LoggerAdapter` supports the following " "methods of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :" @@ -1196,8 +1282,8 @@ msgid "" msgstr "" msgid "" -"Attribute :attr:`manager` and method :meth:`_log` were added, which delegate " -"to the underlying logger and allow adapters to be nested." +"Attribute :attr:`!manager` and method :meth:`!_log` were added, which " +"delegate to the underlying logger and allow adapters to be nested." msgstr "" msgid "Thread Safety" @@ -1263,63 +1349,33 @@ msgid "" msgstr "" msgid "" -"Logs a message with level :const:`DEBUG` on the root logger. The *msg* is " -"the message format string, and the *args* are the arguments which are merged " -"into *msg* using the string formatting operator. (Note that this means that " -"you can use keywords in the format string, together with a single dictionary " -"argument.)" -msgstr "" - -msgid "" -"There are three keyword arguments in *kwargs* which are inspected: " -"*exc_info* which, if it does not evaluate as false, causes exception " -"information to be added to the logging message. If an exception tuple (in " -"the format returned by :func:`sys.exc_info`) or an exception instance is " -"provided, it is used; otherwise, :func:`sys.exc_info` is called to get the " -"exception information." -msgstr "" - -msgid "" -"The third optional keyword argument is *extra* which can be used to pass a " -"dictionary which is used to populate the __dict__ of the 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 "" - -msgid "would print something like:" -msgstr "" - -msgid "" -"The keys in the dictionary passed in *extra* should not clash with the keys " -"used by the logging system. (See the :class:`Formatter` documentation for " -"more information on which keys are used by the logging system.)" +"This is a convenience function that calls :meth:`Logger.debug`, on the root " +"logger. The handling of the arguments is in every way identical to what is " +"described in that method." 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 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." +"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 "" -"This function (as well as :func:`info`, :func:`warning`, :func:`error` and :" -"func:`critical`) will call :func:`basicConfig` if the root logger doesn't " -"have any handler attached." +"For very short scripts or quick demonstrations of ``logging`` facilities, " +"``debug`` and the other module-level functions may be convenient. However, " +"most programs will want to carefully and explicitly control the logging " +"configuration, and should therefore prefer creating a module-level logger " +"and calling :meth:`Logger.debug` (or other level-specific methods) on it, as " +"described at the beginnning of this documentation." msgstr "" msgid "" "Logs a message with level :const:`INFO` on the root logger. The arguments " -"are interpreted as for :func:`debug`." +"and behavior are otherwise the same as for :func:`debug`." msgstr "" msgid "" "Logs a message with level :const:`WARNING` on the root logger. The arguments " -"are interpreted as for :func:`debug`." +"and behavior are otherwise the same as for :func:`debug`." msgstr "" msgid "" @@ -1330,23 +1386,24 @@ msgstr "" msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " -"are interpreted as for :func:`debug`." +"and behavior are otherwise the same as for :func:`debug`." msgstr "" msgid "" "Logs a message with level :const:`CRITICAL` on the root logger. The " -"arguments are interpreted as for :func:`debug`." +"arguments and behavior are otherwise the same as for :func:`debug`." msgstr "" msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " -"are interpreted as for :func:`debug`. Exception info is added to the logging " -"message. This function should only be called from an exception handler." +"and behavior are otherwise the same as for :func:`debug`. Exception info is " +"added to the logging message. This function should only be called from an " +"exception handler." msgstr "" msgid "" -"Logs a message with level *level* on the root logger. The other arguments " -"are interpreted as for :func:`debug`." +"Logs a message with level *level* on the root logger. The arguments and " +"behavior are otherwise the same as for :func:`debug`." msgstr "" msgid "" @@ -1587,8 +1644,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." +"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 " "instantiated by applications which need to use custom logger behavior. After " "this call, as at any other time, do not instantiate loggers directly using " @@ -1679,6 +1736,19 @@ msgid "" "reason, ``lastResort`` can be set to ``None``." msgstr "" +msgid "Used to see if exceptions during handling should be propagated." +msgstr "" + +msgid "Default: ``True``." +msgstr "" + +msgid "" +"If :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." +msgstr "" + msgid "Integration with the warnings module" msgstr "" diff --git a/library/lzma.po b/library/lzma.po new file mode 100644 index 0000000000..69c2d24e48 --- /dev/null +++ b/library/lzma.po @@ -0,0 +1,532 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`lzma` --- Compression using the LZMA algorithm" +msgstr "" + +msgid "**Source code:** :source:`Lib/lzma.py`" +msgstr "" + +msgid "" +"This module provides classes and convenience functions for compressing and " +"decompressing data using the LZMA compression algorithm. Also included is a " +"file interface supporting the ``.xz`` and legacy ``.lzma`` file formats used " +"by the :program:`xz` utility, as well as raw compressed streams." +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." +msgstr "" + +msgid "" +"This exception is raised when an error occurs during compression or " +"decompression, or while initializing the compressor/decompressor state." +msgstr "" + +msgid "Reading and writing compressed files" +msgstr "" + +msgid "" +"Open an LZMA-compressed file in binary or text mode, returning a :term:`file " +"object`." +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." +msgstr "" + +msgid "" +"The *mode* argument can be any of ``\"r\"``, ``\"rb\"``, ``\"w\"``, " +"``\"wb\"``, ``\"x\"``, ``\"xb\"``, ``\"a\"`` or ``\"ab\"`` for binary mode, " +"or ``\"rt\"``, ``\"wt\"``, ``\"xt\"``, or ``\"at\"`` for text mode. The " +"default is ``\"rb\"``." +msgstr "" + +msgid "" +"When opening a file for reading, the *format* and *filters* arguments have " +"the same meanings as for :class:`LZMADecompressor`. In this case, the " +"*check* and *preset* arguments should not be used." +msgstr "" + +msgid "" +"When opening a file for writing, the *format*, *check*, *preset* and " +"*filters* arguments have the same meanings as for :class:`LZMACompressor`." +msgstr "" + +msgid "" +"For binary mode, this function is equivalent to the :class:`LZMAFile` " +"constructor: ``LZMAFile(filename, mode, ...)``. In this case, the " +"*encoding*, *errors* and *newline* arguments must not be provided." +msgstr "" + +msgid "" +"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 "" + +msgid "Added support for the ``\"x\"``, ``\"xb\"`` and ``\"xt\"`` modes." +msgstr "" + +msgid "Accepts a :term:`path-like object`." +msgstr "" + +msgid "Open an LZMA-compressed file in binary mode." +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." +msgstr "" + +msgid "" +"The *mode* argument can be either ``\"r\"`` for reading (default), ``\"w\"`` " +"for overwriting, ``\"x\"`` for exclusive creation, or ``\"a\"`` for " +"appending. These can equivalently be given as ``\"rb\"``, ``\"wb\"``, " +"``\"xb\"`` and ``\"ab\"`` respectively." +msgstr "" + +msgid "" +"If *filename* is a file object (rather than an actual file name), a mode of " +"``\"w\"`` does not truncate the file, and is instead equivalent to ``\"a\"``." +msgstr "" + +msgid "" +"When opening a file for reading, the input file may be the concatenation of " +"multiple separate compressed streams. These are transparently decoded as a " +"single logical stream." +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." +msgstr "" + +msgid "The following method is also provided:" +msgstr "" + +msgid "" +"Return buffered data without advancing the file position. At least one byte " +"of data will be returned, unless EOF has been reached. The exact number of " +"bytes returned is unspecified (the *size* argument is ignored)." +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*)." +msgstr "" + +msgid "Added support for the ``\"x\"`` and ``\"xb\"`` modes." +msgstr "" + +msgid "" +"The :meth:`~io.BufferedIOBase.read` method now accepts an argument of " +"``None``." +msgstr "" + +msgid "Compressing and decompressing data in memory" +msgstr "" + +msgid "" +"Create a compressor object, which can be used to compress data incrementally." +msgstr "" + +msgid "" +"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`)." +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." +msgstr "" + +msgid "" +"If the specified check is not supported, an :class:`LZMAError` is raised." +msgstr "" + +msgid "" +"The compression settings can be specified either as a preset compression " +"level (with the *preset* argument), or in detail as a custom filter chain " +"(with the *filters* argument)." +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." +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." +msgstr "" + +msgid "" +"The *filters* argument (if provided) should be a filter chain specifier. " +"See :ref:`filter-chain-specs` for details." +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`." +msgstr "" + +msgid "" +"Finish the compression process, returning a :class:`bytes` object containing " +"any data stored in the compressor's internal buffers." +msgstr "" + +msgid "The compressor cannot be used after this method has been called." +msgstr "" + +msgid "" +"Create a decompressor object, which can be used to decompress data " +"incrementally." +msgstr "" + +msgid "" +"For a more convenient way of decompressing an entire compressed stream at " +"once, see :func:`decompress`." +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`." +msgstr "" + +msgid "" +"The *memlimit* argument specifies a limit (in bytes) on the amount of memory " +"that the decompressor can use. When this argument is used, decompression " +"will fail with an :class:`LZMAError` if it is not possible to decompress the " +"input within the given memory limit." +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." +msgstr "" + +msgid "" +"This class does not transparently handle inputs containing multiple " +"compressed streams, unlike :func:`decompress` and :class:`LZMAFile`. To " +"decompress a multi-stream input with :class:`LZMADecompressor`, you must " +"create a new decompressor for each stream." +msgstr "" + +msgid "" +"Decompress *data* (a :term:`bytes-like object`), returning uncompressed data " +"as bytes. Some of *data* may be buffered internally, for use in later calls " +"to :meth:`decompress`. The returned data should be concatenated with the " +"output of any previous calls to :meth:`decompress`." +msgstr "" + +msgid "" +"If *max_length* is nonnegative, returns at most *max_length* bytes of " +"decompressed data. If this limit is reached and further output can be " +"produced, the :attr:`~.needs_input` attribute will be set to ``False``. In " +"this case, the next call to :meth:`~.decompress` may provide *data* as " +"``b''`` to obtain more of the output." +msgstr "" + +msgid "" +"If all of the input data was decompressed and returned (either because this " +"was less than *max_length* bytes, or because *max_length* was negative), " +"the :attr:`~.needs_input` attribute will be set to ``True``." +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." +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." +msgstr "" + +msgid "``True`` if the end-of-stream marker has been reached." +msgstr "" + +msgid "Data found after the end of the compressed stream." +msgstr "" + +msgid "Before the end of the stream is reached, this will be ``b\"\"``." +msgstr "" + +msgid "" +"``False`` if the :meth:`.decompress` method can provide more decompressed " +"data before requiring new uncompressed input." +msgstr "" + +msgid "" +"Compress *data* (a :class:`bytes` object), returning the compressed data as " +"a :class:`bytes` object." +msgstr "" + +msgid "" +"See :class:`LZMACompressor` above for a description of the *format*, " +"*check*, *preset* and *filters* arguments." +msgstr "" + +msgid "" +"Decompress *data* (a :class:`bytes` object), returning the uncompressed data " +"as a :class:`bytes` object." +msgstr "" + +msgid "" +"If *data* is the concatenation of multiple distinct compressed streams, " +"decompress all of these streams, and return the concatenation of the results." +msgstr "" + +msgid "" +"See :class:`LZMADecompressor` above for a description of the *format*, " +"*memlimit* and *filters* arguments." +msgstr "" + +msgid "Miscellaneous" +msgstr "" + +msgid "" +"Return ``True`` if the given integrity check is supported on this system." +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." +msgstr "" + +msgid "Specifying custom filter chains" +msgstr "" + +msgid "" +"A filter chain specifier is a sequence of dictionaries, where each " +"dictionary contains the ID and options for a single filter. Each dictionary " +"must contain the key ``\"id\"``, and may contain additional keys to specify " +"filter-dependent options. Valid filter IDs are as follows:" +msgstr "" + +msgid "Compression filters:" +msgstr "" + +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`)" +msgstr "" + +msgid "Delta filter:" +msgstr "" + +msgid ":const:`FILTER_DELTA`" +msgstr ":const:`FILTER_DELTA`" + +msgid "Branch-Call-Jump (BCJ) filters:" +msgstr "" + +msgid ":const:`FILTER_X86`" +msgstr ":const:`FILTER_X86`" + +msgid ":const:`FILTER_IA64`" +msgstr ":const:`FILTER_IA64`" + +msgid ":const:`FILTER_ARM`" +msgstr ":const:`FILTER_ARM`" + +msgid ":const:`FILTER_ARMTHUMB`" +msgstr ":const:`FILTER_ARMTHUMB`" + +msgid ":const:`FILTER_POWERPC`" +msgstr ":const:`FILTER_POWERPC`" + +msgid ":const:`FILTER_SPARC`" +msgstr ":const:`FILTER_SPARC`" + +msgid "" +"A filter chain can consist of up to 4 filters, and cannot be empty. The last " +"filter in the chain must be a compression filter, and any other filters must " +"be delta or BCJ filters." +msgstr "" + +msgid "" +"Compression filters support the following options (specified as additional " +"entries in the dictionary representing the filter):" +msgstr "" + +msgid "" +"``preset``: A compression preset to use as a source of default values for " +"options that are not specified explicitly." +msgstr "" + +msgid "" +"``dict_size``: Dictionary size in bytes. This should be between 4 KiB and " +"1.5 GiB (inclusive)." +msgstr "" + +msgid "``lc``: Number of literal context bits." +msgstr "" + +msgid "" +"``lp``: Number of literal position bits. The sum ``lc + lp`` must be at most " +"4." +msgstr "" + +msgid "``pb``: Number of position bits; must be at most 4." +msgstr "" + +msgid "``mode``: :const:`MODE_FAST` or :const:`MODE_NORMAL`." +msgstr "" + +msgid "" +"``nice_len``: What should be considered a \"nice length\" for a match. This " +"should be 273 or less." +msgstr "" + +msgid "" +"``mf``: What match finder to use -- :const:`MF_HC3`, :const:`MF_HC4`, :const:" +"`MF_BT2`, :const:`MF_BT3`, or :const:`MF_BT4`." +msgstr "" + +msgid "" +"``depth``: Maximum search depth used by match finder. 0 (default) means to " +"select automatically based on other filter options." +msgstr "" + +msgid "" +"The delta filter stores the differences between bytes, producing more " +"repetitive input for the compressor in certain circumstances. It supports " +"one option, ``dist``. This indicates the distance between bytes to be " +"subtracted. The default is 1, i.e. take the differences between adjacent " +"bytes." +msgstr "" + +msgid "" +"The BCJ filters are intended to be applied to machine code. They convert " +"relative branches, calls and jumps in the code to use absolute addressing, " +"with the aim of increasing the redundancy that can be exploited by the " +"compressor. These filters support one option, ``start_offset``. This " +"specifies the address that should be mapped to the beginning of the input " +"data. The default is 0." +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid "Reading in a compressed file::" +msgstr "" + +msgid "Creating a compressed file::" +msgstr "" + +msgid "Compressing data in memory::" +msgstr "" + +msgid "Incremental compression::" +msgstr "" + +msgid "Writing compressed data to an already-open file::" +msgstr "" + +msgid "Creating a compressed file using a custom filter chain::" +msgstr "" diff --git a/library/mailbox.po b/library/mailbox.po index 13ab15150d..6b6ed458cf 100644 --- a/library/mailbox.po +++ b/library/mailbox.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 @@ msgstr "" 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." +"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 "" @@ -45,65 +44,66 @@ msgstr "" msgid "Represent and manipulate messages." msgstr "" -msgid ":class:`Mailbox` objects" +msgid ":class:`!Mailbox` objects" msgstr "" msgid "A mailbox, which may be inspected and modified." msgstr "" msgid "" -"The :class:`Mailbox` class defines an interface and is not intended to be " +"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." +"class:`!Mailbox` and your code should instantiate a particular subclass." msgstr "" msgid "" -"The :class:`Mailbox` interface is dictionary-like, with small keys " -"corresponding to messages. Keys are issued by the :class:`Mailbox` instance " -"with which they will be used and are only meaningful to that :class:" -"`Mailbox` instance. A key continues to identify a message even if the " +"The :class:`!Mailbox` interface is dictionary-like, with small keys " +"corresponding to messages. Keys are issued by the :class:`!Mailbox` instance " +"with which they will be used and are only meaningful to that :class:`!" +"Mailbox` instance. A key continues to identify a message even if the " "corresponding message is modified, such as by replacing it with another " "message." msgstr "" msgid "" -"Messages may be added to a :class:`Mailbox` instance using the set-like " +"Messages may be added to a :class:`!Mailbox` instance using the set-like " "method :meth:`add` and removed using a ``del`` statement or the set-like " "methods :meth:`remove` and :meth:`discard`." msgstr "" msgid "" -":class:`Mailbox` interface semantics differ from dictionary semantics in " +":class:`!Mailbox` interface semantics differ from dictionary semantics in " "some noteworthy ways. Each time a message is requested, a new representation " "(typically a :class:`Message` instance) is generated based upon the current " -"state of the mailbox. Similarly, when a message is added to a :class:" -"`Mailbox` instance, the provided message representation's contents are " +"state of the mailbox. Similarly, when a message is added to a :class:`!" +"Mailbox` instance, the provided message representation's contents are " "copied. In neither case is a reference to the message representation kept by " -"the :class:`Mailbox` instance." +"the :class:`!Mailbox` instance." msgstr "" msgid "" -"The default :class:`Mailbox` iterator iterates over message representations, " -"not keys as the default dictionary iterator does. Moreover, modification of " -"a mailbox during iteration is safe and well-defined. Messages added to the " -"mailbox after an iterator is created will not be seen by the iterator. " -"Messages removed from the mailbox before the iterator yields them will be " -"silently skipped, though using a key from an iterator may result in a :exc:" -"`KeyError` exception if the corresponding message is subsequently removed." +"The default :class:`!Mailbox` :term:`iterator` iterates over message " +"representations, not keys as the default :class:`dictionary ` iterator " +"does. Moreover, modification of a mailbox during iteration is safe and well-" +"defined. Messages added to the mailbox after an iterator is created will not " +"be seen by the iterator. Messages removed from the mailbox before the " +"iterator yields them will be silently skipped, though using a key from an " +"iterator may result in a :exc:`KeyError` exception if the corresponding " +"message is subsequently removed." 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 Maildir; try to avoid using single-file formats such as 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 messages or corrupting " -"the entire mailbox." +"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 " +"messages or corrupting the entire mailbox." msgstr "" -msgid ":class:`Mailbox` instances have the following methods:" +msgid ":class:`!Mailbox` instances have the following methods:" msgstr "" msgid "" @@ -150,18 +150,19 @@ msgid "" "left unchanged." msgstr "" +msgid "Return an :term:`iterator` over all keys" +msgstr "" + msgid "" -"Return an iterator over all keys if called as :meth:`iterkeys` or return a " -"list of keys if called as :meth:`keys`." +"The same as :meth:`iterkeys`, except that a :class:`list` is returned rather " +"than an :term:`iterator`" msgstr "" msgid "" -"Return an iterator over representations of all messages if called as :meth:" -"`itervalues` or :meth:`__iter__` or return a list of such representations if " -"called as :meth:`values`. 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." +"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." msgstr "" msgid "" @@ -170,21 +171,30 @@ msgid "" msgstr "" msgid "" -"Return an iterator over (*key*, *message*) pairs, where *key* is a key and " -"*message* is a message representation, if called as :meth:`iteritems` or " -"return a list of such pairs if called as :meth:`items`. 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." +"The same as :meth:`itervalues`, except that a :class:`list` is returned " +"rather than an :term:`iterator`" +msgstr "" + +msgid "" +"Return an :term:`iterator` over (*key*, *message*) pairs, where *key* is a " +"key and *message* is a message representation. 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." +msgstr "" + +msgid "" +"The same as :meth:`iteritems`, except that a :class:`list` of pairs is " +"returned rather than an :term:`iterator` of pairs." 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 " +"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 " +"message factory was specified when the :class:`!Mailbox` instance was " "initialized." msgstr "" @@ -207,24 +217,24 @@ msgid "" msgstr "" msgid "" -"Return a file-like representation of the message corresponding to *key*, or " -"raise a :exc:`KeyError` exception if no such message exists. The file-like " -"object behaves as if open in binary mode. This file should be closed once " -"it is no longer needed." +"Return a :term:`file-like ` representation of the message " +"corresponding to *key*, or raise a :exc:`KeyError` exception if no such " +"message exists. The file-like object behaves as if open in binary mode. " +"This file should be closed once it is no longer needed." msgstr "" msgid "" -"The file object really is a binary file; previously it was incorrectly " -"returned in text mode. Also, the file-like object now supports the context " -"management protocol: you can use a :keyword:`with` statement to " -"automatically close it." +"The file object really is a :term:`binary file`; previously it was " +"incorrectly returned in text mode. Also, the :term:`file-like object` now " +"supports the :term:`context manager` protocol: you can use a :keyword:`with` " +"statement to automatically close it." msgstr "" msgid "" -"Unlike other representations of messages, file-like representations are not " -"necessarily independent of the :class:`Mailbox` instance that created them " -"or of the underlying mailbox. More specific documentation is provided by " -"each subclass." +"Unlike other representations of messages, :term:`file-like ` representations are not necessarily independent of the :class:`!" +"Mailbox` instance that created them or of the underlying mailbox. More " +"specific documentation is provided by each subclass." msgstr "" msgid "Return ``True`` if *key* corresponds to a message, ``False`` otherwise." @@ -241,7 +251,7 @@ msgid "" "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." +"class:`!Mailbox` instance was initialized." msgstr "" msgid "" @@ -250,7 +260,7 @@ msgid "" "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." +"class:`!Mailbox` instance was initialized." msgstr "" msgid "" @@ -260,7 +270,7 @@ msgid "" "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." +"class:`!Mailbox` instance." msgstr "" msgid "Unlike with dictionaries, keyword arguments are not supported." @@ -268,7 +278,7 @@ msgstr "" msgid "" "Write any pending changes to the filesystem. For some :class:`Mailbox` " -"subclasses, changes are always written immediately and :meth:`flush` does " +"subclasses, changes are always written immediately and :meth:`!flush` does " "nothing, but you should still make a habit of calling this method." msgstr "" @@ -285,10 +295,10 @@ msgstr "" msgid "" "Flush the mailbox, unlock it if necessary, and close any open files. For " -"some :class:`Mailbox` subclasses, this method does nothing." +"some :class:`!Mailbox` subclasses, this method does nothing." msgstr "" -msgid ":class:`Maildir`" +msgid ":class:`!Maildir` objects" msgstr "" msgid "" @@ -332,9 +342,10 @@ 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 Maildir " -"mailbox but should not contain other folders. Instead, a logical nesting is " -"indicated using ``'.'`` to delimit levels, e.g., \"Archived.2005.07\"." +"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\"." msgstr "" msgid "" @@ -345,11 +356,11 @@ msgid "" "exclamation point (``'!'``) is a popular choice. For example::" msgstr "" -msgid "The :attr:`colon` attribute may also be set on a per-instance basis." +msgid "The :attr:`!colon` attribute may also be set on a per-instance basis." msgstr "" msgid "" -":class:`Maildir` instances have all of the methods of :class:`Mailbox` in " +":class:`!Maildir` instances have all of the methods of :class:`Mailbox` in " "addition to the following:" msgstr "" @@ -357,13 +368,13 @@ msgid "Return a list of the names of all folders." msgstr "" msgid "" -"Return a :class:`Maildir` instance representing the folder whose name is " +"Return a :class:`!Maildir` instance representing the folder whose name is " "*folder*. A :exc:`NoSuchMailboxError` exception is raised if the folder does " "not exist." msgstr "" msgid "" -"Create a folder whose name is *folder* and return a :class:`Maildir` " +"Create a folder whose name is *folder* and return a :class:`!Maildir` " "instance representing it." msgstr "" @@ -380,7 +391,7 @@ msgid "" msgstr "" msgid "" -"Some :class:`Mailbox` methods implemented by :class:`Maildir` deserve " +"Some :class:`Mailbox` methods implemented by :class:`!Maildir` deserve " "special remarks:" msgstr "" @@ -402,7 +413,7 @@ msgid "" msgstr "" msgid "" -":class:`Maildir` instances do not keep any open files and the underlying " +":class:`!Maildir` instances do not keep any open files and the underlying " "mailboxes do not support locking, so this method does nothing." msgstr "" @@ -428,7 +439,7 @@ msgid "" "and details on \"info\" semantics." msgstr "" -msgid ":class:`mbox`" +msgid ":class:`!mbox` objects" msgstr "" msgid "" @@ -449,9 +460,9 @@ 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 " +"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 " "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 \" " @@ -459,18 +470,19 @@ msgid "" msgstr "" msgid "" -"Some :class:`Mailbox` methods implemented by :class:`mbox` deserve special " +"Some :class:`Mailbox` methods implemented by :class:`!mbox` deserve special " "remarks:" msgstr "" msgid "" -"Using the file after calling :meth:`flush` or :meth:`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." +"func:`!flock` and :c:func:`!lockf` system calls." msgstr "" msgid "" @@ -497,7 +509,7 @@ msgstr "" msgid "A history of mbox variations." msgstr "" -msgid ":class:`MH`" +msgid ":class:`!MH` objects" msgstr "" msgid "" @@ -520,25 +532,25 @@ msgid "" msgstr "" msgid "" -"The :class:`MH` class manipulates MH mailboxes, but it does not attempt to " +"The :class:`!MH` class manipulates MH mailboxes, but it does not attempt to " "emulate all of :program:`mh`'s behaviors. In particular, it does not modify " "and is not affected by the :file:`context` or :file:`.mh_profile` files that " "are used by :program:`mh` to store its state and configuration." msgstr "" msgid "" -":class:`MH` instances have all of the methods of :class:`Mailbox` in " +":class:`!MH` instances have all of the methods of :class:`Mailbox` in " "addition to the following:" msgstr "" msgid "" -"Return an :class:`MH` instance representing the folder whose name is " +"Return an :class:`!MH` instance representing the folder whose name is " "*folder*. A :exc:`NoSuchMailboxError` exception is raised if the folder does " "not exist." msgstr "" msgid "" -"Create a folder whose name is *folder* and return an :class:`MH` instance " +"Create a folder whose name is *folder* and return an :class:`!MH` instance " "representing it." msgstr "" @@ -564,7 +576,7 @@ msgid "" msgstr "" msgid "" -"Some :class:`Mailbox` methods implemented by :class:`MH` deserve special " +"Some :class:`Mailbox` methods implemented by :class:`!MH` deserve special " "remarks:" msgstr "" @@ -575,8 +587,8 @@ 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 " +"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 "" @@ -592,7 +604,7 @@ msgid "" msgstr "" msgid "" -":class:`MH` instances do not keep any open files, so this method is " +":class:`!MH` instances do not keep any open files, so this method is " "equivalent to :meth:`unlock`." msgstr "" @@ -614,7 +626,7 @@ msgid "" "information on the mailbox format." msgstr "" -msgid ":class:`Babyl`" +msgid ":class:`!Babyl` objects" msgstr "" msgid "" @@ -646,7 +658,7 @@ msgid "" msgstr "" msgid "" -":class:`Babyl` instances have all of the methods of :class:`Mailbox` in " +":class:`!Babyl` instances have all of the methods of :class:`Mailbox` in " "addition to the following:" msgstr "" @@ -661,7 +673,7 @@ msgid "" msgstr "" msgid "" -"Some :class:`Mailbox` methods implemented by :class:`Babyl` deserve special " +"Some :class:`Mailbox` methods implemented by :class:`!Babyl` deserve special " "remarks:" msgstr "" @@ -689,7 +701,7 @@ msgstr "" msgid "The Rmail manual, with some information on Babyl semantics." msgstr "" -msgid ":class:`MMDF`" +msgid ":class:`!MMDF` objects" msgstr "" msgid "" @@ -714,13 +726,14 @@ msgid "" msgstr "" msgid "" -"Some :class:`Mailbox` methods implemented by :class:`MMDF` deserve special " +"Some :class:`Mailbox` methods implemented by :class:`!MMDF` deserve special " "remarks:" msgstr "" msgid "" -"Using the file after calling :meth:`flush` or :meth:`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 "" @@ -740,20 +753,20 @@ msgid "" "Facility." msgstr "" -msgid ":class:`Message` objects" +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." +"Message`. Subclasses of :class:`!mailbox.Message` add mailbox-format-" +"specific state and behavior." msgstr "" msgid "" "If *message* is omitted, the new instance is created in a default, empty " "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. " +"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:`2822`\\ -compliant message, which is read and parsed. Files should be " "open in binary mode, but text mode files are accepted for backward " @@ -772,15 +785,16 @@ msgid "" msgstr "" msgid "" -"There is no requirement that :class:`Message` instances be used to represent " -"messages retrieved using :class:`Mailbox` instances. In some situations, the " -"time and memory required to generate :class:`Message` representations might " -"not be acceptable. For such situations, :class:`Mailbox` instances also " -"offer string and file-like representations, and a custom message factory may " -"be specified when a :class:`Mailbox` instance is initialized." +"There is no requirement that :class:`!Message` instances be used to " +"represent messages retrieved using :class:`Mailbox` instances. In some " +"situations, the time and memory required to generate :class:`!Message` " +"representations might not be acceptable. For such situations, :class:`!" +"Mailbox` instances also offer string and file-like representations, and a " +"custom message factory may be specified when a :class:`!Mailbox` instance is " +"initialized." msgstr "" -msgid ":class:`MaildirMessage`" +msgid ":class:`!MaildirMessage` objects" msgstr "" msgid "" @@ -811,7 +825,7 @@ msgid "Explanation" msgstr "Wytłumaczenie" msgid "D" -msgstr "" +msgstr "D" msgid "Draft" msgstr "" @@ -820,7 +834,7 @@ msgid "Under composition" msgstr "" msgid "F" -msgstr "" +msgstr "F" msgid "Flagged" msgstr "" @@ -856,7 +870,7 @@ msgid "Read" msgstr "" msgid "T" -msgstr "" +msgstr "T" msgid "Trashed" msgstr "" @@ -864,7 +878,7 @@ msgstr "" msgid "Marked for subsequent deletion" msgstr "" -msgid ":class:`MaildirMessage` instances offer the following methods:" +msgid ":class:`!MaildirMessage` instances offer the following methods:" msgstr "" msgid "" @@ -929,7 +943,7 @@ msgid "Set \"info\" to *info*, which should be a string." msgstr "" msgid "" -"When a :class:`MaildirMessage` instance is created based upon an :class:" +"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:" @@ -966,7 +980,7 @@ msgid "D flag" msgstr "" msgid "" -"When a :class:`MaildirMessage` instance is created based upon an :class:" +"When a :class:`!MaildirMessage` instance is created based upon an :class:" "`MHMessage` instance, the following conversions take place:" msgstr "" @@ -989,7 +1003,7 @@ msgid "\"replied\" sequence" msgstr "" msgid "" -"When a :class:`MaildirMessage` instance is created based upon a :class:" +"When a :class:`!MaildirMessage` instance is created based upon a :class:" "`BabylMessage` instance, the following conversions take place:" msgstr "" @@ -1014,7 +1028,7 @@ msgstr "" msgid "\"deleted\" label" msgstr "" -msgid ":class:`mboxMessage`" +msgid ":class:`!mboxMessage` objects" msgstr "" msgid "" @@ -1036,7 +1050,7 @@ msgid "Conventional flags for mbox messages are as follows:" msgstr "" msgid "O" -msgstr "" +msgstr "O" msgid "Old" msgstr "" @@ -1059,7 +1073,7 @@ msgid "" "header. The flags and headers typically appear in the order mentioned." msgstr "" -msgid ":class:`mboxMessage` instances offer the following methods:" +msgid ":class:`!mboxMessage` instances offer the following methods:" msgstr "" msgid "" @@ -1073,8 +1087,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 :meth:`time.strftime`, or ``True`` (to use :" -"meth:`time.gmtime`)." +"tuple suitable for passing to :func:`time.strftime`, or ``True`` (to use :" +"func:`time.gmtime`)." msgstr "" msgid "" @@ -1103,7 +1117,7 @@ msgid "" msgstr "" msgid "" -"When an :class:`mboxMessage` instance is created based upon a :class:" +"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:" @@ -1113,7 +1127,7 @@ msgid ":class:`MaildirMessage` state" msgstr "" msgid "" -"When an :class:`mboxMessage` instance is created based upon an :class:" +"When an :class:`!mboxMessage` instance is created based upon an :class:" "`MHMessage` instance, the following conversions take place:" msgstr "" @@ -1121,12 +1135,12 @@ msgid "R flag and O flag" msgstr "" msgid "" -"When an :class:`mboxMessage` instance is created based upon a :class:" +"When an :class:`!mboxMessage` instance is created based upon a :class:" "`BabylMessage` instance, the following conversions take place:" msgstr "" msgid "" -"When a :class:`Message` instance is created based upon an :class:" +"When a :class:`!mboxMessage` instance is created based upon an :class:" "`MMDFMessage` instance, the \"From \" line is copied and all flags directly " "correspond:" msgstr "" @@ -1134,7 +1148,7 @@ msgstr "" msgid ":class:`MMDFMessage` state" msgstr "" -msgid ":class:`MHMessage`" +msgid ":class:`!MHMessage` objects" msgstr "" msgid "" @@ -1165,7 +1179,7 @@ msgstr "" msgid "flagged" msgstr "" -msgid ":class:`MHMessage` instances offer the following methods:" +msgid ":class:`!MHMessage` instances offer the following methods:" msgstr "" msgid "Return a list of the names of sequences that include this message." @@ -1181,7 +1195,7 @@ 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:" +"When an :class:`!MHMessage` instance is created based upon a :class:" "`MaildirMessage` instance, the following conversions take place:" msgstr "" @@ -1189,7 +1203,7 @@ msgid "no S flag" msgstr "" msgid "" -"When an :class:`MHMessage` instance is created based upon an :class:" +"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:" @@ -1199,11 +1213,11 @@ msgid "no R flag" msgstr "" msgid "" -"When an :class:`MHMessage` instance is created based upon a :class:" +"When an :class:`!MHMessage` instance is created based upon a :class:" "`BabylMessage` instance, the following conversions take place:" msgstr "" -msgid ":class:`BabylMessage`" +msgid ":class:`!BabylMessage` objects" msgstr "" msgid "" @@ -1250,12 +1264,12 @@ msgid "Resent" msgstr "" msgid "" -"By default, Rmail displays only visible headers. The :class:`BabylMessage` " +"By default, Rmail displays only visible headers. The :class:`!BabylMessage` " "class, though, uses the original headers because they are more complete. " "Visible headers may be accessed explicitly if desired." msgstr "" -msgid ":class:`BabylMessage` instances offer the following methods:" +msgid ":class:`!BabylMessage` instances offer the following methods:" msgstr "" msgid "Return a list of labels on the message." @@ -1283,7 +1297,7 @@ msgid "" msgstr "" msgid "" -"When a :class:`BabylMessage` instance's original headers are modified, the " +"When a :class:`!BabylMessage` instance's original headers are modified, the " "visible headers are not automatically modified to correspond. This method " "updates the visible headers as follows: each visible header with a " "corresponding original header is set to the value of the original header, " @@ -1295,7 +1309,7 @@ msgid "" msgstr "" msgid "" -"When a :class:`BabylMessage` instance is created based upon a :class:" +"When a :class:`!BabylMessage` instance is created based upon a :class:" "`MaildirMessage` instance, the following conversions take place:" msgstr "" @@ -1303,18 +1317,18 @@ msgid "\"forwarded\" label" msgstr "" msgid "" -"When a :class:`BabylMessage` instance is created based upon an :class:" +"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:" +"When a :class:`!BabylMessage` instance is created based upon an :class:" "`MHMessage` instance, the following conversions take place:" msgstr "" -msgid ":class:`MMDFMessage`" +msgid ":class:`!MMDFMessage` objects" msgstr "" msgid "" @@ -1335,29 +1349,29 @@ msgid "" msgstr "" msgid "" -":class:`MMDFMessage` instances offer the following methods, which are " +":class:`!MMDFMessage` instances offer the following methods, which are " "identical to those offered by :class:`mboxMessage`:" msgstr "" msgid "" -"When an :class:`MMDFMessage` instance is created based upon a :class:" +"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:" +"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:" +"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:" +"When an :class:`!MMDFMessage` instance is created based upon an :class:" "`mboxMessage` instance, the \"From \" line is copied and all flags directly " "correspond:" msgstr "" @@ -1369,7 +1383,7 @@ msgid "Exceptions" msgstr "Wyjątki" msgid "" -"The following exception classes are defined in the :mod:`mailbox` module:" +"The following exception classes are defined in the :mod:`!mailbox` module:" msgstr "" msgid "The based class for all other module-specific exceptions." diff --git a/library/marshal.po b/library/marshal.po index 71f8fbb51e..db79535639 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 +# Waldemar Stoczkowski, 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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" @@ -178,7 +179,7 @@ msgid "shelve" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "code" msgstr "" diff --git a/library/math.po b/library/math.po index 27483250d5..a1af21b6fd 100644 --- a/library/math.po +++ b/library/math.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Michał Biliński , 2021 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -250,7 +249,7 @@ msgid "If *x* is equal to *y*, return *y*." msgstr "" msgid "Examples:" -msgstr "" +msgstr "Przykłady:" msgid "``math.nextafter(x, math.inf)`` goes up: towards positive infinity." msgstr "" @@ -564,7 +563,7 @@ msgstr "" msgid "" "The :func:`erf` function can be used to compute traditional statistical " "functions such as the `cumulative standard normal distribution `_::" +"wikipedia.org/wiki/Cumulative_distribution_function>`_::" msgstr "" msgid "" diff --git a/library/mimetypes.po b/library/mimetypes.po new file mode 100644 index 0000000000..fc3bd0e4cb --- /dev/null +++ b/library/mimetypes.po @@ -0,0 +1,289 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 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:`mimetypes` --- Map filenames to MIME types" +msgstr "" + +msgid "**Source code:** :source:`Lib/mimetypes.py`" +msgstr "" + +msgid "" +"The :mod:`mimetypes` module converts between a filename or URL and the MIME " +"type associated with the filename extension. Conversions are provided from " +"filename to MIME type and from MIME type to filename extension; encodings " +"are not supported for the latter conversion." +msgstr "" + +msgid "" +"The module provides one class and a number of convenience functions. The " +"functions are the normal interface to this module, but some applications may " +"be interested in the class as well." +msgstr "" + +msgid "" +"The functions described below provide the primary interface for this " +"module. If the module has not been initialized, they will call :func:`init` " +"if they rely on the information :func:`init` sets up." +msgstr "" + +msgid "" +"Guess the type of a file based on its filename, path or URL, given by *url*. " +"URL can be a string or a :term:`path-like object`." +msgstr "" + +msgid "" +"The return value is a tuple ``(type, encoding)`` where *type* is ``None`` if " +"the type can't be guessed (missing or unknown suffix) or a string of the " +"form ``'type/subtype'``, usable for a MIME :mailheader:`content-type` header." +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 " +"driven. Encoding suffixes are case sensitive; type suffixes are first tried " +"case sensitively, then case insensitively." +msgstr "" + +msgid "" +"The optional *strict* argument is a flag specifying whether the list of " +"known MIME types is limited to only the official types `registered with IANA " +"`_. When " +"*strict* is ``True`` (the default), only the IANA types are supported; when " +"*strict* is ``False``, some additional non-standard but commonly used MIME " +"types are also recognized." +msgstr "" + +msgid "Added support for url being a :term:`path-like object`." +msgstr "" + +msgid "" +"Guess the extensions for a file based on its MIME type, given by *type*. The " +"return value is a list of strings giving all possible filename extensions, " +"including the leading dot (``'.'``). The extensions are not guaranteed to " +"have been associated with any particular data stream, but would be mapped to " +"the MIME type *type* by :func:`guess_type`." +msgstr "" + +msgid "" +"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`. If no extension can be guessed for *type*, ``None`` is " +"returned." +msgstr "" + +msgid "" +"Some additional functions and data items are available for controlling the " +"behavior of the module." +msgstr "" + +msgid "" +"Initialize the internal data structures. If given, *files* must be a " +"sequence of file names which should be used to augment the default type " +"map. If omitted, the file names to use are taken from :const:`knownfiles`; " +"on Windows, the current registry settings are loaded. Each file named in " +"*files* or :const:`knownfiles` takes precedence over those named before it. " +"Calling :func:`init` repeatedly is allowed." +msgstr "" + +msgid "" +"Specifying an empty list for *files* will prevent the system defaults from " +"being applied: only the well-known values will be present from a built-in " +"list." +msgstr "" + +msgid "" +"If *files* is ``None`` the internal data structure is completely rebuilt to " +"its initial default value. This is a stable operation and will produce the " +"same results when called multiple times." +msgstr "" + +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." +msgstr "" + +msgid "" +"Add a mapping from the MIME type *type* to the extension *ext*. When the " +"extension is already known, the new type will replace the old one. When the " +"type is already known the extension will be added to the list of known " +"extensions." +msgstr "" + +msgid "" +"When *strict* is ``True`` (the default), the mapping will be added to the " +"official MIME types, otherwise to the non-standard ones." +msgstr "" + +msgid "" +"Flag indicating whether or not the global data structures have been " +"initialized. This is set to ``True`` by :func:`init`." +msgstr "" + +msgid "" +"List of type map file names commonly installed. These files are typically " +"named :file:`mime.types` and are installed in different locations by " +"different packages." +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." +msgstr "" + +msgid "Dictionary mapping filename extensions to encoding types." +msgstr "" + +msgid "Dictionary mapping filename extensions to MIME types." +msgstr "" + +msgid "" +"Dictionary mapping filename extensions to non-standard, but commonly found " +"MIME types." +msgstr "" + +msgid "An example usage of the module::" +msgstr "" + +msgid "MimeTypes Objects" +msgstr "" + +msgid "" +"The :class:`MimeTypes` class may be useful for applications which may want " +"more than one MIME-type database; it provides an interface similar to the " +"one of the :mod:`mimetypes` module." +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." +msgstr "" + +msgid "" +"The optional *filenames* parameter can be used to cause additional files to " +"be loaded \"on top\" of the default database." +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." +msgstr "" + +msgid "" +"Dictionary mapping filename extensions to encoding types. This is initially " +"a copy of the global :data:`encodings_map` defined in the module." +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`." +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`." +msgstr "" + +msgid "" +"Similar to the :func:`guess_extension` function, using the tables stored as " +"part of the object." +msgstr "" + +msgid "" +"Similar to the :func:`guess_type` function, using the tables stored as part " +"of the object." +msgstr "" + +msgid "" +"Similar to the :func:`guess_all_extensions` function, using the tables " +"stored as part of the object." +msgstr "" + +msgid "" +"Load MIME information from a file named *filename*. This uses :meth:" +"`readfp` to parse the file." +msgstr "" + +msgid "" +"If *strict* is ``True``, information will be added to list of standard " +"types, else to the list of non-standard types." +msgstr "" + +msgid "" +"Load MIME type information from an open file *fp*. The file must have the " +"format of the standard :file:`mime.types` files." +msgstr "" + +msgid "" +"If *strict* is ``True``, information will be added to the list of standard " +"types, else to the list of non-standard types." +msgstr "" + +msgid "Load MIME type information from the Windows registry." +msgstr "" + +msgid ":ref:`Availability `: Windows." +msgstr "" + +msgid "MIME" +msgstr "" + +msgid "content type" +msgstr "" + +msgid "headers" +msgstr "" + +msgid "file" +msgstr "plik" + +msgid "mime.types" +msgstr "" diff --git a/library/msilib.po b/library/msilib.po index 46830538b8..bb903d1b94 100644 --- a/library/msilib.po +++ b/library/msilib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/multiprocessing.po b/library/multiprocessing.po new file mode 100644 index 0000000000..891012116d --- /dev/null +++ b/library/multiprocessing.po @@ -0,0 +1,2765 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`multiprocessing` --- Process-based parallelism" +msgstr "" + +msgid "**Source code:** :source:`Lib/multiprocessing/`" +msgstr "" + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + +msgid "Introduction" +msgstr "Wprowadzenie" + +msgid "" +":mod:`multiprocessing` is a package that supports spawning processes using " +"an API similar to the :mod:`threading` module. The :mod:`multiprocessing` " +"package offers both local and remote concurrency, effectively side-stepping " +"the :term:`Global Interpreter Lock ` by using " +"subprocesses instead of threads. Due to this, the :mod:`multiprocessing` " +"module allows the programmer to fully leverage multiple processors on a " +"given machine. It runs on both Unix and Windows." +msgstr "" + +msgid "" +"The :mod:`multiprocessing` module also introduces APIs which do not have " +"analogs in the :mod:`threading` module. A prime example of this is 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`, ::" +msgstr "" + +msgid "will print to standard output ::" +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." +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 ::" +msgstr "" + +msgid "" +"To show the individual process IDs involved, here is an expanded example::" +msgstr "" + +msgid "" +"For an explanation of why the ``if __name__ == '__main__'`` part is " +"necessary, see :ref:`multiprocessing-programming`." +msgstr "" + +msgid "Contexts and start methods" +msgstr "" + +msgid "" +"Depending on the platform, :mod:`multiprocessing` supports three ways to " +"start a process. These *start methods* are" +msgstr "" + +msgid "*spawn*" +msgstr "" + +msgid "" +"The parent process starts a fresh Python interpreter process. The child " +"process will only inherit those resources necessary to run the process " +"object's :meth:`~Process.run` method. In particular, unnecessary file " +"descriptors and handles from the parent process will not be inherited. " +"Starting a process using this method is rather slow compared to using *fork* " +"or *forkserver*." +msgstr "" + +msgid "Available on Unix and Windows. The default on Windows and macOS." +msgstr "" + +msgid "*fork*" +msgstr "" + +msgid "" +"The parent process uses :func:`os.fork` to fork the Python interpreter. The " +"child process, when it begins, is effectively identical to the parent " +"process. All resources of the parent are inherited by the child process. " +"Note that safely forking a multithreaded process is problematic." +msgstr "" + +msgid "Available on Unix only. The default on Unix." +msgstr "" + +msgid "*forkserver*" +msgstr "" + +msgid "" +"When the program starts and selects the *forkserver* start method, a server " +"process is started. From then on, whenever a new process is needed, the " +"parent process connects to the server and requests that it fork a new " +"process. The fork server process is single threaded so it is safe for it to " +"use :func:`os.fork`. No unnecessary resources are inherited." +msgstr "" + +msgid "" +"Available on Unix platforms which support passing file descriptors over Unix " +"pipes." +msgstr "" + +msgid "" +"*spawn* added on all Unix platforms, and *forkserver* added for some Unix " +"platforms. Child processes no longer inherit all of the parents inheritable " +"handles on Windows." +msgstr "" + +msgid "" +"On macOS, the *spawn* start method is now the default. The *fork* start " +"method should be considered unsafe as it can lead to crashes of the " +"subprocess as macOS system libraries may start threads. See :issue:`33725`." +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.)" +msgstr "" + +msgid "" +"To select a start method you use the :func:`set_start_method` in the ``if " +"__name__ == '__main__'`` clause of the main module. For example::" +msgstr "" + +msgid "" +":func:`set_start_method` should not be used more than once in the program." +msgstr "" + +msgid "" +"Alternatively, you can use :func:`get_context` to obtain a context object. " +"Context objects have the same API as the multiprocessing module, and allow " +"one to use multiple start methods in the same program. ::" +msgstr "" + +msgid "" +"Note that objects related to one context may not be compatible with " +"processes for a different context. In particular, locks created using the " +"*fork* context cannot be passed to processes started using the *spawn* or " +"*forkserver* start methods." +msgstr "" + +msgid "" +"A library which wants to use a particular start method should probably use :" +"func:`get_context` to avoid interfering with the choice of the library user." +msgstr "" + +msgid "" +"The ``'spawn'`` and ``'forkserver'`` start methods cannot currently be used " +"with \"frozen\" executables (i.e., binaries produced by packages like " +"**PyInstaller** and **cx_Freeze**) on Unix. The ``'fork'`` start method does " +"work." +msgstr "" + +msgid "Exchanging objects between processes" +msgstr "" + +msgid "" +":mod:`multiprocessing` supports two types of communication channel between " +"processes:" +msgstr "" + +msgid "**Queues**" +msgstr "" + +msgid "" +"The :class:`Queue` class is a near clone of :class:`queue.Queue`. For " +"example::" +msgstr "" + +msgid "Queues are thread and process safe." +msgstr "" + +msgid "**Pipes**" +msgstr "" + +msgid "" +"The :func:`Pipe` function returns a pair of connection objects connected by " +"a pipe which by default is duplex (two-way). For example::" +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." +msgstr "" + +msgid "Synchronization between processes" +msgstr "" + +msgid "" +":mod:`multiprocessing` contains equivalents of all the synchronization " +"primitives from :mod:`threading`. For instance one can use a lock to ensure " +"that only one process prints to standard output at a time::" +msgstr "" + +msgid "" +"Without using the lock output from the different processes is liable to get " +"all mixed up." +msgstr "" + +msgid "Sharing state between processes" +msgstr "" + +msgid "" +"As mentioned above, when doing concurrent programming it is usually best to " +"avoid using shared state as far as possible. This is particularly true when " +"using multiple processes." +msgstr "" + +msgid "" +"However, if you really do need to use some shared data then :mod:" +"`multiprocessing` provides a couple of ways of doing so." +msgstr "" + +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 ::" +msgstr "" + +msgid "will print ::" +msgstr "" + +msgid "" +"The ``'d'`` and ``'i'`` arguments used when creating ``num`` and ``arr`` are " +"typecodes of the kind used by the :mod:`array` module: ``'d'`` indicates a " +"double precision float and ``'i'`` indicates a signed integer. These shared " +"objects will be process and thread-safe." +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." +msgstr "" + +msgid "**Server process**" +msgstr "" + +msgid "" +"A manager object returned by :func:`Manager` controls a server process which " +"holds Python objects and allows other processes to manipulate them using " +"proxies." +msgstr "" + +msgid "" +"A manager returned by :func:`Manager` will support types :class:`list`, :" +"class:`dict`, :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 "" +"Server process managers are more flexible than using shared memory objects " +"because they can be made to support arbitrary object types. Also, a single " +"manager can be shared by processes on different computers over a network. " +"They are, however, slower than using shared memory." +msgstr "" + +msgid "Using a pool of workers" +msgstr "" + +msgid "" +"The :class:`~multiprocessing.pool.Pool` class represents a pool of worker " +"processes. It has methods which allows tasks to be offloaded to the worker " +"processes in a few different ways." +msgstr "" + +msgid "For example::" +msgstr "Dla przykładu::" + +msgid "" +"Note that the methods of a pool should only ever be used by the process " +"which created it." +msgstr "" + +msgid "" +"Functionality within this package requires that the ``__main__`` module be " +"importable by the children. This is covered in :ref:`multiprocessing-" +"programming` however it is worth pointing out here. This means that some " +"examples, such as the :class:`multiprocessing.pool.Pool` examples will not " +"work in the interactive interpreter. For example::" +msgstr "" + +msgid "" +"(If you try this it will actually output three full tracebacks interleaved " +"in a semi-random fashion, and then you may have to stop the parent process " +"somehow.)" +msgstr "" + +msgid "Reference" +msgstr "" + +msgid "" +"The :mod:`multiprocessing` package mostly replicates the API of the :mod:" +"`threading` module." +msgstr "" + +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`." +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." +msgstr "" + +msgid "" +"By default, no arguments are passed to *target*. The *args* argument, which " +"defaults to ``()``, can be used to specify a list or tuple of the arguments " +"to pass to *target*." +msgstr "" + +msgid "" +"If a subclass overrides the constructor, it must make sure it invokes the " +"base class constructor (:meth:`Process.__init__`) before doing anything else " +"to the process." +msgstr "" + +msgid "Added the *daemon* parameter." +msgstr "" + +msgid "Method representing the process's activity." +msgstr "" + +msgid "" +"You may override this method in a subclass. The standard :meth:`run` method " +"invokes the callable object passed to the object's constructor as the target " +"argument, if any, with sequential and keyword arguments taken from the " +"*args* and *kwargs* arguments, respectively." +msgstr "" + +msgid "" +"Using a list or tuple as the *args* argument passed to :class:`Process` " +"achieves the same effect." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "Start the process's activity." +msgstr "" + +msgid "" +"This must be called at most once per process object. It arranges for the " +"object's :meth:`run` method to be invoked in a separate process." +msgstr "" + +msgid "" +"If the optional argument *timeout* is ``None`` (the default), the method " +"blocks until the process whose :meth:`join` method is called terminates. If " +"*timeout* is a positive number, it blocks at most *timeout* seconds. Note " +"that the method returns ``None`` if its process terminates or if the method " +"times out. Check the process's :attr:`exitcode` to determine if it " +"terminated." +msgstr "" + +msgid "A process can be joined many times." +msgstr "" + +msgid "" +"A process cannot join itself because this would cause a deadlock. It is an " +"error to attempt to join a process before it has been started." +msgstr "" + +msgid "" +"The process's name. The name is a string used for identification purposes " +"only. It has no semantics. Multiple processes may be given the same name." +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." +msgstr "" + +msgid "Return whether the process is alive." +msgstr "" + +msgid "" +"Roughly, a process object is alive from the moment the :meth:`start` method " +"returns until the child process terminates." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"When a process exits, it attempts to terminate all of its daemonic child " +"processes." +msgstr "" + +msgid "" +"Note that a daemonic process is not allowed to create child processes. " +"Otherwise a daemonic process would leave its children orphaned if it gets " +"terminated when its parent process exits. Additionally, these are **not** " +"Unix daemons or services, they are normal processes that will be terminated " +"(and not joined) if non-daemonic processes have exited." +msgstr "" + +msgid "" +"In addition to the :class:`threading.Thread` API, :class:`Process` objects " +"also support the following attributes and methods:" +msgstr "" + +msgid "" +"Return the process ID. Before the process is spawned, this will be ``None``." +msgstr "" + +msgid "" +"The child's exit code. This will be ``None`` if the process has not yet " +"terminated." +msgstr "" + +msgid "" +"If the child's :meth:`run` method returned normally, the exit code will be " +"0. If it terminated via :func:`sys.exit` with an integer argument *N*, the " +"exit code will be *N*." +msgstr "" + +msgid "" +"If the child terminated due to an exception not caught within :meth:`run`, " +"the exit code will be 1. If it was terminated by signal *N*, the exit code " +"will be the negative value *-N*." +msgstr "" + +msgid "The process's authentication key (a byte string)." +msgstr "" + +msgid "" +"When :mod:`multiprocessing` is initialized the main process is assigned a " +"random string using :func:`os.urandom`." +msgstr "" + +msgid "" +"When a :class:`Process` object is created, it will inherit the " +"authentication key of its parent process, although this may be changed by " +"setting :attr:`authkey` to another byte string." +msgstr "" + +msgid "See :ref:`multiprocessing-auth-keys`." +msgstr "" + +msgid "" +"A numeric handle of a system object which will become \"ready\" when the " +"process ends." +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." +msgstr "" + +msgid "" +"On Windows, this is an OS handle usable with the ``WaitForSingleObject`` and " +"``WaitForMultipleObjects`` family of API calls. On Unix, this is a file " +"descriptor usable with primitives from the :mod:`select` module." +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." +msgstr "" + +msgid "" +"Note that descendant processes of the process will *not* be terminated -- " +"they will simply become orphaned." +msgstr "" + +msgid "" +"If this method is used when the associated process is using a pipe or queue " +"then the pipe or queue is liable to become corrupted and may become unusable " +"by other process. Similarly, if the process has acquired a lock or " +"semaphore etc. then terminating it is liable to cause other processes to " +"deadlock." +msgstr "" + +msgid "Same as :meth:`terminate()` but using the ``SIGKILL`` signal on Unix." +msgstr "" + +msgid "" +"Close the :class:`Process` object, releasing all resources associated with " +"it. :exc:`ValueError` is raised if the underlying process is still " +"running. Once :meth:`close` returns successfully, most other methods and " +"attributes of the :class:`Process` object will raise :exc:`ValueError`." +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." +msgstr "" + +msgid "Example usage of some of the methods of :class:`Process`:" +msgstr "" + +msgid "The base class of all :mod:`multiprocessing` exceptions." +msgstr "" + +msgid "" +"Exception raised by :meth:`Connection.recv_bytes_into()` when the supplied " +"buffer object is too small for the message read." +msgstr "" + +msgid "" +"If ``e`` is an instance of :exc:`BufferTooShort` then ``e.args[0]`` will " +"give the message as a byte string." +msgstr "" + +msgid "Raised when there is an authentication error." +msgstr "" + +msgid "Raised by methods with a timeout when the timeout expires." +msgstr "" + +msgid "Pipes and Queues" +msgstr "" + +msgid "" +"When using multiple processes, one generally uses message passing for " +"communication between processes and avoids having to use any synchronization " +"primitives like locks." +msgstr "" + +msgid "" +"For passing messages one can use :func:`Pipe` (for a connection between two " +"processes) or a queue (which allows multiple producers and consumers)." +msgstr "" + +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." +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." +msgstr "" + +msgid "" +"Note that one can also create a shared queue by using a manager object -- " +"see :ref:`multiprocessing-managers`." +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`." +msgstr "" + +msgid "" +"When an object is put on a queue, the object is pickled and a background " +"thread later flushes the pickled data to an underlying pipe. This has some " +"consequences which are a little surprising, but should not cause any " +"practical difficulties -- if they really bother you then you can instead use " +"a queue created with a :ref:`manager `." +msgstr "" + +msgid "" +"After putting an object on an empty queue there may be an infinitesimal " +"delay before the queue's :meth:`~Queue.empty` method returns :const:`False` " +"and :meth:`~Queue.get_nowait` can return without raising :exc:`queue.Empty`." +msgstr "" + +msgid "" +"If multiple processes are enqueuing objects, it is possible for the objects " +"to be received at the other end out-of-order. However, objects enqueued by " +"the same process will always be in the expected order with respect to each " +"other." +msgstr "" + +msgid "" +"If a process is killed using :meth:`Process.terminate` or :func:`os.kill` " +"while it is trying to use a :class:`Queue`, then the data in the queue is " +"likely to become corrupted. This may cause any other process to get an " +"exception when it tries to use the queue later on." +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." +msgstr "" + +msgid "" +"This means that if you try joining that process you may get a deadlock " +"unless you are sure that all items which have been put on the queue have " +"been consumed. Similarly, if the child process is non-daemonic then the " +"parent process may hang on exit when it tries to join all its non-daemonic " +"children." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "" +"Returns a pair ``(conn1, conn2)`` of :class:`~multiprocessing.connection." +"Connection` objects representing the ends of a pipe." +msgstr "" + +msgid "" +"If *duplex* is ``True`` (the default) then the pipe is bidirectional. If " +"*duplex* is ``False`` then the pipe is unidirectional: ``conn1`` can only be " +"used for receiving messages and ``conn2`` can only be used for sending " +"messages." +msgstr "" + +msgid "" +"Returns a process shared queue implemented using a pipe and a few locks/" +"semaphores. When a process first puts an item on the queue a feeder thread " +"is started which transfers objects from a buffer into the pipe." +msgstr "" + +msgid "" +"The usual :exc:`queue.Empty` and :exc:`queue.Full` exceptions from the " +"standard library's :mod:`queue` module are raised to signal timeouts." +msgstr "" + +msgid "" +":class:`Queue` implements all the methods of :class:`queue.Queue` except " +"for :meth:`~queue.Queue.task_done` and :meth:`~queue.Queue.join`." +msgstr "" + +msgid "" +"Return the approximate size of the queue. Because of multithreading/" +"multiprocessing semantics, this number is not reliable." +msgstr "" + +msgid "" +"Note that this may raise :exc:`NotImplementedError` on Unix platforms like " +"macOS where ``sem_getvalue()`` is not implemented." +msgstr "" + +msgid "" +"Return ``True`` if the queue is empty, ``False`` otherwise. Because of " +"multithreading/multiprocessing semantics, this is not reliable." +msgstr "" + +msgid "" +"Return ``True`` if the queue is full, ``False`` otherwise. Because of " +"multithreading/multiprocessing semantics, this is not reliable." +msgstr "" + +msgid "" +"Put obj into the queue. If the optional argument *block* is ``True`` (the " +"default) 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:`queue.Full` exception if no free " +"slot was available within that time. Otherwise (*block* is ``False``), put " +"an item on the queue if a free slot is immediately available, else raise " +"the :exc:`queue.Full` exception (*timeout* is ignored in that case)." +msgstr "" + +msgid "" +"If the queue is closed, :exc:`ValueError` is raised instead of :exc:" +"`AssertionError`." +msgstr "" + +msgid "Equivalent to ``put(obj, False)``." +msgstr "" + +msgid "" +"Remove and return an item from the queue. If optional args *block* is " +"``True`` (the default) and *timeout* is ``None`` (the default), block if " +"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)." +msgstr "" + +msgid "" +"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:" +msgstr "" + +msgid "" +"Indicate that no more data will be put on this queue by the current " +"process. The background thread will quit once it has flushed all buffered " +"data to the pipe. This is called automatically when the queue is garbage " +"collected." +msgstr "" + +msgid "" +"Join the background thread. This can only be used after :meth:`close` has " +"been called. It blocks until the background thread exits, ensuring that all " +"data in the buffer has been flushed to the pipe." +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." +msgstr "" + +msgid "" +"Prevent :meth:`join_thread` from blocking. In particular, this prevents the " +"background thread from being joined automatically when the process exits -- " +"see :meth:`join_thread`." +msgstr "" + +msgid "" +"A better name for this method might be ``allow_exit_without_flush()``. It " +"is likely to cause enqueued data to be lost, and you almost certainly will " +"not need to use it. It is really only there if you need the current process " +"to exit immediately without waiting to flush enqueued data to the underlying " +"pipe, and you don't care about lost data." +msgstr "" + +msgid "" +"This class's functionality requires a functioning shared semaphore " +"implementation on the host operating system. Without one, the functionality " +"in this class will be disabled, and attempts to instantiate a :class:`Queue` " +"will result in an :exc:`ImportError`. See :issue:`3770` for additional " +"information. The same holds true for any of the specialized queue types " +"listed below." +msgstr "" + +msgid "" +"It is a simplified :class:`Queue` type, very close to a locked :class:`Pipe`." +msgstr "" + +msgid "Close the queue: release internal resources." +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." +msgstr "" + +msgid "Return ``True`` if the queue is empty, ``False`` otherwise." +msgstr "" + +msgid "Remove and return an item from the queue." +msgstr "" + +msgid "Put *item* into the queue." +msgstr "" + +msgid "" +":class:`JoinableQueue`, a :class:`Queue` subclass, is a queue which " +"additionally has :meth:`task_done` and :meth:`join` methods." +msgstr "" + +msgid "" +"Indicate that a formerly enqueued task is complete. Used by queue " +"consumers. For each :meth:`~Queue.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 "" +"If a :meth:`~queue.Queue.join` is currently blocking, it will resume when " +"all items have been processed (meaning that a :meth:`task_done` call was " +"received for every item that had been :meth:`~Queue.put` into the queue)." +msgstr "" + +msgid "" +"Raises a :exc:`ValueError` if called more times than there were items placed " +"in the queue." +msgstr "" + +msgid "Block until all items in the queue have been gotten 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 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:`~queue.Queue.join` " +"unblocks." +msgstr "" + +msgid "Miscellaneous" +msgstr "" + +msgid "Return list of all live children of the current process." +msgstr "" + +msgid "" +"Calling this has the side effect of \"joining\" any processes which have " +"already finished." +msgstr "" + +msgid "Return the number of CPUs in the system." +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 ``len(os." +"sched_getaffinity(0))``" +msgstr "" + +msgid "" +"When the number of CPUs cannot be determined a :exc:`NotImplementedError` is " +"raised." +msgstr "" + +msgid ":func:`os.cpu_count`" +msgstr "" + +msgid "" +"Return the :class:`Process` object corresponding to the current process." +msgstr "" + +msgid "An analogue of :func:`threading.current_thread`." +msgstr "" + +msgid "" +"Return the :class:`Process` object corresponding to the parent process of " +"the :func:`current_process`. For the main process, ``parent_process`` will " +"be ``None``." +msgstr "" + +msgid "" +"Add support for when a program which uses :mod:`multiprocessing` has been " +"frozen to produce a Windows executable. (Has been tested with **py2exe**, " +"**PyInstaller** and **cx_Freeze**.)" +msgstr "" + +msgid "" +"One needs to call this function straight after the ``if __name__ == " +"'__main__'`` line of the main module. For example::" +msgstr "" + +msgid "" +"If the ``freeze_support()`` line is omitted then trying to run the frozen " +"executable will raise :exc:`RuntimeError`." +msgstr "" + +msgid "" +"Calling ``freeze_support()`` has no effect when invoked on any operating " +"system other than Windows. In addition, if the module is being run normally " +"by the Python interpreter on Windows (the program has not been frozen), then " +"``freeze_support()`` has no effect." +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'``. On Windows only ``'spawn'`` is available. On Unix " +"``'fork'`` and ``'spawn'`` are always supported, with ``'fork'`` being the " +"default." +msgstr "" + +msgid "" +"Return a context object which has the same attributes as the :mod:" +"`multiprocessing` module." +msgstr "" + +msgid "" +"If *method* is ``None`` then the default context is returned. Otherwise " +"*method* should be ``'fork'``, ``'spawn'``, ``'forkserver'``. :exc:" +"`ValueError` is raised if the specified start method is not available." +msgstr "" + +msgid "Return the name of start method used for starting processes." +msgstr "" + +msgid "" +"If the start method has not been fixed and *allow_none* is false, then the " +"start method is fixed to the default and the name is returned. If the start " +"method has not been fixed and *allow_none* is true then ``None`` is returned." +msgstr "" + +msgid "" +"The return value can be ``'fork'``, ``'spawn'``, ``'forkserver'`` or " +"``None``. ``'fork'`` is the default on Unix, while ``'spawn'`` is the " +"default on Windows and macOS." +msgstr "" + +msgid "" +"On macOS, the *spawn* start method is now the default. The *fork* start " +"method should be considered unsafe as it can lead to crashes of the " +"subprocess. See :issue:`33725`." +msgstr "" + +msgid "" +"Set the path of the Python interpreter to use when starting a child process. " +"(By default :data:`sys.executable` is used). Embedders will probably need " +"to do some thing like ::" +msgstr "" + +msgid "before they can create child processes." +msgstr "" + +msgid "Now supported on Unix when the ``'spawn'`` start method is used." +msgstr "" + +msgid "Accepts a :term:`path-like object`." +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." +msgstr "" + +msgid "" +"Note that this should be called at most once, and it should be protected " +"inside the ``if __name__ == '__main__'`` clause of the main module." +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`." +msgstr "" + +msgid "Connection Objects" +msgstr "" + +msgid "" +"Connection objects allow the sending and receiving of picklable objects or " +"strings. They can be thought of as message oriented connected sockets." +msgstr "" + +msgid "" +"Connection objects are usually created using :func:`Pipe ` -- see also :ref:`multiprocessing-listeners-clients`." +msgstr "" + +msgid "" +"Send an object to the other end of the connection which should be read " +"using :meth:`recv`." +msgstr "" + +msgid "" +"The object must be picklable. Very large pickles (approximately 32 MiB+, " +"though it depends on the OS) may raise a :exc:`ValueError` exception." +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." +msgstr "" + +msgid "Return the file descriptor or handle used by the connection." +msgstr "" + +msgid "Close the connection." +msgstr "" + +msgid "This is called automatically when the connection is garbage collected." +msgstr "" + +msgid "Return whether there is any data available to be read." +msgstr "" + +msgid "" +"If *timeout* is not specified then it will return immediately. If *timeout* " +"is a number then this specifies the maximum time in seconds to block. If " +"*timeout* is ``None`` then an infinite timeout is used." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"If *offset* is given then data is read from that position in *buffer*. If " +"*size* is given then that many bytes will be read from buffer. Very large " +"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." +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." +msgstr "" + +msgid "" +"This function used to raise :exc:`IOError`, which is now an alias of :exc:" +"`OSError`." +msgstr "" + +msgid "" +"Read into *buffer* a complete message of byte data sent from the other end " +"of the connection and return the number of bytes in the message. 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 "" +"*buffer* must be a writable :term:`bytes-like object`. If *offset* is given " +"then the message will be written into the buffer from that position. Offset " +"must be a non-negative integer less than the length of *buffer* (in bytes)." +msgstr "" + +msgid "" +"If the buffer is too short then a :exc:`BufferTooShort` exception is raised " +"and the complete message is available as ``e.args[0]`` where ``e`` is the " +"exception instance." +msgstr "" + +msgid "" +"Connection objects themselves can now be transferred between processes " +"using :meth:`Connection.send` and :meth:`Connection.recv`." +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`." +msgstr "" + +msgid "For example:" +msgstr "Na przykład::" + +msgid "" +"The :meth:`Connection.recv` method automatically unpickles the data it " +"receives, which can be a security risk unless you can trust the process " +"which sent the message." +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`." +msgstr "" + +msgid "" +"If a process is killed while it is trying to read or write to a pipe then " +"the data in the pipe is likely to become corrupted, because it may become " +"impossible to be sure where the message boundaries lie." +msgstr "" + +msgid "Synchronization primitives" +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." +msgstr "" + +msgid "" +"Note that one can also create synchronization primitives by using a manager " +"object -- see :ref:`multiprocessing-managers`." +msgstr "" + +msgid "A barrier object: a clone of :class:`threading.Barrier`." +msgstr "" + +msgid "" +"A bounded semaphore object: a close analog of :class:`threading." +"BoundedSemaphore`." +msgstr "" + +msgid "" +"A solitary difference from its close analog exists: its ``acquire`` method's " +"first argument is named *block*, as is consistent with :meth:`Lock.acquire`." +msgstr "" + +msgid "" +"On macOS, this is indistinguishable from :class:`Semaphore` because " +"``sem_getvalue()`` is not implemented on that platform." +msgstr "" + +msgid "A condition variable: an alias for :class:`threading.Condition`." +msgstr "" + +msgid "" +"If *lock* is specified then it should be a :class:`Lock` or :class:`RLock` " +"object from :mod:`multiprocessing`." +msgstr "" + +msgid "The :meth:`~threading.Condition.wait_for` method was added." +msgstr "" + +msgid "A clone of :class:`threading.Event`." +msgstr "" + +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." +msgstr "" + +msgid "" +"Note that :class:`Lock` is actually a factory function which returns an " +"instance of ``multiprocessing.synchronize.Lock`` initialized with a default " +"context." +msgstr "" + +msgid "" +":class:`Lock` supports the :term:`context manager` protocol and thus may be " +"used in :keyword:`with` statements." +msgstr "" + +msgid "Acquire a lock, blocking or non-blocking." +msgstr "" + +msgid "" +"With the *block* argument set to ``True`` (the default), the method call " +"will block until the lock is in an unlocked state, then set it to locked and " +"return ``True``. Note that the name of this first argument differs from " +"that in :meth:`threading.Lock.acquire`." +msgstr "" + +msgid "" +"With the *block* argument set to ``False``, the method call does not block. " +"If the lock is currently in a locked state, return ``False``; otherwise set " +"the lock to a locked state and return ``True``." +msgstr "" + +msgid "" +"When invoked with a positive, floating-point value for *timeout*, block for " +"at most the number of seconds specified by *timeout* as long as the lock can " +"not be acquired. Invocations with a negative value for *timeout* are " +"equivalent to a *timeout* of zero. Invocations with a *timeout* value of " +"``None`` (the default) set the timeout period to infinite. Note that the " +"treatment of negative or ``None`` values for *timeout* differs from the " +"implemented behavior in :meth:`threading.Lock.acquire`. The *timeout* " +"argument has no practical implications if the *block* argument is set to " +"``False`` and is thus ignored. Returns ``True`` if the lock has been " +"acquired or ``False`` if the timeout period has elapsed." +msgstr "" + +msgid "" +"Release a lock. This can be called from any process or thread, not only the " +"process or thread which originally acquired the lock." +msgstr "" + +msgid "" +"Behavior is the same as in :meth:`threading.Lock.release` except that when " +"invoked on an unlocked lock, a :exc:`ValueError` is raised." +msgstr "" + +msgid "" +"A recursive lock object: a close analog of :class:`threading.RLock`. A " +"recursive lock must be released by the process or thread that acquired it. " +"Once a process or thread has acquired a recursive lock, the same process or " +"thread may acquire it again without blocking; that process or thread must " +"release it once for each time it has been acquired." +msgstr "" + +msgid "" +"Note that :class:`RLock` is actually a factory function which returns an " +"instance of ``multiprocessing.synchronize.RLock`` initialized with a default " +"context." +msgstr "" + +msgid "" +":class:`RLock` supports the :term:`context manager` protocol and thus may be " +"used in :keyword:`with` statements." +msgstr "" + +msgid "" +"When invoked with the *block* argument set to ``True``, block until the lock " +"is in an unlocked state (not owned by any process or thread) unless the lock " +"is already owned by the current process or thread. The current process or " +"thread then takes ownership of the lock (if it does not already have " +"ownership) and the recursion level inside the lock increments by one, " +"resulting in a return value of ``True``. Note that there are several " +"differences in this first argument's behavior compared to the implementation " +"of :meth:`threading.RLock.acquire`, starting with the name of the argument " +"itself." +msgstr "" + +msgid "" +"When invoked with the *block* argument set to ``False``, do not block. If " +"the lock has already been acquired (and thus is owned) by another process or " +"thread, the current process or thread does not take ownership and the " +"recursion level within the lock is not changed, resulting in a return value " +"of ``False``. If the lock is in an unlocked state, the current process or " +"thread takes ownership and the recursion level is incremented, resulting in " +"a return value of ``True``." +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`." +msgstr "" + +msgid "" +"Release a lock, decrementing the recursion level. If after the decrement " +"the recursion level is zero, reset the lock to unlocked (not owned by any " +"process or thread) and if any other processes or threads are blocked waiting " +"for the lock to become unlocked, allow exactly one of them to proceed. If " +"after the decrement the recursion level is still nonzero, the lock remains " +"locked and owned by the calling process or thread." +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 " +"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`." +msgstr "" + +msgid "A semaphore object: a close analog of :class:`threading.Semaphore`." +msgstr "" + +msgid "" +"On macOS, ``sem_timedwait`` is unsupported, so calling ``acquire()`` with a " +"timeout will emulate that function's behavior using a sleeping loop." +msgstr "" + +msgid "" +"If the SIGINT signal generated by :kbd:`Ctrl-C` arrives while the main " +"thread is blocked by a call to :meth:`BoundedSemaphore.acquire`, :meth:`Lock." +"acquire`, :meth:`RLock.acquire`, :meth:`Semaphore.acquire`, :meth:`Condition." +"acquire` or :meth:`Condition.wait` then the call will be immediately " +"interrupted and :exc:`KeyboardInterrupt` will be raised." +msgstr "" + +msgid "" +"This differs from the behaviour of :mod:`threading` where SIGINT will be " +"ignored while the equivalent blocking calls are in progress." +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 " +"additional information." +msgstr "" + +msgid "Shared :mod:`ctypes` Objects" +msgstr "" + +msgid "" +"It is possible to create shared objects using shared memory which can be " +"inherited by child processes." +msgstr "" + +msgid "" +"Return a :mod:`ctypes` object allocated from shared memory. By default the " +"return value is actually a synchronized wrapper for the object. The object " +"itself can be accessed via the *value* attribute of a :class:`Value`." +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." +msgstr "" + +msgid "" +"If *lock* is ``True`` (the default) then a new recursive 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\"." +msgstr "" + +msgid "" +"Operations like ``+=`` which involve a read and write are not atomic. So " +"if, for instance, you want to atomically increment a shared value it is " +"insufficient to just do ::" +msgstr "" + +msgid "" +"Assuming the associated lock is recursive (which it is by default) you can " +"instead do ::" +msgstr "" + +msgid "Note that *lock* is a keyword-only argument." +msgstr "" + +msgid "" +"Return a ctypes array allocated from shared memory. By default the return " +"value is actually a synchronized wrapper for the array." +msgstr "" + +msgid "" +"*typecode_or_type* determines the type of the elements of the returned " +"array: it is either a ctypes type or a one character typecode of the kind " +"used by the :mod:`array` module. If *size_or_initializer* is an integer, " +"then it determines the length of the array, and the array will be initially " +"zeroed. Otherwise, *size_or_initializer* is a sequence which is used to " +"initialize the array and whose length determines the length of the array." +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\"." +msgstr "" + +msgid "Note that *lock* is a keyword only argument." +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." +msgstr "" + +msgid "The :mod:`multiprocessing.sharedctypes` module" +msgstr "" + +msgid "" +"The :mod:`multiprocessing.sharedctypes` module provides functions for " +"allocating :mod:`ctypes` objects from shared memory which can be inherited " +"by child processes." +msgstr "" + +msgid "" +"Although it is possible to store a pointer in shared memory remember that " +"this will refer to a location in the address space of a specific process. " +"However, the pointer is quite likely to be invalid in the context of a " +"second process and trying to dereference the pointer from the second process " +"may cause a crash." +msgstr "" + +msgid "Return a ctypes array allocated from shared memory." +msgstr "" + +msgid "" +"*typecode_or_type* determines the type of the elements of the returned " +"array: it is either a ctypes type or a one character typecode of the kind " +"used by the :mod:`array` module. If *size_or_initializer* is an integer " +"then it determines the length of the array, and the array will be initially " +"zeroed. Otherwise *size_or_initializer* is a sequence which is used to " +"initialize the array and whose length determines the length of the array." +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." +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." +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 -- see " +"documentation for :mod:`ctypes`." +msgstr "" + +msgid "" +"The same as :func:`RawArray` except that depending on the value of *lock* a " +"process-safe synchronization wrapper may be returned instead of a raw ctypes " +"array." +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\"." +msgstr "" + +msgid "" +"The same as :func:`RawValue` except that depending on the value of *lock* a " +"process-safe synchronization wrapper may be returned instead of a raw ctypes " +"object." +msgstr "" + +msgid "" +"Return a ctypes object allocated from shared memory which is a copy of the " +"ctypes object *obj*." +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." +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." +msgstr "" + +msgid "" +"Note that accessing the ctypes object through the wrapper can be a lot " +"slower than accessing the raw ctypes object." +msgstr "" + +msgid "Synchronized objects support the :term:`context manager` protocol." +msgstr "" + +msgid "" +"The table below compares the syntax for creating shared ctypes objects from " +"shared memory with the normal ctypes syntax. (In the table ``MyStruct`` is " +"some subclass of :class:`ctypes.Structure`.)" +msgstr "" + +msgid "ctypes" +msgstr "" + +msgid "sharedctypes using type" +msgstr "" + +msgid "sharedctypes using typecode" +msgstr "" + +msgid "c_double(2.4)" +msgstr "" + +msgid "RawValue(c_double, 2.4)" +msgstr "" + +msgid "RawValue('d', 2.4)" +msgstr "" + +msgid "MyStruct(4, 6)" +msgstr "" + +msgid "RawValue(MyStruct, 4, 6)" +msgstr "" + +msgid "(c_short * 7)()" +msgstr "" + +msgid "RawArray(c_short, 7)" +msgstr "" + +msgid "RawArray('h', 7)" +msgstr "" + +msgid "(c_int * 3)(9, 2, 8)" +msgstr "" + +msgid "RawArray(c_int, (9, 2, 8))" +msgstr "" + +msgid "RawArray('i', (9, 2, 8))" +msgstr "" + +msgid "" +"Below is an example where a number of ctypes objects are modified by a child " +"process::" +msgstr "" + +msgid "The results printed are ::" +msgstr "" + +msgid "Managers" +msgstr "" + +msgid "" +"Managers provide a way to create data which can be shared between different " +"processes, including sharing over a network between processes running on " +"different machines. A manager object controls a server process which manages " +"*shared objects*. Other processes can access the shared objects by using " +"proxies." +msgstr "" + +msgid "" +"Returns a started :class:`~multiprocessing.managers.SyncManager` object " +"which can be used for sharing objects between processes. The returned " +"manager object corresponds to a spawned child process and has methods which " +"will create shared objects and return corresponding proxies." +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:" +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." +msgstr "" + +msgid "" +"*address* is the address on which the manager process listens for new " +"connections. If *address* is ``None`` then an arbitrary one is chosen." +msgstr "" + +msgid "" +"*authkey* is the authentication key which will be used to check the validity " +"of incoming connections to the server process. If *authkey* is ``None`` " +"then ``current_process().authkey`` is used. Otherwise *authkey* is used and " +"it must be a byte string." +msgstr "" + +msgid "" +"*serializer* must be ``'pickle'`` (use :mod:`pickle` serialization) or " +"``'xmlrpclib'`` (use :mod:`xmlrpc.client` serialization)." +msgstr "" + +msgid "" +"*ctx* is a context object, or ``None`` (use the current context). See the :" +"func:`get_context` function." +msgstr "" + +msgid "" +"*shutdown_timeout* is a timeout in seconds used to wait until the process " +"used by the manager completes in the :meth:`shutdown` method. If the " +"shutdown times out, the process is terminated. If terminating the process " +"also times out, the process is killed." +msgstr "" + +msgid "Added the *shutdown_timeout* parameter." +msgstr "" + +msgid "" +"Start a subprocess to start the manager. If *initializer* is not ``None`` " +"then the subprocess will call ``initializer(*initargs)`` when it starts." +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::" +msgstr "" + +msgid ":class:`Server` additionally has an :attr:`address` attribute." +msgstr "" + +msgid "Connect a local manager object to a remote manager process::" +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "" +"A classmethod which can be used for registering a type or callable with the " +"manager class." +msgstr "" + +msgid "" +"*typeid* is a \"type identifier\" which is used to identify a particular " +"type of shared object. This must be a string." +msgstr "" + +msgid "" +"*callable* is a callable used for creating objects for this type " +"identifier. If a manager instance will be connected to the server using " +"the :meth:`connect` method, or if the *create_method* argument is ``False`` " +"then this can be left as ``None``." +msgstr "" + +msgid "" +"*proxytype* is a subclass of :class:`BaseProxy` which is used to create " +"proxies for shared objects with this *typeid*. If ``None`` then a proxy " +"class is created automatically." +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 ``'_'``.)" +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." +msgstr "" + +msgid "" +"*create_method* determines whether a method should be created with name " +"*typeid* which can be used to tell the server process to create a new shared " +"object and return a proxy for it. By default it is ``True``." +msgstr "" + +msgid ":class:`BaseManager` instances also have one read-only property:" +msgstr "" + +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 " +"object. :meth:`~contextmanager.__exit__` calls :meth:`shutdown`." +msgstr "" + +msgid "" +"In previous versions :meth:`~contextmanager.__enter__` did not start the " +"manager's server process if it was not already started." +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`." +msgstr "" + +msgid "" +"Its methods create and return :ref:`multiprocessing-proxy_objects` for a " +"number of commonly used data types to be synchronized across processes. This " +"notably includes shared lists and dictionaries." +msgstr "" + +msgid "" +"Create a shared :class:`threading.Barrier` object and return a proxy for it." +msgstr "" + +msgid "" +"Create a shared :class:`threading.BoundedSemaphore` object and return a " +"proxy for it." +msgstr "" + +msgid "" +"Create a shared :class:`threading.Condition` object and return a proxy for " +"it." +msgstr "" + +msgid "" +"If *lock* is supplied then it should be a proxy for a :class:`threading." +"Lock` or :class:`threading.RLock` object." +msgstr "" + +msgid "" +"Create a shared :class:`threading.Event` object and return a proxy for it." +msgstr "" + +msgid "" +"Create a shared :class:`threading.Lock` object and return a proxy for it." +msgstr "" + +msgid "Create a shared :class:`Namespace` object and return a proxy for it." +msgstr "" + +msgid "Create a shared :class:`queue.Queue` object and return a proxy for it." +msgstr "" + +msgid "" +"Create a shared :class:`threading.RLock` object and return a proxy for it." +msgstr "" + +msgid "" +"Create a shared :class:`threading.Semaphore` object and return a proxy for " +"it." +msgstr "" + +msgid "Create an array and return a proxy for it." +msgstr "" + +msgid "" +"Create an object with a writable ``value`` attribute and return a proxy for " +"it." +msgstr "" + +msgid "Create a shared :class:`dict` object and return a proxy for it." +msgstr "" + +msgid "Create a shared :class:`list` object and return a proxy for it." +msgstr "" + +msgid "" +"Shared objects are capable of being nested. For example, a shared container " +"object such as a shared list can contain other shared objects which will all " +"be managed and synchronized by the :class:`SyncManager`." +msgstr "" + +msgid "A type that can register with :class:`SyncManager`." +msgstr "" + +msgid "" +"A namespace object has no public methods, but does have writable attributes. " +"Its representation shows the values of its attributes." +msgstr "" + +msgid "" +"However, when using a proxy for a namespace object, an attribute beginning " +"with ``'_'`` will be an attribute of the proxy and not an attribute of the " +"referent:" +msgstr "" + +msgid "Customized managers" +msgstr "" + +msgid "" +"To create one's own manager, one creates a subclass of :class:`BaseManager` " +"and uses the :meth:`~BaseManager.register` classmethod to register new types " +"or callables with the manager class. For example::" +msgstr "" + +msgid "Using a remote manager" +msgstr "" + +msgid "" +"It is possible to run a manager server on one machine and have clients use " +"it from other machines (assuming that the firewalls involved allow it)." +msgstr "" + +msgid "" +"Running the following commands creates a server for a single shared queue " +"which remote clients can access::" +msgstr "" + +msgid "One client can access the server as follows::" +msgstr "" + +msgid "Another client can also use it::" +msgstr "" + +msgid "" +"Local processes can also access that queue, using the code from above on the " +"client to access it remotely::" +msgstr "" + +msgid "Proxy Objects" +msgstr "" + +msgid "" +"A proxy is an object which *refers* to a shared object which lives " +"(presumably) in a different process. The shared object is said to be the " +"*referent* of the proxy. Multiple proxy objects may have the same referent." +msgstr "" + +msgid "" +"A proxy object has methods which invoke corresponding methods of its " +"referent (although not every method of the referent will necessarily be " +"available through the proxy). In this way, a proxy can be used just like " +"its referent can:" +msgstr "" + +msgid "" +"Notice that applying :func:`str` to a proxy will return the representation " +"of the referent, whereas applying :func:`repr` will return the " +"representation of the proxy." +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`:" +msgstr "" + +msgid "Similarly, dict and list proxies may be nested inside one another::" +msgstr "" + +msgid "" +"If standard (non-proxy) :class:`list` or :class:`dict` objects are contained " +"in a referent, modifications to those mutable values will not be propagated " +"through the manager because the proxy has no way of knowing when the values " +"contained within are modified. However, storing a value in a container " +"proxy (which triggers a ``__setitem__`` on the proxy object) does propagate " +"through the manager and so to effectively modify such an item, one could re-" +"assign the modified value to the container proxy::" +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." +msgstr "" + +msgid "" +"The proxy types in :mod:`multiprocessing` do nothing to support comparisons " +"by value. So, for instance, we have:" +msgstr "" + +msgid "" +"One should just use a copy of the referent instead when making comparisons." +msgstr "" + +msgid "Proxy objects are instances of subclasses of :class:`BaseProxy`." +msgstr "" + +msgid "Call and return the result of a method of the proxy's referent." +msgstr "" + +msgid "" +"If ``proxy`` is a proxy whose referent is ``obj`` then the expression ::" +msgstr "" + +msgid "will evaluate the expression ::" +msgstr "" + +msgid "in the manager's process." +msgstr "" + +msgid "" +"The returned value will be a copy of the result of the call or a proxy to a " +"new shared object -- see documentation for the *method_to_typeid* argument " +"of :meth:`BaseManager.register`." +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`." +msgstr "" + +msgid "" +"Note in particular that an exception will be raised if *methodname* has not " +"been *exposed*." +msgstr "" + +msgid "An example of the usage of :meth:`_callmethod`:" +msgstr "" + +msgid "Return a copy of the referent." +msgstr "" + +msgid "If the referent is unpicklable then this will raise an exception." +msgstr "" + +msgid "Return a representation of the proxy object." +msgstr "" + +msgid "Return the representation of the referent." +msgstr "" + +msgid "Cleanup" +msgstr "" + +msgid "" +"A proxy object uses a weakref callback so that when it gets garbage " +"collected it deregisters itself from the manager which owns its referent." +msgstr "" + +msgid "" +"A shared object gets deleted from the manager process when there are no " +"longer any proxies referring to it." +msgstr "" + +msgid "Process Pools" +msgstr "" + +msgid "" +"One can create a pool of processes which will carry out tasks submitted to " +"it with the :class:`Pool` class." +msgstr "" + +msgid "" +"A process pool object which controls a pool of worker processes to which " +"jobs can be submitted. It supports asynchronous results with timeouts and " +"callbacks and has a parallel map implementation." +msgstr "" + +msgid "" +"*processes* is the number of worker processes to use. If *processes* is " +"``None`` then the number returned by :func:`os.cpu_count` is used." +msgstr "" + +msgid "" +"If *initializer* is not ``None`` then each worker process will call " +"``initializer(*initargs)`` when it starts." +msgstr "" + +msgid "" +"*maxtasksperchild* is the number of tasks a worker process can complete " +"before it will exit and be replaced with a fresh worker process, to enable " +"unused resources to be freed. The default *maxtasksperchild* is ``None``, " +"which means worker processes will live as long as the pool." +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." +msgstr "" + +msgid "" +"Note that the methods of the pool object should only be called by the " +"process which created the pool." +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." +msgstr "" + +msgid "" +"Note that it is **not correct** to rely on the garbage collector to destroy " +"the pool as CPython does not assure that the finalizer of the pool will be " +"called (see :meth:`object.__del__` for more information)." +msgstr "" + +msgid "Added the *maxtasksperchild* parameter." +msgstr "" + +msgid "Added the *context* parameter." +msgstr "" + +msgid "" +"Worker processes within a :class:`Pool` typically live for the complete " +"duration of the Pool's work queue. A frequent pattern found in other systems " +"(such as Apache, mod_wsgi, etc) to free resources held by workers is to " +"allow a worker within a pool to complete only a set amount of work before " +"being exiting, being cleaned up and a new process spawned to replace the old " +"one. The *maxtasksperchild* argument to the :class:`Pool` exposes this " +"ability to the end user." +msgstr "" + +msgid "" +"Call *func* with arguments *args* and keyword arguments *kwds*. It blocks " +"until the result is ready. Given this blocks, :meth:`apply_async` is better " +"suited for performing work in parallel. Additionally, *func* is only " +"executed in one of the workers of the pool." +msgstr "" + +msgid "" +"A variant of the :meth:`apply` method which returns a :class:" +"`~multiprocessing.pool.AsyncResult` object." +msgstr "" + +msgid "" +"If *callback* is specified then it should be a callable which accepts a " +"single argument. When the result becomes ready *callback* is applied to it, " +"that is unless the call failed, in which case the *error_callback* is " +"applied instead." +msgstr "" + +msgid "" +"If *error_callback* is specified then it should be a callable which accepts " +"a single argument. If the target function fails, then the *error_callback* " +"is called with the exception instance." +msgstr "" + +msgid "" +"Callbacks should complete immediately since otherwise the thread which " +"handles the results will get blocked." +msgstr "" + +msgid "" +"A parallel equivalent of the :func:`map` built-in function (it supports only " +"one *iterable* argument though, for multiple iterables see :meth:`starmap`). " +"It blocks until the result is ready." +msgstr "" + +msgid "" +"This method chops the iterable into a number of chunks which it submits to " +"the process pool as separate tasks. The (approximate) size of these chunks " +"can be specified by setting *chunksize* to a positive integer." +msgstr "" + +msgid "" +"Note that it may cause high memory usage for very long iterables. Consider " +"using :meth:`imap` or :meth:`imap_unordered` with explicit *chunksize* " +"option for better efficiency." +msgstr "" + +msgid "" +"A variant of the :meth:`.map` method which returns a :class:" +"`~multiprocessing.pool.AsyncResult` object." +msgstr "" + +msgid "A lazier version of :meth:`.map`." +msgstr "" + +msgid "" +"The *chunksize* argument is the same as the one used by the :meth:`.map` " +"method. For very long iterables using a large value for *chunksize* can " +"make the job complete **much** faster than using the default value of ``1``." +msgstr "" + +msgid "" +"Also if *chunksize* is ``1`` then the :meth:`!next` method of the iterator " +"returned by the :meth:`imap` method has an optional *timeout* parameter: " +"``next(timeout)`` will raise :exc:`multiprocessing.TimeoutError` if the " +"result cannot be returned within *timeout* seconds." +msgstr "" + +msgid "" +"The same as :meth:`imap` except that the ordering of the results from the " +"returned iterator should be considered arbitrary. (Only when there is only " +"one worker process is the order guaranteed to be \"correct\".)" +msgstr "" + +msgid "" +"Like :meth:`~multiprocessing.pool.Pool.map` except that the elements of the " +"*iterable* are expected to be iterables that are unpacked as arguments." +msgstr "" + +msgid "" +"Hence an *iterable* of ``[(1,2), (3, 4)]`` results in ``[func(1,2), " +"func(3,4)]``." +msgstr "" + +msgid "" +"A combination of :meth:`starmap` and :meth:`map_async` that iterates over " +"*iterable* of iterables and calls *func* with the iterables unpacked. " +"Returns a result object." +msgstr "" + +msgid "" +"Prevents any more tasks from being submitted to the pool. Once all the " +"tasks have been completed the worker processes will exit." +msgstr "" + +msgid "" +"Stops the worker processes immediately without completing outstanding work. " +"When the pool object is garbage collected :meth:`terminate` will be called " +"immediately." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "Wait until the result is available or until *timeout* seconds pass." +msgstr "" + +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." +msgstr "" + +msgid "" +"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::" +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`." +msgstr "" + +msgid "" +"However, the :mod:`multiprocessing.connection` module allows some extra " +"flexibility. It basically gives a high level message oriented API for " +"dealing with sockets or Windows named pipes. It also has support for " +"*digest authentication* using the :mod:`hmac` module, and for polling " +"multiple connections at the same time." +msgstr "" + +msgid "" +"Send a randomly generated message to the other end of the connection and " +"wait for a reply." +msgstr "" + +msgid "" +"If the reply matches the digest of the message using *authkey* as the key " +"then a welcome message is sent to the other end of the connection. " +"Otherwise :exc:`~multiprocessing.AuthenticationError` is raised." +msgstr "" + +msgid "" +"Receive a message, calculate the digest of the message using *authkey* as " +"the key, and then send the digest back." +msgstr "" + +msgid "" +"If a welcome message is not received, then :exc:`~multiprocessing." +"AuthenticationError` is raised." +msgstr "" + +msgid "" +"Attempt to set up a connection to the listener which is using address " +"*address*, returning a :class:`~Connection`." +msgstr "" + +msgid "" +"The type of the connection is determined by *family* argument, but this can " +"generally be omitted since it can usually be inferred from the format of " +"*address*. (See :ref:`multiprocessing-address-formats`)" +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`." +msgstr "" + +msgid "" +"A wrapper for a bound socket or Windows named pipe which is 'listening' for " +"connections." +msgstr "" + +msgid "" +"*address* is the address to be used by the bound socket or named pipe of the " +"listener object." +msgstr "" + +msgid "" +"If an address of '0.0.0.0' is used, the address will not be a connectable " +"end point on Windows. If you require a connectable end-point, you should use " +"'127.0.0.1'." +msgstr "" + +msgid "" +"*family* is the type of socket (or named pipe) to use. This can be one of " +"the strings ``'AF_INET'`` (for a TCP socket), ``'AF_UNIX'`` (for a Unix " +"domain socket) or ``'AF_PIPE'`` (for a Windows named pipe). Of these only " +"the first is guaranteed to be available. If *family* is ``None`` then the " +"family is inferred from the format of *address*. If *address* is also " +"``None`` then a default is chosen. This default is the family which is " +"assumed to be the fastest available. See :ref:`multiprocessing-address-" +"formats`. Note that if *family* is ``'AF_UNIX'`` and address is ``None`` " +"then the socket will be created in a private temporary directory created " +"using :func:`tempfile.mkstemp`." +msgstr "" + +msgid "" +"If the listener object uses a socket then *backlog* (1 by default) is passed " +"to the :meth:`~socket.socket.listen` method of the socket once it has been " +"bound." +msgstr "" + +msgid "" +"Accept a connection on the bound socket or named pipe of the listener object " +"and return a :class:`~Connection` object. If authentication is attempted and " +"fails, then :exc:`~multiprocessing.AuthenticationError` is raised." +msgstr "" + +msgid "" +"Close the bound socket or named pipe of the listener object. This is called " +"automatically when the listener is garbage collected. However it is " +"advisable to call it explicitly." +msgstr "" + +msgid "Listener objects have the following read-only properties:" +msgstr "" + +msgid "The address which is being used by the Listener object." +msgstr "" + +msgid "" +"The address from which the last accepted connection came. If this is " +"unavailable then it is ``None``." +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`." +msgstr "" + +msgid "" +"Wait till an object in *object_list* is ready. Returns the list of those " +"objects in *object_list* which are ready. If *timeout* is a float then the " +"call blocks for at most that many seconds. If *timeout* is ``None`` then it " +"will block for an unlimited period. A negative timeout is equivalent to a " +"zero timeout." +msgstr "" + +msgid "" +"For both Unix and Windows, an object can appear in *object_list* if it is" +msgstr "" + +msgid "a readable :class:`~multiprocessing.connection.Connection` object;" +msgstr "" + +msgid "a connected and readable :class:`socket.socket` object; or" +msgstr "" + +msgid "" +"the :attr:`~multiprocessing.Process.sentinel` attribute of a :class:" +"`~multiprocessing.Process` object." +msgstr "" + +msgid "" +"A connection or socket object is ready when there is data available to be " +"read from it, or the other end has been closed." +msgstr "" + +msgid "" +"**Unix**: ``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 " +"handle. (Note that pipe handles and socket handles are **not** waitable " +"handles.)" +msgstr "" + +msgid "**Examples**" +msgstr "" + +msgid "" +"The following server code creates a listener which uses ``'secret " +"password'`` as an authentication key. It then waits for a connection and " +"sends some data to the client::" +msgstr "" + +msgid "" +"The following code connects to the server and receives some data from the " +"server::" +msgstr "" + +msgid "" +"The following code uses :func:`~multiprocessing.connection.wait` to wait for " +"messages from multiple processes at once::" +msgstr "" + +msgid "Address Formats" +msgstr "" + +msgid "" +"An ``'AF_INET'`` address is a tuple of the form ``(hostname, port)`` where " +"*hostname* is a string and *port* is an integer." +msgstr "" + +msgid "" +"An ``'AF_UNIX'`` address is a string representing a filename on the " +"filesystem." +msgstr "" + +msgid "" +"An ``'AF_PIPE'`` address is a string of the form :samp:`r'\\\\\\\\\\\\.\\" +"\\pipe\\\\\\\\{PipeName}'`. To use :func:`Client` to connect to a named " +"pipe on a remote computer called *ServerName* one should use an address of " +"the form :samp:`r'\\\\\\\\\\\\\\\\{ServerName}\\\\pipe\\\\\\\\{PipeName}'` " +"instead." +msgstr "" + +msgid "" +"Note that any string beginning with two backslashes is assumed by default to " +"be an ``'AF_PIPE'`` address rather than an ``'AF_UNIX'`` address." +msgstr "" + +msgid "Authentication keys" +msgstr "" + +msgid "" +"When one uses :meth:`Connection.recv `, the data received " +"is automatically unpickled. Unfortunately unpickling data from an untrusted " +"source is a security risk. Therefore :class:`Listener` and :func:`Client` " +"use the :mod:`hmac` module to provide digest authentication." +msgstr "" + +msgid "" +"An authentication key is a byte string which can be thought of as a " +"password: once a connection is established both ends will demand proof that " +"the other knows the authentication key. (Demonstrating that both ends are " +"using the same key does **not** involve sending the key over the connection.)" +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." +msgstr "" + +msgid "" +"Suitable authentication keys can also be generated by using :func:`os." +"urandom`." +msgstr "" + +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." +msgstr "" + +msgid "" +"Returns the logger used by :mod:`multiprocessing`. If necessary, a new one " +"will be created." +msgstr "" + +msgid "" +"When first created the logger has level :const:`logging.NOTSET` and no " +"default handler. Messages sent to this logger will not by default propagate " +"to the root logger." +msgstr "" + +msgid "" +"Note that on Windows child processes will only inherit the level of the " +"parent process's logger -- any other customization of the logger will not be " +"inherited." +msgstr "" + +msgid "" +"This function performs a call to :func:`get_logger` but in addition to " +"returning the logger created by get_logger, it adds a handler which sends " +"output to :data:`sys.stderr` using format ``'[%(levelname)s/%(processName)s] " +"%(message)s'``. You can modify ``levelname`` of the logger by passing a " +"``level`` argument." +msgstr "" + +msgid "Below is an example session with logging turned on::" +msgstr "" + +msgid "For a full table of logging levels, see the :mod:`logging` module." +msgstr "" + +msgid "The :mod:`multiprocessing.dummy` module" +msgstr "" + +msgid "" +":mod:`multiprocessing.dummy` replicates the API of :mod:`multiprocessing` " +"but is no more than a wrapper around the :mod:`threading` module." +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." +msgstr "" + +msgid "" +"A thread pool object which controls a pool of worker threads to which jobs " +"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." +msgstr "" + +msgid "" +"*processes* is the number of worker threads to use. If *processes* is " +"``None`` then the number returned by :func:`os.cpu_count` is used." +msgstr "" + +msgid "" +"Unlike :class:`Pool`, *maxtasksperchild* and *context* cannot be provided." +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." +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`." +msgstr "" + +msgid "Programming guidelines" +msgstr "" + +msgid "" +"There are certain guidelines and idioms which should be adhered to when " +"using :mod:`multiprocessing`." +msgstr "" + +msgid "All start methods" +msgstr "" + +msgid "The following applies to all start methods." +msgstr "" + +msgid "Avoid shared state" +msgstr "" + +msgid "" +"As far as possible one should try to avoid shifting large amounts of data " +"between processes." +msgstr "" + +msgid "" +"It is probably best to stick to using queues or pipes for communication " +"between processes rather than using the lower level synchronization " +"primitives." +msgstr "" + +msgid "Picklability" +msgstr "" + +msgid "Ensure that the arguments to the methods of proxies are picklable." +msgstr "" + +msgid "Thread safety of proxies" +msgstr "" + +msgid "" +"Do not use a proxy object from more than one thread unless you protect it " +"with a lock." +msgstr "" + +msgid "" +"(There is never a problem with different processes using the *same* proxy.)" +msgstr "" + +msgid "Joining zombie processes" +msgstr "" + +msgid "" +"On Unix when a process finishes but has not been joined it becomes a 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." +msgstr "" + +msgid "Better to inherit than pickle/unpickle" +msgstr "" + +msgid "" +"When using the *spawn* or *forkserver* start methods many types from :mod:" +"`multiprocessing` need to be picklable so that child processes can use " +"them. However, one should generally avoid sending shared objects to other " +"processes using pipes or queues. Instead you should arrange the program so " +"that a process which needs access to a shared resource created elsewhere can " +"inherit it from an ancestor process." +msgstr "" + +msgid "Avoid terminating processes" +msgstr "" + +msgid "" +"Using the :meth:`Process.terminate ` " +"method to stop a process is liable to cause any shared resources (such as " +"locks, semaphores, pipes and queues) currently being used by the process to " +"become broken or unavailable to other processes." +msgstr "" + +msgid "" +"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" +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.)" +msgstr "" + +msgid "" +"This means that whenever you use a queue you need to make sure that all " +"items which have been put on the queue will eventually be removed before the " +"process is joined. Otherwise you cannot be sure that processes which have " +"put items on the queue will terminate. Remember also that non-daemonic " +"processes will be joined automatically." +msgstr "" + +msgid "An example which will deadlock is the following::" +msgstr "" + +msgid "" +"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" +msgstr "" + +msgid "" +"On Unix using the *fork* start method, a child process can make use of a " +"shared resource created in a parent process using a global resource. " +"However, it is better to pass the object as an argument to the constructor " +"for the child process." +msgstr "" + +msgid "" +"Apart from making the code (potentially) compatible with Windows and the " +"other start methods this also ensures that as long as the child process is " +"still alive the object will not be garbage collected in the parent process. " +"This might be important if some resource is freed when the object is garbage " +"collected in the parent process." +msgstr "" + +msgid "So for instance ::" +msgstr "" + +msgid "should be rewritten as ::" +msgstr "" + +msgid "Beware of replacing :data:`sys.stdin` with a \"file like object\"" +msgstr "" + +msgid ":mod:`multiprocessing` originally unconditionally called::" +msgstr "" + +msgid "" +"in the :meth:`multiprocessing.Process._bootstrap` method --- this resulted " +"in issues with processes-in-processes. This has been changed to::" +msgstr "" + +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." +msgstr "" + +msgid "" +"If you write a file-like object and implement your own caching, you can make " +"it fork-safe by storing the pid whenever you append to the cache, and " +"discarding the cache when the pid changes. For example::" +msgstr "" + +msgid "" +"For more information, see :issue:`5155`, :issue:`5313` and :issue:`5331`" +msgstr "" + +msgid "The *spawn* and *forkserver* start methods" +msgstr "" + +msgid "" +"There are a few extra restrictions which don't apply to the *fork* start " +"method." +msgstr "" + +msgid "More picklability" +msgstr "" + +msgid "" +"Ensure that all arguments to :meth:`Process.__init__` are picklable. Also, " +"if you subclass :class:`~multiprocessing.Process` then make sure that " +"instances will be picklable when the :meth:`Process.start ` method is called." +msgstr "" + +msgid "Global variables" +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." +msgstr "" + +msgid "" +"However, global variables which are just module level constants cause no " +"problems." +msgstr "" + +msgid "Safe importing of main module" +msgstr "" + +msgid "" +"Make sure that the main module can be safely imported by a new Python " +"interpreter without causing unintended side effects (such as starting a new " +"process)." +msgstr "" + +msgid "" +"For example, using the *spawn* or *forkserver* start method running the " +"following module would fail with a :exc:`RuntimeError`::" +msgstr "" + +msgid "" +"Instead one should protect the \"entry point\" of the program by using ``if " +"__name__ == '__main__':`` as follows::" +msgstr "" + +msgid "" +"(The ``freeze_support()`` line can be omitted if the program will be run " +"normally instead of frozen.)" +msgstr "" + +msgid "" +"This allows the newly spawned Python interpreter to safely import the module " +"and then run the module's ``foo()`` function." +msgstr "" + +msgid "" +"Similar restrictions apply if a pool or manager is created in the main " +"module." +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid "Demonstration of how to create and use customized managers and proxies:" +msgstr "" + +msgid "Using :class:`~multiprocessing.pool.Pool`:" +msgstr "" + +msgid "" +"An example showing how to use queues to feed tasks to a collection of worker " +"processes and collect the results:" +msgstr "" diff --git a/library/multiprocessing.shared_memory.po b/library/multiprocessing.shared_memory.po new file mode 100644 index 0000000000..aefdf29cbc --- /dev/null +++ b/library/multiprocessing.shared_memory.po @@ -0,0 +1,298 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:17+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`multiprocessing.shared_memory` --- Shared memory for direct access " +"across processes" +msgstr "" + +msgid "**Source code:** :source:`Lib/multiprocessing/shared_memory.py`" +msgstr "" + +msgid "" +"This module provides a class, :class:`SharedMemory`, for the allocation and " +"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." +msgstr "" + +msgid "" +"In this module, shared memory refers to \"POSIX style\" shared memory blocks " +"(though is not necessarily implemented explicitly as such) and does not " +"refer to \"distributed shared memory\". This style of shared memory permits " +"distinct processes to potentially read and write to a common (or shared) " +"region of volatile memory. Processes are conventionally limited to only " +"have access to their own process memory space but shared memory permits the " +"sharing of data between processes, avoiding the need to instead send " +"messages between processes containing that data. Sharing data directly via " +"memory can provide significant performance benefits compared to sharing data " +"via disk or socket or other communications requiring the serialization/" +"deserialization and copying of data." +msgstr "" + +msgid "" +"Create an instance of the :class:`!SharedMemory` class for either creating a " +"new shared memory block or attaching to an existing shared memory block. " +"Each shared memory block is assigned a unique name. In this way, one process " +"can create a shared memory block with a particular name and a different " +"process can attach to that same shared memory block using that same name." +msgstr "" + +msgid "" +"As a resource for sharing data across processes, shared memory blocks may " +"outlive the original process that created them. When one process no longer " +"needs access to a shared memory block that might still be needed by other " +"processes, the :meth:`close` method should be called. When a shared memory " +"block is no longer needed by any process, the :meth:`unlink` method should " +"be called to ensure proper cleanup." +msgstr "" + +msgid "Parameters" +msgstr "parametry" + +msgid "" +"The unique name for the requested shared memory, specified as a string. When " +"creating a new shared memory block, if ``None`` (the default) is supplied " +"for the name, a novel name will be generated." +msgstr "" + +msgid "" +"Control whether a new shared memory block is created (``True``) or an " +"existing shared memory block is attached (``False``)." +msgstr "" + +msgid "" +"The requested number of bytes when creating a new shared memory block. " +"Because some platforms choose to allocate chunks of memory based upon that " +"platform's memory page size, the exact size of the shared memory block may " +"be larger or equal to the size requested. When attaching to an existing " +"shared memory block, the *size* parameter is ignored." +msgstr "" + +msgid "" +"Close access to the shared memory from this instance. In order to ensure " +"proper cleanup of resources, all instances should call :meth:`close` once " +"the instance is no longer needed. Note that calling :meth:`!close` does not " +"cause the shared memory block itself to be destroyed." +msgstr "" + +msgid "" +"Request that the underlying shared memory block be destroyed. In order to " +"ensure proper cleanup of resources, :meth:`unlink` should be called once " +"(and only once) across all processes which have need for the shared memory " +"block. After requesting its destruction, a shared memory block may or may " +"not be immediately destroyed and this behavior may differ across platforms. " +"Attempts to access data inside the shared memory block after :meth:`!unlink` " +"has been called may result in memory access errors. Note: the last process " +"relinquishing its hold on a shared memory block may call :meth:`!unlink` " +"and :meth:`close` in either order." +msgstr "" + +msgid "A memoryview of contents of the shared memory block." +msgstr "" + +msgid "Read-only access to the unique name of the shared memory block." +msgstr "" + +msgid "Read-only access to size in bytes of the shared memory block." +msgstr "" + +msgid "" +"The following example demonstrates low-level use of :class:`SharedMemory` " +"instances::" +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:" +msgstr "" + +msgid "" +"A subclass of :class:`multiprocessing.managers.BaseManager` which can be " +"used for the management of shared memory blocks across processes." +msgstr "" + +msgid "" +"A call to :meth:`~multiprocessing.managers.BaseManager.start` on a :class:`!" +"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." +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." +msgstr "" + +msgid "" +"Refer to :class:`~multiprocessing.managers.BaseManager` for a description of " +"the inherited *address* and *authkey* optional input arguments and how they " +"may be used to connect to an existing :class:`!SharedMemoryManager` service " +"from other processes." +msgstr "" + +msgid "" +"Create and return a new :class:`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*." +msgstr "" + +msgid "" +"The following example demonstrates the basic mechanisms of a :class:" +"`~multiprocessing.managers.SharedMemoryManager`:" +msgstr "" + +msgid "" +"The following example depicts a potentially more convenient pattern for " +"using :class:`~multiprocessing.managers.SharedMemoryManager` objects via " +"the :keyword:`with` statement to ensure that all shared memory blocks are " +"released after they are no longer needed:" +msgstr "" + +msgid "" +"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 "" + +msgid "" +"Provide a mutable list-like object where all values stored within are stored " +"in a shared memory block. This constrains storable values to the following " +"built-in data types:" +msgstr "" + +msgid ":class:`int` (signed 64-bit)" +msgstr "" + +msgid ":class:`float`" +msgstr ":class:`float`" + +msgid ":class:`bool`" +msgstr ":class:`bool`" + +msgid ":class:`str` (less than 10M bytes each when encoded as UTF-8)" +msgstr "" + +msgid ":class:`bytes` (less than 10M bytes each)" +msgstr "" + +msgid "``None``" +msgstr "``None`` - z ang. - ``Żaden``" + +msgid "" +"It also notably differs from the built-in :class:`list` type in that these " +"lists can not change their overall length (i.e. no :meth:`!append`, :meth:`!" +"insert`, etc.) and do not support the dynamic creation of new :class:`!" +"ShareableList` instances via slicing." +msgstr "" + +msgid "" +"*sequence* is used in populating a new :class:`!ShareableList` full of " +"values. Set to ``None`` to instead attach to an already existing :class:`!" +"ShareableList` by its unique shared memory name." +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``." +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 " +"future. See :gh:`106939`." +msgstr "" + +msgid "" +"For applications where rstripping of trailing nulls is a problem, work " +"around it by always unconditionally appending an extra non-0 byte to the end " +"of such values when storing and unconditionally removing it when fetching:" +msgstr "" + +msgid "Return the number of occurrences of *value*." +msgstr "" + +msgid "" +"Return first index position of *value*. Raise :exc:`ValueError` if *value* " +"is not present." +msgstr "" + +msgid "" +"Read-only attribute containing the :mod:`struct` packing format used by all " +"currently stored values." +msgstr "" + +msgid "The :class:`SharedMemory` instance where the values are stored." +msgstr "" + +msgid "" +"The following example demonstrates basic use of a :class:`ShareableList` " +"instance:" +msgstr "" + +msgid "" +"The following example depicts how one, two, or many processes may access the " +"same :class:`ShareableList` by supplying the name of the shared memory block " +"behind it:" +msgstr "" + +msgid "" +"The following examples demonstrates that :class:`ShareableList` (and " +"underlying :class:`SharedMemory`) objects can be pickled and unpickled if " +"needed. Note, that it will still be the same shared object. This happens, " +"because the deserialized object has the same unique name and is just " +"attached to an existing object with the same name (if the object is still " +"alive):" +msgstr "" + +msgid "Shared Memory" +msgstr "" + +msgid "POSIX Shared Memory" +msgstr "" + +msgid "Named Shared Memory" +msgstr "" diff --git a/library/numeric.po b/library/numeric.po index 7ca86e6327..765de57199 100644 --- a/library/numeric.po +++ b/library/numeric.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/operator.po b/library/operator.po new file mode 100644 index 0000000000..4cc66a2da0 --- /dev/null +++ b/library/operator.po @@ -0,0 +1,645 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`operator` --- Standard operators as functions" +msgstr "" + +msgid "**Source code:** :source:`Lib/operator.py`" +msgstr "" + +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." +msgstr "" + +msgid "" +"The functions fall into categories that perform object comparisons, logical " +"operations, mathematical operations and sequence operations." +msgstr "" + +msgid "" +"The object comparison functions are useful for all objects, and are named " +"after the rich comparison operators they support:" +msgstr "" + +msgid "" +"Perform \"rich comparisons\" between *a* and *b*. Specifically, ``lt(a, b)`` " +"is equivalent to ``a < b``, ``le(a, b)`` is equivalent to ``a <= b``, " +"``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." +msgstr "" + +msgid "" +"The logical operations are also generally applicable to all objects, and " +"support truth tests, identity tests, and boolean operations:" +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.)" +msgstr "" + +msgid "" +"Return :const:`True` if *obj* is true, and :const:`False` otherwise. This " +"is equivalent to using the :class:`bool` constructor." +msgstr "" + +msgid "Return ``a is b``. Tests object identity." +msgstr "" + +msgid "Return ``a is not b``. Tests object identity." +msgstr "" + +msgid "The mathematical and bitwise operations are the most numerous:" +msgstr "" + +msgid "Return the absolute value of *obj*." +msgstr "" + +msgid "Return ``a + b``, for *a* and *b* numbers." +msgstr "" + +msgid "Return the bitwise and of *a* and *b*." +msgstr "" + +msgid "Return ``a // b``." +msgstr "" + +msgid "Return *a* converted to an integer. Equivalent to ``a.__index__()``." +msgstr "" + +msgid "" +"The result always has exact type :class:`int`. Previously, the result could " +"have been an instance of a subclass of ``int``." +msgstr "" + +msgid "" +"Return the bitwise inverse of the number *obj*. This is equivalent to " +"``~obj``." +msgstr "" + +msgid "Return *a* shifted left by *b*." +msgstr "" + +msgid "Return ``a % b``." +msgstr "" + +msgid "Return ``a * b``, for *a* and *b* numbers." +msgstr "" + +msgid "Return ``a @ b``." +msgstr "" + +msgid "Return *obj* negated (``-obj``)." +msgstr "" + +msgid "Return the bitwise or of *a* and *b*." +msgstr "" + +msgid "Return *obj* positive (``+obj``)." +msgstr "" + +msgid "Return ``a ** b``, for *a* and *b* numbers." +msgstr "" + +msgid "Return *a* shifted right by *b*." +msgstr "" + +msgid "Return ``a - b``." +msgstr "" + +msgid "" +"Return ``a / b`` where 2/3 is .66 rather than 0. This is also known as " +"\"true\" division." +msgstr "" + +msgid "Return the bitwise exclusive or of *a* and *b*." +msgstr "" + +msgid "" +"Operations which work with sequences (some of them with mappings too) " +"include:" +msgstr "" + +msgid "Return ``a + b`` for *a* and *b* sequences." +msgstr "" + +msgid "Return the outcome of the test ``b in a``. Note the reversed operands." +msgstr "" + +msgid "Return the number of occurrences of *b* in *a*." +msgstr "" + +msgid "Remove the value of *a* at index *b*." +msgstr "" + +msgid "Return the value of *a* at index *b*." +msgstr "" + +msgid "Return the index of the first of occurrence of *b* in *a*." +msgstr "" + +msgid "Set the value of *a* at index *b* to *c*." +msgstr "" + +msgid "" +"Return an estimated length for the object *obj*. First try to return its " +"actual length, then an estimate using :meth:`object.__length_hint__`, and " +"finally return the default value." +msgstr "" + +msgid "The following operation works with callables:" +msgstr "" + +msgid "Return ``obj(*args, **kwargs)``." +msgstr "" + +msgid "" +"The :mod:`operator` module also defines tools for generalized attribute and " +"item lookups. These are useful for making fast field extractors as " +"arguments for :func:`map`, :func:`sorted`, :meth:`itertools.groupby`, or " +"other functions that expect a function argument." +msgstr "" + +msgid "" +"Return a callable object that fetches *attr* from its operand. If more than " +"one attribute is requested, returns a tuple of attributes. The attribute " +"names can also contain dots. For example:" +msgstr "" + +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)``." +msgstr "" + +msgid "" +"After ``f = attrgetter('name.first', 'name.last')``, the call ``f(b)`` " +"returns ``(b.name.first, b.name.last)``." +msgstr "" + +msgid "Equivalent to::" +msgstr "Odpowiednik::" + +msgid "" +"Return a callable object that fetches *item* from its operand using the " +"operand's :meth:`~object.__getitem__` method. If multiple items are " +"specified, returns a tuple of lookup values. For example:" +msgstr "" + +msgid "After ``f = itemgetter(2)``, the call ``f(r)`` returns ``r[2]``." +msgstr "" + +msgid "" +"After ``g = itemgetter(2, 5, 3)``, the call ``g(r)`` returns ``(r[2], r[5], " +"r[3])``." +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:" +msgstr "" + +msgid "" +"Example of using :func:`itemgetter` to retrieve specific fields from a tuple " +"record:" +msgstr "" + +msgid "" +"Return a callable object that calls the method *name* on its operand. If " +"additional arguments and/or keyword arguments are given, they will be given " +"to the method as well. For example:" +msgstr "" + +msgid "" +"After ``f = methodcaller('name')``, the call ``f(b)`` returns ``b.name()``." +msgstr "" + +msgid "" +"After ``f = methodcaller('name', 'foo', bar=1)``, the call ``f(b)`` returns " +"``b.name('foo', bar=1)``." +msgstr "" + +msgid "Mapping Operators to Functions" +msgstr "" + +msgid "" +"This table shows how abstract operations correspond to operator symbols in " +"the Python syntax and the functions in the :mod:`operator` module." +msgstr "" + +msgid "Operation" +msgstr "" + +msgid "Syntax" +msgstr "" + +msgid "Function" +msgstr "Funkcja" + +msgid "Addition" +msgstr "" + +msgid "``a + b``" +msgstr "``a + b``" + +msgid "``add(a, b)``" +msgstr "``add(a, b)``" + +msgid "Concatenation" +msgstr "" + +msgid "``seq1 + seq2``" +msgstr "" + +msgid "``concat(seq1, seq2)``" +msgstr "``concat(seq1, seq2)``" + +msgid "Containment Test" +msgstr "" + +msgid "``obj in seq``" +msgstr "" + +msgid "``contains(seq, obj)``" +msgstr "``contains(seq, obj)``" + +msgid "Division" +msgstr "" + +msgid "``a / b``" +msgstr "``a / b``" + +msgid "``truediv(a, b)``" +msgstr "``truediv(a, b)``" + +msgid "``a // b``" +msgstr "``a // b``" + +msgid "``floordiv(a, b)``" +msgstr "``floordiv(a, b)``" + +msgid "Bitwise And" +msgstr "" + +msgid "``a & b``" +msgstr "``a & b``" + +msgid "``and_(a, b)``" +msgstr "``and_(a, b)``" + +msgid "Bitwise Exclusive Or" +msgstr "" + +msgid "``a ^ b``" +msgstr "``a ^ b``" + +msgid "``xor(a, b)``" +msgstr "``xor(a, b)``" + +msgid "Bitwise Inversion" +msgstr "" + +msgid "``~ a``" +msgstr "``~ a``" + +msgid "``invert(a)``" +msgstr "``invert(a)``" + +msgid "Bitwise Or" +msgstr "" + +msgid "``a | b``" +msgstr "``a | b``" + +msgid "``or_(a, b)``" +msgstr "``or_(a, b)``" + +msgid "Exponentiation" +msgstr "" + +msgid "``a ** b``" +msgstr "``a ** b``" + +msgid "``pow(a, b)``" +msgstr "``pow(a, b)``" + +msgid "Identity" +msgstr "" + +msgid "``a is b``" +msgstr "``a is b``" + +msgid "``is_(a, b)``" +msgstr "``is_(a, b)``" + +msgid "``a is not b``" +msgstr "" + +msgid "``is_not(a, b)``" +msgstr "``is_not(a, b)``" + +msgid "Indexed Assignment" +msgstr "" + +msgid "``obj[k] = v``" +msgstr "``obj[k] = v``" + +msgid "``setitem(obj, k, v)``" +msgstr "``setitem(obj, k, v)``" + +msgid "Indexed Deletion" +msgstr "" + +msgid "``del obj[k]``" +msgstr "``del obj[k]``" + +msgid "``delitem(obj, k)``" +msgstr "``delitem(obj, k)``" + +msgid "Indexing" +msgstr "" + +msgid "``obj[k]``" +msgstr "``obj[k]``" + +msgid "``getitem(obj, k)``" +msgstr "``getitem(obj, k)``" + +msgid "Left Shift" +msgstr "" + +msgid "``a << b``" +msgstr "``a << b``" + +msgid "``lshift(a, b)``" +msgstr "``lshift(a, b)``" + +msgid "Modulo" +msgstr "" + +msgid "``a % b``" +msgstr "``a % b``" + +msgid "``mod(a, b)``" +msgstr "``mod(a, b)``" + +msgid "Multiplication" +msgstr "" + +msgid "``a * b``" +msgstr "``a * b``" + +msgid "``mul(a, b)``" +msgstr "``mul(a, b)``" + +msgid "Matrix Multiplication" +msgstr "" + +msgid "``a @ b``" +msgstr "``a @ b``" + +msgid "``matmul(a, b)``" +msgstr "``matmul(a, b)``" + +msgid "Negation (Arithmetic)" +msgstr "" + +msgid "``- a``" +msgstr "``- a``" + +msgid "``neg(a)``" +msgstr "``neg(a)``" + +msgid "Negation (Logical)" +msgstr "" + +msgid "``not a``" +msgstr "``not a``" + +msgid "``not_(a)``" +msgstr "``not_(a)``" + +msgid "Positive" +msgstr "" + +msgid "``+ a``" +msgstr "``+ a``" + +msgid "``pos(a)``" +msgstr "``pos(a)``" + +msgid "Right Shift" +msgstr "" + +msgid "``a >> b``" +msgstr "``a >> b``" + +msgid "``rshift(a, b)``" +msgstr "``rshift(a, b)``" + +msgid "Slice Assignment" +msgstr "" + +msgid "``seq[i:j] = values``" +msgstr "``seq[i:j] = values``" + +msgid "``setitem(seq, slice(i, j), values)``" +msgstr "" + +msgid "Slice Deletion" +msgstr "" + +msgid "``del seq[i:j]``" +msgstr "``del seq[i:j]``" + +msgid "``delitem(seq, slice(i, j))``" +msgstr "``delitem(seq, slice(i, j))``" + +msgid "Slicing" +msgstr "" + +msgid "``seq[i:j]``" +msgstr "``seq[i:j]``" + +msgid "``getitem(seq, slice(i, j))``" +msgstr "``getitem(seq, slice(i, j))``" + +msgid "String Formatting" +msgstr "" + +msgid "``s % obj``" +msgstr "``s % obj``" + +msgid "``mod(s, obj)``" +msgstr "``mod(s, obj)``" + +msgid "Subtraction" +msgstr "" + +msgid "``a - b``" +msgstr "``a - b``" + +msgid "``sub(a, b)``" +msgstr "``sub(a, b)``" + +msgid "Truth Test" +msgstr "" + +msgid "``obj``" +msgstr "``obj``" + +msgid "``truth(obj)``" +msgstr "``truth(obj)``" + +msgid "Ordering" +msgstr "" + +msgid "``a < b``" +msgstr "``a < b``" + +msgid "``lt(a, b)``" +msgstr "``lt(a, b)``" + +msgid "``a <= b``" +msgstr "``a <= b``" + +msgid "``le(a, b)``" +msgstr "``le(a, b)``" + +msgid "Equality" +msgstr "" + +msgid "``a == b``" +msgstr "``a == b``" + +msgid "``eq(a, b)``" +msgstr "``eq(a, b)``" + +msgid "Difference" +msgstr "" + +msgid "``a != b``" +msgstr "``a != b``" + +msgid "``ne(a, b)``" +msgstr "``ne(a, b)``" + +msgid "``a >= b``" +msgstr "``a >= b``" + +msgid "``ge(a, b)``" +msgstr "``ge(a, b)``" + +msgid "``a > b``" +msgstr "``a > b``" + +msgid "``gt(a, b)``" +msgstr "``gt(a, b)``" + +msgid "In-place Operators" +msgstr "" + +msgid "" +"Many operations have an \"in-place\" version. Listed below are functions " +"providing a more primitive access to in-place operators than the usual " +"syntax does; for example, the :term:`statement` ``x += y`` is equivalent to " +"``x = operator.iadd(x, y)``. Another way to put it is to say that ``z = " +"operator.iadd(x, y)`` is equivalent to the compound statement ``z = x; z += " +"y``." +msgstr "" + +msgid "" +"In those examples, note that when an in-place method is called, the " +"computation and assignment are performed in two separate steps. The in-" +"place functions listed below only do the first step, calling the in-place " +"method. The second step, assignment, is not handled." +msgstr "" + +msgid "" +"For immutable targets such as strings, numbers, and tuples, the updated " +"value is computed, but not assigned back to the input variable:" +msgstr "" + +msgid "" +"For mutable targets such as lists and dictionaries, the in-place method will " +"perform the update, so no subsequent assignment is necessary:" +msgstr "" + +msgid "``a = iadd(a, b)`` is equivalent to ``a += b``." +msgstr "" + +msgid "``a = iand(a, b)`` is equivalent to ``a &= b``." +msgstr "" + +msgid "" +"``a = iconcat(a, b)`` is equivalent to ``a += b`` for *a* and *b* sequences." +msgstr "" + +msgid "``a = ifloordiv(a, b)`` is equivalent to ``a //= b``." +msgstr "" + +msgid "``a = ilshift(a, b)`` is equivalent to ``a <<= b``." +msgstr "" + +msgid "``a = imod(a, b)`` is equivalent to ``a %= b``." +msgstr "" + +msgid "``a = imul(a, b)`` is equivalent to ``a *= b``." +msgstr "" + +msgid "``a = imatmul(a, b)`` is equivalent to ``a @= b``." +msgstr "" + +msgid "``a = ior(a, b)`` is equivalent to ``a |= b``." +msgstr "" + +msgid "``a = ipow(a, b)`` is equivalent to ``a **= b``." +msgstr "" + +msgid "``a = irshift(a, b)`` is equivalent to ``a >>= b``." +msgstr "" + +msgid "``a = isub(a, b)`` is equivalent to ``a -= b``." +msgstr "" + +msgid "``a = itruediv(a, b)`` is equivalent to ``a /= b``." +msgstr "" + +msgid "``a = ixor(a, b)`` is equivalent to ``a ^= b``." +msgstr "" diff --git a/library/optparse.po b/library/optparse.po new file mode 100644 index 0000000000..066bd39a1b --- /dev/null +++ b/library/optparse.po @@ -0,0 +1,2067 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2024 +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`optparse` --- Parser for command line options" +msgstr "" + +msgid "**Source code:** :source:`Lib/optparse.py`" +msgstr "" + +msgid "" +"The :mod:`optparse` module is deprecated and will not be developed further; " +"development will continue with the :mod:`argparse` module." +msgstr "" + +msgid "" +":mod:`optparse` is a more convenient, flexible, and powerful library for " +"parsing command-line options than the old :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::" +msgstr "" + +msgid "" +"With these few lines of code, users of your script can now do the \"usual " +"thing\" on the command-line, for example::" +msgstr "" + +msgid "" +"As it parses the command line, :mod:`optparse` sets attributes of the " +"``options`` object returned by :meth:`~OptionParser.parse_args` based on " +"user-supplied command-line values. When :meth:`~OptionParser.parse_args` " +"returns from parsing this command line, ``options.filename`` will be " +"``\"outfile\"`` and ``options.verbose`` will be ``False``. :mod:`optparse` " +"supports both long and short options, allows short options to be merged " +"together, and allows options to be associated with their arguments in a " +"variety of ways. Thus, the following command lines are all equivalent to " +"the above example::" +msgstr "" + +msgid "Additionally, users can run one of the following ::" +msgstr "" + +msgid "" +"and :mod:`optparse` will print out a brief summary of your script's options:" +msgstr "" + +msgid "" +"where the value of *yourscript* is determined at runtime (normally from " +"``sys.argv[0]``)." +msgstr "" + +msgid "Background" +msgstr "" + +msgid "" +":mod:`optparse` was explicitly designed to encourage the creation of " +"programs with straightforward, conventional command-line interfaces. To " +"that end, it supports only the most common command-line syntax and semantics " +"conventionally used under Unix. If you are unfamiliar with these " +"conventions, read this section to acquaint yourself with them." +msgstr "" + +msgid "Terminology" +msgstr "" + +msgid "argument" +msgstr "argument" + +msgid "" +"a string entered on the command-line, and passed by the shell to ``execl()`` " +"or ``execv()``. In Python, arguments are elements of ``sys.argv[1:]`` " +"(``sys.argv[0]`` is the name of the program being executed). Unix shells " +"also use the term \"word\"." +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:]``\"." +msgstr "" + +msgid "option" +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-" +"separated words, e.g. ``--file`` or ``--dry-run``. These are the only two " +"option syntaxes provided by :mod:`optparse`." +msgstr "" + +msgid "Some other option syntaxes that the world has seen include:" +msgstr "" + +msgid "" +"a hyphen followed by a few letters, e.g. ``-pf`` (this is *not* the same as " +"multiple options merged into a single argument)" +msgstr "" + +msgid "" +"a hyphen followed by a whole word, e.g. ``-file`` (this is technically " +"equivalent to the previous syntax, but they aren't usually seen in the same " +"program)" +msgstr "" + +msgid "" +"a plus sign followed by a single letter, or a few letters, or a word, e.g. " +"``+f``, ``+rgb``" +msgstr "" + +msgid "" +"a slash followed by a letter, or a few letters, or a word, e.g. ``/f``, ``/" +"file``" +msgstr "" + +msgid "" +"These option syntaxes are not supported by :mod:`optparse`, and they never " +"will be. This is deliberate: the first three are non-standard on any " +"environment, and the last only makes sense if you're exclusively targeting " +"Windows or certain legacy platforms (e.g. VMS, MS-DOS)." +msgstr "" + +msgid "option argument" +msgstr "" + +msgid "" +"an argument that follows an option, is closely associated with that option, " +"and is consumed from the argument list when that option is. With :mod:" +"`optparse`, option arguments may either be in a separate argument from their " +"option:" +msgstr "" + +msgid "or included in the same argument:" +msgstr "" + +msgid "" +"Typically, a given option either takes an argument or it doesn't. Lots of " +"people want an \"optional option arguments\" feature, meaning that some " +"options will take an argument if they see it, and won't if they don't. This " +"is somewhat controversial, because it makes parsing ambiguous: if ``-a`` " +"takes an optional argument and ``-b`` is another option entirely, how do we " +"interpret ``-ab``? Because of this ambiguity, :mod:`optparse` does not " +"support this feature." +msgstr "" + +msgid "positional argument" +msgstr "" + +msgid "" +"something leftover in the argument list after options have been parsed, i.e. " +"after options and their arguments have been parsed and removed from the " +"argument list." +msgstr "" + +msgid "required option" +msgstr "" + +msgid "" +"an option that must be supplied on the command-line; note that the phrase " +"\"required option\" is self-contradictory in English. :mod:`optparse` " +"doesn't prevent you from implementing required options, but doesn't give you " +"much help at it either." +msgstr "" + +msgid "For example, consider this hypothetical command-line::" +msgstr "" + +msgid "" +"``-v`` and ``--report`` are both options. Assuming that ``--report`` takes " +"one argument, ``report.txt`` is an option argument. ``foo`` and ``bar`` are " +"positional arguments." +msgstr "" + +msgid "What are options for?" +msgstr "" + +msgid "" +"Options are used to provide extra information to tune or customize the " +"execution of a program. In case it wasn't clear, options are usually " +"*optional*. A program should be able to run just fine with no options " +"whatsoever. (Pick a random program from the Unix or GNU toolsets. Can it " +"run without any options at all and still make sense? The main exceptions " +"are ``find``, ``tar``, and ``dd``\\ ---all of which are mutant oddballs that " +"have been rightly criticized for their non-standard syntax and confusing " +"interfaces.)" +msgstr "" + +msgid "" +"Lots of people want their programs to have \"required options\". Think " +"about it. If it's required, then it's *not optional*! If there is a piece " +"of information that your program absolutely requires in order to run " +"successfully, that's what positional arguments are for." +msgstr "" + +msgid "" +"As an example of good command-line interface design, consider the humble " +"``cp`` utility, for copying files. It doesn't make much sense to try to " +"copy files without supplying a destination and at least one source. Hence, " +"``cp`` fails if you run it with no arguments. However, it has a flexible, " +"useful syntax that does not require any options at all::" +msgstr "" + +msgid "" +"You can get pretty far with just that. Most ``cp`` implementations provide " +"a bunch of options to tweak exactly how the files are copied: you can " +"preserve mode and modification time, avoid following symlinks, ask before " +"clobbering existing files, etc. But none of this distracts from the core " +"mission of ``cp``, which is to copy either one file to another, or several " +"files to another directory." +msgstr "" + +msgid "What are positional arguments for?" +msgstr "" + +msgid "" +"Positional arguments are for those pieces of information that your program " +"absolutely, positively requires to run." +msgstr "" + +msgid "" +"A good user interface should have as few absolute requirements as possible. " +"If your program requires 17 distinct pieces of information in order to run " +"successfully, it doesn't much matter *how* you get that information from the " +"user---most people will give up and walk away before they successfully run " +"the program. This applies whether the user interface is a command-line, a " +"configuration file, or a GUI: if you make that many demands on your users, " +"most of them will simply give up." +msgstr "" + +msgid "" +"In short, try to minimize the amount of information that users are " +"absolutely required to supply---use sensible defaults whenever possible. Of " +"course, you also want to make your programs reasonably flexible. That's " +"what options are for. Again, it doesn't matter if they are entries in a " +"config file, widgets in the \"Preferences\" dialog of a GUI, or command-line " +"options---the more options you implement, the more flexible your program is, " +"and the more complicated its implementation becomes. Too much flexibility " +"has drawbacks as well, of course; too many options can overwhelm users and " +"make your code much harder to maintain." +msgstr "" + +msgid "Tutorial" +msgstr "Tutorial" + +msgid "" +"While :mod:`optparse` is quite flexible and powerful, it's also " +"straightforward to use in most cases. This section covers the code patterns " +"that are common to any :mod:`optparse`\\ -based program." +msgstr "" + +msgid "" +"First, you need to import the OptionParser class; then, early in the main " +"program, create an OptionParser instance::" +msgstr "" + +msgid "Then you can start defining options. The basic syntax is::" +msgstr "" + +msgid "" +"Each option has one or more option strings, such as ``-f`` or ``--file``, " +"and several option attributes that tell :mod:`optparse` what to expect and " +"what to do when it encounters that option on the command line." +msgstr "" + +msgid "" +"Typically, each option will have one short option string and one long option " +"string, e.g.::" +msgstr "" + +msgid "" +"You're free to define as many short option strings and as many long option " +"strings as you like (including zero), as long as there is at least one " +"option string overall." +msgstr "" + +msgid "" +"The option strings passed to :meth:`OptionParser.add_option` are effectively " +"labels for the option defined by that call. For brevity, we will frequently " +"refer to *encountering an option* on the command line; in reality, :mod:" +"`optparse` encounters *option strings* and looks up options from them." +msgstr "" + +msgid "" +"Once all of your options are defined, instruct :mod:`optparse` to parse your " +"program's command line::" +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:]``.)" +msgstr "" + +msgid ":meth:`~OptionParser.parse_args` returns two values:" +msgstr "" + +msgid "" +"``options``, an object containing values for all of your options---e.g. if " +"``--file`` takes a single string argument, then ``options.file`` will be the " +"filename supplied by the user, or ``None`` if the user did not supply that " +"option" +msgstr "" + +msgid "" +"``args``, the list of positional arguments leftover after parsing options" +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." +msgstr "" + +msgid "Understanding option actions" +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``." +msgstr "" + +msgid "" +"If you don't specify an option action, :mod:`optparse` defaults to ``store``." +msgstr "" + +msgid "The store action" +msgstr "" + +msgid "" +"The most common option action is ``store``, which tells :mod:`optparse` to " +"take the next argument (or the remainder of the current argument), ensure " +"that it is of the correct type, and store it to your chosen destination." +msgstr "" + +msgid "For example::" +msgstr "Dla przykładu::" + +msgid "" +"Now let's make up a fake command line and ask :mod:`optparse` to parse it::" +msgstr "" + +msgid "" +"When :mod:`optparse` sees the option string ``-f``, it consumes the next " +"argument, ``foo.txt``, and stores it in ``options.filename``. So, after " +"this call to :meth:`~OptionParser.parse_args`, ``options.filename`` is " +"``\"foo.txt\"``." +msgstr "" + +msgid "" +"Some other option types supported by :mod:`optparse` are ``int`` and " +"``float``. Here's an option that expects an integer argument::" +msgstr "" + +msgid "" +"Note that this option has no long option string, which is perfectly " +"acceptable. Also, there's no explicit action, since the default is ``store``." +msgstr "" + +msgid "" +"Let's parse another fake command-line. This time, we'll jam the option " +"argument right up against the option: since ``-n42`` (one argument) is " +"equivalent to ``-n 42`` (two arguments), the code ::" +msgstr "" + +msgid "will print ``42``." +msgstr "" + +msgid "" +"If you don't specify a type, :mod:`optparse` assumes ``string``. Combined " +"with the fact that the default action is ``store``, that means our first " +"example can be a lot shorter::" +msgstr "" + +msgid "" +"If you don't supply a destination, :mod:`optparse` figures out a sensible " +"default from the option strings: if the first long option string is ``--foo-" +"bar``, then the default destination is ``foo_bar``. If there are no long " +"option strings, :mod:`optparse` looks at the first short option string: the " +"default destination for ``-f`` is ``f``." +msgstr "" + +msgid "" +":mod:`optparse` also includes the built-in ``complex`` type. Adding types " +"is covered in section :ref:`optparse-extending-optparse`." +msgstr "" + +msgid "Handling boolean (flag) options" +msgstr "" + +msgid "" +"Flag options---set a variable to true or false when a particular option is " +"seen---are quite common. :mod:`optparse` supports them with two separate " +"actions, ``store_true`` and ``store_false``. For example, you might have a " +"``verbose`` flag that is turned on with ``-v`` and off with ``-q``::" +msgstr "" + +msgid "" +"Here we have two different options with the same destination, which is " +"perfectly OK. (It just means you have to be a bit careful when setting " +"default values---see below.)" +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``." +msgstr "" + +msgid "Other actions" +msgstr "" + +msgid "Some other actions supported by :mod:`optparse` are:" +msgstr "" + +msgid "``\"store_const\"``" +msgstr "" + +msgid "store a constant value, pre-set via :attr:`Option.const`" +msgstr "" + +msgid "``\"append\"``" +msgstr "" + +msgid "append this option's argument to a list" +msgstr "" + +msgid "``\"count\"``" +msgstr "" + +msgid "increment a counter by one" +msgstr "" + +msgid "``\"callback\"``" +msgstr "" + +msgid "call a specified function" +msgstr "" + +msgid "" +"These are covered in section :ref:`optparse-reference-guide`, and section :" +"ref:`optparse-option-callbacks`." +msgstr "" + +msgid "Default values" +msgstr "" + +msgid "" +"All of the above examples involve setting some variable (the " +"\"destination\") when certain command-line options are seen. What happens " +"if those options are never seen? Since we didn't supply any defaults, they " +"are all set to ``None``. This is usually fine, but sometimes you want more " +"control. :mod:`optparse` lets you supply a default value for each " +"destination, which is assigned before the command line is parsed." +msgstr "" + +msgid "" +"First, consider the verbose/quiet example. If we want :mod:`optparse` to " +"set ``verbose`` to ``True`` unless ``-q`` is seen, then we can do this::" +msgstr "" + +msgid "" +"Since default values apply to the *destination* rather than to any " +"particular option, and these two options happen to have the same " +"destination, this is exactly equivalent::" +msgstr "" + +msgid "Consider this::" +msgstr "" + +msgid "" +"Again, the default value for ``verbose`` will be ``True``: the last default " +"value supplied for any particular destination is the one that counts." +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`::" +msgstr "" + +msgid "" +"As before, the last value specified for a given option destination is the " +"one that counts. For clarity, try to use one method or the other of setting " +"default values, not both." +msgstr "" + +msgid "Generating help" +msgstr "" + +msgid "" +":mod:`optparse`'s ability to generate help and usage text automatically is " +"useful for creating user-friendly command-line interfaces. All you have to " +"do is supply a :attr:`~Option.help` value for each option, and optionally a " +"short usage message for your whole program. Here's an OptionParser " +"populated with user-friendly (documented) options::" +msgstr "" + +msgid "" +"If :mod:`optparse` encounters either ``-h`` or ``--help`` on the command-" +"line, or if you just call :meth:`parser.print_help`, it prints the following " +"to standard output:" +msgstr "" + +msgid "" +"(If the help output is triggered by a help option, :mod:`optparse` exits " +"after printing the help text.)" +msgstr "" + +msgid "" +"There's a lot going on here to help :mod:`optparse` generate the best " +"possible help message:" +msgstr "" + +msgid "the script defines its own usage message::" +msgstr "" + +msgid "" +":mod:`optparse` expands ``%prog`` in the usage string to the name of the " +"current program, i.e. ``os.path.basename(sys.argv[0])``. The expanded " +"string is then printed before the detailed option help." +msgstr "" + +msgid "" +"If you don't supply a usage string, :mod:`optparse` uses a bland but " +"sensible default: ``\"Usage: %prog [options]\"``, which is fine if your " +"script doesn't take any positional arguments." +msgstr "" + +msgid "" +"every option defines a help string, and doesn't worry about line-wrapping---" +"\\ :mod:`optparse` takes care of wrapping lines and making the help output " +"look good." +msgstr "" + +msgid "" +"options that take a value indicate this fact in their automatically " +"generated help message, e.g. for the \"mode\" option::" +msgstr "" + +msgid "" +"Here, \"MODE\" is called the meta-variable: it stands for the argument that " +"the user is expected to supply to ``-m``/``--mode``. By default, :mod:" +"`optparse` converts the destination variable name to uppercase and uses that " +"for the meta-variable. Sometimes, that's not what you want---for example, " +"the ``--filename`` option explicitly sets ``metavar=\"FILE\"``, resulting in " +"this automatically generated option description::" +msgstr "" + +msgid "" +"This is important for more than just saving space, though: the manually " +"written help text uses the meta-variable ``FILE`` to clue the user in that " +"there's a connection between the semi-formal syntax ``-f FILE`` and the " +"informal semantic description \"write output to FILE\". This is a simple but " +"effective way to make your help text a lot clearer and more useful for end " +"users." +msgstr "" + +msgid "" +"options that have a default value can include ``%default`` in the help " +"string---\\ :mod:`optparse` will replace it with :func:`str` of the option's " +"default value. If an option has no default value (or the default value is " +"``None``), ``%default`` expands to ``none``." +msgstr "" + +msgid "Grouping Options" +msgstr "" + +msgid "" +"When dealing with many options, it is convenient to group these options for " +"better help output. An :class:`OptionParser` can contain several option " +"groups, each of which can contain several options." +msgstr "" + +msgid "An option group is obtained using the class :class:`OptionGroup`:" +msgstr "" + +msgid "where" +msgstr "" + +msgid "" +"parser is the :class:`OptionParser` instance the group will be inserted in to" +msgstr "" + +msgid "title is the group title" +msgstr "" + +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." +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." +msgstr "" + +msgid "" +"Continuing with the parser defined in the previous section, adding an :class:" +"`OptionGroup` to a parser is easy::" +msgstr "" + +msgid "This would result in the following help output:" +msgstr "" + +msgid "" +"A bit more complete example might involve using more than one group: still " +"extending the previous example::" +msgstr "" + +msgid "that results in the following output:" +msgstr "" + +msgid "" +"Another interesting method, in particular when working programmatically with " +"option groups is:" +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``." +msgstr "" + +msgid "Printing a version string" +msgstr "" + +msgid "" +"Similar to the brief usage string, :mod:`optparse` can also print a version " +"string for your program. You have to supply the string as the ``version`` " +"argument to OptionParser::" +msgstr "" + +msgid "" +"``%prog`` is expanded just like it is in ``usage``. Apart from that, " +"``version`` can contain anything you like. When you supply it, :mod:" +"`optparse` automatically adds a ``--version`` option to your parser. If it " +"encounters this option on the command line, it expands your ``version`` " +"string (by replacing ``%prog``), prints it to stdout, and exits." +msgstr "" + +msgid "For example, if your script is called ``/usr/bin/foo``:" +msgstr "" + +msgid "" +"The following two methods can be used to print and get the ``version`` " +"string:" +msgstr "" + +msgid "" +"Print the version message for the current program (``self.version``) to " +"*file* (default stdout). As with :meth:`print_usage`, any occurrence of " +"``%prog`` in ``self.version`` is replaced with the name of the current " +"program. Does nothing if ``self.version`` is empty or undefined." +msgstr "" + +msgid "" +"Same as :meth:`print_version` but returns the version string instead of " +"printing it." +msgstr "" + +msgid "How :mod:`optparse` handles errors" +msgstr "" + +msgid "" +"There are two broad classes of errors that :mod:`optparse` has to worry " +"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." +msgstr "" + +msgid "" +"Handling user errors is much more important, since they are guaranteed to " +"happen no matter how stable your code is. :mod:`optparse` can automatically " +"detect some user errors, such as bad option arguments (passing ``-n 4x`` " +"where ``-n`` takes an integer argument), missing arguments (``-n`` at the " +"end of the command line, where ``-n`` takes an argument of any type). Also, " +"you can call :func:`OptionParser.error` to signal an application-defined " +"error condition::" +msgstr "" + +msgid "" +"In either case, :mod:`optparse` handles the error the same way: it prints " +"the program's usage message and an error message to standard error and exits " +"with error status 2." +msgstr "" + +msgid "" +"Consider the first example above, where the user passes ``4x`` to an option " +"that takes an integer:" +msgstr "" + +msgid "Or, where the user fails to pass a value at all:" +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." +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." +msgstr "" + +msgid "Putting it all together" +msgstr "" + +msgid "Here's what :mod:`optparse`\\ -based scripts usually look like::" +msgstr "" + +msgid "Reference Guide" +msgstr "" + +msgid "Creating the parser" +msgstr "" + +msgid "" +"The first step in using :mod:`optparse` is to create an OptionParser " +"instance." +msgstr "" + +msgid "" +"The OptionParser constructor has no required arguments, but a number of " +"optional keyword arguments. You should always pass them as keyword " +"arguments, i.e. do not rely on the order in which the arguments are declared." +msgstr "" + +msgid "``usage`` (default: ``\"%prog [options]\"``)" +msgstr "" + +msgid "" +"The usage summary to print when your program is run incorrectly or with a " +"help option. When :mod:`optparse` prints the usage string, it expands " +"``%prog`` to ``os.path.basename(sys.argv[0])`` (or to ``prog`` if you passed " +"that keyword argument). To suppress a usage message, pass the special " +"value :const:`optparse.SUPPRESS_USAGE`." +msgstr "" + +msgid "``option_list`` (default: ``[]``)" +msgstr "" + +msgid "" +"A list of Option objects to populate the parser with. The options in " +"``option_list`` are added after any options in ``standard_option_list`` (a " +"class attribute that may be set by OptionParser subclasses), but before any " +"version or help options. Deprecated; use :meth:`add_option` after creating " +"the parser instead." +msgstr "" + +msgid "``option_class`` (default: optparse.Option)" +msgstr "" + +msgid "Class to use when adding options to the parser in :meth:`add_option`." +msgstr "" + +msgid "``version`` (default: ``None``)" +msgstr "" + +msgid "" +"A version string to print when the user supplies a version option. If you " +"supply a true value for ``version``, :mod:`optparse` automatically adds a " +"version option with the single option string ``--version``. The substring " +"``%prog`` is expanded the same as for ``usage``." +msgstr "" + +msgid "``conflict_handler`` (default: ``\"error\"``)" +msgstr "" + +msgid "" +"Specifies what to do when options with conflicting option strings are added " +"to the parser; see section :ref:`optparse-conflicts-between-options`." +msgstr "" + +msgid "``description`` (default: ``None``)" +msgstr "" + +msgid "" +"A paragraph of text giving a brief overview of your program. :mod:`optparse` " +"reformats this paragraph to fit the current terminal width and prints it " +"when the user requests help (after ``usage``, but before the list of " +"options)." +msgstr "" + +msgid "``formatter`` (default: a new :class:`IndentedHelpFormatter`)" +msgstr "" + +msgid "" +"An instance of optparse.HelpFormatter that will be used for printing help " +"text. :mod:`optparse` provides two concrete classes for this purpose: " +"IndentedHelpFormatter and TitledHelpFormatter." +msgstr "" + +msgid "``add_help_option`` (default: ``True``)" +msgstr "" + +msgid "" +"If true, :mod:`optparse` will add a help option (with option strings ``-h`` " +"and ``--help``) to the parser." +msgstr "" + +msgid "``prog``" +msgstr "``prog``" + +msgid "" +"The string to use when expanding ``%prog`` in ``usage`` and ``version`` " +"instead of ``os.path.basename(sys.argv[0])``." +msgstr "" + +msgid "``epilog`` (default: ``None``)" +msgstr "" + +msgid "A paragraph of help text to print after the option help." +msgstr "" + +msgid "Populating the parser" +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:" +msgstr "" + +msgid "pass it an Option instance (as returned by :func:`make_option`)" +msgstr "" + +msgid "" +"pass it any combination of positional and keyword arguments that are " +"acceptable to :func:`make_option` (i.e., to the Option constructor), and it " +"will create the Option instance for you" +msgstr "" + +msgid "" +"The other alternative is to pass a list of pre-constructed Option instances " +"to the OptionParser constructor, as in::" +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.)" +msgstr "" + +msgid "Defining options" +msgstr "" + +msgid "" +"Each Option instance represents a set of synonymous command-line option " +"strings, e.g. ``-f`` and ``--file``. You can specify any number of short or " +"long option strings, but you must specify at least one overall option string." +msgstr "" + +msgid "" +"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::" +msgstr "" + +msgid "And to define an option with only a long option string::" +msgstr "" + +msgid "" +"The keyword arguments define attributes of the new Option object. The most " +"important option attribute is :attr:`~Option.action`, and it largely " +"determines which other attributes are relevant or required. If you pass " +"irrelevant option attributes, or fail to pass required ones, :mod:`optparse` " +"raises an :exc:`OptionError` exception explaining your mistake." +msgstr "" + +msgid "" +"An option's *action* determines what :mod:`optparse` does when it encounters " +"this option on the command-line. The standard option actions hard-coded " +"into :mod:`optparse` are:" +msgstr "" + +msgid "``\"store\"``" +msgstr "" + +msgid "store this option's argument (default)" +msgstr "" + +msgid "``\"store_true\"``" +msgstr "" + +msgid "store ``True``" +msgstr "store ``True``" + +msgid "``\"store_false\"``" +msgstr "" + +msgid "store ``False``" +msgstr "store ``False``" + +msgid "``\"append_const\"``" +msgstr "" + +msgid "append a constant value to a list, pre-set via :attr:`Option.const`" +msgstr "" + +msgid "``\"help\"``" +msgstr "" + +msgid "" +"print a usage message including all options and the documentation for them" +msgstr "" + +msgid "" +"(If you don't supply an action, the default is ``\"store\"``. For this " +"action, you may also supply :attr:`~Option.type` and :attr:`~Option.dest` " +"option attributes; see :ref:`optparse-standard-option-actions`.)" +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`." +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-" +"arguments`)." +msgstr "" + +msgid "" +"Option arguments (and various other values) are stored as attributes of this " +"object, according to the :attr:`~Option.dest` (destination) option attribute." +msgstr "" + +msgid "For example, when you call ::" +msgstr "" + +msgid "" +"one of the first things :mod:`optparse` does is create the ``options`` " +"object::" +msgstr "" + +msgid "If one of the options in this parser is defined with ::" +msgstr "" + +msgid "and the command-line being parsed includes any of the following::" +msgstr "" + +msgid "" +"then :mod:`optparse`, on seeing this option, will do the equivalent of ::" +msgstr "" + +msgid "" +"The :attr:`~Option.type` and :attr:`~Option.dest` option attributes are " +"almost as important as :attr:`~Option.action`, but :attr:`~Option.action` is " +"the only one that makes sense for *all* options." +msgstr "" + +msgid "Option attributes" +msgstr "" + +msgid "" +"A single command line argument, with various attributes passed by keyword to " +"the constructor. Normally created with :meth:`OptionParser.add_option` " +"rather than directly, and can be overridden by a custom class via the " +"*option_class* argument to :class:`OptionParser`." +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 " +"attribute, :mod:`optparse` raises :exc:`OptionError`." +msgstr "" + +msgid "(default: ``\"store\"``)" +msgstr "(default: ``\"store\"``)" + +msgid "" +"Determines :mod:`optparse`'s behaviour when this option is seen on the " +"command line; the available options are documented :ref:`here `." +msgstr "" + +msgid "(default: ``\"string\"``)" +msgstr "(default: ``\"string\"``)" + +msgid "" +"The argument type expected by this option (e.g., ``\"string\"`` or " +"``\"int\"``); the available option types are documented :ref:`here `." +msgstr "" + +msgid "(default: derived from option strings)" +msgstr "" + +msgid "" +"If the option's action implies writing or modifying a value somewhere, this " +"tells :mod:`optparse` where to write it: :attr:`~Option.dest` names an " +"attribute of the ``options`` object that :mod:`optparse` builds as it parses " +"the command line." +msgstr "" + +msgid "" +"The value to use for this option's destination if the option is not seen on " +"the command line. See also :meth:`OptionParser.set_defaults`." +msgstr "" + +msgid "(default: 1)" +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`." +msgstr "" + +msgid "For actions that store a constant value, the constant value to store." +msgstr "" + +msgid "" +"For options of type ``\"choice\"``, the list of strings the user may choose " +"from." +msgstr "" + +msgid "" +"For options with action ``\"callback\"``, the callable to call when this " +"option is seen. See section :ref:`optparse-option-callbacks` for detail on " +"the arguments passed to the callable." +msgstr "" + +msgid "" +"Additional positional and keyword arguments to pass to ``callback`` after " +"the four standard callback arguments." +msgstr "" + +msgid "" +"Help text to print for this option when listing all available options after " +"the user supplies a :attr:`~Option.help` option (such as ``--help``). If no " +"help text is supplied, the option will be listed without help text. To hide " +"this option, use the special value :const:`optparse.SUPPRESS_HELP`." +msgstr "" + +msgid "" +"Stand-in for the option argument(s) to use when printing help text. See " +"section :ref:`optparse-tutorial` for an example." +msgstr "" + +msgid "Standard option actions" +msgstr "" + +msgid "" +"The various option actions all have slightly different requirements and " +"effects. Most actions have several relevant option attributes which you may " +"specify to guide :mod:`optparse`'s behaviour; a few have required " +"attributes, which you must specify for any option using that action." +msgstr "" + +msgid "" +"``\"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 " +"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." +msgstr "" + +msgid "" +"If :attr:`~Option.choices` is supplied (a list or tuple of strings), the " +"type defaults to ``\"choice\"``." +msgstr "" + +msgid "If :attr:`~Option.type` is not supplied, it defaults to ``\"string\"``." +msgstr "" + +msgid "" +"If :attr:`~Option.dest` is not supplied, :mod:`optparse` derives a " +"destination from the first long option string (e.g., ``--foo-bar`` implies " +"``foo_bar``). If there are no long option strings, :mod:`optparse` derives a " +"destination from the first short option string (e.g., ``-f`` implies ``f``)." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "As it parses the command line ::" +msgstr "" + +msgid ":mod:`optparse` will set ::" +msgstr "" + +msgid "" +"``\"store_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" +"`~Option.dest`]" +msgstr "" + +msgid "The value :attr:`~Option.const` is stored in :attr:`~Option.dest`." +msgstr "" + +msgid "If ``--noisy`` is seen, :mod:`optparse` will set ::" +msgstr "" + +msgid "``\"store_true\"`` [relevant: :attr:`~Option.dest`]" +msgstr "" + +msgid "" +"A special case of ``\"store_const\"`` that stores ``True`` to :attr:`~Option." +"dest`." +msgstr "" + +msgid "``\"store_false\"`` [relevant: :attr:`~Option.dest`]" +msgstr "" + +msgid "Like ``\"store_true\"``, but stores ``False``." +msgstr "" + +msgid "" +"``\"append\"`` [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 appended to the list " +"in :attr:`~Option.dest`. If no default value for :attr:`~Option.dest` is " +"supplied, an empty list is automatically created when :mod:`optparse` first " +"encounters this option on the command-line. If :attr:`~Option.nargs` > 1, " +"multiple arguments are consumed, and a tuple of length :attr:`~Option.nargs` " +"is appended to :attr:`~Option.dest`." +msgstr "" + +msgid "" +"The defaults for :attr:`~Option.type` and :attr:`~Option.dest` are the same " +"as for the ``\"store\"`` action." +msgstr "" + +msgid "" +"If ``-t3`` is seen on the command-line, :mod:`optparse` does the equivalent " +"of::" +msgstr "" + +msgid "If, a little later on, ``--tracks=4`` is seen, it does::" +msgstr "" + +msgid "" +"The ``append`` action calls the ``append`` method on the current value of " +"the option. This means that any default value specified must have an " +"``append`` method. It also means that if the default value is non-empty, " +"the default elements will be present in the parsed value for the option, " +"with any values from the command line appended after those default values::" +msgstr "" + +msgid "" +"``\"append_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" +"`~Option.dest`]" +msgstr "" + +msgid "" +"Like ``\"store_const\"``, but the value :attr:`~Option.const` is appended " +"to :attr:`~Option.dest`; as with ``\"append\"``, :attr:`~Option.dest` " +"defaults to ``None``, and an empty list is automatically created the first " +"time the option is encountered." +msgstr "" + +msgid "``\"count\"`` [relevant: :attr:`~Option.dest`]" +msgstr "" + +msgid "" +"Increment the integer stored at :attr:`~Option.dest`. If no default value " +"is supplied, :attr:`~Option.dest` is set to zero before being incremented " +"the first time." +msgstr "" + +msgid "" +"The first time ``-v`` is seen on the command line, :mod:`optparse` does the " +"equivalent of::" +msgstr "" + +msgid "Every subsequent occurrence of ``-v`` results in ::" +msgstr "" + +msgid "" +"``\"callback\"`` [required: :attr:`~Option.callback`; relevant: :attr:" +"`~Option.type`, :attr:`~Option.nargs`, :attr:`~Option.callback_args`, :attr:" +"`~Option.callback_kwargs`]" +msgstr "" + +msgid "" +"Call the function specified by :attr:`~Option.callback`, which is called " +"as ::" +msgstr "" + +msgid "See section :ref:`optparse-option-callbacks` for more detail." +msgstr "" + +msgid "" +"Prints a complete help message for all the options in the current option " +"parser. The help message is constructed from the ``usage`` string passed to " +"OptionParser's constructor and the :attr:`~Option.help` string passed to " +"every option." +msgstr "" + +msgid "" +"If no :attr:`~Option.help` string is supplied for an option, it will still " +"be listed in the help message. To omit an option entirely, use the special " +"value :const:`optparse.SUPPRESS_HELP`." +msgstr "" + +msgid "" +":mod:`optparse` automatically adds a :attr:`~Option.help` option to all " +"OptionParsers, so you do not normally need to create one." +msgstr "" + +msgid "" +"If :mod:`optparse` sees either ``-h`` or ``--help`` on the command line, it " +"will print something like the following help message to stdout (assuming " +"``sys.argv[0]`` is ``\"foo.py\"``):" +msgstr "" + +msgid "" +"After printing the help message, :mod:`optparse` terminates your process " +"with ``sys.exit(0)``." +msgstr "" + +msgid "``\"version\"``" +msgstr "" + +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." +msgstr "" + +msgid "Standard option types" +msgstr "" + +msgid "" +":mod:`optparse` has five built-in option types: ``\"string\"``, ``\"int\"``, " +"``\"choice\"``, ``\"float\"`` and ``\"complex\"``. If you need to add new " +"option types, see section :ref:`optparse-extending-optparse`." +msgstr "" + +msgid "" +"Arguments to string options are not checked or converted in any way: the " +"text on the command line is stored in the destination (or passed to the " +"callback) as-is." +msgstr "" + +msgid "Integer arguments (type ``\"int\"``) are parsed as follows:" +msgstr "" + +msgid "if the number starts with ``0x``, it is parsed as a hexadecimal number" +msgstr "" + +msgid "if the number starts with ``0``, it is parsed as an octal number" +msgstr "" + +msgid "if the number starts with ``0b``, it is parsed as a binary number" +msgstr "" + +msgid "otherwise, the number is parsed as a decimal number" +msgstr "" + +msgid "" +"The conversion is done by calling :func:`int` with the appropriate base (2, " +"8, 10, or 16). If this fails, so will :mod:`optparse`, although with a more " +"useful error message." +msgstr "" + +msgid "" +"``\"float\"`` and ``\"complex\"`` option arguments are converted directly " +"with :func:`float` and :func:`complex`, with similar error-handling." +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." +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." +msgstr "" + +msgid "Parse the command-line options found in *args*." +msgstr "" + +msgid "The input parameters are" +msgstr "" + +msgid "``args``" +msgstr "" + +msgid "the list of arguments to process (default: ``sys.argv[1:]``)" +msgstr "" + +msgid "``values``" +msgstr "" + +msgid "" +"an :class:`Values` object to store option arguments in (default: a new " +"instance of :class:`Values`) -- if you give an existing object, the option " +"defaults will not be initialized on it" +msgstr "" + +msgid "and the return value is a pair ``(options, args)`` where" +msgstr "" + +msgid "``options``" +msgstr "" + +msgid "" +"the same object that was passed in as *values*, or the ``optparse.Values`` " +"instance created by :mod:`optparse`" +msgstr "" + +msgid "the leftover positional arguments after all options have been processed" +msgstr "" + +msgid "" +"The most common usage is to supply neither keyword argument. If you supply " +"``values``, it will be modified with repeated :func:`setattr` calls (roughly " +"one for every option argument stored to an option destination) and returned " +"by :meth:`~OptionParser.parse_args`." +msgstr "" + +msgid "" +"If :meth:`~OptionParser.parse_args` encounters any errors in the argument " +"list, it calls the OptionParser's :meth:`error` method with an appropriate " +"end-user error message. This ultimately terminates your process with an exit " +"status of 2 (the traditional Unix exit status for command-line errors)." +msgstr "" + +msgid "Querying and manipulating your option parser" +msgstr "" + +msgid "" +"The default behavior of the option parser can be customized slightly, and " +"you can also poke around your option parser and see what's there. " +"OptionParser provides several methods to help you out:" +msgstr "" + +msgid "" +"Set parsing to stop on the first non-option. For example, if ``-a`` and ``-" +"b`` are both simple options that take no arguments, :mod:`optparse` normally " +"accepts this syntax::" +msgstr "" + +msgid "and treats it as equivalent to ::" +msgstr "" + +msgid "" +"To disable this feature, call :meth:`disable_interspersed_args`. This " +"restores traditional Unix syntax, where option parsing stops with the first " +"non-option argument." +msgstr "" + +msgid "" +"Use this if you have a command processor which runs another command which " +"has options of its own and you want to make sure these options don't get " +"confused. For example, each command might have a different set of options." +msgstr "" + +msgid "" +"Set parsing to not stop on the first non-option, allowing interspersing " +"switches with command arguments. This is the default behavior." +msgstr "" + +msgid "" +"Returns the Option instance with the option string *opt_str*, or ``None`` if " +"no options have that option string." +msgstr "" + +msgid "" +"Return ``True`` if the OptionParser has an option with option string " +"*opt_str* (e.g., ``-q`` or ``--verbose``)." +msgstr "" + +msgid "" +"If the :class:`OptionParser` has an option corresponding to *opt_str*, that " +"option is removed. If that option provided any other option strings, all of " +"those option strings become invalid. If *opt_str* does not occur in any " +"option belonging to this :class:`OptionParser`, raises :exc:`ValueError`." +msgstr "" + +msgid "Conflicts between options" +msgstr "" + +msgid "" +"If you're not careful, it's easy to define options with conflicting option " +"strings::" +msgstr "" + +msgid "" +"(This is particularly true if you've defined your own OptionParser subclass " +"with some standard options.)" +msgstr "" + +msgid "" +"Every time you add an option, :mod:`optparse` checks for conflicts with " +"existing options. If it finds any, it invokes the current conflict-handling " +"mechanism. You can set the conflict-handling mechanism either in the " +"constructor::" +msgstr "" + +msgid "or with a separate call::" +msgstr "" + +msgid "The available conflict handlers are:" +msgstr "" + +msgid "``\"error\"`` (default)" +msgstr "``\"error\"`` (default)" + +msgid "" +"assume option conflicts are a programming error and raise :exc:" +"`OptionConflictError`" +msgstr "" + +msgid "``\"resolve\"``" +msgstr "" + +msgid "resolve option conflicts intelligently (see below)" +msgstr "" + +msgid "" +"As an example, let's define an :class:`OptionParser` that resolves conflicts " +"intelligently and add conflicting options to it::" +msgstr "" + +msgid "" +"At this point, :mod:`optparse` detects that a previously added option is " +"already using the ``-n`` option string. Since ``conflict_handler`` is " +"``\"resolve\"``, it resolves the situation by removing ``-n`` from the " +"earlier option's list of option strings. Now ``--dry-run`` is the only way " +"for the user to activate that option. If the user asks for help, the help " +"message will reflect that::" +msgstr "" + +msgid "" +"It's possible to whittle away the option strings for a previously added " +"option until there are none left, and the user has no way of invoking that " +"option from the command-line. In that case, :mod:`optparse` removes that " +"option completely, so it doesn't show up in help text or anywhere else. " +"Carrying on with our existing OptionParser::" +msgstr "" + +msgid "" +"At this point, the original ``-n``/``--dry-run`` option is no longer " +"accessible, so :mod:`optparse` removes it, leaving this help text::" +msgstr "" + +msgid "Cleanup" +msgstr "" + +msgid "" +"OptionParser instances have several cyclic references. This should not be a " +"problem for Python's garbage collector, but you may wish to break the cyclic " +"references explicitly by calling :meth:`~OptionParser.destroy` on your " +"OptionParser once you are done with it. This is particularly useful in long-" +"running applications where large object graphs are reachable from your " +"OptionParser." +msgstr "" + +msgid "Other methods" +msgstr "" + +msgid "OptionParser supports several other public methods:" +msgstr "" + +msgid "" +"Set the usage string according to the rules described above for the " +"``usage`` constructor keyword argument. Passing ``None`` sets the default " +"usage string; use :const:`optparse.SUPPRESS_USAGE` to suppress a usage " +"message." +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." +msgstr "" + +msgid "" +"Same as :meth:`print_usage` but returns the usage string instead of printing " +"it." +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::" +msgstr "" + +msgid "To avoid this confusion, use :meth:`set_defaults`::" +msgstr "" + +msgid "Option Callbacks" +msgstr "" + +msgid "" +"When :mod:`optparse`'s built-in actions and types aren't quite enough for " +"your needs, you have two choices: extend :mod:`optparse` or define a " +"callback option. Extending :mod:`optparse` is more general, but overkill for " +"a lot of simple cases. Quite often a simple callback is all you need." +msgstr "" + +msgid "There are two steps to defining a callback option:" +msgstr "" + +msgid "define the option itself using the ``\"callback\"`` action" +msgstr "" + +msgid "" +"write the callback; this is a function (or method) that takes at least four " +"arguments, as described below" +msgstr "" + +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::" +msgstr "" + +msgid "" +"``callback`` is a function (or other callable object), so you must have " +"already defined ``my_callback()`` when you create this callback option. In " +"this simple case, :mod:`optparse` doesn't even know if ``-c`` takes any " +"arguments, which usually means that the option takes no arguments---the mere " +"presence of ``-c`` on the command-line is all it needs to know. In some " +"circumstances, though, you might want your callback to consume an arbitrary " +"number of command-line arguments. This is where writing callbacks gets " +"tricky; it's covered later in this section." +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::" +msgstr "" + +msgid "The four arguments to a callback are described below." +msgstr "" + +msgid "" +"There are several other option attributes that you can supply when you " +"define a callback option:" +msgstr "" + +msgid ":attr:`~Option.type`" +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." +msgstr "" + +msgid ":attr:`~Option.nargs`" +msgstr ":attr:`~Option.nargs`" + +msgid "" +"also has its usual meaning: if it is supplied and > 1, :mod:`optparse` will " +"consume :attr:`~Option.nargs` arguments, each of which must be convertible " +"to :attr:`~Option.type`. It then passes a tuple of converted values to your " +"callback." +msgstr "" + +msgid ":attr:`~Option.callback_args`" +msgstr ":attr:`~Option.callback_args`" + +msgid "a tuple of extra positional arguments to pass to the callback" +msgstr "" + +msgid ":attr:`~Option.callback_kwargs`" +msgstr ":attr:`~Option.callback_kwargs`" + +msgid "a dictionary of extra keyword arguments to pass to the callback" +msgstr "" + +msgid "How callbacks are called" +msgstr "" + +msgid "All callbacks are called as follows::" +msgstr "" + +msgid "``option``" +msgstr "" + +msgid "is the Option instance that's calling the callback" +msgstr "" + +msgid "``opt_str``" +msgstr "" + +msgid "" +"is the option string seen on the command-line that's triggering the " +"callback. (If an abbreviated long option was used, ``opt_str`` will be the " +"full, canonical option string---e.g. if the user puts ``--foo`` on the " +"command-line as an abbreviation for ``--foobar``, then ``opt_str`` will be " +"``\"--foobar\"``.)" +msgstr "" + +msgid "``value``" +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." +msgstr "" + +msgid "``parser``" +msgstr "" + +msgid "" +"is the OptionParser instance driving the whole thing, mainly useful because " +"you can access some other interesting data through its instance attributes:" +msgstr "" + +msgid "``parser.largs``" +msgstr "" + +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`.)" +msgstr "" + +msgid "``parser.rargs``" +msgstr "" + +msgid "" +"the current list of remaining arguments, ie. with ``opt_str`` and ``value`` " +"(if applicable) removed, and only the arguments following them still there. " +"Feel free to modify ``parser.rargs``, e.g. by consuming more arguments." +msgstr "" + +msgid "``parser.values``" +msgstr "" + +msgid "" +"the object where option values are by default stored (an instance of " +"optparse.OptionValues). This lets callbacks use the same mechanism as the " +"rest of :mod:`optparse` for storing option values; you don't need to mess " +"around with globals or closures. You can also access or modify the value(s) " +"of any options already encountered on the command-line." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "Raising errors in a callback" +msgstr "" + +msgid "" +"The callback function should raise :exc:`OptionValueError` if there are any " +"problems with the option or its argument(s). :mod:`optparse` catches this " +"and terminates the program, printing the error message you supply to " +"stderr. Your message should be clear, concise, accurate, and mention the " +"option at fault. Otherwise, the user will have a hard time figuring out what " +"they did wrong." +msgstr "" + +msgid "Callback example 1: trivial callback" +msgstr "" + +msgid "" +"Here's an example of a callback option that takes no arguments, and simply " +"records that the option was seen::" +msgstr "" + +msgid "Of course, you could do that with the ``\"store_true\"`` action." +msgstr "" + +msgid "Callback example 2: check option order" +msgstr "" + +msgid "" +"Here's a slightly more interesting example: record the fact that ``-a`` is " +"seen, but blow up if it comes after ``-b`` in the command-line. ::" +msgstr "" + +msgid "Callback example 3: check option order (generalized)" +msgstr "" + +msgid "" +"If you want to re-use this callback for several similar options (set a flag, " +"but blow up if ``-b`` has already been seen), it needs a bit of work: the " +"error message and the flag that it sets must be generalized. ::" +msgstr "" + +msgid "Callback example 4: check arbitrary condition" +msgstr "" + +msgid "" +"Of course, you could put any condition in there---you're not limited to " +"checking the values of already-defined options. For example, if you have " +"options that should not be called when the moon is full, all you have to do " +"is this::" +msgstr "" + +msgid "" +"(The definition of ``is_moon_full()`` is left as an exercise for the reader.)" +msgstr "" + +msgid "Callback example 5: fixed arguments" +msgstr "" + +msgid "" +"Things get slightly more interesting when you define callback options that " +"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." +msgstr "" + +msgid "" +"Here's an example that just emulates the standard ``\"store\"`` action::" +msgstr "" + +msgid "" +"Note that :mod:`optparse` takes care of consuming 3 arguments and converting " +"them to integers for you; all you have to do is store them. (Or whatever; " +"obviously you don't need a callback for this example.)" +msgstr "" + +msgid "Callback example 6: variable arguments" +msgstr "" + +msgid "" +"Things get hairy when you want an option to take a variable number of " +"arguments. For this case, you must write a callback, as :mod:`optparse` " +"doesn't provide any built-in capabilities for it. And you have to deal with " +"certain intricacies of conventional Unix command-line parsing that :mod:" +"`optparse` normally handles for you. In particular, callbacks should " +"implement the conventional rules for bare ``--`` and ``-`` arguments:" +msgstr "" + +msgid "either ``--`` or ``-`` can be option arguments" +msgstr "" + +msgid "" +"bare ``--`` (if not the argument to some option): halt command-line " +"processing and discard the ``--``" +msgstr "" + +msgid "" +"bare ``-`` (if not the argument to some option): halt command-line " +"processing but keep the ``-`` (append it to ``parser.largs``)" +msgstr "" + +msgid "" +"If you want an option that takes a variable number of arguments, there are " +"several subtle, tricky issues to worry about. The exact implementation you " +"choose will be based on which trade-offs you're willing to make for your " +"application (which is why :mod:`optparse` doesn't support this sort of thing " +"directly)." +msgstr "" + +msgid "" +"Nevertheless, here's a stab at a callback for an option with variable " +"arguments::" +msgstr "" + +msgid "Extending :mod:`optparse`" +msgstr "" + +msgid "" +"Since the two major controlling factors in how :mod:`optparse` interprets " +"command-line options are the action and type of each option, the most likely " +"direction of extension is to add new actions and new types." +msgstr "" + +msgid "Adding new types" +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`." +msgstr "" + +msgid "" +"A tuple of type names; in your subclass, simply define a new tuple :attr:" +"`TYPES` that builds on the standard one." +msgstr "" + +msgid "" +"A dictionary mapping type names to type-checking functions. A type-checking " +"function has the following signature::" +msgstr "" + +msgid "" +"where ``option`` is an :class:`Option` instance, ``opt`` is an option string " +"(e.g., ``-f``), and ``value`` is the string from the command line that must " +"be checked and converted to your desired type. ``check_mytype()`` should " +"return an object of the hypothetical type ``mytype``. The value returned by " +"a type-checking function will wind up in the OptionValues instance returned " +"by :meth:`OptionParser.parse_args`, or be passed to a callback as the " +"``value`` parameter." +msgstr "" + +msgid "" +"Your type-checking function should raise :exc:`OptionValueError` if it " +"encounters any problems. :exc:`OptionValueError` takes a single string " +"argument, which is passed as-is to :class:`OptionParser`'s :meth:`error` " +"method, which in turn prepends the program name and the string ``\"error:" +"\"`` and prints everything to stderr before terminating the process." +msgstr "" + +msgid "" +"Here's a silly example that demonstrates adding a ``\"complex\"`` option " +"type to parse Python-style complex numbers on the command line. (This is " +"even sillier than it used to be, because :mod:`optparse` 1.3 added built-in " +"support for complex numbers, but never mind.)" +msgstr "" + +msgid "First, the necessary imports::" +msgstr "" + +msgid "" +"You need to define your type-checker first, since it's referred to later (in " +"the :attr:`~Option.TYPE_CHECKER` class attribute of your Option subclass)::" +msgstr "" + +msgid "Finally, the Option subclass::" +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:" +"`optparse`'s Option class. This being Python, nothing stops you from doing " +"that except good manners and common sense.)" +msgstr "" + +msgid "" +"That's it! Now you can write a script that uses the new option type just " +"like any other :mod:`optparse`\\ -based script, except you have to instruct " +"your OptionParser to use MyOption instead of Option::" +msgstr "" + +msgid "" +"Alternately, you can build your own option list and pass it to OptionParser; " +"if you don't use :meth:`add_option` in the above way, you don't need to tell " +"OptionParser which option class to use::" +msgstr "" + +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:" +msgstr "" + +msgid "\"store\" actions" +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." +msgstr "" + +msgid "\"typed\" actions" +msgstr "" + +msgid "" +"actions that take a value from the command line and expect it to be of a " +"certain type; or rather, a string that can be converted to a certain type. " +"These options require a :attr:`~Option.type` attribute to the Option " +"constructor." +msgstr "" + +msgid "" +"These are overlapping sets: some default \"store\" actions are " +"``\"store\"``, ``\"store_const\"``, ``\"append\"``, and ``\"count\"``, while " +"the default \"typed\" actions are ``\"store\"``, ``\"append\"``, and " +"``\"callback\"``." +msgstr "" + +msgid "" +"When you add an action, you need to categorize it by listing it in at least " +"one of the following class attributes of Option (all are lists of strings):" +msgstr "" + +msgid "All actions must be listed in ACTIONS." +msgstr "" + +msgid "\"store\" actions are additionally listed here." +msgstr "" + +msgid "\"typed\" actions are additionally listed here." +msgstr "" + +msgid "" +"Actions that always take a type (i.e. whose options always take a value) are " +"additionally listed here. The only effect of this is that :mod:`optparse` " +"assigns the default type, ``\"string\"``, to options with no explicit type " +"whose action is listed in :attr:`ALWAYS_TYPED_ACTIONS`." +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." +msgstr "" + +msgid "" +"For example, let's add an ``\"extend\"`` action. This is similar to the " +"standard ``\"append\"`` action, but instead of taking a single value from " +"the command-line and appending it to an existing list, ``\"extend\"`` will " +"take multiple values in a single comma-delimited string, and extend an " +"existing list with them. That is, if ``--names`` is an ``\"extend\"`` " +"option of type ``\"string\"``, the command line ::" +msgstr "" + +msgid "would result in a list ::" +msgstr "" + +msgid "Again we define a subclass of Option::" +msgstr "" + +msgid "Features of note:" +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`." +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." +msgstr "" + +msgid "" +":meth:`MyOption.take_action` implements just this one new action, and passes " +"control back to :meth:`Option.take_action` for the standard :mod:`optparse` " +"actions." +msgstr "" + +msgid "" +"``values`` is an instance of the optparse_parser.Values class, which " +"provides the very useful :meth:`ensure_value` method. :meth:`ensure_value` " +"is essentially :func:`getattr` with a safety valve; it is called as ::" +msgstr "" + +msgid "" +"If the ``attr`` attribute of ``values`` doesn't exist or is ``None``, then " +"ensure_value() first sets it to ``value``, and then returns 'value. This is " +"very handy for actions like ``\"extend\"``, ``\"append\"``, and " +"``\"count\"``, all of which accumulate data in a variable and expect that " +"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." +msgstr "" + +msgid "Exceptions" +msgstr "Wyjątki" + +msgid "" +"Raised if an :class:`Option` instance is created with invalid or " +"inconsistent arguments." +msgstr "" + +msgid "Raised if conflicting options are added to an :class:`OptionParser`." +msgstr "" + +msgid "Raised if an invalid option value is encountered on the command line." +msgstr "" + +msgid "Raised if an invalid option is passed on the command line." +msgstr "" + +msgid "Raised if an ambiguous option is passed on the command line." +msgstr "" diff --git a/library/os_path.po b/library/os.path.po similarity index 90% rename from library/os_path.po rename to library/os.path.po index bca7a29a8c..518cdb935b 100644 --- a/library/os_path.po +++ b/library/os.path.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-06-06 16:13+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -301,10 +300,33 @@ msgid "" msgstr "" msgid "" -"If a path doesn't exist or a symlink loop is encountered, and *strict* is " -"``True``, :exc:`OSError` is raised. If *strict* is ``False``, the path is " -"resolved as far as possible and any remainder is appended without checking " -"whether it exists." +"By default, the path is evaluated up to the first component that does not " +"exist, is a symlink loop, or whose evaluation raises :exc:`OSError`. All " +"such components are appended unchanged to the existing part of the path." +msgstr "" + +msgid "" +"Some errors that are handled this way include \"access denied\", \"not a " +"directory\", or \"bad argument to internal function\". Thus, the resulting " +"path may be missing or inaccessible, may still contain links or loops, and " +"may traverse non-directories." +msgstr "" + +msgid "This behavior can be modified by keyword arguments:" +msgstr "" + +msgid "" +"If *strict* is ``True``, the first error encountered when evaluating the " +"path is re-raised. In particular, :exc:`FileNotFoundError` is raised if " +"*path* does not exist, or another :exc:`OSError` if it is otherwise " +"inaccessible." +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." msgstr "" msgid "" @@ -324,6 +346,14 @@ msgstr "" msgid "The *strict* parameter was added." msgstr "Parametr *strict* został dodany." +msgid "" +"The :py:data:`~os.path.ALLOW_MISSING` value for the *strict* parameter was " +"added." +msgstr "" + +msgid "Special value used for the *strict* argument in :func:`realpath`." +msgstr "" + msgid "" "Return a relative filepath to *path* either from the current directory or " "from an optional *start* directory. This is a path computation: the " @@ -332,7 +362,7 @@ msgid "" "are on different drives." msgstr "" -msgid "*start* defaults to :attr:`os.curdir`." +msgid "*start* defaults to :data:`os.curdir`." msgstr "" msgid "" @@ -435,7 +465,7 @@ msgid "pwd" msgstr "" msgid "$ (dollar)" -msgstr "" +msgstr "$ (dollar)" msgid "environment variables expansion" msgstr "" diff --git a/library/os.po b/library/os.po new file mode 100644 index 0000000000..57b7c38713 --- /dev/null +++ b/library/os.po @@ -0,0 +1,4745 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`os` --- Miscellaneous operating system interfaces" +msgstr "" + +msgid "**Source code:** :source:`Lib/os.py`" +msgstr "" + +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." +msgstr "" + +msgid "Notes on the availability of these functions:" +msgstr "" + +msgid "" +"The design of all built-in operating system dependent modules of Python is " +"such that as long as the same functionality is available, it uses the same " +"interface; for example, the function ``os.stat(path)`` returns stat " +"information about *path* in the same format (which happens to have " +"originated with the POSIX interface)." +msgstr "" + +msgid "" +"Extensions peculiar to a particular operating system are also available " +"through the :mod:`os` module, but using them is of course a threat to " +"portability." +msgstr "" + +msgid "" +"All functions accepting path or file names accept both bytes and string " +"objects, and result in an object of the same type, if a path or file name is " +"returned." +msgstr "" + +msgid "" +"On VxWorks, os.popen, os.fork, os.execv and os.spawn*p* are not supported." +msgstr "" + +msgid "" +"On WebAssembly platforms ``wasm32-emscripten`` and ``wasm32-wasi``, large " +"parts of the :mod:`os` module are not available or behave differently. API " +"related to processes (e.g. :func:`~os.fork`, :func:`~os.execve`), signals (e." +"g. :func:`~os.kill`, :func:`~os.wait`), and resources (e.g. :func:`~os." +"nice`) are not available. Others like :func:`~os.getuid` and :func:`~os." +"getpid` are emulated or stubs." +msgstr "" + +msgid "" +"All functions in this module raise :exc:`OSError` (or subclasses thereof) in " +"the case of invalid or inaccessible file names and paths, or other arguments " +"that have the correct type, but are not accepted by the operating system." +msgstr "" + +msgid "An alias for the built-in :exc:`OSError` exception." +msgstr "" + +msgid "" +"The name of the operating system dependent module imported. The following " +"names have currently been registered: ``'posix'``, ``'nt'``, ``'java'``." +msgstr "" + +msgid "" +":data:`sys.platform` has a finer granularity. :func:`os.uname` gives system-" +"dependent version information." +msgstr "" + +msgid "" +"The :mod:`platform` module provides detailed checks for the system's " +"identity." +msgstr "" + +msgid "File Names, Command Line Arguments, and Environment Variables" +msgstr "" + +msgid "" +"In Python, file names, command line arguments, and environment variables are " +"represented using the string type. On some systems, decoding these strings " +"to and from bytes is necessary before passing them to the operating system. " +"Python uses the :term:`filesystem encoding and error handler` to perform " +"this conversion (see :func:`sys.getfilesystemencoding`)." +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`." +msgstr "" + +msgid "" +"On some systems, conversion using the file system encoding may fail. In this " +"case, Python uses the :ref:`surrogateescape encoding error handler " +"`, which means that undecodable bytes are replaced by a " +"Unicode character U+DC\\ *xx* on decoding, and these are again translated to " +"the original byte on encoding." +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`." +msgstr "" + +msgid "See also the :term:`locale encoding`." +msgstr "" + +msgid "Python UTF-8 Mode" +msgstr "" + +msgid "See :pep:`540` for more details." +msgstr "" + +msgid "" +"The Python UTF-8 Mode ignores the :term:`locale encoding` and forces the " +"usage of the UTF-8 encoding:" +msgstr "" + +msgid "" +"Use UTF-8 as the :term:`filesystem encoding `." +msgstr "" + +msgid ":func:`sys.getfilesystemencoding()` returns ``'utf-8'``." +msgstr "" + +msgid "" +":func:`locale.getpreferredencoding()` returns ``'utf-8'`` (the " +"*do_setlocale* argument has no effect)." +msgstr "" + +msgid "" +":data:`sys.stdin`, :data:`sys.stdout`, and :data:`sys.stderr` all use UTF-8 " +"as their text encoding, with the ``surrogateescape`` :ref:`error handler " +"` being enabled for :data:`sys.stdin` and :data:`sys.stdout` " +"(:data:`sys.stderr` continues to use ``backslashreplace`` as it does in the " +"default locale-aware mode)" +msgstr "" + +msgid "" +"On Unix, :func:`os.device_encoding` returns ``'utf-8'`` rather than the " +"device encoding." +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)." +msgstr "" + +msgid "" +"As a consequence of the changes in those lower level APIs, other higher " +"level APIs also exhibit different default behaviours:" +msgstr "" + +msgid "" +"Command line arguments, environment variables and filenames are decoded to " +"text using the UTF-8 encoding." +msgstr "" + +msgid ":func:`os.fsdecode()` and :func:`os.fsencode()` use the UTF-8 encoding." +msgstr "" + +msgid "" +":func:`open()`, :func:`io.open()`, and :func:`codecs.open()` use the UTF-8 " +"encoding by default. However, they still use the strict error handler by " +"default so that attempting to open a binary file in text mode is likely to " +"raise an exception rather than producing nonsense data." +msgstr "" + +msgid "" +"The :ref:`Python UTF-8 Mode ` is enabled if the LC_CTYPE locale " +"is ``C`` or ``POSIX`` at Python startup (see the :c:func:`PyConfig_Read` " +"function)." +msgstr "" + +msgid "" +"It can be enabled or disabled using the :option:`-X utf8 <-X>` command line " +"option and the :envvar:`PYTHONUTF8` environment variable." +msgstr "" + +msgid "" +"If the :envvar:`PYTHONUTF8` environment variable is not set at all, then the " +"interpreter defaults to using the current locale settings, *unless* the " +"current locale is identified as a legacy ASCII-based locale (as described " +"for :envvar:`PYTHONCOERCECLOCALE`), and locale coercion is either disabled " +"or fails. In such legacy locales, the interpreter will default to enabling " +"UTF-8 mode unless explicitly instructed not to do so." +msgstr "" + +msgid "" +"The Python UTF-8 Mode can only be enabled at the Python startup. Its value " +"can be read from :data:`sys.flags.utf8_mode `." +msgstr "" + +msgid "" +"See also the :ref:`UTF-8 mode on Windows ` and the :term:" +"`filesystem encoding and error handler`." +msgstr "" + +msgid ":pep:`686`" +msgstr ":pep:`686`" + +msgid "Python 3.15 will make :ref:`utf8-mode` default." +msgstr "" + +msgid "Process Parameters" +msgstr "" + +msgid "" +"These functions and data items provide information and operate on the " +"current process and user." +msgstr "" + +msgid "" +"Return the filename corresponding to the controlling terminal of the process." +msgstr "" + +msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." +msgstr "" + +msgid "" +"A :term:`mapping` object where keys and values are strings that represent " +"the process environment. For example, ``environ['HOME']`` is the pathname " +"of your home directory (on some platforms), and is equivalent to " +"``getenv(\"HOME\")`` in C." +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." +msgstr "" + +msgid "" +"This mapping may be used to modify the environment as well as query the " +"environment. :func:`putenv` will be called automatically when the mapping " +"is modified." +msgstr "" + +msgid "" +"On Unix, keys and values use :func:`sys.getfilesystemencoding` and " +"``'surrogateescape'`` error handler. Use :data:`environb` if you would like " +"to use a different encoding." +msgstr "" + +msgid "" +"On Windows, the keys are converted to uppercase. This also applies when " +"getting, setting, or deleting an item. For example, ``environ['monty'] = " +"'python'`` maps the key ``'MONTY'`` to the value ``'python'``." +msgstr "" + +msgid "" +"Calling :func:`putenv` directly does not change :data:`os.environ`, so it's " +"better to modify :data:`os.environ`." +msgstr "" + +msgid "" +"On some platforms, including FreeBSD and macOS, setting ``environ`` may " +"cause memory leaks. Refer to the system documentation for :c:func:`!putenv`." +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." +msgstr "" + +msgid "" +"Updated to support :pep:`584`'s merge (``|``) and update (``|=``) operators." +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)." +msgstr "" + +msgid "" +":data:`environb` is only available if :const:`supports_bytes_environ` is " +"``True``." +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." +msgstr "" + +msgid ":func:`fsdecode` is the reverse function." +msgstr "" + +msgid "" +"Support added to accept objects implementing the :class:`os.PathLike` " +"interface." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "Return the file system representation of the path." +msgstr "" + +msgid "" +"If :class:`str` or :class:`bytes` is passed in, it is returned unchanged. " +"Otherwise :meth:`~os.PathLike.__fspath__` is called and its value is " +"returned as long as it is a :class:`str` or :class:`bytes` object. In all " +"other cases, :exc:`TypeError` is raised." +msgstr "" + +msgid "" +"An :term:`abstract base class` for objects representing a file system path, " +"e.g. :class:`pathlib.PurePath`." +msgstr "" + +msgid "Return the file system path representation of the object." +msgstr "" + +msgid "" +"The method should only return a :class:`str` or :class:`bytes` object, with " +"the preference being for :class:`str`." +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." +msgstr "" + +msgid "" +"On Unix, keys and values are decoded with :func:`sys.getfilesystemencoding` " +"and ``'surrogateescape'`` error handler. Use :func:`os.getenvb` if you would " +"like to use a different encoding." +msgstr "" + +msgid ":ref:`Availability `: Unix, Windows." +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." +msgstr "" + +msgid "" +":func:`getenvb` is only available if :const:`supports_bytes_environ` is " +"``True``." +msgstr "" + +msgid ":ref:`Availability `: Unix." +msgstr "" + +msgid "" +"Returns the list of directories that will be searched for a named " +"executable, similar to a shell, when launching a process. *env*, when " +"specified, should be an environment variable dictionary to lookup the PATH " +"in. By default, when *env* is ``None``, :data:`environ` is used." +msgstr "" + +msgid "" +"Return the effective group id of the current process. This corresponds to " +"the \"set id\" bit on the file being executed in the current process." +msgstr "" + +msgid "Return the current process's effective user id." +msgstr "" + +msgid "Return the real group id of the current process." +msgstr "" + +msgid "" +"The function is a stub on Emscripten and WASI, see :ref:`wasm-availability` " +"for more information." +msgstr "" + +msgid "" +"Return list of group ids that *user* belongs to. If *group* is not in the " +"list, it is included; typically, *group* is specified as the group ID field " +"from the password record for *user*, because that group ID will otherwise be " +"potentially omitted." +msgstr "" + +msgid "" +"Return list of supplemental group ids associated with the current process." +msgstr "" + +msgid "" +"On macOS, :func:`getgroups` behavior differs somewhat from other Unix " +"platforms. If the Python interpreter was built with a deployment target of " +"``10.5`` or earlier, :func:`getgroups` returns the list of effective group " +"ids associated with the current user process; this list is limited to a " +"system-defined number of entries, typically 16, and may be modified by calls " +"to :func:`setgroups` if suitably privileged. If built with a deployment " +"target greater than ``10.5``, :func:`getgroups` returns the current group " +"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`." +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." +msgstr "" + +msgid "" +":ref:`Availability `: Unix, Windows, not Emscripten, not WASI." +msgstr "" + +msgid "" +"Return the process group id of the process with process id *pid*. If *pid* " +"is 0, the process group id of the current process is returned." +msgstr "" + +msgid "Return the id of the current process group." +msgstr "" + +msgid "Return the current process id." +msgstr "Zwróci ID aktualnego procesu." + +msgid "" +"Return the parent's process id. When the parent process has exited, on Unix " +"the id returned is the one of the init process (1), on Windows it is still " +"the same id, which may be already reused by another process." +msgstr "" + +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." +msgstr "" + +msgid "" +"Parameters for the :func:`getpriority` and :func:`setpriority` functions." +msgstr "" + +msgid "" +"Return a tuple (ruid, euid, suid) denoting the current process's real, " +"effective, and saved user ids." +msgstr "" + +msgid "" +"Return a tuple (rgid, egid, sgid) denoting the current process's real, " +"effective, and saved group ids." +msgstr "" + +msgid "Return the current process's real user id." +msgstr "" + +msgid "" +"Call the system initgroups() to initialize the group access list with all of " +"the groups of which the specified username is a member, plus the specified " +"group id." +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`." +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." +msgstr "" + +msgid "" +"On some platforms, including FreeBSD and macOS, setting ``environ`` may " +"cause memory leaks. Refer to the system documentation for :c:func:`!putenv`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.putenv`` with arguments " +"``key``, ``value``." +msgstr "" + +msgid "The function is now always available." +msgstr "" + +msgid "Set the current process's effective group id." +msgstr "" + +msgid "Set the current process's effective user id." +msgstr "" + +msgid "Set the current process' group id." +msgstr "" + +msgid "" +"Set the list of supplemental group ids associated with the current process " +"to *groups*. *groups* must be a sequence, and each element must be an " +"integer identifying a group. This operation is typically available only to " +"the superuser." +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()." +msgstr "" + +msgid "" +"Call the system call :c:func:`!setpgrp` or ``setpgrp(0, 0)`` depending on " +"which version is implemented (if any). See the Unix manual for the " +"semantics." +msgstr "" + +msgid "" +"Call the system call :c:func:`!setpgid` to set the process group id of the " +"process with id *pid* to the process group with id *pgrp*. See the Unix " +"manual for the semantics." +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." +msgstr "" + +msgid "Set the current process's real and effective group ids." +msgstr "" + +msgid "Set the current process's real, effective, and saved group ids." +msgstr "" + +msgid "Set the current process's real, effective, and saved user ids." +msgstr "" + +msgid "Set the current process's real and effective user ids." +msgstr "" + +msgid "" +"Call the system call :c:func:`!getsid`. See the Unix manual for the " +"semantics." +msgstr "" + +msgid "" +"Call the system call :c:func:`!setsid`. See the Unix manual for the " +"semantics." +msgstr "" + +msgid "Set the current process's user id." +msgstr "" + +msgid "" +"Return the error message corresponding to the error code in *code*. On " +"platforms where :c:func:`!strerror` returns ``NULL`` when given an unknown " +"error number, :exc:`ValueError` is raised." +msgstr "" + +msgid "" +"``True`` if the native OS type of the environment is bytes (eg. ``False`` on " +"Windows)." +msgstr "" + +msgid "Set the current numeric umask and return the previous umask." +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" +msgstr "" + +msgid ":attr:`nodename` - name of machine on network (implementation-defined)" +msgstr "" + +msgid ":attr:`release` - operating system release" +msgstr "" + +msgid ":attr:`version` - operating system version" +msgstr "" + +msgid ":attr:`machine` - hardware identifier" +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." +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())``." +msgstr "" + +msgid "" +"Return type changed from a tuple to a tuple-like object with named " +"attributes." +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`." +msgstr "" + +msgid "" +"Deletion of items in :data:`os.environ` is automatically translated into a " +"corresponding call to :func:`unsetenv`; however, calls to :func:`unsetenv` " +"don't update :data:`os.environ`, so it is actually preferable to delete " +"items of :data:`os.environ`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.unsetenv`` with argument " +"``key``." +msgstr "" + +msgid "The function is now always available and is also available on Windows." +msgstr "" + +msgid "File Object Creation" +msgstr "" + +msgid "" +"These functions create new :term:`file objects `. (See also :" +"func:`~os.open` for opening file descriptors.)" +msgstr "" + +msgid "" +"Return an open file object connected to the file descriptor *fd*. This is " +"an alias of the :func:`open` built-in function and accepts the same " +"arguments. The only difference is that the first argument of :func:`fdopen` " +"must always be an integer." +msgstr "" + +msgid "File Descriptor Operations" +msgstr "" + +msgid "" +"These functions operate on I/O streams referenced using file descriptors." +msgstr "" + +msgid "" +"File descriptors are small integers corresponding to a file that has been " +"opened by the current process. For example, standard input is usually file " +"descriptor 0, standard output is 1, and standard error is 2. Further files " +"opened by a process will then be assigned 3, 4, 5, and so forth. The name " +"\"file descriptor\" is slightly deceptive; on Unix platforms, sockets and " +"pipes are also referenced by file descriptors." +msgstr "" + +msgid "" +"The :meth:`~io.IOBase.fileno` method can be used to obtain the file " +"descriptor associated with a :term:`file object` when required. Note that " +"using the file descriptor directly will bypass the file object methods, " +"ignoring aspects such as internal buffering of data." +msgstr "" + +msgid "Close file descriptor *fd*." +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." +msgstr "" + +msgid "" +"Close all file descriptors from *fd_low* (inclusive) to *fd_high* " +"(exclusive), ignoring errors. Equivalent to (but much faster than)::" +msgstr "" + +msgid "" +"Copy *count* bytes from file descriptor *src*, starting from offset " +"*offset_src*, to file descriptor *dst*, starting from offset *offset_dst*. " +"If *offset_src* is None, then *src* is read from the current position; " +"respectively for *offset_dst*. The files pointed 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`." +msgstr "" + +msgid "" +"This copy is done without the additional cost of transferring data from the " +"kernel to user space and then back into the kernel. Additionally, some " +"filesystems could implement extra optimizations. The copy is done as if both " +"files are opened as binary." +msgstr "" + +msgid "" +"The return value is the amount of bytes copied. This could be less than the " +"amount requested." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 4.5 with glibc >= 2.27." +msgstr "" + +msgid "" +"Return a string describing the encoding of the device associated with *fd* " +"if it is connected to a terminal; else return :const:`None`." +msgstr "" + +msgid "" +"On Unix, if the :ref:`Python UTF-8 Mode ` is enabled, return " +"``'UTF-8'`` rather than the device encoding." +msgstr "" + +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 `." +msgstr "" + +msgid "" +"On Windows, when duplicating a standard stream (0: stdin, 1: stdout, 2: " +"stderr), the new file descriptor is :ref:`inheritable `." +msgstr "" + +msgid ":ref:`Availability `: not WASI." +msgstr "" + +msgid "The new file descriptor is now non-inheritable." +msgstr "" + +msgid "" +"Duplicate file descriptor *fd* to *fd2*, closing the latter first if " +"necessary. Return *fd2*. The new file descriptor is :ref:`inheritable " +"` by default or non-inheritable if *inheritable* is " +"``False``." +msgstr "" + +msgid "Add the optional *inheritable* parameter." +msgstr "" + +msgid "Return *fd2* on success. Previously, ``None`` was always returned." +msgstr "" + +msgid "" +"Change the mode of the file given by *fd* to the numeric *mode*. See the " +"docs for :func:`chmod` for possible values of *mode*. As of Python 3.3, " +"this is equivalent to ``os.chmod(fd, mode)``." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.chmod`` with arguments " +"``path``, ``mode``, ``dir_fd``." +msgstr "" + +msgid "" +"The function is limited on Emscripten and WASI, see :ref:`wasm-availability` " +"for more information." +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)``." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.chown`` with arguments " +"``path``, ``uid``, ``gid``, ``dir_fd``." +msgstr "" + +msgid "" +"Force write of file with filedescriptor *fd* to disk. Does not force update " +"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 " +"the name of a defined system value; these names are specified in a number of " +"standards (POSIX.1, Unix 95, Unix 98, and others). Some platforms define " +"additional names as well. The names known to the host operating system are " +"given in the ``pathconf_names`` dictionary. For configuration variables not " +"included in that mapping, passing an integer for *name* is also accepted." +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." +msgstr "" + +msgid "As of Python 3.3, this is equivalent to ``os.pathconf(fd, name)``." +msgstr "" + +msgid "" +"Get the status of the file descriptor *fd*. Return a :class:`stat_result` " +"object." +msgstr "" + +msgid "As of Python 3.3, this is equivalent to ``os.stat(fd)``." +msgstr "" + +msgid "The :func:`.stat` function." +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)``." +msgstr "" + +msgid "" +"Force write of file with filedescriptor *fd* to disk. On Unix, this calls " +"the native :c:func:`!fsync` function; on Windows, the MS :c:func:`!_commit` " +"function." +msgstr "" + +msgid "" +"If you're starting with a buffered Python :term:`file object` *f*, first do " +"``f.flush()``, and then do ``os.fsync(f.fileno())``, to ensure that all " +"internal buffers associated with *f* are written to disk." +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)``." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " +"``fd``, ``length``." +msgstr "" + +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." +msgstr "" + +msgid "See also :func:`set_blocking` and :meth:`socket.socket.setblocking`." +msgstr "" + +msgid "" +"Return ``True`` if the file descriptor *fd* is open and connected to a tty(-" +"like) device, else ``False``." +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* " +"specifies the section of the file to lock." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.lockf`` with arguments " +"``fd``, ``cmd``, ``len``." +msgstr "" + +msgid "Flags that specify what action :func:`lockf` will take." +msgstr "" + +msgid "" +"Prepare the tty of which fd is a file descriptor for a new login session. " +"Make the calling process a session leader; make the tty the controlling tty, " +"the stdin, the stdout, and the stderr of the calling process; close fd." +msgstr "" + +msgid "" +"Set the current position of file descriptor *fd* to position *pos*, modified " +"by *whence*, and return the new position in bytes relative to the start of " +"the file. Valid values for *whence* are:" +msgstr "" + +msgid "" +":const:`SEEK_SET` or ``0`` -- set *pos* relative to the beginning of the file" +msgstr "" + +msgid "" +":const:`SEEK_CUR` or ``1`` -- set *pos* relative to the current file position" +msgstr "" + +msgid ":const:`SEEK_END` or ``2`` -- set *pos* relative to the end of the file" +msgstr "" + +msgid "" +":const:`SEEK_HOLE` -- set *pos* to the next data location, relative to *pos*" +msgstr "" + +msgid "" +":const:`SEEK_DATA` -- set *pos* to the next data hole, relative to *pos*" +msgstr "" + +msgid "Add support for :const:`!SEEK_HOLE` and :const:`!SEEK_DATA`." +msgstr "" + +msgid "" +"Parameters to the :func:`lseek` function and the :meth:`~io.IOBase.seek` " +"method on :term:`file-like objects `, for whence to adjust the " +"file position indicator." +msgstr "" + +msgid ":const:`SEEK_SET`" +msgstr ":const:`SEEK_SET`" + +msgid "Adjust the file position relative to the beginning of the file." +msgstr "" + +msgid ":const:`SEEK_CUR`" +msgstr ":const:`SEEK_CUR`" + +msgid "Adjust the file position relative to the current file position." +msgstr "" + +msgid ":const:`SEEK_END`" +msgstr ":const:`SEEK_END`" + +msgid "Adjust the file position relative to the end of the file." +msgstr "" + +msgid "Their values are 0, 1, and 2, respectively." +msgstr "" + +msgid "" +"Parameters to the :func:`lseek` function and the :meth:`~io.IOBase.seek` " +"method on :term:`file-like objects `, for seeking file data and " +"holes on sparsely allocated files." +msgstr "" + +msgid ":data:`!SEEK_DATA`" +msgstr ":data:`!SEEK_DATA`" + +msgid "" +"Adjust the file offset to the next location containing data, relative to the " +"seek position." +msgstr "" + +msgid ":data:`!SEEK_HOLE`" +msgstr ":data:`!SEEK_HOLE`" + +msgid "" +"Adjust the file offset to the next location containing a hole, relative to " +"the seek position. A hole is defined as a sequence of zeros." +msgstr "" + +msgid "These operations only make sense for filesystems that support them." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 3.1, macOS, Unix" +msgstr "" + +msgid "" +"Open the file *path* and set various flags according to *flags* and possibly " +"its mode according to *mode*. When computing *mode*, the current umask " +"value is first masked out. Return the file descriptor for the newly opened " +"file. The new file descriptor is :ref:`non-inheritable `." +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." +msgstr "" + +msgid "" +"This function can support :ref:`paths relative to directory descriptors " +"` with the *dir_fd* parameter." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " +"``mode``, ``flags``." +msgstr "" +"Rzuca :ref:`auditing event ` ``open`` z argumentami ``path`` , " +"``mode``, ``flags``." + +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:`~file.read` and :meth:`~file.write` methods (and many more). To wrap " +"a file descriptor in a file object, use :func:`fdopen`." +msgstr "" + +msgid "Added the *dir_fd* parameter." +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)." +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 "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." +msgstr "" + +msgid "The above constants are available on Unix and Windows." +msgstr "" + +msgid "The above constants are only available on Unix." +msgstr "" + +msgid "Add :data:`O_CLOEXEC` constant." +msgstr "" + +msgid "The above constants are only available on Windows." +msgstr "" + +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." +msgstr "" + +msgid "" +"The above constants are extensions and not present if they are not defined " +"by the C library." +msgstr "" + +msgid "" +"Add :data:`O_PATH` on systems that support it. Add :data:`O_TMPFILE`, only " +"available on Linux Kernel 3.11 or newer." +msgstr "" + +msgid "" +"Open a new pseudo-terminal pair. Return a pair of file descriptors " +"``(master, slave)`` for the pty and the tty, respectively. The new file " +"descriptors are :ref:`non-inheritable `. For a (slightly) " +"more portable approach, use the :mod:`pty` module." +msgstr "" + +msgid "The new file descriptors are now non-inheritable." +msgstr "" + +msgid "" +"Create a pipe. Return a pair of file descriptors ``(r, w)`` usable for " +"reading and writing, respectively. The new file descriptor is :ref:`non-" +"inheritable `." +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." +msgstr "" + +msgid "" +"Ensures that enough disk space is allocated for the file specified by *fd* " +"starting from *offset* and continuing for *len* bytes." +msgstr "" + +msgid ":ref:`Availability `: Unix, not Emscripten." +msgstr "" + +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`." +msgstr "" + +msgid "" +"Flags that can be used in *advice* in :func:`posix_fadvise` that specify the " +"access pattern that is likely to be used." +msgstr "" + +msgid "" +"Read at most *n* bytes from file descriptor *fd* at a position of *offset*, " +"leaving the file offset unchanged." +msgstr "" + +msgid "" +"Return a bytestring containing the bytes read. If the end of the file " +"referred to by *fd* has been reached, an empty bytes object is returned." +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." +msgstr "" + +msgid "" +"The flags argument contains a bitwise OR of zero or more of the following " +"flags:" +msgstr "" + +msgid ":data:`RWF_HIPRI`" +msgstr ":data:`RWF_HIPRI`" + +msgid ":data:`RWF_NOWAIT`" +msgstr ":data:`RWF_NOWAIT`" + +msgid "" +"Return the total number of bytes actually read which can be less than the " +"total capacity of all the objects." +msgstr "" + +msgid "" +"The operating system may set a limit (:func:`sysconf` value " +"``'SC_IOV_MAX'``) on the number of buffers that can be used." +msgstr "" + +msgid "Combine the functionality of :func:`os.readv` and :func:`os.pread`." +msgstr "" + +msgid "" +":ref:`Availability `: Linux >= 2.6.30, FreeBSD >= 6.0, OpenBSD " +">= 2.7, AIX >= 7.1." +msgstr "" + +msgid "Using flags requires Linux >= 4.6." +msgstr "" + +msgid "" +"Do not wait for data which is not immediately available. If this flag is " +"specified, the system call will return instantly if it would have to read " +"data from the backing storage or wait for a lock." +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`." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 4.14." +msgstr "" + +msgid "" +"High priority read/write. Allows block-based filesystems to use polling of " +"the device, which provides lower latency, but may use additional resources." +msgstr "" + +msgid "" +"Currently, on Linux, this feature is usable only on a file descriptor opened " +"using the :data:`O_DIRECT` flag." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 4.6." +msgstr "" + +msgid "" +"Write the bytestring in *str* to file descriptor *fd* at position of " +"*offset*, leaving the file offset unchanged." +msgstr "" + +msgid "Return the number of bytes actually written." +msgstr "" + +msgid "" +"Write the *buffers* contents to file descriptor *fd* at a 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." +msgstr "" + +msgid ":data:`RWF_DSYNC`" +msgstr ":data:`RWF_DSYNC`" + +msgid ":data:`RWF_SYNC`" +msgstr ":data:`RWF_SYNC`" + +msgid ":data:`RWF_APPEND`" +msgstr ":data:`RWF_APPEND`" + +msgid "Return the total number of bytes actually written." +msgstr "" + +msgid "Combine the functionality of :func:`os.writev` and :func:`os.pwrite`." +msgstr "" + +msgid "" +"Provide a per-write equivalent of the :data:`O_DSYNC` :func:`os.open` flag. " +"This flag effect applies only to the data range written by the system call." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 4.7." +msgstr "" + +msgid "" +"Provide a per-write equivalent of the :data:`O_SYNC` :func:`os.open` flag. " +"This flag effect applies only to the data range written by the system call." +msgstr "" + +msgid "" +"Provide a per-write equivalent of the :data:`O_APPEND` :func:`os.open` flag. " +"This flag is meaningful only for :func:`os.pwritev`, and its effect applies " +"only to the data range written by the system call. The *offset* argument " +"does not affect the write operation; the data is always appended to the end " +"of the file. However, if the *offset* argument is ``-1``, the current file " +"*offset* is updated." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 4.16." +msgstr "" + +msgid "Read at most *n* bytes from file descriptor *fd*." +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 read a \"file " +"object\" returned by the built-in function :func:`open` or by :func:`popen` " +"or :func:`fdopen`, or :data:`sys.stdin`, use its :meth:`~file.read` or :meth:" +"`~file.readline` methods." +msgstr "" + +msgid "" +"Copy *count* bytes from file descriptor *in_fd* to file descriptor *out_fd* " +"starting at *offset*. Return the number of bytes sent. When EOF is reached " +"return ``0``." +msgstr "" + +msgid "" +"The first function notation is supported by all platforms that define :func:" +"`sendfile`." +msgstr "" + +msgid "" +"On Linux, if *offset* is given as ``None``, the bytes are read from the " +"current position of *in_fd* and the position of *in_fd* is updated." +msgstr "" + +msgid "" +"The second case may be used on macOS and FreeBSD where *headers* and " +"*trailers* are arbitrary sequences of buffers that are written before and " +"after the data from *in_fd* is written. It returns the same as the first " +"case." +msgstr "" + +msgid "" +"On macOS and FreeBSD, a value of ``0`` for *count* specifies to send until " +"the end of *in_fd* is reached." +msgstr "" + +msgid "" +"All platforms support sockets as *out_fd* file descriptor, and some " +"platforms allow other types (e.g. regular file, pipe) as well." +msgstr "" + +msgid "" +"Cross-platform applications should not use *headers*, *trailers* and *flags* " +"arguments." +msgstr "" + +msgid "" +"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*." +msgstr "" + +msgid "" +"Parameters to the :func:`sendfile` function, if the implementation supports " +"them." +msgstr "" + +msgid "" +"Parameter to the :func:`sendfile` function, if the implementation supports " +"it. The data won't be cached in the virtual memory and will be freed " +"afterwards." +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." +msgstr "" + +msgid "See also :func:`get_blocking` and :meth:`socket.socket.setblocking`." +msgstr "" + +msgid "" +"Transfer *count* bytes from file descriptor *src*, starting from offset " +"*offset_src*, to file descriptor *dst*, starting from offset *offset_dst*. " +"At least one of the file descriptors must refer to a pipe. If *offset_src* " +"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 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`." +msgstr "" + +msgid "" +"Upon successful completion, returns the number of bytes spliced to or from " +"the pipe. A return value of 0 means end of input. If *src* refers to a pipe, " +"then this means that there was no data to transfer, and it would not make " +"sense to block because there are no writers connected to the write end of " +"the pipe." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.17 with glibc >= 2.5" +msgstr "" + +msgid "" +"Read from a file descriptor *fd* into a number of mutable :term:`bytes-like " +"objects ` *buffers*. 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 "" +"Return the process group associated with the terminal given by *fd* (an open " +"file descriptor as returned by :func:`os.open`)." +msgstr "" + +msgid ":ref:`Availability `: Unix, not WASI." +msgstr "" + +msgid "" +"Set the process group associated with the terminal given by *fd* (an open " +"file descriptor as returned by :func:`os.open`) to *pg*." +msgstr "" + +msgid "" +"Return a string which specifies the terminal device associated with file " +"descriptor *fd*. If *fd* is not associated with a terminal device, an " +"exception is raised." +msgstr "" + +msgid "Write the bytestring in *str* to file descriptor *fd*." +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:`~file.write` method." +msgstr "" + +msgid "" +"Write the contents of *buffers* to file descriptor *fd*. *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 "Returns the total number of bytes actually written." +msgstr "" + +msgid "Querying the size of a terminal" +msgstr "" + +msgid "" +"Return the size of the terminal window as ``(columns, lines)``, tuple of " +"type :class:`terminal_size`." +msgstr "" + +msgid "" +"The optional argument ``fd`` (default ``STDOUT_FILENO``, or standard output) " +"specifies which file descriptor should be queried." +msgstr "" + +msgid "" +"If the file descriptor is not connected to a terminal, an :exc:`OSError` is " +"raised." +msgstr "" + +msgid "" +":func:`shutil.get_terminal_size` is the high-level function which should " +"normally be used, ``os.get_terminal_size`` is the low-level implementation." +msgstr "" + +msgid "" +"A subclass of tuple, holding ``(columns, lines)`` of the terminal window " +"size." +msgstr "" + +msgid "Width of the terminal window in characters." +msgstr "" + +msgid "Height of the terminal window in characters." +msgstr "" + +msgid "Inheritance of File Descriptors" +msgstr "" + +msgid "" +"A file descriptor has an \"inheritable\" flag which indicates if the file " +"descriptor can be inherited by child processes. Since Python 3.4, file " +"descriptors created by Python are non-inheritable by default." +msgstr "" + +msgid "" +"On UNIX, non-inheritable file descriptors are closed in child processes at " +"the execution of a new program, other file descriptors are inherited." +msgstr "" + +msgid "" +"On Windows, non-inheritable handles and file descriptors are closed in child " +"processes, except for standard streams (file descriptors 0, 1 and 2: stdin, " +"stdout and stderr), which are always inherited. Using :func:`spawn\\* " +"` functions, all inheritable handles and all inheritable file " +"descriptors are inherited. Using the :mod:`subprocess` module, all file " +"descriptors except standard streams are closed, and inheritable handles are " +"only inherited if the *close_fds* parameter is ``False``." +msgstr "" + +msgid "" +"On WebAssembly platforms ``wasm32-emscripten`` and ``wasm32-wasi``, the file " +"descriptor cannot be modified." +msgstr "" + +msgid "" +"Get the \"inheritable\" flag of the specified file descriptor (a boolean)." +msgstr "" + +msgid "Set the \"inheritable\" flag of the specified file descriptor." +msgstr "" + +msgid "Get the \"inheritable\" flag of the specified handle (a boolean)." +msgstr "" + +msgid ":ref:`Availability `: Windows." +msgstr "" + +msgid "Set the \"inheritable\" flag of the specified handle." +msgstr "" + +msgid "Files and Directories" +msgstr "" + +msgid "" +"On some Unix platforms, many of these functions support one or more of these " +"features:" +msgstr "" + +msgid "" +"**specifying a file descriptor:** Normally the *path* argument provided to " +"functions in the :mod:`os` module must be a string specifying a file path. " +"However, some functions now alternatively accept an open file descriptor for " +"their *path* argument. The function will then operate on the file referred " +"to by the descriptor. (For POSIX systems, Python will call the variant of " +"the function prefixed with ``f`` (e.g. call ``fchdir`` instead of " +"``chdir``).)" +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`." +msgstr "" + +msgid "" +"If the function also supports *dir_fd* or *follow_symlinks* arguments, it's " +"an error to specify one of those when supplying *path* as a file descriptor." +msgstr "" + +msgid "" +"**paths relative to directory descriptors:** If *dir_fd* is not ``None``, it " +"should be a file descriptor referring to a directory, and the path to " +"operate on should be relative; path will then be relative to that " +"directory. If the path is absolute, *dir_fd* is ignored. (For POSIX " +"systems, Python will call the variant of the function with an ``at`` suffix " +"and possibly prefixed with ``f`` (e.g. call ``faccessat`` instead of " +"``access``)." +msgstr "" + +msgid "" +"You can check whether or not *dir_fd* is supported for a particular function " +"on your platform using :data:`os.supports_dir_fd`. If it's unavailable, " +"using it will raise a :exc:`NotImplementedError`." +msgstr "" + +msgid "" +"**not following symlinks:** If *follow_symlinks* is ``False``, and the last " +"element of the path to operate on is a symbolic link, the function will " +"operate on the symbolic link itself rather than the file pointed to by the " +"link. (For POSIX systems, Python will call the ``l...`` variant of the " +"function.)" +msgstr "" + +msgid "" +"You can check whether or not *follow_symlinks* is supported for a particular " +"function on your platform using :data:`os.supports_follow_symlinks`. If it's " +"unavailable, using it will raise a :exc:`NotImplementedError`." +msgstr "" + +msgid "" +"Use the real uid/gid to test for access to *path*. Note that most " +"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." +msgstr "" + +msgid "" +"This function can support specifying :ref:`paths relative to directory " +"descriptors ` and :ref:`not following symlinks `." +msgstr "" + +msgid "" +"If *effective_ids* is ``True``, :func:`access` will perform its access " +"checks using the effective uid/gid instead of the real uid/gid. " +"*effective_ids* may not be supported on your platform; you can check whether " +"or not it is available using :data:`os.supports_effective_ids`. If it is " +"unavailable, using it will raise a :exc:`NotImplementedError`." +msgstr "" + +msgid "" +"Using :func:`access` to check if a user is authorized to e.g. open a file " +"before actually doing so using :func:`open` creates a security hole, because " +"the user might exploit the short time interval between checking and opening " +"the file to manipulate it. It's preferable to use :term:`EAFP` techniques. " +"For example::" +msgstr "" + +msgid "is better written as::" +msgstr "" + +msgid "" +"I/O operations may fail even when :func:`access` indicates that they would " +"succeed, particularly for operations on network filesystems which may have " +"permissions semantics beyond the usual POSIX permission-bit model." +msgstr "" + +msgid "Added the *dir_fd*, *effective_ids*, and *follow_symlinks* parameters." +msgstr "" + +msgid "" +"Values to pass as the *mode* parameter of :func:`access` to test the " +"existence, readability, writability and executability of *path*, " +"respectively." +msgstr "" + +msgid "Change the current working directory to *path*." +msgstr "" + +msgid "" +"This function can support :ref:`specifying a file descriptor `. " +"The descriptor must refer to an opened directory, not an open file." +msgstr "" + +msgid "" +"This function can raise :exc:`OSError` and subclasses such as :exc:" +"`FileNotFoundError`, :exc:`PermissionError`, and :exc:`NotADirectoryError`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.chdir`` with argument " +"``path``." +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):" +msgstr "" + +msgid ":const:`stat.UF_NODUMP`" +msgstr ":const:`stat.UF_NODUMP`" + +msgid ":const:`stat.UF_IMMUTABLE`" +msgstr ":const:`stat.UF_IMMUTABLE`" + +msgid ":const:`stat.UF_APPEND`" +msgstr ":const:`stat.UF_APPEND`" + +msgid ":const:`stat.UF_OPAQUE`" +msgstr ":const:`stat.UF_OPAQUE`" + +msgid ":const:`stat.UF_NOUNLINK`" +msgstr ":const:`stat.UF_NOUNLINK`" + +msgid ":const:`stat.UF_COMPRESSED`" +msgstr ":const:`stat.UF_COMPRESSED`" + +msgid ":const:`stat.UF_HIDDEN`" +msgstr ":const:`stat.UF_HIDDEN`" + +msgid ":const:`stat.SF_ARCHIVED`" +msgstr ":const:`stat.SF_ARCHIVED`" + +msgid ":const:`stat.SF_IMMUTABLE`" +msgstr ":const:`stat.SF_IMMUTABLE`" + +msgid ":const:`stat.SF_APPEND`" +msgstr ":const:`stat.SF_APPEND`" + +msgid ":const:`stat.SF_NOUNLINK`" +msgstr ":const:`stat.SF_NOUNLINK`" + +msgid ":const:`stat.SF_SNAPSHOT`" +msgstr ":const:`stat.SF_SNAPSHOT`" + +msgid "" +"This function can support :ref:`not following symlinks `." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.chflags`` with arguments " +"``path``, ``flags``." +msgstr "" + +msgid "Added the *follow_symlinks* parameter." +msgstr "" + +msgid "" +"Change the mode of *path* to the numeric *mode*. *mode* may take one of the " +"following values (as defined in the :mod:`stat` module) or bitwise ORed " +"combinations of them:" +msgstr "" + +msgid ":const:`stat.S_ISUID`" +msgstr ":const:`stat.S_ISUID`" + +msgid ":const:`stat.S_ISGID`" +msgstr ":const:`stat.S_ISGID`" + +msgid ":const:`stat.S_ENFMT`" +msgstr ":const:`stat.S_ENFMT`" + +msgid ":const:`stat.S_ISVTX`" +msgstr ":const:`stat.S_ISVTX`" + +msgid ":const:`stat.S_IREAD`" +msgstr ":const:`stat.S_IREAD`" + +msgid ":const:`stat.S_IWRITE`" +msgstr ":const:`stat.S_IWRITE`" + +msgid ":const:`stat.S_IEXEC`" +msgstr ":const:`stat.S_IEXEC`" + +msgid ":const:`stat.S_IRWXU`" +msgstr ":const:`stat.S_IRWXU`" + +msgid ":const:`stat.S_IRUSR`" +msgstr ":const:`stat.S_IRUSR`" + +msgid ":const:`stat.S_IWUSR`" +msgstr ":const:`stat.S_IWUSR`" + +msgid ":const:`stat.S_IXUSR`" +msgstr ":const:`stat.S_IXUSR`" + +msgid ":const:`stat.S_IRWXG`" +msgstr ":const:`stat.S_IRWXG`" + +msgid ":const:`stat.S_IRGRP`" +msgstr ":const:`stat.S_IRGRP`" + +msgid ":const:`stat.S_IWGRP`" +msgstr ":const:`stat.S_IWGRP`" + +msgid ":const:`stat.S_IXGRP`" +msgstr ":const:`stat.S_IXGRP`" + +msgid ":const:`stat.S_IRWXO`" +msgstr ":const:`stat.S_IRWXO`" + +msgid ":const:`stat.S_IROTH`" +msgstr ":const:`stat.S_IROTH`" + +msgid ":const:`stat.S_IWOTH`" +msgstr ":const:`stat.S_IWOTH`" + +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 `." +msgstr "" + +msgid "" +"Although Windows supports :func:`chmod`, you can only set the file's read-" +"only flag with it (via the ``stat.S_IWRITE`` and ``stat.S_IREAD`` constants " +"or a corresponding integer value). All other bits are ignored." +msgstr "" + +msgid "" +"Added support for specifying *path* as an open file descriptor, and the " +"*dir_fd* and *follow_symlinks* arguments." +msgstr "" + +msgid "" +"Change the owner and group id of *path* to the numeric *uid* and *gid*. To " +"leave one of the ids unchanged, set it to -1." +msgstr "" + +msgid "" +"See :func:`shutil.chown` for a higher-level function that accepts names in " +"addition to numeric ids." +msgstr "" + +msgid "Supports a :term:`path-like object`." +msgstr "" + +msgid "Change the root directory of the current process to *path*." +msgstr "" + +msgid "" +"Change the current working directory to the directory represented by the " +"file descriptor *fd*. The descriptor must refer to an opened directory, not " +"an open file. As of Python 3.3, this is equivalent to ``os.chdir(fd)``." +msgstr "" + +msgid "Return a string representing the current working directory." +msgstr "" + +msgid "Return a bytestring representing the current working directory." +msgstr "" + +msgid "" +"The function now uses the UTF-8 encoding on Windows, rather than the ANSI " +"code page: see :pep:`529` for the rationale. The function is no longer " +"deprecated on Windows." +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)``." +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)``." +msgstr "" + +msgid "" +"``lchmod()`` is not part of POSIX, but Unix implementations may have it if " +"changing the mode of symbolic links is supported." +msgstr "" + +msgid "" +":ref:`Availability `: Unix, not Linux, FreeBSD >= 1.3, NetBSD " +">= 1.3, not OpenBSD" +msgstr "" + +msgid "" +"Change the owner and group id of *path* to the numeric *uid* and *gid*. " +"This function will not follow symbolic links. As of Python 3.3, this is " +"equivalent to ``os.chown(path, uid, gid, follow_symlinks=False)``." +msgstr "" + +msgid "Create a hard link pointing to *src* named *dst*." +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 `." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.link`` with arguments " +"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." +msgstr "" + +msgid ":ref:`Availability `: Unix, Windows, not Emscripten." +msgstr "" + +msgid "Added Windows support." +msgstr "Dodano wsparcie dla WIndowsa." + +msgid "Added the *src_dir_fd*, *dst_dir_fd*, and *follow_symlinks* parameters." +msgstr "" + +msgid "Accepts a :term:`path-like object` for *src* and *dst*." +msgstr "" + +msgid "" +"Return a list containing the names of the entries in the directory given by " +"*path*. The list is in arbitrary order, and does not include the special " +"entries ``'.'`` and ``'..'`` even if they are present in the directory. If a " +"file is removed from or added to the directory during the call of this " +"function, whether a name for that file be included is unspecified." +msgstr "" + +msgid "" +"*path* may be a :term:`path-like object`. If *path* is of type ``bytes`` " +"(directly or indirectly through the :class:`PathLike` interface), the " +"filenames returned will also be of type ``bytes``; in all other " +"circumstances, they will be of type ``str``." +msgstr "" + +msgid "" +"This function can also support :ref:`specifying a file descriptor " +"`; the file descriptor must refer to a directory." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.listdir`` with argument " +"``path``." +msgstr "" + +msgid "To encode ``str`` filenames to ``bytes``, use :func:`~os.fsencode`." +msgstr "" + +msgid "" +"The :func:`scandir` function returns directory entries along with file " +"attribute information, giving better performance for many common use cases." +msgstr "" + +msgid "The *path* parameter became optional." +msgstr "" + +msgid "Added support for specifying *path* as an open file descriptor." +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." +msgstr "" + +msgid "" +"On platforms that do not support symbolic links, this is an alias for :func:" +"`~os.stat`." +msgstr "" + +msgid "" +"As of Python 3.3, this is equivalent to ``os.stat(path, dir_fd=dir_fd, " +"follow_symlinks=False)``." +msgstr "" + +msgid "" +"This function can also support :ref:`paths relative to directory descriptors " +"`." +msgstr "" + +msgid "Added support for Windows 6.0 (Vista) symbolic links." +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`." +msgstr "" + +msgid "Create a directory named *path* with numeric mode *mode*." +msgstr "" + +msgid "" +"If the directory already exists, :exc:`FileExistsError` is raised. If a " +"parent directory in the path does not exist, :exc:`FileNotFoundError` is " +"raised." +msgstr "" + +msgid "" +"On some systems, *mode* is ignored. Where it is used, the current umask " +"value is first masked out. If bits other than the last 9 (i.e. the last 3 " +"digits of the octal representation of the *mode*) are set, their meaning is " +"platform-dependent. On some platforms, they are ignored and you should " +"call :func:`chmod` explicitly to set them." +msgstr "" + +msgid "" +"On Windows, a *mode* of ``0o700`` is specifically handled to apply access " +"control to the new directory such that only the current user and " +"administrators have access. Other values of *mode* are ignored." +msgstr "" + +msgid "" +"It is also possible to create temporary directories; see the :mod:`tempfile` " +"module's :func:`tempfile.mkdtemp` function." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.mkdir`` with arguments " +"``path``, ``mode``, ``dir_fd``." +msgstr "" + +msgid "Windows now handles a *mode* of ``0o700``." +msgstr "" + +msgid "" +"Recursive directory creation function. Like :func:`mkdir`, but makes all " +"intermediate-level directories needed to contain the leaf directory." +msgstr "" + +msgid "" +"The *mode* parameter is passed to :func:`mkdir` for creating the leaf " +"directory; see :ref:`the mkdir() description ` for how it is " +"interpreted. To set the file permission bits of any newly created parent " +"directories you can set the umask before invoking :func:`makedirs`. The " +"file permission bits of existing parent directories are not changed." +msgstr "" + +msgid "" +"If *exist_ok* is ``False`` (the default), a :exc:`FileExistsError` is raised " +"if the target directory already exists." +msgstr "" + +msgid "" +":func:`makedirs` will become confused if the path elements to create " +"include :data:`pardir` (eg. \"..\" on UNIX systems)." +msgstr "" + +msgid "This function handles UNC paths correctly." +msgstr "" + +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`." +msgstr "" + +msgid "" +"The *mode* argument no longer affects the file permission bits of newly " +"created intermediate-level directories." +msgstr "" + +msgid "" +"Create a FIFO (a named pipe) named *path* with numeric mode *mode*. The " +"current umask value is first masked out from the mode." +msgstr "" + +msgid "" +"FIFOs are pipes that can be accessed like regular files. FIFOs exist until " +"they are deleted (for example with :func:`os.unlink`). Generally, FIFOs are " +"used as rendezvous between \"client\" and \"server\" type processes: the " +"server opens the FIFO for reading, and the client opens it for writing. " +"Note that :func:`mkfifo` doesn't open the FIFO --- it just creates the " +"rendezvous point." +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." +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`)." +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`)." +msgstr "" + +msgid "Compose a raw device number from the major and minor device numbers." +msgstr "" + +msgid "" +"Return system configuration information relevant to a named file. *name* " +"specifies the configuration value to retrieve; it may be a string which is " +"the name of a defined system value; these names are specified in a number of " +"standards (POSIX.1, Unix 95, Unix 98, and others). Some platforms define " +"additional names as well. The names known to the host operating system are " +"given in the ``pathconf_names`` dictionary. For configuration variables not " +"included in that mapping, passing an integer for *name* is also accepted." +msgstr "" + +msgid "" +"This function can support :ref:`specifying a file descriptor `." +msgstr "" + +msgid "" +"Dictionary mapping names accepted by :func:`pathconf` and :func:`fpathconf` " +"to the integer values defined for those names by the host operating system. " +"This can be used to determine the set of names known to the system." +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)``." +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." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "Accepts a :term:`path-like object` and a bytes object on Windows." +msgstr "" + +msgid "" +"Added support for directory junctions, and changed to return the " +"substitution path (which typically includes ``\\\\?\\`` prefix) rather than " +"the optional \"print name\" field that was previously returned." +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." +msgstr "" + +msgid "" +"This function can support :ref:`paths relative to directory descriptors " +"`." +msgstr "" + +msgid "" +"On Windows, attempting to remove a file that is in use causes an exception " +"to be raised; on Unix, the directory entry is removed but the storage " +"allocated to the file is not made available until the original file is no " +"longer in use." +msgstr "" + +msgid "This function is semantically identical to :func:`unlink`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.remove`` with arguments " +"``path``, ``dir_fd``." +msgstr "" + +msgid "" +"Remove directories recursively. Works like :func:`rmdir` except that, if " +"the leaf directory is successfully removed, :func:`removedirs` tries to " +"successively remove every parent directory mentioned in *path* until an " +"error is raised (which is ignored, because it generally means that a parent " +"directory is not empty). For example, ``os.removedirs('foo/bar/baz')`` will " +"first remove the directory ``'foo/bar/baz'``, and then remove ``'foo/bar'`` " +"and ``'foo'`` if they are empty. Raises :exc:`OSError` if the leaf directory " +"could not be successfully removed." +msgstr "" + +msgid "" +"Rename the file or directory *src* to *dst*. If *dst* exists, the operation " +"will fail with an :exc:`OSError` subclass in a number of cases:" +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." +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 " +"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 " +"permission. The operation may fail on some Unix flavors if *src* and *dst* " +"are on different filesystems. If successful, the renaming will be an atomic " +"operation (this is a POSIX requirement)." +msgstr "" + +msgid "" +"This function can support specifying *src_dir_fd* and/or *dst_dir_fd* to " +"supply :ref:`paths relative to directory descriptors `." +msgstr "" + +msgid "" +"If you want cross-platform overwriting of the destination, use :func:" +"`replace`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.rename`` with arguments " +"``src``, ``dst``, ``src_dir_fd``, ``dst_dir_fd``." +msgstr "" + +msgid "Added the *src_dir_fd* and *dst_dir_fd* parameters." +msgstr "" + +msgid "" +"Recursive directory or file renaming function. Works like :func:`rename`, " +"except creation of any intermediate directories needed to make the new " +"pathname good is attempted first. After the rename, directories " +"corresponding to rightmost path segments of the old name will be pruned away " +"using :func:`removedirs`." +msgstr "" + +msgid "" +"This function can fail with the new directory structure made if you lack " +"permissions needed to remove the leaf directory or file." +msgstr "" + +msgid "Accepts a :term:`path-like object` for *old* and *new*." +msgstr "" + +msgid "" +"Rename the file or directory *src* to *dst*. If *dst* is a non-empty " +"directory, :exc:`OSError` will be raised. If *dst* exists and is a file, it " +"will be replaced silently if the user has permission. The operation may " +"fail if *src* and *dst* are on different filesystems. If successful, the " +"renaming will be an atomic operation (this is a POSIX requirement)." +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." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.rmdir`` with arguments " +"``path``, ``dir_fd``." +msgstr "" + +msgid "" +"Return an iterator of :class:`os.DirEntry` objects corresponding to the " +"entries in the directory given by *path*. The entries are yielded in " +"arbitrary order, and the special entries ``'.'`` and ``'..'`` are not " +"included. If a file is removed from or added to the directory after " +"creating the iterator, whether an entry for that file be included is " +"unspecified." +msgstr "" + +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." +msgstr "" + +msgid "" +"*path* may be a :term:`path-like object`. If *path* is of type ``bytes`` " +"(directly or indirectly through the :class:`PathLike` interface), the type " +"of the :attr:`~os.DirEntry.name` and :attr:`~os.DirEntry.path` attributes of " +"each :class:`os.DirEntry` will be ``bytes``; in all other circumstances, " +"they will be of type ``str``." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.scandir`` with argument " +"``path``." +msgstr "" + +msgid "" +"The :func:`scandir` iterator supports the :term:`context manager` protocol " +"and has the following method:" +msgstr "" + +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 " +"advisable to call it explicitly or use the :keyword:`with` statement." +msgstr "" + +msgid "" +"The following example shows a simple use of :func:`scandir` to display all " +"the files (excluding directories) in the given *path* that don't start with " +"``'.'``. The ``entry.is_file()`` call will generally not make an additional " +"system call::" +msgstr "" + +msgid "" +"On Unix-based systems, :func:`scandir` uses the system's `opendir() `_ and " +"`readdir() `_ functions. On Windows, it uses the Win32 `FindFirstFileW " +"`_ 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." +msgstr "" + +msgid "The function accepts a :term:`path-like object`." +msgstr "" + +msgid "Added support for :ref:`file descriptors ` on Unix." +msgstr "" + +msgid "" +"Object yielded by :func:`scandir` to expose the file path and other file " +"attributes of a directory entry." +msgstr "" + +msgid "" +":func:`scandir` will provide as much of this information as possible without " +"making additional system calls. When a ``stat()`` or ``lstat()`` system call " +"is made, the ``os.DirEntry`` object will cache the result." +msgstr "" + +msgid "" +"``os.DirEntry`` instances are not intended to be stored in long-lived data " +"structures; if you know the file metadata has changed or if a long time has " +"elapsed since calling :func:`scandir`, call ``os.stat(entry.path)`` to fetch " +"up-to-date information." +msgstr "" + +msgid "" +"Because the ``os.DirEntry`` methods can make operating system calls, they " +"may also raise :exc:`OSError`. If you need very fine-grained control over " +"errors, you can catch :exc:`OSError` when calling one of the ``os.DirEntry`` " +"methods and handle as appropriate." +msgstr "" + +msgid "" +"To be directly usable as a :term:`path-like object`, ``os.DirEntry`` " +"implements the :class:`PathLike` interface." +msgstr "" + +msgid "Attributes and methods on a ``os.DirEntry`` instance are as follows:" +msgstr "" + +msgid "" +"The entry's base filename, relative to the :func:`scandir` *path* argument." +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." +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 :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." +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." +msgstr "" + +msgid "" +"On the first, uncached call, a system call is required on Windows but not on " +"Unix." +msgstr "" + +msgid "" +"Return ``True`` if this entry is a directory or a symbolic link pointing to " +"a directory; return ``False`` if the entry is or points to any other kind of " +"file, or if it doesn't exist anymore." +msgstr "" + +msgid "" +"If *follow_symlinks* is ``False``, return ``True`` only if this entry is a " +"directory (without following symlinks); return ``False`` if the entry is any " +"other kind of file or if it doesn't exist anymore." +msgstr "" + +msgid "" +"The result is cached on the ``os.DirEntry`` object, with a separate cache " +"for *follow_symlinks* ``True`` and ``False``. Call :func:`os.stat` along " +"with :func:`stat.S_ISDIR` to fetch up-to-date information." +msgstr "" + +msgid "" +"On the first, uncached call, no system call is required in most cases. " +"Specifically, for non-symlinks, neither Windows or Unix require a system " +"call, except on certain Unix file systems, such as network file systems, " +"that return ``dirent.d_type == DT_UNKNOWN``. If the entry is a symlink, a " +"system call will be required to follow the symlink unless *follow_symlinks* " +"is ``False``." +msgstr "" + +msgid "" +"This method can raise :exc:`OSError`, such as :exc:`PermissionError`, but :" +"exc:`FileNotFoundError` is caught and not raised." +msgstr "" + +msgid "" +"Return ``True`` if this entry is a file or a symbolic link pointing to a " +"file; return ``False`` if the entry is or points to a directory or other non-" +"file entry, or if it doesn't exist anymore." +msgstr "" + +msgid "" +"If *follow_symlinks* is ``False``, return ``True`` only if this entry is a " +"file (without following symlinks); return ``False`` if the entry is a " +"directory or other non-file entry, or if it doesn't exist anymore." +msgstr "" + +msgid "" +"The result is cached on the ``os.DirEntry`` object. Caching, system calls " +"made, and exceptions raised are as per :func:`~os.DirEntry.is_dir`." +msgstr "" + +msgid "" +"Return ``True`` if this entry is a symbolic link (even if broken); return " +"``False`` if the entry points to a directory or any kind of file, or if it " +"doesn't exist anymore." +msgstr "" + +msgid "" +"The result is cached on the ``os.DirEntry`` object. Call :func:`os.path." +"islink` to fetch up-to-date information." +msgstr "" + +msgid "" +"On the first, uncached call, no system call is required in most cases. " +"Specifically, neither Windows or Unix require a system call, except on " +"certain Unix file systems, such as network file systems, that return " +"``dirent.d_type == DT_UNKNOWN``." +msgstr "" + +msgid "" +"Return a :class:`stat_result` object for this entry. This method follows " +"symbolic links by default; to stat a symbolic link add the " +"``follow_symlinks=False`` argument." +msgstr "" + +msgid "" +"On Unix, this method always requires a system call. On Windows, it only " +"requires a system call if *follow_symlinks* is ``True`` and the entry is a " +"reparse point (for example, a symbolic link or directory junction)." +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 " +"these attributes." +msgstr "" + +msgid "" +"The result is cached on the ``os.DirEntry`` object, with a separate cache " +"for *follow_symlinks* ``True`` and ``False``. Call :func:`os.stat` to fetch " +"up-to-date information." +msgstr "" + +msgid "" +"Note that there is a nice correspondence between several attributes and " +"methods of ``os.DirEntry`` and of :class:`pathlib.Path`. In particular, the " +"``name`` attribute has the same meaning, as do the ``is_dir()``, " +"``is_file()``, ``is_symlink()`` and ``stat()`` methods." +msgstr "" + +msgid "" +"Added support for the :class:`~os.PathLike` interface. Added support for :" +"class:`bytes` paths on Windows." +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." +msgstr "" + +msgid "" +"This function normally follows symlinks; to stat a symlink add the argument " +"``follow_symlinks=False``, or use :func:`lstat`." +msgstr "" + +msgid "" +"This function can support :ref:`specifying a file descriptor ` and :" +"ref:`not following symlinks `." +msgstr "" + +msgid "" +"On Windows, passing ``follow_symlinks=False`` will disable following all " +"name-surrogate reparse points, which includes symlinks and directory " +"junctions. Other types of reparse points that do not resemble links or that " +"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." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid ":func:`fstat` and :func:`lstat` functions." +msgstr "" + +msgid "" +"Added the *dir_fd* and *follow_symlinks* parameters, specifying a file " +"descriptor instead of a path." +msgstr "" + +msgid "" +"On Windows, all reparse points that can be resolved by the operating system " +"are now followed, and passing ``follow_symlinks=False`` disables following " +"all name surrogate reparse points. If the operating system reaches a reparse " +"point that it is not able to follow, *stat* now returns the information for " +"the original path as if ``follow_symlinks=False`` had been specified instead " +"of raising an error." +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`." +msgstr "" + +msgid "Attributes:" +msgstr "" + +msgid "File mode: file type and file mode bits (permissions)." +msgstr "" + +msgid "" +"Platform dependent, but if non-zero, uniquely identifies the file for a " +"given value of ``st_dev``. Typically:" +msgstr "" + +msgid "the inode number on Unix," +msgstr "" + +msgid "" +"the `file index `_ on " +"Windows" +msgstr "" + +msgid "Identifier of the device on which this file resides." +msgstr "" + +msgid "Number of hard links." +msgstr "" + +msgid "User identifier of the file owner." +msgstr "" + +msgid "Group identifier of the file owner." +msgstr "" + +msgid "" +"Size of the file in bytes, if it is a regular file or a symbolic link. The " +"size of a symbolic link is the length of the pathname it contains, without a " +"terminating null byte." +msgstr "" + +msgid "Timestamps:" +msgstr "" + +msgid "Time of most recent access expressed in seconds." +msgstr "" + +msgid "Time of most recent content modification expressed in seconds." +msgstr "" + +msgid "Platform dependent:" +msgstr "" + +msgid "the time of most recent metadata change on Unix," +msgstr "" + +msgid "the time of creation on Windows, expressed in seconds." +msgstr "" + +msgid "Time of most recent access expressed in nanoseconds as an integer." +msgstr "" + +msgid "" +"Time of most recent content modification expressed in nanoseconds as an " +"integer." +msgstr "" + +msgid "" +"the time of creation on Windows, expressed in nanoseconds as an integer." +msgstr "" + +msgid "" +"The exact meaning and resolution of the :attr:`st_atime`, :attr:`st_mtime`, " +"and :attr:`st_ctime` attributes depend on the operating system and the file " +"system. For example, on Windows systems using the FAT or 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`, and :attr:" +"`st_ctime_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`, and :attr:`st_ctime` 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`, and :attr:`st_ctime_ns`." +msgstr "" + +msgid "" +"On some Unix systems (such as Linux), the following attributes may also be " +"available:" +msgstr "" + +msgid "" +"Number of 512-byte blocks allocated for file. This may be smaller than :attr:" +"`st_size`/512 when the file has holes." +msgstr "" + +msgid "" +"\"Preferred\" blocksize for efficient file system I/O. Writing to a file in " +"smaller chunks may cause an inefficient read-modify-rewrite." +msgstr "" + +msgid "Type of device if an inode device." +msgstr "" + +msgid "User defined flags for file." +msgstr "" + +msgid "" +"On other Unix systems (such as FreeBSD), the following attributes may be " +"available (but may be only filled out if root tries to use them):" +msgstr "" + +msgid "File generation number." +msgstr "" + +msgid "Time of file creation." +msgstr "" + +msgid "" +"On Solaris and derivatives, the following attributes may also be available:" +msgstr "" + +msgid "" +"String that uniquely identifies the type of the filesystem that contains the " +"file." +msgstr "" + +msgid "On macOS systems, the following attributes may also be available:" +msgstr "" + +msgid "Real size of the file." +msgstr "" + +msgid "Creator of the file." +msgstr "" + +msgid "File type." +msgstr "" + +msgid "On Windows systems, the following attributes are also available:" +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." +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." +msgstr "" + +msgid "" +"The standard module :mod:`stat` defines functions and constants that are " +"useful for extracting information from a :c:struct:`stat` structure. (On " +"Windows, some items are filled with dummy values.)" +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." +msgstr "" + +msgid "Windows now returns the file index as :attr:`st_ino` when available." +msgstr "" + +msgid "Added the :attr:`st_fstype` member to Solaris/derivatives." +msgstr "" + +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." +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`." +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." +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)." +msgstr "" + +msgid "The :const:`ST_RDONLY` and :const:`ST_NOSUID` constants were added." +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." +msgstr "" + +msgid "Added the :attr:`f_fsid` attribute." +msgstr "" + +msgid "" +"A :class:`set` object indicating which functions in the :mod:`os` module " +"accept an open file descriptor for their *dir_fd* parameter. Different " +"platforms provide different features, and the underlying functionality " +"Python uses to implement the *dir_fd* parameter is not available on all " +"platforms Python supports. For consistency's sake, functions that may " +"support *dir_fd* always allow specifying the parameter, but will throw an " +"exception if the functionality is used when it's not locally available. " +"(Specifying ``None`` for *dir_fd* is always supported on all platforms.)" +msgstr "" + +msgid "" +"To check whether a particular function accepts an open file descriptor for " +"its *dir_fd* parameter, use the ``in`` operator on ``supports_dir_fd``. As " +"an example, this expression evaluates to ``True`` if :func:`os.stat` accepts " +"open file descriptors for *dir_fd* on the local platform::" +msgstr "" + +msgid "" +"Currently *dir_fd* parameters only work on Unix platforms; none of them work " +"on Windows." +msgstr "" + +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." +msgstr "" + +msgid "" +"This expression evaluates to ``True`` if :func:`os.access` supports " +"``effective_ids=True`` on the local platform::" +msgstr "" + +msgid "" +"Currently *effective_ids* is only supported on Unix platforms; it does not " +"work on Windows." +msgstr "" + +msgid "" +"A :class:`set` object indicating which functions in the :mod:`os` module " +"permit specifying their *path* parameter as an open file descriptor on the " +"local platform. Different platforms provide different features, and the " +"underlying functionality Python uses to accept open file descriptors as " +"*path* arguments is not available on all platforms Python supports." +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 " +"platform::" +msgstr "" + +msgid "" +"A :class:`set` object indicating which functions in the :mod:`os` module " +"accept ``False`` for their *follow_symlinks* parameter on the local " +"platform. Different platforms provide different features, and the underlying " +"functionality Python uses to implement *follow_symlinks* is not available on " +"all platforms Python supports. For consistency's sake, functions that may " +"support *follow_symlinks* always allow specifying the parameter, but will " +"throw an exception if the functionality is used when it's not locally " +"available. (Specifying ``True`` for *follow_symlinks* is always supported " +"on all platforms.)" +msgstr "" + +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::" +msgstr "" + +msgid "Create a symbolic link pointing to *src* named *dst*." +msgstr "" + +msgid "" +"On Windows, a symlink represents either a file or a directory, and does not " +"morph to the target dynamically. If the target is present, the type of the " +"symlink will be created to match. Otherwise, the symlink will be created as " +"a directory if *target_is_directory* is ``True`` or a file symlink (the " +"default) otherwise. On non-Windows platforms, *target_is_directory* is " +"ignored." +msgstr "" + +msgid "" +"On newer versions of Windows 10, unprivileged accounts can create symlinks " +"if Developer Mode is enabled. When Developer Mode is not available/enabled, " +"the *SeCreateSymbolicLinkPrivilege* privilege is required, or the process " +"must be run as an administrator." +msgstr "" + +msgid "" +":exc:`OSError` is raised when the function is called by an unprivileged user." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.symlink`` with arguments " +"``src``, ``dst``, ``dir_fd``." +msgstr "" + +msgid "" +"Added the *dir_fd* parameter, and now allow *target_is_directory* on non-" +"Windows platforms." +msgstr "" + +msgid "Added support for unelevated symlinks on Windows with Developer Mode." +msgstr "" + +msgid "Force write of everything to disk." +msgstr "" + +msgid "" +"Truncate the file corresponding to *path*, so that it is at most *length* " +"bytes in size." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.truncate`` with arguments " +"``path``, ``length``." +msgstr "" + +msgid "" +"Remove (delete) the file *path*. This function is semantically identical " +"to :func:`remove`; the ``unlink`` name is its traditional Unix name. Please " +"see the documentation for :func:`remove` for further information." +msgstr "" + +msgid "Set the access and modified times of the file specified by *path*." +msgstr "" + +msgid "" +":func:`utime` takes two optional parameters, *times* and *ns*. These specify " +"the times set on *path* and are used as follows:" +msgstr "" + +msgid "" +"If *ns* is specified, it must be a 2-tuple of the form ``(atime_ns, " +"mtime_ns)`` where each member is an int expressing nanoseconds." +msgstr "" + +msgid "" +"If *times* is not ``None``, it must be a 2-tuple of the form ``(atime, " +"mtime)`` where each member is an int or float expressing seconds." +msgstr "" + +msgid "" +"If *times* is ``None`` and *ns* is unspecified, this is equivalent to " +"specifying ``ns=(atime_ns, mtime_ns)`` where both times are the current time." +msgstr "" + +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`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.utime`` with arguments " +"``path``, ``times``, ``ns``, ``dir_fd``." +msgstr "" + +msgid "" +"Added support for specifying *path* as an open file descriptor, and the " +"*dir_fd*, *follow_symlinks*, and *ns* parameters." +msgstr "" + +msgid "" +"Generate the file names in a directory tree by walking the tree either top-" +"down or bottom-up. For each directory in the tree rooted at directory *top* " +"(including *top* itself), it yields a 3-tuple ``(dirpath, dirnames, " +"filenames)``." +msgstr "" + +msgid "" +"*dirpath* is a string, the path to the directory. *dirnames* is a list of " +"the names of the subdirectories in *dirpath* (including symlinks to " +"directories, and excluding ``'.'`` and ``'..'``). *filenames* is a list of " +"the names of the non-directory files in *dirpath*. Note that the names in " +"the lists contain no path components. To get a full path (which begins with " +"*top*) to a file or directory in *dirpath*, do ``os.path.join(dirpath, " +"name)``. Whether or not the lists are sorted depends on the file system. " +"If a file is removed from or added to the *dirpath* directory during " +"generating the lists, whether a name for that file be included is " +"unspecified." +msgstr "" + +msgid "" +"If optional argument *topdown* is ``True`` or not specified, the triple for " +"a directory is generated before the triples for any of its subdirectories " +"(directories are generated top-down). If *topdown* is ``False``, the triple " +"for a directory is generated after the triples for all of its subdirectories " +"(directories are generated bottom-up). No matter the value of *topdown*, the " +"list of subdirectories is retrieved before the tuples for the directory and " +"its subdirectories are generated." +msgstr "" + +msgid "" +"When *topdown* is ``True``, the caller can modify the *dirnames* list in-" +"place (perhaps using :keyword:`del` or slice assignment), and :func:`walk` " +"will only recurse into the subdirectories whose names remain in *dirnames*; " +"this can be used to prune the search, impose a specific order of visiting, " +"or even to inform :func:`walk` about directories the caller creates or " +"renames before it resumes :func:`walk` again. Modifying *dirnames* when " +"*topdown* is ``False`` has no effect on the behavior of the walk, because in " +"bottom-up mode the directories in *dirnames* are generated before *dirpath* " +"itself is generated." +msgstr "" + +msgid "" +"By default, errors from the :func:`scandir` call are ignored. If optional " +"argument *onerror* is specified, it should be a function; it will be called " +"with one argument, an :exc:`OSError` instance. It can report the error to " +"continue with the walk, or raise the exception to abort the walk. Note that " +"the filename is available as the ``filename`` attribute of the exception " +"object." +msgstr "" + +msgid "" +"By default, :func:`walk` will not walk down into symbolic links that resolve " +"to directories. Set *followlinks* to ``True`` to visit directories pointed " +"to by symlinks, on systems that support them." +msgstr "" + +msgid "" +"Be aware that setting *followlinks* to ``True`` can lead to infinite " +"recursion if a link points to a parent directory of itself. :func:`walk` " +"does not keep track of the directories it visited already." +msgstr "" + +msgid "" +"If you pass a relative pathname, don't change the current working directory " +"between resumptions of :func:`walk`. :func:`walk` never changes the current " +"directory, and assumes that its caller doesn't either." +msgstr "" + +msgid "" +"This example displays the number of bytes taken by non-directory files in " +"each directory under the starting directory, except that it doesn't look " +"under any CVS subdirectory::" +msgstr "" + +msgid "" +"In the next example (simple implementation of :func:`shutil.rmtree`), " +"walking the tree bottom-up is essential, :func:`rmdir` doesn't allow " +"deleting a directory before the directory is empty::" +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.walk`` with arguments " +"``top``, ``topdown``, ``onerror``, ``followlinks``." +msgstr "" + +msgid "" +"This function now calls :func:`os.scandir` instead of :func:`os.listdir`, " +"making it faster by reducing the number of calls to :func:`os.stat`." +msgstr "" + +msgid "" +"This behaves exactly like :func:`walk`, except that it yields a 4-tuple " +"``(dirpath, dirnames, filenames, dirfd)``, and it supports ``dir_fd``." +msgstr "" + +msgid "" +"*dirpath*, *dirnames* and *filenames* are identical to :func:`walk` output, " +"and *dirfd* is a file descriptor referring to the directory *dirpath*." +msgstr "" + +msgid "" +"This function always supports :ref:`paths relative to directory descriptors " +"` and :ref:`not following symlinks `. Note however " +"that, unlike other functions, the :func:`fwalk` default value for " +"*follow_symlinks* is ``False``." +msgstr "" + +msgid "" +"Since :func:`fwalk` yields file descriptors, those are only valid until the " +"next iteration step, so you should duplicate them (e.g. with :func:`dup`) if " +"you want to keep them longer." +msgstr "" + +msgid "" +"In the next example, walking the tree bottom-up is essential: :func:`rmdir` " +"doesn't allow deleting a directory before the directory is empty::" +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.fwalk`` with arguments " +"``top``, ``topdown``, ``onerror``, ``follow_symlinks``, ``dir_fd``." +msgstr "" + +msgid "Added support for :class:`bytes` paths." +msgstr "" + +msgid "" +"Create an anonymous file and return a file descriptor that refers to it. " +"*flags* must be one of the ``os.MFD_*`` constants available on the system " +"(or a bitwise ORed combination of them). By default, the new file " +"descriptor is :ref:`non-inheritable `." +msgstr "" + +msgid "" +"The name supplied in *name* is used as a filename and will be displayed as " +"the target of the corresponding symbolic link in the directory ``/proc/self/" +"fd/``. The displayed name is always prefixed with ``memfd:`` and serves only " +"for debugging purposes. Names do not affect the behavior of the file " +"descriptor, and as such multiple files can have the same name without any " +"side effects." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 3.17 with glibc >= 2.27." +msgstr "" + +msgid "These flags can be passed to :func:`memfd_create`." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 3.17 with glibc >= 2.27" +msgstr "" + +msgid "The ``MFD_HUGE*`` flags are only available since Linux 4.14." +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 `." +msgstr "" + +msgid "" +"*initval* is the initial value of the event counter. The initial value must " +"be an 32 bit unsigned integer. Please note that the initial value is limited " +"to a 32 bit unsigned int although the event counter is an unsigned 64 bit " +"integer with a maximum value of 2\\ :sup:`64`\\ -\\ 2." +msgstr "" + +msgid "" +"*flags* can be constructed from :const:`EFD_CLOEXEC`, :const:`EFD_NONBLOCK`, " +"and :const:`EFD_SEMAPHORE`." +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." +msgstr "" + +msgid "" +"If :const:`EFD_SEMAPHORE` is not specified and the event counter is non-" +"zero, :func:`eventfd_read` returns the current event counter value and " +"resets the counter to zero." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.27 with glibc >= 2.8" +msgstr "" + +msgid "" +"Read value from an :func:`eventfd` file descriptor and return a 64 bit " +"unsigned int. The function does not verify that *fd* is an :func:`eventfd`." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.27" +msgstr "" + +msgid "" +"Add value to an :func:`eventfd` file descriptor. *value* must be a 64 bit " +"unsigned int. The function does not verify that *fd* is an :func:`eventfd`." +msgstr "" + +msgid "Set close-on-exec flag for new :func:`eventfd` file descriptor." +msgstr "" + +msgid "" +"Set :const:`O_NONBLOCK` status flag for new :func:`eventfd` file descriptor." +msgstr "" + +msgid "" +"Provide semaphore-like semantics for reads from a :func:`eventfd` file " +"descriptor. On read the internal counter is decremented by one." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.30" +msgstr "" + +msgid "Linux extended attributes" +msgstr "" + +msgid "These functions are all available on Linux only." +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." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.getxattr`` with arguments " +"``path``, ``attribute``." +msgstr "" + +msgid "Accepts a :term:`path-like object` for *path* and *attribute*." +msgstr "" + +msgid "" +"Return a list of the extended filesystem attributes on *path*. The " +"attributes in the list are represented as strings decoded with the " +"filesystem encoding. If *path* is ``None``, :func:`listxattr` will examine " +"the current directory." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.listxattr`` with argument " +"``path``." +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`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.removexattr`` with arguments " +"``path``, ``attribute``." +msgstr "" + +msgid "" +"Set the extended filesystem attribute *attribute* on *path* to *value*. " +"*attribute* must be a bytes or str with no embedded NULs (directly or " +"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." +msgstr "" + +msgid "" +"A bug in Linux kernel versions less than 2.6.39 caused the flags argument to " +"be ignored on some filesystems." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.setxattr`` with arguments " +"``path``, ``attribute``, ``value``, ``flags``." +msgstr "" + +msgid "" +"The maximum size the value of an extended attribute can be. Currently, this " +"is 64 KiB on Linux." +msgstr "" + +msgid "" +"This is a possible value for the flags argument in :func:`setxattr`. It " +"indicates the operation must create an attribute." +msgstr "" + +msgid "" +"This is a possible value for the flags argument in :func:`setxattr`. It " +"indicates the operation must replace an existing attribute." +msgstr "" + +msgid "Process Management" +msgstr "" + +msgid "These functions may be used to create and manage processes." +msgstr "" + +msgid "" +"The various :func:`exec\\* ` functions take a list of arguments for " +"the new program loaded into the process. In each case, the first of these " +"arguments is passed to the new program as its own name rather than as an " +"argument a user may have typed on a command line. For the C programmer, " +"this is the ``argv[0]`` passed to a program's :c:func:`main`. For example, " +"``os.execv('/bin/echo', ['foo', 'bar'])`` will only print ``bar`` on " +"standard output; ``foo`` will seem to be ignored." +msgstr "" + +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`." +msgstr "" + +msgid "Add a path to the DLL search path." +msgstr "" + +msgid "" +"This search path is used when resolving dependencies for imported extension " +"modules (the module itself is resolved through :data:`sys.path`), and also " +"by :mod:`ctypes`." +msgstr "" + +msgid "" +"Remove the directory by calling **close()** on the returned object or using " +"it in a :keyword:`with` statement." +msgstr "" + +msgid "" +"See the `Microsoft documentation `_ for more information about how " +"DLLs are loaded." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.add_dll_directory`` with " +"argument ``path``." +msgstr "" + +msgid "" +"Previous versions of CPython would resolve DLLs using the default behavior " +"for the current process. This led to inconsistencies, such as only sometimes " +"searching :envvar:`PATH` or the current working directory, and OS functions " +"such as ``AddDllDirectory`` having no effect." +msgstr "" + +msgid "" +"In 3.8, the two primary ways DLLs are loaded now explicitly override the " +"process-wide behavior to ensure consistency. See the :ref:`porting notes " +"` for information on updating libraries." +msgstr "" + +msgid "" +"These functions all execute a new program, replacing the current process; " +"they do not return. On Unix, the new executable is loaded into the current " +"process, and will have the same process id as the caller. Errors will be " +"reported as :exc:`OSError` exceptions." +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:`sys.stdout.flush` or :func:`os." +"fsync` before calling an :func:`exec\\* ` function." +msgstr "" + +msgid "" +"The \"l\" and \"v\" variants of the :func:`exec\\* ` functions differ " +"in how command-line arguments are passed. The \"l\" variants are perhaps " +"the easiest to work with if the number of parameters is fixed when the code " +"is written; the individual parameters simply become additional parameters to " +"the :func:`!execl\\*` functions. The \"v\" variants are good when the " +"number of parameters is variable, with the arguments being passed in a list " +"or tuple as the *args* parameter. In either case, the arguments to the " +"child process should start with the name of the command being run, but this " +"is not enforced." +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." +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." +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`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.exec`` with arguments " +"``path``, ``args``, ``env``." +msgstr "" + +msgid "" +"Added support for specifying *path* as an open file descriptor for :func:" +"`execve`." +msgstr "" + +msgid "" +"Exit the process with status *n*, without calling cleanup handlers, flushing " +"stdio buffers, etc." +msgstr "" + +msgid "" +"The standard way to exit is :func:`sys.exit(n) `. :func:`!_exit` " +"should normally only be used in the child process after a :func:`fork`." +msgstr "" + +msgid "" +"The following exit codes are defined and can be used with :func:`_exit`, " +"although they are not required. These are typically used for system " +"programs written in Python, such as a mail server's external command " +"delivery program." +msgstr "" + +msgid "" +"Some of these may not be available on all Unix platforms, since there is " +"some variation. These constants are defined where they are defined by the " +"underlying platform." +msgstr "" + +msgid "" +"Exit code that means no error occurred. May be taken from the defined value " +"of ``EXIT_SUCCESS`` on some platforms. Generally has a value of zero." +msgstr "" + +msgid "" +"Exit code that means the command was used incorrectly, such as when the " +"wrong number of arguments are given." +msgstr "" + +msgid "Exit code that means the input data was incorrect." +msgstr "" + +msgid "Exit code that means an input file did not exist or was not readable." +msgstr "" + +msgid "Exit code that means a specified user did not exist." +msgstr "" + +msgid "Exit code that means a specified host did not exist." +msgstr "" + +msgid "Exit code that means that a required service is unavailable." +msgstr "" + +msgid "Exit code that means an internal software error was detected." +msgstr "" + +msgid "" +"Exit code that means an operating system error was detected, such as the " +"inability to fork or create a pipe." +msgstr "" + +msgid "" +"Exit code that means some system file did not exist, could not be opened, or " +"had some other kind of error." +msgstr "" + +msgid "Exit code that means a user specified output file could not be created." +msgstr "" + +msgid "" +"Exit code that means that an error occurred while doing I/O on some file." +msgstr "" + +msgid "" +"Exit code that means a temporary failure occurred. This indicates something " +"that may not really be an error, such as a network connection that couldn't " +"be made during a retryable operation." +msgstr "" + +msgid "" +"Exit code that means that a protocol exchange was illegal, invalid, or not " +"understood." +msgstr "" + +msgid "" +"Exit code that means that there were insufficient permissions to perform the " +"operation (but not intended for file system problems)." +msgstr "" + +msgid "Exit code that means that some kind of configuration error occurred." +msgstr "" + +msgid "Exit code that means something like \"an entry was not found\"." +msgstr "" + +msgid "" +"Fork a child process. Return ``0`` in the child and the child's process id " +"in the parent. If an error occurs :exc:`OSError` is raised." +msgstr "" + +msgid "" +"Note that some platforms including FreeBSD <= 6.3 and Cygwin have known " +"issues when using ``fork()`` from a thread." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.fork`` with no arguments." +msgstr "" + +msgid "" +"On macOS the use of this function is unsafe when mixed with using higher-" +"level system APIs, and that includes using :mod:`urllib.request`." +msgstr "" + +msgid "" +"Calling ``fork()`` in a subinterpreter is no longer supported (:exc:" +"`RuntimeError` is raised)." +msgstr "" + +msgid "See :mod:`ssl` for applications that use the SSL module with fork()." +msgstr "" + +msgid "" +"Fork a child process, using a new pseudo-terminal as the child's controlling " +"terminal. Return a pair of ``(pid, fd)``, where *pid* is ``0`` in the child, " +"the new child's process id in the parent, and *fd* is the file descriptor of " +"the master end of the pseudo-terminal. For a more portable approach, use " +"the :mod:`pty` module. If an error occurs :exc:`OSError` is raised." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.forkpty`` with no arguments." +msgstr "" + +msgid "" +"Calling ``forkpty()`` in a subinterpreter is no longer supported (:exc:" +"`RuntimeError` is raised)." +msgstr "" + +msgid "" +"Send signal *sig* to the process *pid*. Constants for the specific signals " +"available on the host platform are defined in the :mod:`signal` module." +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 " +"unconditionally killed by the TerminateProcess API, and the exit code will " +"be set to *sig*. The Windows version of :func:`kill` additionally takes " +"process handles to be killed." +msgstr "" + +msgid "See also :func:`signal.pthread_kill`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.kill`` with arguments " +"``pid``, ``sig``." +msgstr "" + +msgid "Send the signal *sig* to the process group *pgid*." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.killpg`` with arguments " +"``pgid``, ``sig``." +msgstr "" + +msgid "" +"Add *increment* to the process's \"niceness\". Return the new niceness." +msgstr "" + +msgid "" +"Return a file descriptor referring to the process *pid*. This descriptor " +"can be used to perform process management without races and signals. The " +"*flags* argument is provided for future extensions; no flag values are " +"currently defined." +msgstr "" + +msgid "See the :manpage:`pidfd_open(2)` man page for more details." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 5.3" +msgstr "" + +msgid "" +"Lock program segments into memory. The value of *op* (defined in ````) determines which segments are locked." +msgstr "" + +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." +msgstr "" + +msgid "" +"The ``close`` method returns :const:`None` if the subprocess exited " +"successfully, or the subprocess's return code if there was an error. On " +"POSIX systems, if the return code is positive it represents the return value " +"of the process left-shifted by one byte. If the return code is negative, " +"the process was terminated by the signal given by the negated value of the " +"return code. (For example, the return value might be ``- signal.SIGKILL`` " +"if the subprocess was killed.) On Windows systems, the return value " +"contains the signed integer return code from the child process." +msgstr "" + +msgid "" +"On Unix, :func:`waitstatus_to_exitcode` can be used to convert the ``close`` " +"method result (exit status) into an exit code if it is not ``None``. On " +"Windows, the ``close`` method result is directly the exit code (or ``None``)." +msgstr "" + +msgid "" +"This is implemented using :class:`subprocess.Popen`; see that class's " +"documentation for more powerful ways to manage and communicate with " +"subprocesses." +msgstr "" + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"The :ref:`Python UTF-8 Mode ` affects encodings used for *cmd* " +"and pipe contents." +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." +msgstr "" + +msgid "Wraps the :c:func:`!posix_spawn` C library API for use from Python." +msgstr "" + +msgid "" +"Most users should use :func:`subprocess.run` instead of :func:`posix_spawn`." +msgstr "" + +msgid "" +"The positional-only arguments *path*, *args*, and *env* are similar to :func:" +"`execve`." +msgstr "" + +msgid "" +"The *path* parameter is the path to the executable file. The *path* should " +"contain a directory. Use :func:`posix_spawnp` to pass an executable file " +"without directory." +msgstr "" + +msgid "" +"The *file_actions* argument may be a sequence of tuples describing actions " +"to take on specific file descriptors in the child process between the C " +"library implementation's :c:func:`fork` and :c:func:`exec` steps. The first " +"item in each tuple must be one of the three type indicator listed below " +"describing the remaining tuple elements:" +msgstr "" + +msgid "(``os.POSIX_SPAWN_OPEN``, *fd*, *path*, *flags*, *mode*)" +msgstr "" + +msgid "Performs ``os.dup2(os.open(path, flags, mode), fd)``." +msgstr "" + +msgid "(``os.POSIX_SPAWN_CLOSE``, *fd*)" +msgstr "(``os.POSIX_SPAWN_CLOSE``, *fd*)" + +msgid "Performs ``os.close(fd)``." +msgstr "Performs ``os.close(fd)``." + +msgid "(``os.POSIX_SPAWN_DUP2``, *fd*, *new_fd*)" +msgstr "" + +msgid "Performs ``os.dup2(fd, new_fd)``." +msgstr "" + +msgid "" +"These tuples correspond to the C library :c:func:`!" +"posix_spawn_file_actions_addopen`, :c:func:`!" +"posix_spawn_file_actions_addclose`, and :c:func:`!" +"posix_spawn_file_actions_adddup2` API calls used to prepare for the :c:func:" +"`!posix_spawn` call itself." +msgstr "" + +msgid "" +"The *setpgroup* argument will set the process group of the child to the " +"value specified. If the value specified is 0, the child's process group ID " +"will be made the same as its process ID. If the value of *setpgroup* is not " +"set, the child will inherit the parent's process group ID. This argument " +"corresponds to the C library :c:macro:`!POSIX_SPAWN_SETPGROUP` flag." +msgstr "" + +msgid "" +"If the *resetids* argument is ``True`` it will reset the effective UID and " +"GID of the child to the real UID and GID of the parent process. If the " +"argument is ``False``, then the child retains the effective UID and GID of " +"the parent. In either case, if the set-user-ID and set-group-ID permission " +"bits are enabled on the executable file, their effect will override the " +"setting of the effective UID and GID. This argument corresponds to the C " +"library :c:macro:`!POSIX_SPAWN_RESETIDS` flag." +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." +msgstr "" + +msgid "" +"The *setsigmask* argument will set the signal mask to the signal set " +"specified. If the parameter is not used, then the child inherits the " +"parent's signal mask. This argument corresponds to the C library :c:macro:`!" +"POSIX_SPAWN_SETSIGMASK` flag." +msgstr "" + +msgid "" +"The *sigdef* argument will reset the disposition of all signals in the set " +"specified. This argument corresponds to the C library :c:macro:`!" +"POSIX_SPAWN_SETSIGDEF` flag." +msgstr "" + +msgid "" +"The *scheduler* argument must be a tuple containing the (optional) scheduler " +"policy and an instance of :class:`sched_param` with the scheduler " +"parameters. A value of ``None`` in the place of the scheduler policy " +"indicates that is not being provided. This argument is a combination of the " +"C library :c:macro:`!POSIX_SPAWN_SETSCHEDPARAM` and :c:macro:`!" +"POSIX_SPAWN_SETSCHEDULER` flags." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.posix_spawn`` with arguments " +"``path``, ``argv``, ``env``." +msgstr "" + +msgid "Wraps the :c:func:`!posix_spawnp` C library API for use from Python." +msgstr "" + +msgid "" +"Similar to :func:`posix_spawn` except that the system searches for the " +"*executable* file in the list of directories specified by the :envvar:`PATH` " +"environment variable (in the same way as for ``execvp(3)``)." +msgstr "" + +msgid ":ref:`Availability `: POSIX, not Emscripten, not WASI." +msgstr "" + +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." +msgstr "" + +msgid "*before* is a function called before forking a child process." +msgstr "" + +msgid "" +"*after_in_parent* is a function called from the parent process after forking " +"a child process." +msgstr "" + +msgid "*after_in_child* is a function called from the child process." +msgstr "" + +msgid "" +"These calls are only made if control is expected to return to the Python " +"interpreter. A typical :mod:`subprocess` launch will not trigger them as " +"the child is not going to re-enter the interpreter." +msgstr "" + +msgid "" +"Functions registered for execution before forking are called in reverse " +"registration order. Functions registered for execution after forking " +"(either in the parent or in the child) are called in registration order." +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`." +msgstr "" + +msgid "There is no way to unregister a function." +msgstr "" + +msgid "Execute the program *path* in a new process." +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.)" +msgstr "" + +msgid "" +"If *mode* is :const:`P_NOWAIT`, this function returns the process id of the " +"new process; if *mode* is :const:`P_WAIT`, returns the process's exit code " +"if it exits normally, or ``-signal``, where *signal* is the signal that " +"killed the process. On Windows, the process id will actually be the process " +"handle, so can be used with the :func:`waitpid` function." +msgstr "" + +msgid "" +"Note on VxWorks, this function doesn't return ``-signal`` when the new " +"process is killed. Instead it raises OSError exception." +msgstr "" + +msgid "" +"The \"l\" and \"v\" variants of the :func:`spawn\\* ` functions " +"differ in how command-line arguments are passed. The \"l\" variants are " +"perhaps the easiest to work with if the number of parameters is fixed when " +"the code is written; the individual parameters simply become additional " +"parameters to the :func:`!spawnl\\*` functions. The \"v\" variants are good " +"when the number of parameters is variable, with the arguments being passed " +"in a list or tuple as the *args* parameter. In either case, the arguments " +"to the child process must start with the name of the command being run." +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." +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``." +msgstr "" + +msgid "" +"As an example, the following calls to :func:`spawnlp` and :func:`spawnvpe` " +"are equivalent::" +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.spawn`` with arguments " +"``mode``, ``path``, ``args``, ``env``." +msgstr "" + +msgid "" +":func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp` and :func:`spawnvpe` are " +"not available on Windows. :func:`spawnle` and :func:`spawnve` are not " +"thread-safe on Windows; we advise you to use the :mod:`subprocess` module " +"instead." +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." +msgstr "" + +msgid "" +"Possible value for the *mode* parameter to the :func:`spawn\\* ` " +"family of functions. If this is given as *mode*, the :func:`spawn\\* " +"` functions will not return until the new process has run to " +"completion and will return the exit code of the process the run is " +"successful, or ``-signal`` if a signal kills the process." +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." +msgstr "" + +msgid "Start a file with its associated application." +msgstr "" + +msgid "" +"When *operation* is not specified or ``'open'``, 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." +msgstr "" + +msgid "" +"When another *operation* is given, it must be a \"command verb\" that " +"specifies what should be done with the file. Common verbs documented by " +"Microsoft are ``'print'`` and ``'edit'`` (to be used on files) as well as " +"``'explore'`` and ``'find'`` (to be used on directories)." +msgstr "" + +msgid "" +"When launching an application, specify *arguments* to be passed as a single " +"string. This argument may have no effect when using this function to launch " +"a document." +msgstr "" + +msgid "" +"The default working directory is inherited, but may be overridden by the " +"*cwd* argument. This should be an absolute path. A relative *path* will be " +"resolved against this argument." +msgstr "" + +msgid "" +"Use *show_cmd* to override the default window style. Whether this has any " +"effect will depend on the application being launched. Values are integers as " +"supported by the Win32 :c:func:`!ShellExecute` function." +msgstr "" + +msgid "" +":func:`startfile` returns as soon as the associated application is launched. " +"There is no option to wait for the application to close, and no way to " +"retrieve the application's exit status. The *path* parameter is relative to " +"the current directory or *cwd*. If you want to use an absolute path, make " +"sure the first character is not a slash (``'/'``) Use :mod:`pathlib` or " +"the :func:`os.path.normpath` function to ensure that paths are properly " +"encoded for Win32." +msgstr "" + +msgid "" +"To reduce interpreter startup overhead, the Win32 :c:func:`!ShellExecute` " +"function is not resolved until this function is first called. If the " +"function cannot be resolved, :exc:`NotImplementedError` will be raised." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.startfile`` with arguments " +"``path``, ``operation``." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.startfile/2`` with arguments " +"``path``, ``operation``, ``arguments``, ``cwd``, ``show_cmd``." +msgstr "" + +msgid "" +"Added the *arguments*, *cwd* and *show_cmd* arguments, and the ``os." +"startfile/2`` audit event." +msgstr "" + +msgid "" +"Execute the command (a string) in a subshell. This is implemented by " +"calling the Standard C function :c:func:`system`, and has the same " +"limitations. Changes to :data:`sys.stdin`, etc. are not reflected in the " +"environment of the executed command. If *command* generates any output, it " +"will be sent to the interpreter standard output stream. The C standard does " +"not specify the meaning of the return value of the C function, so the return " +"value of the Python function is system-dependent." +msgstr "" + +msgid "" +"On Unix, the return value is the exit status of the process encoded in the " +"format specified for :func:`wait`." +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." +msgstr "" + +msgid "" +"The :mod:`subprocess` module provides more powerful facilities for spawning " +"new processes and retrieving their results; using that module is preferable " +"to using this function. See the :ref:`subprocess-replacements` section in " +"the :mod:`subprocess` documentation for some helpful recipes." +msgstr "" + +msgid "" +"On Unix, :func:`waitstatus_to_exitcode` can be used to convert the result " +"(exit status) into an exit code. On Windows, the result is directly the exit " +"code." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``os.system`` with argument " +"``command``." +msgstr "" + +msgid "" +"Returns the current global process times. The return value is an object with " +"five attributes:" +msgstr "" + +msgid ":attr:`!user` - user time" +msgstr "" + +msgid ":attr:`!system` - system time" +msgstr "" + +msgid ":attr:`!children_user` - user time of all child processes" +msgstr "" + +msgid ":attr:`!children_system` - system time of all child processes" +msgstr "" + +msgid ":attr:`!elapsed` - elapsed real time since a fixed point in the past" +msgstr "" + +msgid "" +"For backwards compatibility, this object also behaves like a five-tuple " +"containing :attr:`!user`, :attr:`!system`, :attr:`!children_user`, :attr:`!" +"children_system`, and :attr:`!elapsed` in that order." +msgstr "" + +msgid "" +"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 " +"attributes are zero." +msgstr "" + +msgid "" +"Wait for completion of a child process, and return a tuple containing its " +"pid and exit status indication: a 16-bit number, whose low byte is the " +"signal number that killed the process, and whose high byte is the exit " +"status (if the signal number is zero); the high bit of the low byte is set " +"if a core file was produced." +msgstr "" + +msgid "" +"If there are no children that could be waited for, :exc:`ChildProcessError` " +"is raised." +msgstr "" + +msgid "" +":func:`waitstatus_to_exitcode` can be used to convert the exit status into " +"an exit code." +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." +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 " +"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." +msgstr "" + +msgid "" +"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)" +msgstr "" + +msgid ":attr:`!si_uid` (real user ID of the child)" +msgstr "" + +msgid ":attr:`!si_signo` (always :const:`~signal.SIGCHLD`)" +msgstr "" + +msgid "" +":attr:`!si_status` (the exit status or signal number, depending on :attr:`!" +"si_code`)" +msgstr "" + +msgid ":attr:`!si_code` (see :data:`CLD_EXITED` for possible values)" +msgstr "" + +msgid "" +"If :data:`WNOHANG` is specified and there are no matching children in the " +"requested state, ``None`` is returned. Otherwise, if there are no matching " +"children that could be waited for, :exc:`ChildProcessError` is raised." +msgstr "" + +msgid "This function is not available on macOS." +msgstr "" + +msgid "The details of this function differ on Unix and Windows." +msgstr "" + +msgid "" +"On Unix: Wait for completion of a child process given by process id *pid*, " +"and return a tuple containing its process id and exit status indication " +"(encoded as for :func:`wait`). The semantics of the call are affected by " +"the value of the integer *options*, which should be ``0`` for normal " +"operation." +msgstr "" + +msgid "" +"If *pid* is greater than ``0``, :func:`waitpid` requests status information " +"for that specific process. If *pid* is ``0``, the request is for the status " +"of any child in the process group of the current process. If *pid* is " +"``-1``, the request pertains to any child of the current process. If *pid* " +"is less than ``-1``, status is requested for any process in the process " +"group ``-pid`` (the absolute value of *pid*)." +msgstr "" + +msgid "" +"*options* is an OR combination of flags. If it contains :data:`WNOHANG` and " +"there are no matching children in the requested state, ``(0, 0)`` is " +"returned. Otherwise, if there are no matching children that could be waited " +"for, :exc:`ChildProcessError` is raised. Other options that can be used " +"are :data:`WUNTRACED` and :data:`WCONTINUED`." +msgstr "" + +msgid "" +"On Windows: Wait for completion of a process given by process handle *pid*, " +"and return a tuple containing *pid*, and its exit status shifted left by 8 " +"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." +msgstr "" + +msgid "" +"Similar to :func:`waitpid`, except no process id argument is given and a 3-" +"element tuple containing the child's process id, exit status indication, and " +"resource usage information is returned. Refer to :func:`resource.getrusage` " +"for details on resource usage information. The *options* argument is the " +"same as that provided to :func:`waitpid` and :func:`wait4`." +msgstr "" + +msgid "" +":func:`waitstatus_to_exitcode` can be used to convert the exit status into " +"an exitcode." +msgstr "" + +msgid "" +"Similar to :func:`waitpid`, except a 3-element tuple, containing the child's " +"process id, exit status indication, and resource usage information is " +"returned. Refer to :func:`resource.getrusage` for details on resource usage " +"information. The arguments to :func:`wait4` are the same as those provided " +"to :func:`waitpid`." +msgstr "" + +msgid "" +"These are the possible values for *idtype* in :func:`waitid`. They affect " +"how *id* is interpreted:" +msgstr "" + +msgid ":data:`!P_PID` - wait for the child whose PID is *id*." +msgstr "" + +msgid ":data:`!P_PGID` - wait for any child whose progress group ID is *id*." +msgstr "" + +msgid ":data:`!P_ALL` - wait for any child; *id* is ignored." +msgstr "" + +msgid "" +":data:`!P_PIDFD` - wait for the child identified by the file descriptor *id* " +"(a process file descriptor created with :func:`pidfd_open`)." +msgstr "" + +msgid ":data:`!P_PIDFD` is only available on Linux >= 5.4." +msgstr "" + +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 " +"continued from a job control stop since they were last reported." +msgstr "" + +msgid "" +"This *options* flag for :func:`waitid` causes child processes that have " +"terminated to be reported." +msgstr "" + +msgid "" +"The other ``wait*`` functions always report children that have terminated, " +"so this option is not available for them." +msgstr "" + +msgid "" +"This *options* flag for :func:`waitid` causes child processes that have been " +"stopped by the delivery of a signal to be reported." +msgstr "" + +msgid "This option is not available for the other ``wait*`` functions." +msgstr "" + +msgid "" +"This *options* flag for :func:`waitpid`, :func:`wait3`, and :func:`wait4` " +"causes child processes to also be reported if they have been stopped but " +"their current state has not been reported since they were stopped." +msgstr "" + +msgid "This option is not available for :func:`waitid`." +msgstr "" + +msgid "" +"This *options* flag causes :func:`waitpid`, :func:`wait3`, :func:`wait4`, " +"and :func:`waitid` to return right away if no child process status is " +"available immediately." +msgstr "" + +msgid "" +"This *options* flag causes :func:`waitid` to leave the child in a waitable " +"state, so that a later :func:`!wait*` call can be used to retrieve the child " +"status information again." +msgstr "" + +msgid "" +"These are the possible values for :attr:`!si_code` in the result returned " +"by :func:`waitid`." +msgstr "" + +msgid "Added :data:`CLD_KILLED` and :data:`CLD_STOPPED` values." +msgstr "" + +msgid "Convert a wait status to an exit code." +msgstr "" + +msgid "On Unix:" +msgstr "" + +msgid "" +"If the process exited normally (if ``WIFEXITED(status)`` is true), return " +"the process exit status (return ``WEXITSTATUS(status)``): result greater " +"than or equal to 0." +msgstr "" + +msgid "" +"If the process was terminated by a signal (if ``WIFSIGNALED(status)`` is " +"true), return ``-signum`` where *signum* is the number of the signal that " +"caused the process to terminate (return ``-WTERMSIG(status)``): result less " +"than 0." +msgstr "" + +msgid "Otherwise, raise a :exc:`ValueError`." +msgstr "" + +msgid "On Windows, return *status* shifted right by 8 bits." +msgstr "" + +msgid "" +"On Unix, if the process is being traced or if :func:`waitpid` was called " +"with :data:`WUNTRACED` option, the caller must first check if " +"``WIFSTOPPED(status)`` is true. This function must not be called if " +"``WIFSTOPPED(status)`` is true." +msgstr "" + +msgid "" +":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." +msgstr "" + +msgid "" +"Return ``True`` if a core dump was generated for the process, otherwise " +"return ``False``." +msgstr "" + +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``." +msgstr "" + +msgid "See :data:`WCONTINUED` option." +msgstr "" + +msgid "" +"Return ``True`` if the process was stopped by delivery of a signal, " +"otherwise return ``False``." +msgstr "" + +msgid "" +":func:`WIFSTOPPED` only returns ``True`` if the :func:`waitpid` call was " +"done using :data:`WUNTRACED` option or when the process is being traced " +"(see :manpage:`ptrace(2)`)." +msgstr "" + +msgid "" +"Return ``True`` if the process was terminated by a signal, otherwise return " +"``False``." +msgstr "" + +msgid "" +"Return ``True`` if the process exited terminated normally, that is, by " +"calling ``exit()`` or ``_exit()``, or by returning from ``main()``; " +"otherwise return ``False``." +msgstr "" + +msgid "Return the process exit status." +msgstr "" + +msgid "This function should be employed only if :func:`WIFEXITED` is true." +msgstr "" + +msgid "Return the signal which caused the process to stop." +msgstr "" + +msgid "This function should be employed only if :func:`WIFSTOPPED` is true." +msgstr "" + +msgid "Return the number of the signal that caused the process to terminate." +msgstr "" + +msgid "Interface to the scheduler" +msgstr "" + +msgid "" +"These functions control how a process is allocated CPU time by the operating " +"system. They are only available on some Unix platforms. For more detailed " +"information, consult your Unix manpages." +msgstr "" + +msgid "" +"The following scheduling policies are exposed if they are supported by the " +"operating system." +msgstr "" + +msgid "The default scheduling policy." +msgstr "" + +msgid "" +"Scheduling policy for CPU-intensive processes that tries to preserve " +"interactivity on the rest of the computer." +msgstr "" + +msgid "Scheduling policy for extremely low priority background tasks." +msgstr "" + +msgid "Scheduling policy for sporadic server programs." +msgstr "" + +msgid "A First In First Out scheduling policy." +msgstr "" + +msgid "A round-robin scheduling policy." +msgstr "" + +msgid "" +"This flag can be OR'ed with any other scheduling policy. When a process with " +"this flag set forks, its child's scheduling policy and priority are reset to " +"the default." +msgstr "" + +msgid "" +"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:" +msgstr "" + +msgid "The scheduling priority for a scheduling policy." +msgstr "" + +msgid "" +"Get the minimum priority value for *policy*. *policy* is one of the " +"scheduling policy constants above." +msgstr "" + +msgid "" +"Get the maximum priority value for *policy*. *policy* is one of the " +"scheduling policy constants above." +msgstr "" + +msgid "" +"Set the scheduling policy for the process with PID *pid*. A *pid* of 0 means " +"the calling process. *policy* is one of the scheduling policy constants " +"above. *param* is a :class:`sched_param` instance." +msgstr "" + +msgid "" +"Return the scheduling policy for the process with PID *pid*. A *pid* of 0 " +"means the calling process. The result is one of the scheduling policy " +"constants above." +msgstr "" + +msgid "" +"Set the scheduling parameters for the process with PID *pid*. A *pid* of 0 " +"means the calling process. *param* is a :class:`sched_param` instance." +msgstr "" + +msgid "" +"Return the scheduling parameters as a :class:`sched_param` instance for the " +"process with PID *pid*. A *pid* of 0 means the calling process." +msgstr "" + +msgid "" +"Return the round-robin quantum in seconds for the process with PID *pid*. A " +"*pid* of 0 means the calling process." +msgstr "" + +msgid "Voluntarily relinquish the CPU." +msgstr "" + +msgid "" +"Restrict the process with PID *pid* (or the current process if zero) to a " +"set of CPUs. *mask* is an iterable of integers representing the set of CPUs " +"to which the process should be restricted." +msgstr "" + +msgid "Return the set of CPUs the process with PID *pid* is restricted to." +msgstr "" + +msgid "" +"If *pid* is zero, return the set of CPUs the calling thread of the current " +"process is restricted to." +msgstr "" + +msgid "Miscellaneous System Information" +msgstr "" + +msgid "" +"Return string-valued system configuration values. *name* specifies the " +"configuration value to retrieve; it may be a string which is the name of a " +"defined system value; these names are specified in a number of standards " +"(POSIX, Unix 95, Unix 98, and others). Some platforms define additional " +"names as well. The names known to the host operating system are given as the " +"keys of the ``confstr_names`` dictionary. For configuration variables not " +"included in that mapping, passing an integer for *name* is also accepted." +msgstr "" + +msgid "" +"If the configuration value specified by *name* isn't defined, ``None`` is " +"returned." +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." +msgstr "" + +msgid "" +"Dictionary mapping names accepted by :func:`confstr` to the integer values " +"defined for those names by the host operating system. This can be used to " +"determine the set of names known to the system." +msgstr "" + +msgid "" +"Return the number of logical CPUs in the system. Returns ``None`` if " +"undetermined." +msgstr "" + +msgid "" +"This number is not equivalent to the number of logical CPUs the current " +"process can use. ``len(os.sched_getaffinity(0))`` gets the number of logical " +"CPUs the calling thread of the current process is restricted to" +msgstr "" + +msgid "" +"Return the number of processes in the system run queue averaged over the " +"last 1, 5, and 15 minutes or raises :exc:`OSError` if the load average was " +"unobtainable." +msgstr "" + +msgid "" +"Return integer-valued system configuration values. If the configuration " +"value specified by *name* isn't defined, ``-1`` is returned. The comments " +"regarding the *name* parameter for :func:`confstr` apply here as well; the " +"dictionary that provides information on the known names is given by " +"``sysconf_names``." +msgstr "" + +msgid "" +"Dictionary mapping names accepted by :func:`sysconf` to the integer values " +"defined for those names by the host operating system. This can be used to " +"determine the set of names known to the system." +msgstr "" + +msgid "Add ``'SC_MINSIGSTKSZ'`` name." +msgstr "" + +msgid "" +"The following data values are used to support path manipulation operations. " +"These are defined for all platforms." +msgstr "" + +msgid "" +"Higher-level operations on pathnames are defined in the :mod:`os.path` " +"module." +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`." +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`." +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`." +msgstr "" + +msgid "" +"An alternative character used by the operating system to separate pathname " +"components, or ``None`` if only one separator character exists. This is set " +"to ``'/'`` on Windows systems where ``sep`` is a backslash. Also available " +"via :mod:`os.path`." +msgstr "" + +msgid "" +"The character which separates the base filename from the extension; for " +"example, the ``'.'`` in :file:`os.py`. Also available via :mod:`os.path`." +msgstr "" + +msgid "" +"The character conventionally used by the operating system to separate search " +"path components (as in :envvar:`PATH`), such as ``':'`` for POSIX or ``';'`` " +"for Windows. Also available via :mod:`os.path`." +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`." +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." +msgstr "" + +msgid "" +"The file path of the null device. For example: ``'/dev/null'`` for POSIX, " +"``'nul'`` for Windows. Also available via :mod:`os.path`." +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." +msgstr "" + +msgid "Random numbers" +msgstr "" + +msgid "" +"Get up to *size* random bytes. The function can return less bytes than " +"requested." +msgstr "" + +msgid "" +"These bytes can be used to seed user-space random number generators or for " +"cryptographic purposes." +msgstr "" + +msgid "" +"``getrandom()`` relies on entropy gathered from device drivers and other " +"sources of environmental noise. Unnecessarily reading large quantities of " +"data will have a negative impact on other users of the ``/dev/random`` and " +"``/dev/urandom`` devices." +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`." +msgstr "" + +msgid "" +"See also the `Linux getrandom() manual page `_." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 3.17." +msgstr "" + +msgid "" +"Return a bytestring of *size* random bytes suitable for cryptographic use." +msgstr "" + +msgid "" +"This function returns random bytes from an OS-specific randomness source. " +"The returned data should be unpredictable enough for cryptographic " +"applications, though its exact quality depends on the OS implementation." +msgstr "" + +msgid "" +"On Linux, if the ``getrandom()`` syscall is available, it is used in " +"blocking mode: block until the system urandom entropy pool is initialized " +"(128 bits of entropy are collected by the kernel). See the :pep:`524` for " +"the rationale. On Linux, the :func:`getrandom` function can be used to get " +"random bytes in non-blocking mode (using the :data:`GRND_NONBLOCK` flag) or " +"to poll until the system urandom entropy pool is initialized." +msgstr "" + +msgid "" +"On a Unix-like system, random bytes are read from the ``/dev/urandom`` " +"device. If the ``/dev/urandom`` device is not available or not readable, " +"the :exc:`NotImplementedError` exception is raised." +msgstr "" + +msgid "On Windows, it will use ``BCryptGenRandom()``." +msgstr "" + +msgid "" +"The :mod:`secrets` module provides higher level functions. For an easy-to-" +"use interface to the random number generator provided by your platform, " +"please see :class:`random.SystemRandom`." +msgstr "" + +msgid "" +"On Linux 3.17 and newer, the ``getrandom()`` syscall is now used when " +"available. On OpenBSD 5.6 and newer, the C ``getentropy()`` function is now " +"used. These functions avoid the usage of an internal file descriptor." +msgstr "" + +msgid "" +"On Linux, if the ``getrandom()`` syscall blocks (the urandom entropy pool is " +"not initialized yet), fall back on reading ``/dev/urandom``." +msgstr "" + +msgid "" +"On Linux, ``getrandom()`` is now used in blocking mode to increase the " +"security." +msgstr "" + +msgid "" +"On Windows, ``BCryptGenRandom()`` is used instead of ``CryptGenRandom()`` " +"which is deprecated." +msgstr "" + +msgid "" +"By default, when reading from ``/dev/random``, :func:`getrandom` blocks if " +"no random bytes are available, and when reading from ``/dev/urandom``, it " +"blocks if the entropy pool has not yet been initialized." +msgstr "" + +msgid "" +"If the :py:data:`GRND_NONBLOCK` flag is set, then :func:`getrandom` does not " +"block in these cases, but instead immediately raises :exc:`BlockingIOError`." +msgstr "" + +msgid "" +"If this bit is set, then random bytes are drawn from the ``/dev/" +"random`` pool instead of the ``/dev/urandom`` pool." +msgstr "" + +msgid "user" +msgstr "" + +msgid "effective id" +msgstr "" + +msgid "process" +msgstr "" + +msgid "group" +msgstr "" + +msgid "id" +msgstr "" + +msgid "id of parent" +msgstr "" + +msgid "scheduling priority" +msgstr "" + +msgid "environment variables" +msgstr "" + +msgid "setting" +msgstr "" + +msgid "id, setting" +msgstr "" + +msgid "gethostname() (in module socket)" +msgstr "" + +msgid "gethostbyaddr() (in module socket)" +msgstr "" + +msgid "deleting" +msgstr "" + +msgid "module" +msgstr "moduł" + +msgid "pty" +msgstr "" + +msgid "directory" +msgstr "" + +msgid "changing" +msgstr "" + +msgid "creating" +msgstr "" + +msgid "UNC paths" +msgstr "" + +msgid "and os.makedirs()" +msgstr "" + +msgid "stat" +msgstr "" + +msgid "walking" +msgstr "" + +msgid "traversal" +msgstr "" + +msgid "killing" +msgstr "" + +msgid "signalling" +msgstr "" + +msgid ". (dot)" +msgstr "" + +msgid "in pathnames" +msgstr "" + +msgid ".." +msgstr "" + +msgid "/ (slash)" +msgstr "" + +msgid "\\ (backslash)" +msgstr "" + +msgid "in pathnames (Windows)" +msgstr "" + +msgid ": (colon)" +msgstr ": (dwukropek)" + +msgid "path separator (POSIX)" +msgstr "" + +msgid "; (semicolon)" +msgstr "" diff --git a/library/ossaudiodev.po b/library/ossaudiodev.po index 045bcf0042..c2a578005c 100644 --- a/library/ossaudiodev.po +++ b/library/ossaudiodev.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/pathlib.po b/library/pathlib.po new file mode 100644 index 0000000000..729a5771cd --- /dev/null +++ b/library/pathlib.po @@ -0,0 +1,1005 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`pathlib` --- Object-oriented filesystem paths" +msgstr "" + +msgid "**Source code:** :source:`Lib/pathlib.py`" +msgstr "" + +msgid "" +"This module offers classes representing filesystem paths with semantics " +"appropriate for different operating systems. Path classes are divided " +"between :ref:`pure paths `, which provide purely computational " +"operations without I/O, and :ref:`concrete paths `, which " +"inherit from pure paths but also provide I/O operations." +msgstr "" + +msgid "" +"If you've never used this module before or just aren't sure which class is " +"right for your task, :class:`Path` is most likely what you need. It " +"instantiates a :ref:`concrete path ` for the platform the " +"code is running on." +msgstr "" + +msgid "Pure paths are useful in some special cases; for example:" +msgstr "" + +msgid "" +"If you want to manipulate Windows paths on a Unix machine (or vice versa). " +"You cannot instantiate a :class:`WindowsPath` when running on Unix, but you " +"can instantiate :class:`PureWindowsPath`." +msgstr "" + +msgid "" +"You want to make sure that your code only manipulates paths without actually " +"accessing the OS. In this case, instantiating one of the pure classes may be " +"useful since those simply don't have any OS-accessing operations." +msgstr "" + +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." +msgstr "" + +msgid "Basic use" +msgstr "" + +msgid "Importing the main class::" +msgstr "" + +msgid "Listing subdirectories::" +msgstr "" + +msgid "Listing Python source files in this directory tree::" +msgstr "" + +msgid "Navigating inside a directory tree::" +msgstr "" + +msgid "Querying path properties::" +msgstr "" + +msgid "Opening a file::" +msgstr "" + +msgid "Pure paths" +msgstr "" + +msgid "" +"Pure path objects provide path-handling operations which don't actually " +"access a filesystem. There are three ways to access these classes, which we " +"also call *flavours*:" +msgstr "" + +msgid "" +"A generic class that represents the system's path flavour (instantiating it " +"creates either a :class:`PurePosixPath` or a :class:`PureWindowsPath`)::" +msgstr "" + +msgid "" +"Each element of *pathsegments* can be either a string representing a path " +"segment, an object implementing the :class:`os.PathLike` interface which " +"returns a string, or another path object::" +msgstr "" + +msgid "When *pathsegments* is empty, the current directory is assumed::" +msgstr "" + +msgid "" +"If a segment is an absolute path, all previous segments are ignored (like :" +"func:`os.path.join`)::" +msgstr "" + +msgid "" +"On Windows, the drive is not reset when a rooted relative path segment (e." +"g., ``r'\\foo'``) is encountered::" +msgstr "" + +msgid "" +"Spurious slashes and single dots are collapsed, but double dots (``'..'``) " +"and leading double slashes (``'//'``) are not, since this would change the " +"meaning of a path for various reasons (e.g. symbolic links, UNC paths)::" +msgstr "" + +msgid "" +"(a naïve approach would make ``PurePosixPath('foo/../bar')`` equivalent to " +"``PurePosixPath('bar')``, which is wrong if ``foo`` is a symbolic link to " +"another directory)" +msgstr "" + +msgid "" +"Pure path objects implement the :class:`os.PathLike` interface, allowing " +"them to be used anywhere the interface is accepted." +msgstr "" + +msgid "Added support for the :class:`os.PathLike` interface." +msgstr "" + +msgid "" +"A subclass of :class:`PurePath`, this path flavour represents non-Windows " +"filesystem paths::" +msgstr "" + +msgid "*pathsegments* is specified similarly to :class:`PurePath`." +msgstr "" + +msgid "" +"A subclass of :class:`PurePath`, this path flavour represents Windows " +"filesystem paths, including `UNC paths`_::" +msgstr "" + +msgid "" +"Regardless of the system you're running on, you can instantiate all of these " +"classes, since they don't provide any operation that does system calls." +msgstr "" + +msgid "General properties" +msgstr "" + +msgid "" +"Paths are immutable and :term:`hashable`. Paths of a same flavour are " +"comparable and orderable. These properties respect the flavour's case-" +"folding semantics::" +msgstr "" + +msgid "Paths of a different flavour compare unequal and cannot be ordered::" +msgstr "" + +msgid "Operators" +msgstr "" + +msgid "" +"The slash operator helps create child paths, like :func:`os.path.join`. If " +"the argument is an absolute path, the previous path is ignored. On Windows, " +"the drive is not reset when the argument is a rooted relative path (e.g., " +"``r'\\foo'``)::" +msgstr "" + +msgid "" +"A path object can be used anywhere an object implementing :class:`os." +"PathLike` is accepted::" +msgstr "" + +msgid "" +"The string representation of a path is the raw filesystem path itself (in " +"native form, e.g. with backslashes under Windows), which you can pass to any " +"function taking a file path as a string::" +msgstr "" + +msgid "" +"Similarly, calling :class:`bytes` on a path gives the raw filesystem path as " +"a bytes object, as encoded by :func:`os.fsencode`::" +msgstr "" + +msgid "" +"Calling :class:`bytes` is only recommended under Unix. Under Windows, the " +"unicode form is the canonical representation of filesystem paths." +msgstr "" + +msgid "Accessing individual parts" +msgstr "" + +msgid "" +"To access the individual \"parts\" (components) of a path, use the following " +"property:" +msgstr "" + +msgid "A tuple giving access to the path's various components::" +msgstr "" + +msgid "(note how the drive and local root are regrouped in a single part)" +msgstr "" + +msgid "Methods and properties" +msgstr "" + +msgid "Pure paths provide the following methods and properties:" +msgstr "" + +msgid "A string representing the drive letter or name, if any::" +msgstr "" + +msgid "UNC shares are also considered drives::" +msgstr "" + +msgid "A string representing the (local or global) root, if any::" +msgstr "" + +msgid "UNC shares always have a root::" +msgstr "" + +msgid "" +"If the path starts with more than two successive slashes, :class:`~pathlib." +"PurePosixPath` collapses them::" +msgstr "" + +msgid "" +"This behavior conforms to *The Open Group Base Specifications Issue 6*, " +"paragraph `4.11 Pathname Resolution `_:" +msgstr "" + +msgid "" +"*\"A pathname that begins with two successive slashes may be interpreted in " +"an implementation-defined manner, although more than two leading slashes " +"shall be treated as a single slash.\"*" +msgstr "" + +msgid "The concatenation of the drive and root::" +msgstr "" + +msgid "" +"An immutable sequence providing access to the logical ancestors of the path::" +msgstr "" + +msgid "" +"The parents sequence now supports :term:`slices ` and negative index " +"values." +msgstr "" + +msgid "The logical parent of the path::" +msgstr "" + +msgid "You cannot go past an anchor, or empty path::" +msgstr "" + +msgid "This is a purely lexical operation, hence the following behaviour::" +msgstr "" + +msgid "" +"If you want to walk an arbitrary filesystem path upwards, it is recommended " +"to first call :meth:`Path.resolve` so as to resolve symlinks and eliminate " +"``\"..\"`` components." +msgstr "" + +msgid "" +"A string representing the final path component, excluding the drive and " +"root, if any::" +msgstr "" + +msgid "UNC drive names are not considered::" +msgstr "" + +msgid "The file extension of the final component, if any::" +msgstr "" + +msgid "A list of the path's file extensions::" +msgstr "" + +msgid "The final path component, without its suffix::" +msgstr "" + +msgid "" +"Return a string representation of the path with forward slashes (``/``)::" +msgstr "" + +msgid "" +"Represent the path as a ``file`` URI. :exc:`ValueError` is raised if the " +"path isn't absolute." +msgstr "" + +msgid "" +"Return whether the path is absolute or not. A path is considered absolute " +"if it has both a root and (if the flavour allows) a drive::" +msgstr "" + +msgid "Return whether or not this path is relative to the *other* path." +msgstr "" + +msgid "If multiple arguments are supplied, they are joined together." +msgstr "" + +msgid "" +"This method is string-based; it neither accesses the filesystem nor treats " +"\"``..``\" segments specially. The following code is equivalent:" +msgstr "" + +msgid "" +"With :class:`PureWindowsPath`, return ``True`` if the path is considered " +"reserved under Windows, ``False`` otherwise. With :class:`PurePosixPath`, " +"``False`` is always returned." +msgstr "" + +msgid "" +"File system calls on reserved paths can fail mysteriously or have unintended " +"effects." +msgstr "" + +msgid "" +"Calling this method is equivalent to combining the path with each of the " +"*other* arguments in turn::" +msgstr "" + +msgid "" +"Match this path against the provided glob-style pattern. Return ``True`` if " +"matching is successful, ``False`` otherwise." +msgstr "" + +msgid "" +"If *pattern* is relative, the path can be either relative or absolute, and " +"matching is done from the right::" +msgstr "" + +msgid "" +"If *pattern* is absolute, the path must be absolute, and the whole path must " +"match::" +msgstr "" + +msgid "As with other methods, case-sensitivity follows platform defaults::" +msgstr "" + +msgid "" +"Compute a version of this path relative to the path represented by *other*. " +"If it's impossible, ValueError is raised::" +msgstr "" + +msgid "" +"NOTE: This function is part of :class:`PurePath` and works with strings. It " +"does not check or access the underlying file structure." +msgstr "" + +msgid "" +"Return a new path with the :attr:`name` changed. If the original path " +"doesn't have a name, ValueError is raised::" +msgstr "" + +msgid "" +"Return a new path with the :attr:`stem` changed. If the original path " +"doesn't have a name, ValueError is raised::" +msgstr "" + +msgid "" +"Return a new path with the :attr:`suffix` changed. If the original path " +"doesn't have a suffix, the new *suffix* is appended instead. If the " +"*suffix* is an empty string, the original suffix is removed::" +msgstr "" + +msgid "Concrete paths" +msgstr "" + +msgid "" +"Concrete paths are subclasses of the pure path classes. In addition to " +"operations provided by the latter, they also provide methods to do system " +"calls on path objects. There are three ways to instantiate concrete paths:" +msgstr "" + +msgid "" +"A subclass of :class:`PurePath`, this class represents concrete paths of the " +"system's path flavour (instantiating it creates either a :class:`PosixPath` " +"or a :class:`WindowsPath`)::" +msgstr "" + +msgid "" +"A subclass of :class:`Path` and :class:`PurePosixPath`, this class " +"represents concrete non-Windows filesystem paths::" +msgstr "" + +msgid "" +"A subclass of :class:`Path` and :class:`PureWindowsPath`, this class " +"represents concrete Windows filesystem paths::" +msgstr "" + +msgid "" +"You can only instantiate the class flavour that corresponds to your system " +"(allowing system calls on non-compatible path flavours could lead to bugs or " +"failures in your application)::" +msgstr "" + +msgid "Methods" +msgstr "" + +msgid "" +"Concrete paths provide the following methods in addition to pure paths " +"methods. Many of these methods can raise an :exc:`OSError` if a system call " +"fails (for example because the path doesn't exist)." +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()` now return ``False`` instead of " +"raising an exception for paths that contain characters unrepresentable at " +"the OS level." +msgstr "" + +msgid "" +"Return a new path object representing the current directory (as returned by :" +"func:`os.getcwd`)::" +msgstr "" + +msgid "" +"Return a new path object representing the user's home directory (as returned " +"by :func:`os.path.expanduser` with ``~`` construct). If the home directory " +"can't be resolved, :exc:`RuntimeError` is raised." +msgstr "" + +msgid "" +"Return a :class:`os.stat_result` object containing information about this " +"path, like :func:`os.stat`. The result is looked up at each call to this " +"method." +msgstr "" + +msgid "" +"This method normally follows symlinks; to stat a symlink add the argument " +"``follow_symlinks=False``, or use :meth:`~Path.lstat`." +msgstr "" + +msgid "The *follow_symlinks* parameter was added." +msgstr "" + +msgid "Change the file mode and permissions, like :func:`os.chmod`." +msgstr "" + +msgid "" +"This method normally follows symlinks. Some Unix flavours support changing " +"permissions on the symlink itself; on these platforms you may add the " +"argument ``follow_symlinks=False``, or use :meth:`~Path.lchmod`." +msgstr "" + +msgid "Whether the path points to an existing file or directory::" +msgstr "" + +msgid "" +"If the path points to a symlink, :meth:`exists` returns whether the symlink " +"*points to* an existing file or directory." +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." +msgstr "" + +msgid "" +"Glob the given relative *pattern* in the directory represented by this path, " +"yielding all matching files (of any kind)::" +msgstr "" + +msgid "" +"Patterns are the same as for :mod:`fnmatch`, with the addition of \"``**``\" " +"which means \"this directory and all subdirectories, recursively\". In " +"other words, it enables recursive globbing::" +msgstr "" + +msgid "" +"Using the \"``**``\" pattern in large directory trees may consume an " +"inordinate amount of time." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``pathlib.Path.glob`` with " +"arguments ``self``, ``pattern``." +msgstr "" + +msgid "" +"Return only directories if *pattern* ends with a pathname components " +"separator (:data:`~os.sep` or :data:`~os.altsep`)." +msgstr "" + +msgid "" +"Return the name of the group owning the file. :exc:`KeyError` is raised if " +"the file's gid isn't found in the system database." +msgstr "" + +msgid "" +"Return ``True`` if the path points to a directory (or a symbolic link " +"pointing to a directory), ``False`` if it points to another kind of file." +msgstr "" + +msgid "" +"``False`` is also returned if the path doesn't exist or is a broken symlink; " +"other errors (such as permission errors) are propagated." +msgstr "" + +msgid "" +"Return ``True`` if the path points to a regular file (or a symbolic link " +"pointing to a regular file), ``False`` if it points to another kind of file." +msgstr "" + +msgid "" +"Return ``True`` if the path is a :dfn:`mount point`: a point in a file " +"system where a different file system has been mounted. On POSIX, the " +"function checks whether *path*'s parent, :file:`path/..`, is on a different " +"device than *path*, or whether :file:`path/..` and *path* point to the same " +"i-node on the same device --- this should detect mount points for all Unix " +"and POSIX variants. Not implemented on Windows." +msgstr "" + +msgid "" +"Return ``True`` if the path points to a symbolic link, ``False`` otherwise." +msgstr "" + +msgid "" +"``False`` is also returned if the path doesn't exist; other errors (such as " +"permission errors) are propagated." +msgstr "" + +msgid "" +"Return ``True`` if the path points to a Unix socket (or a symbolic link " +"pointing to a Unix socket), ``False`` if it points to another kind of file." +msgstr "" + +msgid "" +"Return ``True`` if the path points to a FIFO (or a symbolic link pointing to " +"a FIFO), ``False`` if it points to another kind of file." +msgstr "" + +msgid "" +"Return ``True`` if the path points to a block device (or a symbolic link " +"pointing to a block device), ``False`` if it points to another kind of file." +msgstr "" + +msgid "" +"Return ``True`` if the path points to a character device (or a symbolic link " +"pointing to a character device), ``False`` if it points to another kind of " +"file." +msgstr "" + +msgid "" +"When the path points to a directory, yield path objects of the directory " +"contents::" +msgstr "" + +msgid "" +"The children are yielded in arbitrary order, and the special entries ``'.'`` " +"and ``'..'`` are not included. If a file is removed from or added to the " +"directory after creating the iterator, whether a path object for that file " +"be included is unspecified." +msgstr "" + +msgid "" +"Like :meth:`Path.chmod` but, if the path points to a symbolic link, the " +"symbolic link's mode is changed rather than its target's." +msgstr "" + +msgid "" +"Like :meth:`Path.stat` but, if the path points to a symbolic link, return " +"the symbolic link's information rather than its target's." +msgstr "" + +msgid "" +"Create a new directory at this given path. If *mode* is given, it is " +"combined with the process' ``umask`` value to determine the file mode and " +"access flags. If the path already exists, :exc:`FileExistsError` is raised." +msgstr "" + +msgid "" +"If *parents* is true, any missing parents of this path are created as " +"needed; they are created with the default permissions without taking *mode* " +"into account (mimicking the POSIX ``mkdir -p`` command)." +msgstr "" + +msgid "" +"If *parents* is false (the default), a missing parent raises :exc:" +"`FileNotFoundError`." +msgstr "" + +msgid "" +"If *exist_ok* is false (the default), :exc:`FileExistsError` is raised if " +"the target directory already exists." +msgstr "" + +msgid "" +"If *exist_ok* is true, :exc:`FileExistsError` will not be raised unless the " +"given path already exists in the file system and is not a directory (same " +"behavior as the POSIX ``mkdir -p`` command)." +msgstr "" + +msgid "The *exist_ok* parameter was added." +msgstr "" + +msgid "" +"Open the file pointed to by the path, like the built-in :func:`open` " +"function does::" +msgstr "" + +msgid "" +"Return the name of the user owning the file. :exc:`KeyError` is raised if " +"the file's uid isn't found in the system database." +msgstr "" + +msgid "Return the binary contents of the pointed-to file as a bytes object::" +msgstr "" + +msgid "Return the decoded contents of the pointed-to file as a string::" +msgstr "" + +msgid "" +"The file is opened and then closed. The optional parameters have the same " +"meaning as in :func:`open`." +msgstr "" + +msgid "" +"Return the path to which the symbolic link points (as returned by :func:`os." +"readlink`)::" +msgstr "" + +msgid "" +"Rename this file or directory to the given *target*, and return a new 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 "" +"The target path may be absolute or relative. Relative paths are interpreted " +"relative to the current working directory, *not* the directory of the Path " +"object." +msgstr "" + +msgid "" +"It is implemented in terms of :func:`os.rename` and gives the same " +"guarantees." +msgstr "" + +msgid "Added return value, return the new Path instance." +msgstr "" + +msgid "" +"Rename this file or directory to the given *target*, and return a new Path " +"instance pointing to *target*. If *target* points to an existing file or " +"empty directory, it will be unconditionally replaced." +msgstr "" + +msgid "" +"Make the path absolute, without normalization or resolving symlinks. Returns " +"a new path object::" +msgstr "" + +msgid "" +"Make the path absolute, resolving any symlinks. A new path object is " +"returned::" +msgstr "" + +msgid "" +"\"``..``\" components are also eliminated (this is the only method to do " +"so)::" +msgstr "" + +msgid "" +"If the path doesn't exist and *strict* is ``True``, :exc:`FileNotFoundError` " +"is raised. If *strict* is ``False``, the path is resolved as far as " +"possible and any remainder is appended without checking whether it exists. " +"If an infinite loop is encountered along the resolution path, :exc:" +"`RuntimeError` is raised." +msgstr "" + +msgid "The *strict* argument (pre-3.6 behavior is strict)." +msgstr "" + +msgid "" +"This is like calling :func:`Path.glob` with \"``**/``\" added in front of " +"the given relative *pattern*::" +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``pathlib.Path.rglob`` with " +"arguments ``self``, ``pattern``." +msgstr "" + +msgid "Remove this directory. The directory must be empty." +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`." +msgstr "" + +msgid "" +"An :exc:`OSError` can be raised if either file cannot be accessed for some " +"reason." +msgstr "" + +msgid "Make this path a symbolic link pointing to *target*." +msgstr "" + +msgid "" +"On Windows, a symlink represents either a file or a directory, and does not " +"morph to the target dynamically. If the target is present, the type of the " +"symlink will be created to match. Otherwise, the symlink will be created as " +"a directory if *target_is_directory* is ``True`` or a file symlink (the " +"default) otherwise. On non-Windows platforms, *target_is_directory* is " +"ignored." +msgstr "" + +msgid "" +"The order of arguments (link, target) is the reverse of :func:`os.symlink`'s." +msgstr "" + +msgid "Make this path a hard link to the same file as *target*." +msgstr "" + +msgid "" +"The order of arguments (link, target) is the reverse of :func:`os.link`'s." +msgstr "" + +msgid "Make *target* a hard link to this path." +msgstr "" + +msgid "" +"This function does not make this path a hard link to *target*, despite the " +"implication of the function and argument names. The argument order (target, " +"link) is the reverse of :func:`Path.symlink_to` and :func:`Path." +"hardlink_to`, but matches that of :func:`os.link`." +msgstr "" + +msgid "" +"This method is deprecated in favor of :meth:`Path.hardlink_to`, as the " +"argument order of :meth:`Path.link_to` does not match that of :meth:`Path." +"symlink_to`." +msgstr "" + +msgid "" +"Create a file at this given path. If *mode* is given, it is combined with " +"the process' ``umask`` value to determine the file mode and access flags. " +"If the file already exists, the function succeeds if *exist_ok* is true (and " +"its modification time is updated to the current time), otherwise :exc:" +"`FileExistsError` is raised." +msgstr "" + +msgid "" +"Remove this file or symbolic link. If the path points to a directory, use :" +"func:`Path.rmdir` instead." +msgstr "" + +msgid "" +"If *missing_ok* is false (the default), :exc:`FileNotFoundError` is raised " +"if the path does not exist." +msgstr "" + +msgid "" +"If *missing_ok* is true, :exc:`FileNotFoundError` exceptions will be ignored " +"(same behavior as the POSIX ``rm -f`` command)." +msgstr "" + +msgid "The *missing_ok* parameter was added." +msgstr "" + +msgid "" +"Open the file pointed to in bytes mode, write *data* to it, and close the " +"file::" +msgstr "" + +msgid "An existing file of the same name is overwritten." +msgstr "" + +msgid "" +"Open the file pointed to in text mode, write *data* to it, and close the " +"file::" +msgstr "" + +msgid "" +"An existing file of the same name is overwritten. The optional parameters " +"have the same meaning as in :func:`open`." +msgstr "" + +msgid "The *newline* parameter was added." +msgstr "" + +msgid "Correspondence to tools in the :mod:`os` module" +msgstr "" + +msgid "" +"Below is a table mapping various :mod:`os` functions to their corresponding :" +"class:`PurePath`/:class:`Path` equivalent." +msgstr "" + +msgid "" +"Not all pairs of functions/methods below are equivalent. Some of them, " +"despite having some overlapping use-cases, have different semantics. They " +"include :func:`os.path.abspath` and :meth:`Path.absolute`, :func:`os.path." +"relpath` and :meth:`PurePath.relative_to`." +msgstr "" + +msgid ":mod:`os` and :mod:`os.path`" +msgstr "" + +msgid ":mod:`pathlib`" +msgstr ":mod:`pathlib`" + +msgid ":func:`os.path.abspath`" +msgstr ":func:`os.path.abspath`" + +msgid ":meth:`Path.absolute` [#]_" +msgstr "" + +msgid ":func:`os.path.realpath`" +msgstr ":func:`os.path.realpath`" + +msgid ":meth:`Path.resolve`" +msgstr ":meth:`Path.resolve`" + +msgid ":func:`os.chmod`" +msgstr ":func:`os.chmod`" + +msgid ":meth:`Path.chmod`" +msgstr ":meth:`Path.chmod`" + +msgid ":func:`os.mkdir`" +msgstr "" + +msgid ":meth:`Path.mkdir`" +msgstr ":meth:`Path.mkdir`" + +msgid ":func:`os.makedirs`" +msgstr "" + +msgid ":func:`os.rename`" +msgstr ":func:`os.rename`" + +msgid ":meth:`Path.rename`" +msgstr ":meth:`Path.rename`" + +msgid ":func:`os.replace`" +msgstr ":func:`os.replace`" + +msgid ":meth:`Path.replace`" +msgstr ":meth:`Path.replace`" + +msgid ":func:`os.rmdir`" +msgstr ":func:`os.rmdir`" + +msgid ":meth:`Path.rmdir`" +msgstr ":meth:`Path.rmdir`" + +msgid ":func:`os.remove`, :func:`os.unlink`" +msgstr "" + +msgid ":meth:`Path.unlink`" +msgstr ":meth:`Path.unlink`" + +msgid ":func:`os.getcwd`" +msgstr ":func:`os.getcwd`" + +msgid ":func:`Path.cwd`" +msgstr "" + +msgid ":func:`os.path.exists`" +msgstr ":func:`os.path.exists`" + +msgid ":meth:`Path.exists`" +msgstr ":meth:`Path.exists`" + +msgid ":func:`os.path.expanduser`" +msgstr ":func:`os.path.expanduser`" + +msgid ":meth:`Path.expanduser` and :meth:`Path.home`" +msgstr "" + +msgid ":func:`os.listdir`" +msgstr ":func:`os.listdir`" + +msgid ":meth:`Path.iterdir`" +msgstr ":meth:`Path.iterdir`" + +msgid ":func:`os.path.isdir`" +msgstr ":func:`os.path.isdir`" + +msgid ":meth:`Path.is_dir`" +msgstr ":meth:`Path.is_dir`" + +msgid ":func:`os.path.isfile`" +msgstr ":func:`os.path.isfile`" + +msgid ":meth:`Path.is_file`" +msgstr ":meth:`Path.is_file`" + +msgid ":func:`os.path.islink`" +msgstr ":func:`os.path.islink`" + +msgid ":meth:`Path.is_symlink`" +msgstr ":meth:`Path.is_symlink`" + +msgid ":func:`os.link`" +msgstr ":func:`os.link`" + +msgid ":meth:`Path.hardlink_to`" +msgstr ":meth:`Path.hardlink_to`" + +msgid ":func:`os.symlink`" +msgstr ":func:`os.symlink`" + +msgid ":meth:`Path.symlink_to`" +msgstr ":meth:`Path.symlink_to`" + +msgid ":func:`os.readlink`" +msgstr ":func:`os.readlink`" + +msgid ":meth:`Path.readlink`" +msgstr ":meth:`Path.readlink`" + +msgid ":func:`os.path.relpath`" +msgstr ":func:`os.path.relpath`" + +msgid ":meth:`PurePath.relative_to` [#]_" +msgstr "" + +msgid ":func:`os.stat`" +msgstr ":func:`os.stat`" + +msgid ":meth:`Path.stat`, :meth:`Path.owner`, :meth:`Path.group`" +msgstr "" + +msgid ":func:`os.path.isabs`" +msgstr ":func:`os.path.isabs`" + +msgid ":meth:`PurePath.is_absolute`" +msgstr ":meth:`PurePath.is_absolute`" + +msgid ":func:`os.path.join`" +msgstr ":func:`os.path.join`" + +msgid ":func:`PurePath.joinpath`" +msgstr "" + +msgid ":func:`os.path.basename`" +msgstr ":func:`os.path.basename`" + +msgid ":attr:`PurePath.name`" +msgstr ":attr:`PurePath.name`" + +msgid ":func:`os.path.dirname`" +msgstr ":func:`os.path.dirname`" + +msgid ":attr:`PurePath.parent`" +msgstr ":attr:`PurePath.parent`" + +msgid ":func:`os.path.samefile`" +msgstr ":func:`os.path.samefile`" + +msgid ":meth:`Path.samefile`" +msgstr ":meth:`Path.samefile`" + +msgid ":func:`os.path.splitext`" +msgstr ":func:`os.path.splitext`" + +msgid ":attr:`PurePath.stem` and :attr:`PurePath.suffix`" +msgstr "" + +msgid "Footnotes" +msgstr "Przypisy" + +msgid "" +":func:`os.path.abspath` normalizes the resulting path, which may change its " +"meaning in the presence of symlinks, while :meth:`Path.absolute` does not." +msgstr "" + +msgid "" +":meth:`PurePath.relative_to` requires ``self`` to be the subpath of the " +"argument, but :func:`os.path.relpath` does not." +msgstr "" + +msgid "path" +msgstr "ścieżka" + +msgid "operations" +msgstr "" diff --git a/library/pdb.po b/library/pdb.po index a4927c62f3..806b88c2c7 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,14 @@ msgid "" msgstr "" msgid "" -"``-c`` option is introduced to execute commands as if given in a :file:`." -"pdbrc` file, see :ref:`debugger-commands`." +"Added the ``-c`` option to execute commands as if given in a :file:`.pdbrc` " +"file; see :ref:`debugger-commands`." msgstr "" msgid "" -"``-m`` option is introduced to execute modules similar to the way ``python -" -"m`` does. As with a script, the debugger will pause execution just before " -"the first line of the module." +"Added the ``-m`` option to execute modules similar to the way ``python -m`` " +"does. As with a script, the debugger will pause execution just before the " +"first line of the module." msgstr "" msgid "Typical usage to execute a statement under control of the debugger is::" @@ -209,11 +209,12 @@ msgid "" "Raises an :ref:`auditing event ` ``pdb.Pdb`` with no arguments." msgstr "" -msgid "The *skip* argument." +msgid "Added the *skip* parameter." msgstr "" msgid "" -"The *nosigint* argument. Previously, a SIGINT handler was never set by Pdb." +"Added the *nosigint* parameter. Previously, a SIGINT handler was never set " +"by Pdb." msgstr "" msgid "The *readrc* argument." @@ -270,14 +271,10 @@ msgstr "" msgid "" "If a file :file:`.pdbrc` exists in the user's home directory or in the " "current directory, it is read with ``'utf-8'`` encoding and executed as if " -"it had been typed at the debugger prompt. This is particularly useful for " -"aliases. If both files exist, the one in the home directory is read first " -"and aliases defined there can be overridden by the local file." -msgstr "" - -msgid "" -":file:`.pdbrc` is now read with ``'utf-8'`` encoding. Previously, it was " -"read with the system locale encoding." +"it had been typed at the debugger prompt, with the exception that empty " +"lines and lines starting with ``#`` are ignored. This is particularly " +"useful for aliases. If both files exist, the one in the home directory is " +"read first and aliases defined there can be overridden by the local file." msgstr "" msgid "" @@ -286,6 +283,11 @@ msgid "" "effect." msgstr "" +msgid "" +":file:`.pdbrc` is now read with ``'utf-8'`` encoding. Previously, it was " +"read with the system locale encoding." +msgstr "" + msgid "" "Without argument, print the list of available commands. With a *command* as " "argument, print help about that command. ``help pdb`` displays the full " @@ -465,7 +467,7 @@ msgid "" "line." msgstr "" -msgid "The ``>>`` marker." +msgid "Added the ``>>`` marker." msgstr "" msgid "" @@ -511,7 +513,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "" "Display won't realize ``lst`` has been changed because the result of " @@ -609,7 +611,7 @@ msgid ".pdbrc" msgstr "" msgid "file" -msgstr "" +msgstr "plik" msgid "debugger" msgstr "" diff --git a/library/pickle.po b/library/pickle.po index ae4c3c1ba2..ed5aafc48c 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -327,13 +326,13 @@ msgid "The :mod:`pickle` module defines three exceptions:" msgstr "" msgid "" -"Common base class for the other pickling exceptions. It inherits :exc:" +"Common base class for the other pickling exceptions. It inherits from :exc:" "`Exception`." msgstr "" msgid "" "Error raised when an unpicklable object is encountered by :class:`Pickler`. " -"It inherits :exc:`PickleError`." +"It inherits from :exc:`PickleError`." msgstr "" msgid "" @@ -343,7 +342,7 @@ msgstr "" msgid "" "Error raised when there is a problem unpickling an object, such as a data " -"corruption or a security violation. It inherits :exc:`PickleError`." +"corruption or a security violation. It inherits from :exc:`PickleError`." msgstr "" msgid "" @@ -421,7 +420,7 @@ msgid "" "the kind which can be declared using :func:`copyreg.pickle`. It is a " "mapping whose keys are classes and whose values are reduction functions. A " "reduction function takes a single argument of the associated class and " -"should conform to the same interface as a :meth:`__reduce__` method." +"should conform to the same interface as a :meth:`~object.__reduce__` method." msgstr "" msgid "" @@ -440,9 +439,9 @@ msgstr "" 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:`__reduce__` method, and can " -"optionally return ``NotImplemented`` to fallback on :attr:`dispatch_table`-" -"registered reducers to pickle ``obj``." +"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``." msgstr "" msgid "For a detailed example, see :ref:`reducer_override`." @@ -569,7 +568,9 @@ msgstr "" msgid "The following types can be pickled:" msgstr "" -msgid "``None``, ``True``, and ``False``;" +msgid "" +"built-in constants (``None``, ``True``, ``False``, ``Ellipsis``, and :data:" +"`NotImplemented`);" msgstr "" msgid "integers, floating-point numbers, complex numbers;" @@ -591,8 +592,8 @@ msgid "classes accessible from the top level of a module;" msgstr "" msgid "" -"instances of such classes whose the result of calling :meth:`__getstate__` " -"is picklable (see section :ref:`pickle-inst` for details)." +"instances of such classes whose the result of calling :meth:`~object." +"__getstate__` is picklable (see section :ref:`pickle-inst` for details)." msgstr "" msgid "" @@ -633,8 +634,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:`__setstate__` " -"method." +"that suitable conversions can be made by the class's :meth:`~object." +"__setstate__` method." msgstr "" msgid "Pickling Class Instances" @@ -648,10 +649,10 @@ 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:`__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 "" @@ -737,38 +738,40 @@ msgid "" msgstr "" msgid "" -"If :meth:`__getstate__` returns a false value, 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:`__getstate__` and :meth:`__setstate__`." +"use the methods :meth:`~object.__getstate__` and :meth:`~object." +"__setstate__`." msgstr "" msgid "" -"At unpickling time, some methods like :meth:`__getattr__`, :meth:" -"`__getattribute__`, or :meth:`__setattr__` may be called upon the instance. " -"In case those methods rely on some internal invariant being true, the type " -"should implement :meth:`__new__` to establish such an invariant, as :meth:" -"`__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:`__reduce__` special method. The copy protocol provides a unified " -"interface for retrieving the data necessary for pickling and copying " +"meth:`~object.__reduce__` special method. The copy protocol provides a " +"unified interface for retrieving the data necessary for pickling and copying " "objects. [#]_" msgstr "" msgid "" -"Although powerful, implementing :meth:`__reduce__` directly in your classes " -"is error prone. For this reason, class designers should use the high-level " -"interface (i.e., :meth:`__getnewargs_ex__`, :meth:`__getstate__` and :meth:" -"`__setstate__`) whenever possible. We will show, however, cases where " -"using :meth:`__reduce__` is the only option or leads to more efficient " -"pickling or both." +"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." msgstr "" msgid "" @@ -812,10 +815,10 @@ msgid "" "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:`append` and :meth:`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.)" +"ref:`append and 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.)" msgstr "" msgid "" @@ -895,8 +898,8 @@ msgstr "" msgid "" "The global dispatch table managed by the :mod:`copyreg` module is available " -"as :data:`copyreg.dispatch_table`. Therefore, one may choose to use a " -"modified copy of :data:`copyreg.dispatch_table` as a private dispatch table." +"as :data:`!copyreg.dispatch_table`. Therefore, one may choose to use a " +"modified copy of :data:`!copyreg.dispatch_table` as a private dispatch table." msgstr "" msgid "For example ::" @@ -922,12 +925,12 @@ msgstr "" msgid "" "Here's an example that shows how to modify pickling behavior for a class. " -"The :class:`TextReader` class opens a text file, and returns the line number " -"and line contents each time its :meth:`!readline` method is called. If a :" -"class:`TextReader` instance is pickled, all attributes *except* the file " -"object member are saved. When the instance is unpickled, the file is " -"reopened, and reading resumes from the last location. The :meth:" -"`__setstate__` and :meth:`__getstate__` methods are used to implement this " +"The :class:`!TextReader` class below opens a text file, and returns the line " +"number and line contents each time its :meth:`!readline` method is called. " +"If a :class:`!TextReader` instance is pickled, all attributes *except* the " +"file object member are saved. When the instance is unpickled, the file is " +"reopened, and reading resumes from the last location. The :meth:`!" +"__setstate__` and :meth:`!__getstate__` methods are used to implement this " "behavior. ::" msgstr "" @@ -947,8 +950,8 @@ msgstr "" msgid "" "For those cases, it is possible to subclass from the :class:`Pickler` class " "and implement a :meth:`~Pickler.reducer_override` method. This method can " -"return an arbitrary reduction tuple (see :meth:`__reduce__`). It can " -"alternatively return ``NotImplemented`` to fallback to the traditional " +"return an arbitrary reduction tuple (see :meth:`~object.__reduce__`). It can " +"alternatively return :data:`NotImplemented` to fallback to the traditional " "behavior." msgstr "" @@ -994,10 +997,10 @@ msgid "Provider API" msgstr "" msgid "" -"The large data objects to be pickled must implement a :meth:`__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 "" @@ -1042,7 +1045,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "" "Here is a trivial example where we implement a :class:`bytearray` subclass " diff --git a/library/pickletools.po b/library/pickletools.po index a27984d765..2f47d1656b 100644 --- a/library/pickletools.po +++ b/library/pickletools.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -89,7 +89,7 @@ msgid "" "where annotation should start." msgstr "" -msgid "The *annotate* argument." +msgid "Added the *annotate* parameter." msgstr "" msgid "" diff --git a/library/pipes.po b/library/pipes.po new file mode 100644 index 0000000000..eadb471691 --- /dev/null +++ b/library/pipes.po @@ -0,0 +1,107 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`pipes` --- Interface to shell pipelines" +msgstr "" + +msgid "**Source code:** :source:`Lib/pipes.py`" +msgstr "" + +msgid "" +"The :mod:`pipes` module is deprecated (see :pep:`PEP 594 <594#pipes>` for " +"details). Please use the :mod:`subprocess` module instead." +msgstr "" + +msgid "" +"The :mod:`pipes` module defines a class to abstract the concept of a " +"*pipeline* --- a sequence of converters from one file to another." +msgstr "" + +msgid "" +"Because the module uses :program:`/bin/sh` command lines, a POSIX or " +"compatible shell for :func:`os.system` and :func:`os.popen` is required." +msgstr "" + +msgid ":ref:`Availability `: Unix, not VxWorks." +msgstr "" + +msgid "The :mod:`pipes` module defines the following class:" +msgstr "" + +msgid "An abstraction of a pipeline." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "Template Objects" +msgstr "" + +msgid "Template objects following methods:" +msgstr "" + +msgid "Restore a pipeline template to its initial state." +msgstr "" + +msgid "Return a new, equivalent, pipeline template." +msgstr "" + +msgid "" +"If *flag* is true, turn debugging on. Otherwise, turn debugging off. When " +"debugging is on, commands to be executed are printed, and the shell is given " +"``set -x`` command to be more verbose." +msgstr "" + +msgid "" +"Append a new action at the end. The *cmd* variable must be a valid bourne " +"shell command. The *kind* variable consists of two letters." +msgstr "" + +msgid "" +"The first letter can be either of ``'-'`` (which means the command reads its " +"standard input), ``'f'`` (which means the commands reads a given file on the " +"command line) or ``'.'`` (which means the commands reads no input, and hence " +"must be first.)" +msgstr "" + +msgid "" +"Similarly, the second letter can be either of ``'-'`` (which means the " +"command writes to standard output), ``'f'`` (which means the command writes " +"a file on the command line) or ``'.'`` (which means the command does not " +"write anything, and hence must be last.)" +msgstr "" + +msgid "" +"Add a new action at the beginning. See :meth:`append` for explanations of " +"the arguments." +msgstr "" + +msgid "" +"Return a file-like object, open to *file*, but read from or written to by " +"the pipeline. Note that only one of ``'r'``, ``'w'`` may be given." +msgstr "" + +msgid "Copy *infile* to *outfile* through the pipe." +msgstr "" diff --git a/library/pkgutil.po b/library/pkgutil.po new file mode 100644 index 0000000000..0067a7e262 --- /dev/null +++ b/library/pkgutil.po @@ -0,0 +1,283 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`pkgutil` --- Package extension utility" +msgstr "" + +msgid "**Source code:** :source:`Lib/pkgutil.py`" +msgstr "" + +msgid "" +"This module provides utilities for the import system, in particular package " +"support." +msgstr "" + +msgid "A namedtuple that holds a brief summary of a module's info." +msgstr "" + +msgid "" +"Extend the search path for the modules which comprise a package. Intended " +"use is to place the following code in a package's :file:`__init__.py`::" +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:`__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 checking for duplicates, 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 "" +"If the input path is not a list (as is the case for frozen packages) it is " +"returned unchanged. The input path is not modified; an extended copy is " +"returned. Items are only appended to the copy at the end." +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)." +msgstr "" + +msgid ":pep:`302` Finder that wraps Python's \"classic\" import algorithm." +msgstr "" + +msgid "" +"If *dirname* is a string, a :pep:`302` finder is created that searches that " +"directory. If *dirname* is ``None``, a :pep:`302` finder is created that " +"searches the current :data:`sys.path`, plus any modules that are frozen or " +"built-in." +msgstr "" + +msgid "" +"Note that :class:`ImpImporter` does not currently support being used by " +"placement on :data:`sys.meta_path`." +msgstr "" + +msgid "" +"This emulation is no longer needed, as the standard import mechanism is now " +"fully :pep:`302` compliant and available in :mod:`importlib`." +msgstr "" + +msgid "" +":term:`Loader ` that wraps Python's \"classic\" import algorithm." +msgstr "" + +msgid "Retrieve a module :term:`loader` for the given *fullname*." +msgstr "" + +msgid "" +"This is a backwards compatibility wrapper around :func:`importlib.util." +"find_spec` that converts most failures to :exc:`ImportError` and only " +"returns the loader rather than the full :class:`importlib.machinery." +"ModuleSpec`." +msgstr "" + +msgid "" +"Updated to be based directly on :mod:`importlib` rather than relying on the " +"package internal :pep:`302` import emulation." +msgstr "" + +msgid "Updated to be based on :pep:`451`" +msgstr "" + +msgid "Retrieve a :term:`finder` for the given *path_item*." +msgstr "" + +msgid "" +"The returned finder is cached in :data:`sys.path_importer_cache` if it was " +"newly created by a path hook." +msgstr "" + +msgid "" +"The cache (or part of it) can be cleared manually if a rescan of :data:`sys." +"path_hooks` is necessary." +msgstr "" + +msgid "Get a :term:`loader` object for *module_or_name*." +msgstr "" + +msgid "" +"If the module or package is accessible via the normal import mechanism, a " +"wrapper around the relevant part of that machinery is returned. Returns " +"``None`` if the module cannot be found or imported. If the named module is " +"not already imported, its containing package (if any) is imported, in order " +"to establish the package ``__path__``." +msgstr "" + +msgid "Yield :term:`finder` objects for the given module name." +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`)." +msgstr "" + +msgid "" +"If the named module is in a package, that package is imported as a side " +"effect of invoking this function." +msgstr "" + +msgid "If no module name is specified, all top level finders are produced." +msgstr "" + +msgid "" +"Yields :class:`ModuleInfo` for all submodules on *path*, or, if *path* is " +"``None``, all top-level modules on :data:`sys.path`." +msgstr "" + +msgid "" +"*path* should be either ``None`` or a list of paths to look for modules in." +msgstr "" + +msgid "" +"*prefix* is a string to output on the front of every module name on output." +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`." +msgstr "" + +msgid "" +"Yields :class:`ModuleInfo` for all modules recursively on *path*, or, if " +"*path* is ``None``, all accessible modules." +msgstr "" + +msgid "" +"Note that this function must import all *packages* (*not* all modules!) on " +"the given *path*, in order to access the ``__path__`` attribute to find " +"submodules." +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." +msgstr "" + +msgid "Examples::" +msgstr "Przykłady::" + +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. The parent directory name ``..`` is not allowed, and nor is a " +"rooted name (starting with a ``/``)." +msgstr "" + +msgid "" +"The function returns a binary string that is the contents of the specified " +"resource." +msgstr "" + +msgid "" +"For packages located in the filesystem, which have already been imported, " +"this is the rough equivalent of::" +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 `." +msgstr "" + +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." +msgstr "" + +msgid "" +"It is expected that *name* will be a string in one of the following formats, " +"where W is shorthand for a valid Python identifier and dot stands for a " +"literal period in these pseudo-regexes:" +msgstr "" + +msgid "``W(.W)*``" +msgstr "``W(.W)*``" + +msgid "``W(.W)*:(W(.W)*)?``" +msgstr "``W(.W)*:(W(.W)*)?``" + +msgid "" +"The first form is intended for backward compatibility only. It assumes that " +"some part of the dotted name is a package, and the rest is an object " +"somewhere within that package, possibly nested inside other objects. Because " +"the place where the package stops and the object hierarchy starts can't be " +"inferred by inspection, repeated attempts to import must be done with this " +"form." +msgstr "" + +msgid "" +"In the second form, the caller makes the division point clear through the " +"provision of a single colon: the dotted name to the left of the colon is a " +"package to be imported, and the dotted name to the right is the object " +"hierarchy within that package. Only one import is needed in this form. If it " +"ends with the colon, then a module object is returned." +msgstr "" + +msgid "" +"The function will return an object (which might be a module), or raise one " +"of the following exceptions:" +msgstr "" + +msgid ":exc:`ValueError` -- if *name* isn't in a recognised format." +msgstr "" + +msgid ":exc:`ImportError` -- if an import failed when it shouldn't have." +msgstr "" + +msgid "" +":exc:`AttributeError` -- If a failure occurred when traversing the object " +"hierarchy within the imported package to get to the desired object." +msgstr "" diff --git a/library/platform.po b/library/platform.po new file mode 100644 index 0000000000..55e0bc8f39 --- /dev/null +++ b/library/platform.po @@ -0,0 +1,307 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`platform` --- Access to underlying platform's identifying data" +msgstr "" + +msgid "**Source code:** :source:`Lib/platform.py`" +msgstr "" + +msgid "" +"Specific platforms listed alphabetically, with Linux included in the Unix " +"section." +msgstr "" + +msgid "Cross Platform" +msgstr "" + +msgid "" +"Queries the given executable (defaults to the Python interpreter binary) for " +"various architecture information." +msgstr "" + +msgid "" +"Returns a tuple ``(bits, linkage)`` which contain information about the bit " +"architecture and the linkage format used for the executable. Both values are " +"returned as strings." +msgstr "" + +msgid "" +"Values that cannot be determined are returned as given by the parameter " +"presets. If bits is given as ``''``, the ``sizeof(pointer)`` (or " +"``sizeof(long)`` on Python version < 1.5.2) is used as indicator for the " +"supported pointer size." +msgstr "" + +msgid "" +"The function relies on the system's :file:`file` command to do the actual " +"work. This is available on most if not all Unix platforms and some non-Unix " +"platforms and then only if the executable points to the Python interpreter. " +"Reasonable defaults are used when the above needs are not met." +msgstr "" + +msgid "" +"On macOS (and perhaps other platforms), executable files may be universal " +"files containing multiple architectures." +msgstr "" + +msgid "" +"To get at the \"64-bitness\" of the current interpreter, it is more reliable " +"to query the :data:`sys.maxsize` attribute::" +msgstr "" + +msgid "" +"Returns the machine type, e.g. ``'AMD64'``. An empty string is returned if " +"the value cannot be determined." +msgstr "" + +msgid "" +"Returns the computer's network name (may not be fully qualified!). An empty " +"string is returned if the value cannot be determined." +msgstr "" + +msgid "" +"Returns a single string identifying the underlying platform with as much " +"useful information as possible." +msgstr "" + +msgid "" +"The output is intended to be *human readable* rather than machine parseable. " +"It may look different on different platforms and this is intended." +msgstr "" + +msgid "" +"If *aliased* is true, the function will use aliases for various platforms " +"that report system names which differ from their common names, for example " +"SunOS will be reported as Solaris. The :func:`system_alias` function is " +"used to implement this." +msgstr "" + +msgid "" +"Setting *terse* to true causes the function to return only the absolute " +"minimum information needed to identify the platform." +msgstr "" + +msgid "" +"On macOS, the function now uses :func:`mac_ver`, if it returns a non-empty " +"release string, to get the macOS version rather than the darwin version." +msgstr "" + +msgid "Returns the (real) processor name, e.g. ``'amdk6'``." +msgstr "" + +msgid "" +"An empty string is returned if the value cannot be determined. Note that " +"many platforms do not provide this information or simply return the same " +"value as for :func:`machine`. NetBSD does this." +msgstr "" + +msgid "" +"Returns a tuple ``(buildno, builddate)`` stating the Python build number and " +"date as strings." +msgstr "" + +msgid "Returns a string identifying the compiler used for compiling Python." +msgstr "" + +msgid "Returns a string identifying the Python implementation SCM branch." +msgstr "" + +msgid "" +"Returns a string identifying the Python implementation. Possible return " +"values are: 'CPython', 'IronPython', 'Jython', 'PyPy'." +msgstr "" + +msgid "Returns a string identifying the Python implementation SCM revision." +msgstr "" + +msgid "Returns the Python version as string ``'major.minor.patchlevel'``." +msgstr "" + +msgid "" +"Note that unlike the Python ``sys.version``, the returned value will always " +"include the patchlevel (it defaults to 0)." +msgstr "" + +msgid "" +"Returns the Python version as tuple ``(major, minor, patchlevel)`` of " +"strings." +msgstr "" + +msgid "" +"Note that unlike the Python ``sys.version``, the returned value will always " +"include the patchlevel (it defaults to ``'0'``)." +msgstr "" + +msgid "" +"Returns the system's release, e.g. ``'2.2.0'`` or ``'NT'``. An empty string " +"is returned if the value cannot be determined." +msgstr "" + +msgid "" +"Returns the system/OS name, such as ``'Linux'``, ``'Darwin'``, ``'Java'``, " +"``'Windows'``. An empty string is returned if the value cannot be determined." +msgstr "" + +msgid "" +"Returns ``(system, release, version)`` aliased to common marketing names " +"used for some systems. It also does some reordering of the information in " +"some cases where it would otherwise cause confusion." +msgstr "" + +msgid "" +"Returns the system's release version, e.g. ``'#3 on degas'``. An empty " +"string is returned if the value cannot be determined." +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`." +msgstr "" + +msgid "" +"Note that this adds a sixth attribute (:attr:`processor`) not present in " +"the :func:`os.uname` result. Also, the attribute names are different for " +"the first two attributes; :func:`os.uname` names them :attr:`sysname` and :" +"attr:`nodename`." +msgstr "" + +msgid "Entries which cannot be determined are set to ``''``." +msgstr "" + +msgid "Result changed from a tuple to a :func:`~collections.namedtuple`." +msgstr "" + +msgid "Java Platform" +msgstr "" + +msgid "Version interface for Jython." +msgstr "" + +msgid "" +"Returns a tuple ``(release, vendor, vminfo, osinfo)`` with *vminfo* being a " +"tuple ``(vm_name, vm_release, vm_vendor)`` and *osinfo* being a tuple " +"``(os_name, os_version, os_arch)``. Values which cannot be determined are " +"set to the defaults given as parameters (which all default to ``''``)." +msgstr "" + +msgid "Windows Platform" +msgstr "" + +msgid "" +"Get additional version information from the Windows Registry and return a " +"tuple ``(release, version, csd, ptype)`` referring to OS release, version " +"number, CSD level (service pack) and OS type (multi/single processor). " +"Values which cannot be determined are set to the defaults given as " +"parameters (which all default to an empty string)." +msgstr "" + +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." +msgstr "" + +msgid "" +"Returns a string representing the current Windows edition, or ``None`` if " +"the value cannot be determined. Possible values include but are not limited " +"to ``'Enterprise'``, ``'IoTUAP'``, ``'ServerStandard'``, and " +"``'nanoserver'``." +msgstr "" + +msgid "" +"Return ``True`` if the Windows edition returned by :func:`win32_edition` is " +"recognized as an IoT edition." +msgstr "" + +msgid "macOS Platform" +msgstr "" + +msgid "" +"Get macOS version information and return it as tuple ``(release, " +"versioninfo, machine)`` with *versioninfo* being a tuple ``(version, " +"dev_stage, non_release_version)``." +msgstr "" + +msgid "" +"Entries which cannot be determined are set to ``''``. All tuple entries are " +"strings." +msgstr "" + +msgid "Unix Platforms" +msgstr "" + +msgid "" +"Tries to determine the libc version against which the file executable " +"(defaults to the Python interpreter) is linked. Returns a tuple of strings " +"``(lib, version)`` which default to the given parameters in case the lookup " +"fails." +msgstr "" + +msgid "" +"Note that this function has intimate knowledge of how different libc " +"versions add symbols to the executable is probably only usable for " +"executables compiled using :program:`gcc`." +msgstr "" + +msgid "The file is read and scanned in chunks of *chunksize* bytes." +msgstr "" + +msgid "Linux Platforms" +msgstr "" + +msgid "" +"Get operating system identification from ``os-release`` file and return it " +"as a dict. The ``os-release`` file is a `freedesktop.org standard `_ and is available " +"in most Linux distributions. A noticeable exception is Android and Android-" +"based distributions." +msgstr "" + +msgid "" +"Raises :exc:`OSError` or subclass when neither ``/etc/os-release`` nor ``/" +"usr/lib/os-release`` can be read." +msgstr "" + +msgid "" +"On success, the function returns a dictionary where keys and values are " +"strings. Values have their special characters like ``\"`` and ``$`` " +"unquoted. The fields ``NAME``, ``ID``, and ``PRETTY_NAME`` are always " +"defined according to the standard. All other fields are optional. Vendors " +"may include additional fields." +msgstr "" + +msgid "" +"Note that fields like ``NAME``, ``VERSION``, and ``VARIANT`` are strings " +"suitable for presentation to users. Programs should use fields like ``ID``, " +"``ID_LIKE``, ``VERSION_ID``, or ``VARIANT_ID`` to identify Linux " +"distributions." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" diff --git a/library/plistlib.po b/library/plistlib.po index 094af78c8f..547fd45574 100644 --- a/library/plistlib.po +++ b/library/plistlib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -194,7 +194,7 @@ msgid "plist" msgstr "" msgid "file" -msgstr "" +msgstr "plik" msgid "property list" msgstr "" diff --git a/library/posix.po b/library/posix.po index 653433d485..0af1a4057b 100644 --- a/library/posix.po +++ b/library/posix.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -32,6 +32,9 @@ msgid "" "Unix interface)." msgstr "" +msgid ":ref:`Availability `: Unix." +msgstr "" + msgid "" "**Do not import this module directly.** Instead, import the module :mod:" "`os`, which provides a *portable* version of this interface. On Unix, the :" @@ -115,4 +118,4 @@ msgid "large files" msgstr "" msgid "file" -msgstr "" +msgstr "plik" diff --git a/library/pprint.po b/library/pprint.po new file mode 100644 index 0000000000..1c47e2e78f --- /dev/null +++ b/library/pprint.po @@ -0,0 +1,268 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`pprint` --- Data pretty printer" +msgstr "" + +msgid "**Source code:** :source:`Lib/pprint.py`" +msgstr "" + +msgid "" +"The :mod:`pprint` module provides a capability to \"pretty-print\" arbitrary " +"Python data structures in a form which can be used as input to the " +"interpreter. If the formatted structures include objects which are not " +"fundamental Python types, the representation may not be loadable. This may " +"be the case if objects such as files, sockets or classes are included, as " +"well as many other objects which are not representable as Python literals." +msgstr "" + +msgid "" +"The formatted representation keeps objects on a single line if it can, and " +"breaks them onto multiple lines if they don't fit within the allowed width. " +"Construct :class:`PrettyPrinter` objects explicitly if you need to adjust " +"the width constraint." +msgstr "" + +msgid "Dictionaries are sorted by key before the display is computed." +msgstr "" + +msgid "Added support for pretty-printing :class:`types.SimpleNamespace`." +msgstr "" + +msgid "Added support for pretty-printing :class:`dataclasses.dataclass`." +msgstr "" + +msgid "Functions" +msgstr "Zadania" + +msgid "" +"Prints the formatted representation of *object* followed by a newline. If " +"*sort_dicts* is false (the default), dictionaries will be displayed with " +"their keys in insertion order, otherwise the dict keys will be sorted. " +"*args* and *kwargs* will be passed to :func:`~pprint.pprint` as formatting " +"parameters." +msgstr "" + +msgid "" +"Prints the formatted representation of *object* on *stream*, followed by a " +"newline. If *stream* is ``None``, :data:`sys.stdout` is used. This may be " +"used in the interactive interpreter instead of the :func:`print` function " +"for inspecting values (you can even reassign ``print = pprint.pprint`` for " +"use within a scope)." +msgstr "" + +msgid "" +"The configuration parameters *stream*, *indent*, *width*, *depth*, " +"*compact*, *sort_dicts* and *underscore_numbers* are passed to the :class:" +"`PrettyPrinter` constructor and their meanings are as described in its " +"documentation below." +msgstr "" + +msgid "" +"Note that *sort_dicts* is ``True`` by default and you might want to use :" +"func:`~pprint.pp` instead where it is ``False`` by default." +msgstr "" + +msgid "" +"Return the formatted representation of *object* as a string. *indent*, " +"*width*, *depth*, *compact*, *sort_dicts* and *underscore_numbers* are " +"passed to the :class:`PrettyPrinter` constructor as formatting parameters " +"and their meanings are as described in its documentation below." +msgstr "" + +msgid "" +"Determine if the formatted representation of *object* is \"readable\", or " +"can be used to reconstruct the value using :func:`eval`. This always " +"returns ``False`` for recursive objects." +msgstr "" + +msgid "Determine if *object* requires a recursive representation." +msgstr "" + +msgid "" +"Return a string representation of *object*, protected against recursive data " +"structures. 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" +msgstr "" + +msgid "This module defines one class:" +msgstr "" + +msgid "" +"Construct a :class:`PrettyPrinter` instance. This constructor understands " +"several keyword parameters." +msgstr "" + +msgid "" +"*stream* (default :data:`!sys.stdout`) is a :term:`file-like object` to " +"which the output will be written by calling its :meth:`!write` method. If " +"both *stream* and :data:`!sys.stdout` are ``None``, then :meth:" +"`~PrettyPrinter.pprint` silently returns." +msgstr "" + +msgid "" +"Other values configure the manner in which nesting of complex data " +"structures is displayed." +msgstr "" + +msgid "" +"*indent* (default 1) specifies the amount of indentation added for each " +"nesting level." +msgstr "" + +msgid "" +"*depth* controls the number of nesting levels which may be printed; if the " +"data structure being printed is too deep, the next contained level is " +"replaced by ``...``. By default, there is no constraint on the depth of the " +"objects being formatted." +msgstr "" + +msgid "" +"*width* (default 80) specifies the desired maximum number of characters per " +"line in the output. If a structure cannot be formatted within the width " +"constraint, a best effort will be made." +msgstr "" + +msgid "" +"*compact* impacts the way that long sequences (lists, tuples, sets, etc) are " +"formatted. If *compact* is false (the default) then each item of a sequence " +"will be formatted on a separate line. If *compact* is true, as many items " +"as will fit within the *width* will be formatted on each output line." +msgstr "" + +msgid "" +"If *sort_dicts* is true (the default), dictionaries will be formatted with " +"their keys sorted, otherwise they will display in insertion order." +msgstr "" + +msgid "" +"If *underscore_numbers* is true, integers will be formatted with the ``_`` " +"character for a thousands separator, otherwise underscores are not displayed " +"(the default)." +msgstr "" + +msgid "Added the *compact* parameter." +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 "" + +msgid "" +"Return the formatted representation of *object*. This takes into account " +"the options passed to the :class:`PrettyPrinter` constructor." +msgstr "" + +msgid "" +"Print the formatted representation of *object* on the configured stream, " +"followed by a newline." +msgstr "" + +msgid "" +"The following methods provide the implementations for the corresponding " +"functions of the same names. Using these methods on an instance is slightly " +"more efficient since new :class:`PrettyPrinter` objects don't need to be " +"created." +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``." +msgstr "" + +msgid "Determine if the object requires a recursive representation." +msgstr "" + +msgid "" +"This method is provided as a hook to allow subclasses to modify the way " +"objects are converted to strings. The default implementation uses the " +"internals of the :func:`saferepr` implementation." +msgstr "" + +msgid "" +"Returns three values: the formatted version of *object* as a string, a flag " +"indicating whether the result is readable, and a flag indicating whether " +"recursion was detected. The first argument is the object to be presented. " +"The second is a dictionary which contains the :func:`id` of objects that are " +"part of the current presentation context (direct and indirect containers for " +"*object* that are affecting the presentation) as the keys; if an object " +"needs to be presented which is already represented in *context*, the third " +"return value should be ``True``. Recursive calls to the :meth:`.format` " +"method should add additional entries for containers to this dictionary. The " +"third argument, *maxlevels*, gives the requested limit to recursion; this " +"will be ``0`` if there is no requested limit. This argument should be " +"passed unmodified to recursive calls. The fourth argument, *level*, gives " +"the current level; recursive calls should be passed a value less than that " +"of the current call." +msgstr "" + +msgid "Example" +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 `_::" +msgstr "" + +msgid "In its basic form, :func:`~pprint.pp` shows the whole object::" +msgstr "" + +msgid "" +"The result can be limited to a certain *depth* (ellipsis is used for deeper " +"contents)::" +msgstr "" + +msgid "" +"Additionally, maximum character *width* can be suggested. If a long object " +"cannot be split, the specified width will be exceeded::" +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "eval" +msgstr "" + +msgid "..." +msgstr "..." + +msgid "placeholder" +msgstr "" diff --git a/library/profile.po b/library/profile.po new file mode 100644 index 0000000000..183687c7c2 --- /dev/null +++ b/library/profile.po @@ -0,0 +1,817 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "The Python Profilers" +msgstr "" + +msgid "**Source code:** :source:`Lib/profile.py` and :source:`Lib/pstats.py`" +msgstr "" + +msgid "Introduction to the profilers" +msgstr "" + +msgid "" +":mod:`cProfile` and :mod:`profile` provide :dfn:`deterministic profiling` of " +"Python programs. A :dfn:`profile` is a set of statistics that describes how " +"often and for how long various parts of the program executed. These " +"statistics can be formatted into reports via the :mod:`pstats` module." +msgstr "" + +msgid "" +"The Python standard library provides two different implementations of the " +"same profiling interface:" +msgstr "" + +msgid "" +":mod:`cProfile` is recommended for most users; it's a C extension with " +"reasonable overhead that makes it suitable for profiling long-running " +"programs. Based on :mod:`lsprof`, contributed by Brett Rosen and Ted " +"Czotter." +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." +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." +msgstr "" + +msgid "Instant User's Manual" +msgstr "" + +msgid "" +"This section is provided for users that \"don't want to read the manual.\" " +"It provides a very brief overview, and allows a user to rapidly perform " +"profiling on an existing application." +msgstr "" + +msgid "To profile a function that takes a single argument, you can do::" +msgstr "" + +msgid "" +"(Use :mod:`profile` instead of :mod:`cProfile` if the latter is not " +"available on your system.)" +msgstr "" + +msgid "" +"The above action would run :func:`re.compile` and print profile results like " +"the following::" +msgstr "" + +msgid "" +"The first line indicates that 214 calls were monitored. Of those calls, 207 " +"were :dfn:`primitive`, meaning that the call was not induced via recursion. " +"The next line: ``Ordered by: cumulative time`` indicates the output is " +"sorted by the ``cumtime`` values. The column headings include:" +msgstr "" + +msgid "ncalls" +msgstr "" + +msgid "for the number of calls." +msgstr "" + +msgid "tottime" +msgstr "" + +msgid "" +"for the total time spent in the given function (and excluding time made in " +"calls to sub-functions)" +msgstr "" + +msgid "percall" +msgstr "" + +msgid "is the quotient of ``tottime`` divided by ``ncalls``" +msgstr "" + +msgid "cumtime" +msgstr "" + +msgid "" +"is the cumulative time spent in this and all subfunctions (from invocation " +"till exit). This figure is accurate *even* for recursive functions." +msgstr "" + +msgid "is the quotient of ``cumtime`` divided by primitive calls" +msgstr "" + +msgid "filename:lineno(function)" +msgstr "filename:lineno(function)" + +msgid "provides the respective data of each function" +msgstr "" + +msgid "" +"When there are two numbers in the first column (for example ``3/1``), it " +"means that the function recursed. The second value is the number of " +"primitive calls and the former is the total number of calls. Note that when " +"the function does not recurse, these two values are the same, and only the " +"single figure is printed." +msgstr "" + +msgid "" +"Instead of printing the output at the end of the profile run, you can save " +"the results to a file by specifying a filename to the :func:`run` function::" +msgstr "" + +msgid "" +"The :class:`pstats.Stats` class reads profile results from a file and " +"formats them in various ways." +msgstr "" + +msgid "" +"The files :mod:`cProfile` and :mod:`profile` can also be invoked as a script " +"to profile another script. For example::" +msgstr "" + +msgid "``-o`` writes the profile results to a file instead of to stdout" +msgstr "" + +msgid "" +"``-s`` specifies one of the :func:`~pstats.Stats.sort_stats` sort values to " +"sort the output by. This only applies when ``-o`` is not supplied." +msgstr "" + +msgid "``-m`` specifies that a module is being profiled instead of a script." +msgstr "" + +msgid "Added the ``-m`` option to :mod:`cProfile`." +msgstr "" + +msgid "Added the ``-m`` option to :mod:`profile`." +msgstr "" + +msgid "" +"The :mod:`pstats` module's :class:`~pstats.Stats` class has a variety of " +"methods for manipulating and printing the data saved into a profile results " +"file::" +msgstr "" + +msgid "" +"The :meth:`~pstats.Stats.strip_dirs` method removed the extraneous path from " +"all the module names. The :meth:`~pstats.Stats.sort_stats` method sorted all " +"the entries according to the standard module/line/name string that is " +"printed. The :meth:`~pstats.Stats.print_stats` method printed out all the " +"statistics. You might try the following sort calls::" +msgstr "" + +msgid "" +"The first call will actually sort the list by function name, and the second " +"call will print out the statistics. The following are some interesting " +"calls to experiment with::" +msgstr "" + +msgid "" +"This sorts the profile by cumulative time in a function, and then only " +"prints the ten most significant lines. If you want to understand what " +"algorithms are taking time, the above line is what you would use." +msgstr "" + +msgid "" +"If you were looking to see what functions were looping a lot, and taking a " +"lot of time, you would do::" +msgstr "" + +msgid "" +"to sort according to time spent within each function, and then print the " +"statistics for the top ten functions." +msgstr "" + +msgid "You might also try::" +msgstr "" + +msgid "" +"This will sort all the statistics by file name, and then print out " +"statistics for only the class init methods (since they are spelled with " +"``__init__`` in them). As one final example, you could try::" +msgstr "" + +msgid "" +"This line sorts statistics with a primary key of time, and a secondary key " +"of cumulative time, and then prints out some of the statistics. To be " +"specific, the list is first culled down to 50% (re: ``.5``) of its original " +"size, then only lines containing ``init`` are maintained, and that sub-sub-" +"list is printed." +msgstr "" + +msgid "" +"If you wondered what functions called the above functions, you could now " +"(``p`` is still sorted according to the last criteria) do::" +msgstr "" + +msgid "and you would get a list of callers for each of the listed functions." +msgstr "" + +msgid "" +"If you want more functionality, you're going to have to read the manual, or " +"guess what the following functions do::" +msgstr "" + +msgid "" +"Invoked as a script, the :mod:`pstats` module is a statistics browser for " +"reading and examining profile dumps. It has a simple line-oriented " +"interface (implemented using :mod:`cmd`) and interactive help." +msgstr "" + +msgid ":mod:`profile` and :mod:`cProfile` Module Reference" +msgstr "" + +msgid "" +"Both the :mod:`profile` and :mod:`cProfile` modules provide the following " +"functions:" +msgstr "" + +msgid "" +"This function takes a single argument that can be passed to the :func:`exec` " +"function, and an optional file name. In all cases this routine executes::" +msgstr "" + +msgid "" +"and gathers profiling statistics from the execution. If no file name is " +"present, then this function automatically creates a :class:`~pstats.Stats` " +"instance and prints a simple profiling report. If the sort value is " +"specified, it is passed to this :class:`~pstats.Stats` instance to control " +"how the results are sorted." +msgstr "" + +msgid "" +"This function is similar to :func:`run`, with added arguments to supply the " +"globals and locals dictionaries for the *command* string. This routine " +"executes::" +msgstr "" + +msgid "and gathers profiling statistics as in the :func:`run` function above." +msgstr "" + +msgid "" +"This class is normally only used if more precise control over profiling is " +"needed than what the :func:`cProfile.run` function provides." +msgstr "" + +msgid "" +"A custom timer can be supplied for measuring how long code takes to run via " +"the *timer* argument. This must be a function that returns a single number " +"representing the current time. If the number is an integer, the *timeunit* " +"specifies a multiplier that specifies the duration of each unit of time. For " +"example, if the timer returns times measured in thousands of seconds, the " +"time unit would be ``.001``." +msgstr "" + +msgid "" +"Directly using the :class:`Profile` class allows formatting profile results " +"without writing the profile data to a file::" +msgstr "" + +msgid "" +"The :class:`Profile` class can also be used as a context manager (supported " +"only in :mod:`cProfile` module. see :ref:`typecontextmanager`)::" +msgstr "" + +msgid "Added context manager support." +msgstr "" + +msgid "Start collecting profiling data. Only in :mod:`cProfile`." +msgstr "" + +msgid "Stop collecting profiling data. Only in :mod:`cProfile`." +msgstr "" + +msgid "" +"Stop collecting profiling data and record the results internally as the " +"current profile." +msgstr "" + +msgid "" +"Create a :class:`~pstats.Stats` object based on the current profile and " +"print the results to stdout." +msgstr "" + +msgid "Write the results of the current profile to *filename*." +msgstr "" + +msgid "Profile the cmd via :func:`exec`." +msgstr "" + +msgid "" +"Profile the cmd via :func:`exec` with the specified global and local " +"environment." +msgstr "" + +msgid "Profile ``func(*args, **kwargs)``" +msgstr "" + +msgid "" +"Note that profiling will only work if the called command/function actually " +"returns. If the interpreter is terminated (e.g. via a :func:`sys.exit` call " +"during the called command/function execution) no profiling results will be " +"printed." +msgstr "" + +msgid "The :class:`Stats` Class" +msgstr "" + +msgid "" +"Analysis of the profiler data is done using the :class:`~pstats.Stats` class." +msgstr "" + +msgid "" +"This class constructor creates an instance of a \"statistics object\" from a " +"*filename* (or list of filenames) or from a :class:`Profile` instance. " +"Output will be printed to the stream specified by *stream*." +msgstr "" + +msgid "" +"The file selected by the above constructor must have been created by the " +"corresponding version of :mod:`profile` or :mod:`cProfile`. To be specific, " +"there is *no* file compatibility guaranteed with future versions of this " +"profiler, and there is no compatibility with files produced by other " +"profilers, or the same profiler run on a different operating system. If " +"several files are provided, all the statistics for identical functions will " +"be coalesced, so that an overall view of several processes can be considered " +"in a single report. If additional files need to be combined with data in an " +"existing :class:`~pstats.Stats` object, the :meth:`~pstats.Stats.add` method " +"can be used." +msgstr "" + +msgid "" +"Instead of reading the profile data from a file, a :class:`cProfile.Profile` " +"or :class:`profile.Profile` object can be used as the profile data source." +msgstr "" + +msgid ":class:`Stats` objects have the following methods:" +msgstr "" + +msgid "" +"This method for the :class:`Stats` class removes all leading path " +"information from file names. It is very useful in reducing the size of the " +"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." +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." +msgstr "" + +msgid "" +"Save the data loaded into the :class:`Stats` object to a file named " +"*filename*. The file is created if it does not exist, and is overwritten if " +"it already exists. This is equivalent to the method of the same name on " +"the :class:`profile.Profile` and :class:`cProfile.Profile` classes." +msgstr "" + +msgid "" +"This method modifies the :class:`Stats` object by sorting it according to " +"the supplied criteria. The argument can be either a string or a SortKey " +"enum identifying the basis of a sort (example: ``'time'``, ``'name'``, " +"``SortKey.TIME`` or ``SortKey.NAME``). The SortKey enums argument have " +"advantage over the string argument in that it is more robust and less error " +"prone." +msgstr "" + +msgid "" +"When more than one key is provided, then additional keys are used as " +"secondary criteria when there is equality in all keys selected before them. " +"For example, ``sort_stats(SortKey.NAME, SortKey.FILE)`` will sort all the " +"entries according to their function name, and resolve all ties (identical " +"function names) by sorting by file name." +msgstr "" + +msgid "" +"For the string argument, abbreviations can be used for any key names, as " +"long as the abbreviation is unambiguous." +msgstr "" + +msgid "The following are the valid string and SortKey:" +msgstr "" + +msgid "Valid String Arg" +msgstr "" + +msgid "Valid enum Arg" +msgstr "" + +msgid "Meaning" +msgstr "Znaczenie" + +msgid "``'calls'``" +msgstr "" + +msgid "SortKey.CALLS" +msgstr "" + +msgid "call count" +msgstr "" + +msgid "``'cumulative'``" +msgstr "" + +msgid "SortKey.CUMULATIVE" +msgstr "" + +msgid "cumulative time" +msgstr "" + +msgid "``'cumtime'``" +msgstr "" + +msgid "N/A" +msgstr "" + +msgid "``'file'``" +msgstr "" + +msgid "file name" +msgstr "" + +msgid "``'filename'``" +msgstr "" + +msgid "SortKey.FILENAME" +msgstr "" + +msgid "``'module'``" +msgstr "" + +msgid "``'ncalls'``" +msgstr "" + +msgid "``'pcalls'``" +msgstr "" + +msgid "SortKey.PCALLS" +msgstr "" + +msgid "primitive call count" +msgstr "" + +msgid "``'line'``" +msgstr "" + +msgid "SortKey.LINE" +msgstr "" + +msgid "line number" +msgstr "" + +msgid "``'name'``" +msgstr "" + +msgid "SortKey.NAME" +msgstr "" + +msgid "function name" +msgstr "" + +msgid "``'nfl'``" +msgstr "" + +msgid "SortKey.NFL" +msgstr "" + +msgid "name/file/line" +msgstr "" + +msgid "``'stdname'``" +msgstr "" + +msgid "SortKey.STDNAME" +msgstr "" + +msgid "standard name" +msgstr "" + +msgid "``'time'``" +msgstr "" + +msgid "SortKey.TIME" +msgstr "" + +msgid "internal time" +msgstr "" + +msgid "``'tottime'``" +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, " +"``sort_stats(SortKey.NFL)`` is the same as ``sort_stats(SortKey.NAME, " +"SortKey.FILENAME, SortKey.LINE)``." +msgstr "" + +msgid "" +"For backward-compatibility reasons, the numeric arguments ``-1``, ``0``, " +"``1``, and ``2`` are permitted. They are interpreted as ``'stdname'``, " +"``'calls'``, ``'time'``, and ``'cumulative'`` respectively. If this old " +"style format (numeric) is used, only one sort key (the numeric key) will be " +"used, and additional arguments will be silently ignored." +msgstr "" + +msgid "Added the SortKey enum." +msgstr "" + +msgid "" +"This method for the :class:`Stats` class reverses the ordering of the basic " +"list within the object. Note that by default ascending vs descending order " +"is properly selected based on the sort key of choice." +msgstr "" + +msgid "" +"This method for the :class:`Stats` class prints out a report as described in " +"the :func:`profile.run` definition." +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`)." +msgstr "" + +msgid "" +"The arguments provided (if any) can be used to limit the list down to the " +"significant entries. Initially, the list is taken to be the complete set of " +"profiled functions. Each restriction is either an integer (to select a " +"count of lines), or a decimal fraction between 0.0 and 1.0 inclusive (to " +"select a percentage of lines), or a string that will interpreted as a " +"regular expression (to pattern match the standard name that is printed). If " +"several restrictions are provided, then they are applied sequentially. For " +"example::" +msgstr "" + +msgid "" +"would first limit the printing to first 10% of list, and then only print " +"functions that were part of filename :file:`.\\*foo:`. In contrast, the " +"command::" +msgstr "" + +msgid "" +"would limit the list to all functions having file names :file:`.\\*foo:`, " +"and then proceed to only print the first 10% of them." +msgstr "" + +msgid "" +"This method for the :class:`Stats` class prints a list of all functions that " +"called each function in the profiled database. The ordering is identical to " +"that provided by :meth:`~pstats.Stats.print_stats`, and the definition of " +"the restricting argument is also identical. Each caller is reported on its " +"own line. The format differs slightly depending on the profiler that " +"produced the stats:" +msgstr "" + +msgid "" +"With :mod:`profile`, a number is shown in parentheses after each caller to " +"show how many times this specific call was made. For convenience, a second " +"non-parenthesized number repeats the cumulative time spent in the function " +"at the right." +msgstr "" + +msgid "" +"With :mod:`cProfile`, each caller is preceded by three numbers: the number " +"of times this specific call was made, and the total and cumulative times " +"spent in the current function while it was invoked by this specific caller." +msgstr "" + +msgid "" +"This method for the :class:`Stats` class prints a list of all function that " +"were called by the indicated function. Aside from this reversal of " +"direction of calls (re: called vs was called by), the arguments and ordering " +"are identical to the :meth:`~pstats.Stats.print_callers` method." +msgstr "" + +msgid "" +"This method returns an instance of StatsProfile, which contains a mapping of " +"function names to instances of FunctionProfile. Each FunctionProfile " +"instance holds information related to the function's profile such as how " +"long the function took to run, how many times it was called, etc..." +msgstr "" + +msgid "" +"Added the following dataclasses: StatsProfile, FunctionProfile. Added the " +"following function: get_stats_profile." +msgstr "" + +msgid "What Is Deterministic Profiling?" +msgstr "" + +msgid "" +":dfn:`Deterministic profiling` is meant to reflect the fact that all " +"*function call*, *function return*, and *exception* events are monitored, " +"and precise timings are made for the intervals between these events (during " +"which time the user's code is executing). In contrast, :dfn:`statistical " +"profiling` (which is not done by this module) randomly samples the effective " +"instruction pointer, and deduces where time is being spent. The latter " +"technique traditionally involves less overhead (as the code does not need to " +"be instrumented), but provides only relative indications of where time is " +"being spent." +msgstr "" + +msgid "" +"In Python, since there is an interpreter active during execution, the " +"presence of instrumented code is not required in order to do deterministic " +"profiling. Python automatically provides a :dfn:`hook` (optional callback) " +"for each event. In addition, the interpreted nature of Python tends to add " +"so much overhead to execution, that deterministic profiling tends to only " +"add small processing overhead in typical applications. The result is that " +"deterministic profiling is not that expensive, yet provides extensive run " +"time statistics about the execution of a Python program." +msgstr "" + +msgid "" +"Call count statistics can be used to identify bugs in code (surprising " +"counts), and to identify possible inline-expansion points (high call " +"counts). Internal time statistics can be used to identify \"hot loops\" " +"that should be carefully optimized. Cumulative time statistics should be " +"used to identify high level errors in the selection of algorithms. Note " +"that the unusual handling of cumulative times in this profiler allows " +"statistics for recursive implementations of algorithms to be directly " +"compared to iterative implementations." +msgstr "" + +msgid "Limitations" +msgstr "" + +msgid "" +"One limitation has to do with accuracy of timing information. There is a " +"fundamental problem with deterministic profilers involving accuracy. The " +"most obvious restriction is that the underlying \"clock\" is only ticking at " +"a rate (typically) of about .001 seconds. Hence no measurements will be " +"more accurate than the underlying clock. If enough measurements are taken, " +"then the \"error\" will tend to average out. Unfortunately, removing this " +"first error induces a second source of error." +msgstr "" + +msgid "" +"The second problem is that it \"takes a while\" from when an event is " +"dispatched until the profiler's call to get the time actually *gets* the " +"state of the clock. Similarly, there is a certain lag when exiting the " +"profiler event handler from the time that the clock's value was obtained " +"(and then squirreled away), until the user's code is once again executing. " +"As a result, functions that are called many times, or call many functions, " +"will typically accumulate this error. The error that accumulates in this " +"fashion is typically less than the accuracy of the clock (less than one " +"clock tick), but it *can* accumulate and become very significant." +msgstr "" + +msgid "" +"The problem is more important with :mod:`profile` than with the lower-" +"overhead :mod:`cProfile`. For this reason, :mod:`profile` provides a means " +"of calibrating itself for a given platform so that this error can be " +"probabilistically (on the average) removed. After the profiler is " +"calibrated, it will be more accurate (in a least square sense), but it will " +"sometimes produce negative numbers (when call counts are exceptionally low, " +"and the gods of probability work against you :-). ) Do *not* be alarmed by " +"negative numbers in the profile. They should *only* appear if you have " +"calibrated your profiler, and the results are actually better than without " +"calibration." +msgstr "" + +msgid "Calibration" +msgstr "" + +msgid "" +"The profiler of the :mod:`profile` module subtracts a constant from each " +"event handling time to compensate for the overhead of calling the time " +"function, and socking away the results. By default, the constant is 0. The " +"following procedure can be used to obtain a better constant for a given " +"platform (see :ref:`profile-limitations`). ::" +msgstr "" + +msgid "" +"The method executes the number of Python calls given by the argument, " +"directly and again under the profiler, measuring the time for both. It then " +"computes the hidden overhead per profiler event, and returns that as a " +"float. For example, on a 1.8Ghz Intel Core i5 running macOS, and using " +"Python's time.process_time() as the timer, the magical number is about " +"4.04e-6." +msgstr "" + +msgid "" +"The object of this exercise is to get a fairly consistent result. If your " +"computer is *very* fast, or your timer function has poor resolution, you " +"might have to pass 100000, or even 1000000, to get consistent results." +msgstr "" + +msgid "" +"When you have a consistent answer, there are three ways you can use it::" +msgstr "" + +msgid "" +"If you have a choice, you are better off choosing a smaller constant, and " +"then your results will \"less often\" show up as negative in profile " +"statistics." +msgstr "" + +msgid "Using a custom timer" +msgstr "" + +msgid "" +"If you want to change how current time is determined (for example, to force " +"use of wall-clock time or elapsed process time), pass the timing function " +"you want to the :class:`Profile` class constructor::" +msgstr "" + +msgid "" +"The resulting profiler will then call ``your_time_func``. Depending on " +"whether you are using :class:`profile.Profile` or :class:`cProfile.Profile`, " +"``your_time_func``'s return value will be interpreted differently:" +msgstr "" + +msgid ":class:`profile.Profile`" +msgstr ":class:`profile.Profile`" + +msgid "" +"``your_time_func`` should return a single number, or a list of numbers whose " +"sum is the current time (like what :func:`os.times` returns). If the " +"function returns a single time number, or the list of returned numbers has " +"length 2, then you will get an especially fast version of the dispatch " +"routine." +msgstr "" + +msgid "" +"Be warned that you should calibrate the profiler class for the timer " +"function that you choose (see :ref:`profile-calibration`). For most " +"machines, a timer that returns a lone integer value will provide the best " +"results in terms of low overhead during profiling. (:func:`os.times` is " +"*pretty* bad, as it returns a tuple of floating point values). If you want " +"to substitute a better timer in the cleanest fashion, derive a class and " +"hardwire a replacement dispatch method that best handles your timer call, " +"along with the appropriate calibration constant." +msgstr "" + +msgid ":class:`cProfile.Profile`" +msgstr ":class:`cProfile.Profile`" + +msgid "" +"``your_time_func`` should return a single number. If it returns integers, " +"you can also invoke the class constructor with a second argument specifying " +"the real duration of one unit of time. For example, if " +"``your_integer_time_func`` returns times measured in thousands of seconds, " +"you would construct the :class:`Profile` instance as follows::" +msgstr "" + +msgid "" +"As the :class:`cProfile.Profile` class cannot be calibrated, custom timer " +"functions should be used with care and should be as fast as possible. For " +"the best results with a custom timer, it might be necessary to hard-code it " +"in the C source of the internal :mod:`_lsprof` module." +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`." +msgstr "" + +msgid "deterministic profiling" +msgstr "" + +msgid "profiling, deterministic" +msgstr "" diff --git a/library/pty.po b/library/pty.po new file mode 100644 index 0000000000..ce8122f5ea --- /dev/null +++ b/library/pty.po @@ -0,0 +1,133 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`pty` --- Pseudo-terminal utilities" +msgstr "" + +msgid "**Source code:** :source:`Lib/pty.py`" +msgstr "" + +msgid "" +"The :mod:`pty` module defines operations for handling the pseudo-terminal " +"concept: starting another process and being able to write to and read from " +"its controlling terminal programmatically." +msgstr "" + +msgid ":ref:`Availability `: Unix." +msgstr "" + +msgid "" +"Pseudo-terminal handling is highly platform dependent. This code is mainly " +"tested on Linux, FreeBSD, and macOS (it is supposed to work on other POSIX " +"platforms but it's not been thoroughly tested)." +msgstr "" + +msgid "The :mod:`pty` module defines the following functions:" +msgstr "" + +msgid "" +"Fork. Connect the child's controlling terminal to a pseudo-terminal. Return " +"value is ``(pid, fd)``. Note that the child gets *pid* 0, and the *fd* is " +"*invalid*. The parent's return value is the *pid* of the child, and *fd* is " +"a file descriptor connected to the child's controlling terminal (and also to " +"the child's standard input and output)." +msgstr "" + +msgid "" +"On macOS the use of this function is unsafe when mixed with using higher-" +"level system APIs, and that includes using :mod:`urllib.request`." +msgstr "" + +msgid "" +"Open a new pseudo-terminal pair, using :func:`os.openpty` if possible, or " +"emulation code for generic Unix systems. Return a pair of file descriptors " +"``(master, slave)``, for the master and the slave end, respectively." +msgstr "" + +msgid "" +"Spawn a process, and connect its controlling terminal with the current " +"process's standard io. This is often used to baffle programs which insist on " +"reading from the controlling terminal. It is expected that the process " +"spawned behind the pty will eventually terminate, and when it does *spawn* " +"will return." +msgstr "" + +msgid "" +"A loop copies STDIN of the current process to the child and data received " +"from the child to STDOUT of the current process. It is not signaled to the " +"child if STDIN of the current process closes down." +msgstr "" + +msgid "" +"The functions *master_read* and *stdin_read* are passed a file descriptor " +"which they should read from, and they should always return a byte string. In " +"order to force spawn to return before the child process exits an empty byte " +"array should be returned to signal end of file." +msgstr "" + +msgid "" +"The default implementation for both functions will read and return up to " +"1024 bytes each time the function is called. The *master_read* callback is " +"passed the pseudoterminal’s master file descriptor to read output from the " +"child process, and *stdin_read* is passed file descriptor 0, to read from " +"the parent process's standard input." +msgstr "" + +msgid "" +"Returning an empty byte string from either callback is interpreted as an end-" +"of-file (EOF) condition, and that callback will not be called after that. If " +"*stdin_read* signals EOF the controlling terminal can no longer communicate " +"with the parent process OR the child process. Unless the child process will " +"quit without any input, *spawn* will then loop forever. If *master_read* " +"signals EOF the same behavior results (on linux at least)." +msgstr "" + +msgid "" +"Return the exit status value from :func:`os.waitpid` on the child process." +msgstr "" + +msgid "" +":func:`os.waitstatus_to_exitcode` can be used to convert the exit status " +"into an exit code." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``pty.spawn`` with argument " +"``argv``." +msgstr "" + +msgid "" +":func:`spawn` now returns the status value from :func:`os.waitpid` on the " +"child process." +msgstr "" + +msgid "Example" +msgstr "Przykład" + +msgid "" +"The following program acts like the Unix command :manpage:`script(1)`, using " +"a pseudo-terminal to record all input and output of a terminal session in a " +"\"typescript\". ::" +msgstr "" diff --git a/library/pwd.po b/library/pwd.po index 91822fafc6..906070f9a1 100644 --- a/library/pwd.po +++ b/library/pwd.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,13 +32,7 @@ msgid "" "It is available on all Unix versions." msgstr "" -msgid ":ref:`Availability `: not Emscripten, not WASI." -msgstr "" - -msgid "" -"This module does not work or is not available on WebAssembly platforms " -"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " -"more information." +msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." msgstr "" msgid "" @@ -50,7 +45,7 @@ msgid "Index" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Meaning" msgstr "Znaczenie" @@ -59,7 +54,7 @@ msgid "0" msgstr "0" msgid "``pw_name``" -msgstr "" +msgstr "``pw_name``" msgid "Login name" msgstr "" @@ -68,7 +63,7 @@ msgid "1" msgstr "1" msgid "``pw_passwd``" -msgstr "" +msgstr "``pw_passwd``" msgid "Optional encrypted password" msgstr "" @@ -77,16 +72,16 @@ msgid "2" msgstr "2" msgid "``pw_uid``" -msgstr "" +msgstr "``pw_uid``" msgid "Numerical user ID" msgstr "" msgid "3" -msgstr "" +msgstr "3" msgid "``pw_gid``" -msgstr "" +msgstr "``pw_gid``" msgid "Numerical group ID" msgstr "" @@ -95,25 +90,25 @@ msgid "4" msgstr "4" msgid "``pw_gecos``" -msgstr "" +msgstr "``pw_gecos``" msgid "User name or comment field" msgstr "" msgid "5" -msgstr "" +msgstr "5" msgid "``pw_dir``" -msgstr "" +msgstr "``pw_dir``" msgid "User home directory" msgstr "" msgid "6" -msgstr "" +msgstr "6" msgid "``pw_shell``" -msgstr "" +msgstr "``pw_shell``" msgid "User command interpreter" msgstr "" diff --git a/library/py_compile.po b/library/py_compile.po new file mode 100644 index 0000000000..0195205e13 --- /dev/null +++ b/library/py_compile.po @@ -0,0 +1,191 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 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:`py_compile` --- Compile Python source files" +msgstr "" + +msgid "**Source code:** :source:`Lib/py_compile.py`" +msgstr "" + +msgid "" +"The :mod:`py_compile` module provides a function to generate a byte-code " +"file from a source file, and another function used when the module source " +"file is invoked as a script." +msgstr "" + +msgid "" +"Though not often needed, this function can be useful when installing modules " +"for shared use, especially if some of the users may not have permission to " +"write the byte-code cache files in the directory containing the source code." +msgstr "" + +msgid "" +"Exception raised when an error occurs while attempting to compile the file." +msgstr "" + +msgid "" +"Compile a source file to byte-code and write out the byte-code cache file. " +"The source code is loaded from the file named *file*. The byte-code is " +"written to *cfile*, which defaults to the :pep:`3147`/:pep:`488` path, " +"ending in ``.pyc``. For example, if *file* is ``/foo/bar/baz.py`` *cfile* " +"will default to ``/foo/bar/__pycache__/baz.cpython-32.pyc`` for Python 3.2. " +"If *dfile* is specified, it is used instead of *file* as the name of the " +"source file from which source lines are obtained for display in exception " +"tracebacks. If *doraise* is true, a :exc:`PyCompileError` is raised when an " +"error is encountered while compiling *file*. If *doraise* is false (the " +"default), an error string is written to ``sys.stderr``, but no exception is " +"raised. This function returns the path to byte-compiled file, i.e. whatever " +"*cfile* value was used." +msgstr "" + +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." +msgstr "" + +msgid "" +"If the path that *cfile* becomes (either explicitly specified or computed) " +"is a symlink or non-regular file, :exc:`FileExistsError` will be raised. " +"This is to act as a warning that import will turn those paths into regular " +"files if it is allowed to write byte-compiled files to those paths. This is " +"a side-effect of import using file renaming to place the final byte-compiled " +"file into place to prevent concurrent file writing issues." +msgstr "" + +msgid "" +"*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 " +"default is :attr:`PycInvalidationMode.TIMESTAMP`." +msgstr "" + +msgid "" +"Changed default value of *cfile* to be :PEP:`3147`-compliant. Previous " +"default was *file* + ``'c'`` (``'o'`` if optimization was enabled). Also " +"added the *optimize* parameter." +msgstr "" + +msgid "" +"Changed code to use :mod:`importlib` for the byte-code cache file writing. " +"This means file creation/writing semantics now match what :mod:`importlib` " +"does, e.g. permissions, write-and-move semantics, etc. Also added the caveat " +"that :exc:`FileExistsError` is raised if *cfile* is a symlink or non-regular " +"file." +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`." +msgstr "" + +msgid "" +"The :envvar:`SOURCE_DATE_EPOCH` environment variable no longer overrides the " +"value of the *invalidation_mode* argument, and determines its default value " +"instead." +msgstr "" + +msgid "The *quiet* parameter was added." +msgstr "" + +msgid "" +"A enumeration of possible methods the interpreter can use to determine " +"whether a bytecode file is up to date with a source file. The ``.pyc`` file " +"indicates the desired invalidation mode in its header. See :ref:`pyc-" +"invalidation` for more information on how Python invalidates ``.pyc`` files " +"at runtime." +msgstr "" + +msgid "" +"The ``.pyc`` file includes the timestamp and size of the source file, which " +"Python will compare against the metadata of the source file at runtime to " +"determine if the ``.pyc`` file needs to be regenerated." +msgstr "" + +msgid "" +"The ``.pyc`` file includes a hash of the source file content, which Python " +"will compare against the source at runtime to determine if the ``.pyc`` file " +"needs to be regenerated." +msgstr "" + +msgid "" +"Like :attr:`CHECKED_HASH`, the ``.pyc`` file includes a hash of the source " +"file content. However, Python will at runtime assume the ``.pyc`` file is up " +"to date and not validate the ``.pyc`` against the source file at all." +msgstr "" + +msgid "" +"This option is useful when the ``.pycs`` are kept up to date by some system " +"external to Python like a build system." +msgstr "" + +msgid "Command-Line Interface" +msgstr "" + +msgid "" +"This module can be invoked as a script to compile several source files. The " +"files named in *filenames* are compiled and the resulting bytecode is cached " +"in the normal manner. This program does not search a directory structure to " +"locate source files; it only compiles files named explicitly. The exit " +"status is nonzero if one of the files could not be compiled." +msgstr "" + +msgid "" +"Positional arguments are files to compile. If ``-`` is the only parameter, " +"the list of files is taken from standard input." +msgstr "" + +msgid "Suppress errors output." +msgstr "" + +msgid "Added support for ``-``." +msgstr "" + +msgid "Added support for :option:`-q`." +msgstr "" + +msgid "Module :mod:`compileall`" +msgstr "" + +msgid "Utilities to compile all Python source files in a directory tree." +msgstr "" + +msgid "file" +msgstr "plik" + +msgid "byte-code" +msgstr "" diff --git a/library/pyclbr.po b/library/pyclbr.po index 145b17d4f2..2b46f3340b 100644 --- a/library/pyclbr.po +++ b/library/pyclbr.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:18+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +78,7 @@ msgid "Function Objects" msgstr "Obiekty Funkcja" msgid "" -"Class :class:`Function` instances describe functions defined by def " +"Class :class:`!Function` instances describe functions defined by def " "statements. They have the following attributes:" msgstr "" @@ -94,24 +94,26 @@ msgstr "" msgid "The line number in the file where the definition starts." msgstr "" -msgid "For top-level functions, None. For nested functions, the parent." +msgid "For top-level functions, ``None``. For nested functions, the parent." msgstr "" msgid "" -"A dictionary mapping names to descriptors for nested functions and classes." +"A :class:`dictionary ` mapping names to descriptors for nested " +"functions and classes." msgstr "" msgid "" -"``True`` for functions that are defined with the ``async`` prefix, ``False`` " -"otherwise." +"``True`` for functions that are defined with the :keyword:`async ` prefix, ``False`` otherwise." msgstr "" msgid "Class Objects" -msgstr "" +msgstr "Obiekty klas" msgid "" -"Class :class:`Class` instances describe classes defined by class " -"statements. They have the same attributes as Functions and two more." +"Class :class:`!Class` instances describe classes defined by class " +"statements. They have the same attributes as :class:`Functions ` " +"and two more." msgstr "" msgid "Name of the file in which the class is defined." @@ -127,13 +129,18 @@ msgid "For top-level classes, None. For nested classes, the parent." msgstr "" msgid "" -"A list of :class:`Class` objects which describe the immediate base classes " +"A dictionary mapping names to descriptors for nested functions and classes." +msgstr "" + +msgid "" +"A list of :class:`!Class` objects which describe the immediate base classes " "of the class being described. Classes which are named as superclasses but " "which are not discoverable by :func:`readmodule_ex` are listed as a string " -"with the class name instead of as :class:`Class` objects." +"with the class name instead of as :class:`!Class` objects." msgstr "" msgid "" -"A dictionary mapping method names to line numbers. This can be derived from " -"the newer children dictionary, but remains for back-compatibility." +"A :class:`dictionary ` mapping method names to line numbers. This can " +"be derived from the newer :attr:`children` dictionary, but remains for back-" +"compatibility." msgstr "" diff --git a/library/pydoc.po b/library/pydoc.po new file mode 100644 index 0000000000..5865b6a8cd --- /dev/null +++ b/library/pydoc.po @@ -0,0 +1,157 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`pydoc` --- Documentation generator and online help system" +msgstr "" + +msgid "**Source code:** :source:`Lib/pydoc.py`" +msgstr "" + +msgid "" +"The :mod:`!pydoc` module automatically generates documentation from Python " +"modules. The documentation can be presented as pages of text on the " +"console, served to a web browser, or saved to HTML files." +msgstr "" + +msgid "" +"For modules, classes, functions and methods, the displayed documentation is " +"derived from the docstring (i.e. the :attr:`!__doc__` attribute) 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`)." +msgstr "" + +msgid "" +"The built-in function :func:`help` invokes the online help system in the " +"interactive interpreter, which uses :mod:`!pydoc` to generate its " +"documentation as text on the console. The same text documentation can also " +"be viewed from outside the Python interpreter by running :program:`pydoc` as " +"a script at the operating system's command prompt. For example, running ::" +msgstr "" + +msgid "" +"at a shell prompt will display documentation on the :mod:`sys` module, in a " +"style similar to the manual pages shown by the Unix :program:`man` command. " +"The argument to :program:`pydoc` can be the name of a function, module, or " +"package, or a dotted reference to a class, method, or function within a " +"module or module in a package. If the argument to :program:`pydoc` looks " +"like a path (that is, it contains the path separator for your operating " +"system, such as a slash in Unix), and refers to an existing Python source " +"file, then documentation is produced for that file." +msgstr "" + +msgid "" +"In order to find objects and their documentation, :mod:`!pydoc` imports the " +"module(s) to be documented. Therefore, any code on module level will be " +"executed on that occasion. Use an ``if __name__ == '__main__':`` guard to " +"only execute code when a file is invoked as a script and not just imported." +msgstr "" + +msgid "" +"When printing output to the console, :program:`pydoc` attempts to paginate " +"the output for easier reading. If the :envvar:`PAGER` environment variable " +"is set, :program:`pydoc` will use its value as a pagination program." +msgstr "" + +msgid "" +"Specifying a ``-w`` flag before the argument will cause HTML documentation " +"to be written out to a file in the current directory, instead of displaying " +"text on the console." +msgstr "" + +msgid "" +"Specifying a ``-k`` flag before the argument will search the synopsis lines " +"of all available modules for the keyword given as the argument, again in a " +"manner similar to the Unix :program:`man` command. The synopsis line of a " +"module is the first line of its documentation string." +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." +msgstr "" + +msgid "" +":program:`python -m pydoc -n ` will start the server listening at " +"the given hostname. By default the hostname is 'localhost' but if you want " +"the server to be reached from other machines, you may want to change the " +"host name that the server responds to. During development this is " +"especially useful if you want to run pydoc from within a container." +msgstr "" + +msgid "" +":program:`python -m pydoc -b` will start the server and additionally open a " +"web browser to a module index page. Each served page has a navigation bar " +"at the top where you can *Get* help on an individual item, *Search* all " +"modules with a keyword in their synopsis line, and go to the *Module index*, " +"*Topics* and *Keywords* pages." +msgstr "" + +msgid "" +"When :program:`pydoc` generates documentation, it uses the current " +"environment and path to locate modules. Thus, invoking :program:`pydoc " +"spam` documents precisely the version of the module you would get if you " +"started the Python interpreter and typed ``import spam``." +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." +msgstr "" + +msgid "Added the ``-b`` option." +msgstr "" + +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." +msgstr "" + +msgid "Added the ``-n`` option." +msgstr "" + +msgid "documentation" +msgstr "" + +msgid "generation" +msgstr "" + +msgid "online" +msgstr "" + +msgid "help" +msgstr "pomoc" diff --git a/library/pyexpat.po b/library/pyexpat.po index e60fbd20c8..6ae4be3568 100644 --- a/library/pyexpat.po +++ b/library/pyexpat.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -190,6 +190,38 @@ msgid "" "``errors.codes[errors.XML_ERROR_CANT_CHANGE_FEATURE_ONCE_PARSING]``." msgstr "" +msgid "" +"Calling ``SetReparseDeferralEnabled(False)`` has security implications, as " +"detailed below; please make sure to understand these consequences prior to " +"using the ``SetReparseDeferralEnabled`` method." +msgstr "" + +msgid "" +"Expat 2.6.0 introduced a security mechanism called \"reparse deferral\" " +"where instead of causing denial of service through quadratic runtime from " +"reparsing large tokens, reparsing of unfinished tokens is now delayed by " +"default until a sufficient amount of input is reached. Due to this delay, " +"registered handlers may — depending of the sizing of input chunks pushed to " +"Expat — no longer be called right after pushing new input to the parser. " +"Where immediate feedback and taking over responsiblity of protecting against " +"denial of service from large tokens are both wanted, calling " +"``SetReparseDeferralEnabled(False)`` disables reparse deferral for the " +"current Expat parser instance, temporarily or altogether. Calling " +"``SetReparseDeferralEnabled(True)`` allows re-enabling reparse deferral." +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 " +"running across a variety of Python versions." +msgstr "" + +msgid "" +"Returns whether reparse deferral is currently enabled for the given Expat " +"parser instance." +msgstr "" + msgid ":class:`xmlparser` objects have the following attributes:" msgstr "" @@ -205,7 +237,8 @@ msgid "" "`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." +"changed at any time. Note that when it is false, data that does not contain " +"newlines may be chunked too." msgstr "" msgid "" @@ -342,7 +375,10 @@ msgid "" "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." +"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 "" @@ -471,7 +507,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "" "The following program defines three handlers that just print out their " diff --git a/library/random.po b/library/random.po index a177d6f8f9..4ca03a6f05 100644 --- a/library/random.po +++ b/library/random.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,11 +66,8 @@ msgstr "" msgid "" "Class :class:`Random` can also be subclassed if you want to use a different " -"basic generator of your own devising: in that case, override the :meth:" -"`~Random.random`, :meth:`~Random.seed`, :meth:`~Random.getstate`, and :meth:" -"`~Random.setstate` methods. Optionally, a new generator can supply a :meth:" -"`~Random.getrandbits` method --- this allows :meth:`randrange` to produce " -"selections over an arbitrarily large range." +"basic generator of your own devising: see the documentation on that class " +"for more details." msgstr "" msgid "" @@ -129,7 +126,7 @@ msgid "" msgstr "" msgid "" -"The *seed* must be one of the following types: *NoneType*, :class:`int`, :" +"The *seed* must be one of the following types: ``None``, :class:`int`, :" "class:`float`, :class:`str`, :class:`bytes`, or :class:`bytearray`." msgstr "" @@ -183,7 +180,7 @@ msgid "" msgstr "" msgid "" -"The exception raised for non-integral values such as ``randrange(10.5)`` or " +"The exception raised for non-integer values such as ``randrange(10.5)`` or " "``randrange('10')`` will be changed from :exc:`ValueError` to :exc:" "`TypeError`." msgstr "" @@ -269,7 +266,7 @@ msgid "" "fit within the period of the Mersenne Twister random number generator." msgstr "" -msgid "The optional parameter *random*." +msgid "Removed the optional parameter *random*." msgstr "" msgid "" @@ -338,7 +335,7 @@ msgstr "" msgid "" "The end-point value ``b`` may or may not be included in the range depending " -"on floating-point rounding in the equation ``a + (b-a) * random()``." +"on floating-point rounding in the expression ``a + (b-a) * random()``." msgstr "" msgid "" @@ -423,11 +420,45 @@ msgid "" msgstr "" msgid "" -"In the future, the *seed* must be one of the following types: :class:" -"`NoneType`, :class:`int`, :class:`float`, :class:`str`, :class:`bytes`, or :" +"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`." msgstr "" +msgid "" +"Subclasses of :class:`!Random` should override the following methods if they " +"wish to make use of a different basic generator:" +msgstr "" + +msgid "" +"Override this method in subclasses to customise the :meth:`~random.seed` " +"behaviour of :class:`!Random` instances." +msgstr "" + +msgid "" +"Override this method in subclasses to customise the :meth:`~random.getstate` " +"behaviour of :class:`!Random` instances." +msgstr "" + +msgid "" +"Override this method in subclasses to customise the :meth:`~random.setstate` " +"behaviour of :class:`!Random` instances." +msgstr "" + +msgid "" +"Override this method in subclasses to customise the :meth:`~random.random` " +"behaviour of :class:`!Random` instances." +msgstr "" + +msgid "" +"Optionally, a custom generator subclass can also supply the following method:" +msgstr "" + +msgid "" +"Override this method in subclasses to customise the :meth:`~random." +"getrandbits` behaviour of :class:`!Random` instances." +msgstr "" + msgid "" "Class that uses the :func:`os.urandom` function for generating random " "numbers from sources provided by the operating system. Not available on all " @@ -469,7 +500,7 @@ msgid "Basic examples::" msgstr "" msgid "Simulations::" -msgstr "" +msgstr "Symulacje::" msgid "" "Example of `statistical bootstrapping `_ 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 "" -"`A Concrete Introduction to Probability (using Python) `_ a tutorial by `Peter " -"Norvig `_ covering the basics of probability " -"theory, how to write simulations, and how to perform data analysis using " -"Python." +"`A Concrete Introduction to Probability (using Python) `_ a tutorial by `Peter Norvig " +"`_ covering the basics of probability theory, " +"how to write simulations, and how to perform data analysis using Python." msgstr "" msgid "Recipes" diff --git a/library/re.po b/library/re.po index 65c575fec3..7536732d7a 100644 --- a/library/re.po +++ b/library/re.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2022 -# Igor Zubrycki , 2022 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Igor Zubrycki , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +38,7 @@ 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 byte pattern or vice-versa; similarly, when asking for a " +"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 "" @@ -138,7 +136,7 @@ msgid "The special characters are:" msgstr "" msgid "``.``" -msgstr "" +msgstr "``.``" msgid "" "(Dot.) In the default mode, this matches any character except a newline. " @@ -147,7 +145,7 @@ msgid "" msgstr "" msgid "``^``" -msgstr "" +msgstr "``^``" msgid "" "(Caret.) Matches the start of the string, and in :const:`MULTILINE` mode " @@ -155,7 +153,7 @@ msgid "" msgstr "" msgid "``$``" -msgstr "" +msgstr "``$``" msgid "" "Matches the end of the string or just before the newline at the end of the " @@ -169,7 +167,7 @@ msgid "" msgstr "" msgid "``*``" -msgstr "" +msgstr "``*``" msgid "" "Causes the resulting RE to match 0 or more repetitions of the preceding RE, " @@ -178,7 +176,7 @@ msgid "" msgstr "" msgid "``+``" -msgstr "" +msgstr "``+``" msgid "" "Causes the resulting RE to match 1 or more repetitions of the preceding RE. " @@ -187,7 +185,7 @@ msgid "" msgstr "" msgid "``?``" -msgstr "" +msgstr "``?``" msgid "" "Causes the resulting RE to match 0 or 1 repetitions of the preceding RE. " @@ -195,7 +193,7 @@ msgid "" msgstr "" msgid "``*?``, ``+?``, ``??``" -msgstr "" +msgstr "``*?``, ``+?``, ``??``" msgid "" "The ``'*'``, ``'+'``, and ``'?'`` quantifiers are all :dfn:`greedy`; they " @@ -208,7 +206,7 @@ msgid "" msgstr "" msgid "``*+``, ``++``, ``?+``" -msgstr "" +msgstr "``*+``, ``++``, ``?+``" msgid "" "Like the ``'*'``, ``'+'``, and ``'?'`` quantifiers, those where ``'+'`` is " @@ -227,7 +225,7 @@ msgid "" msgstr "" msgid "``{m}``" -msgstr "" +msgstr "``{m}``" msgid "" "Specifies that exactly *m* copies of the previous RE should be matched; " @@ -236,7 +234,7 @@ msgid "" msgstr "" msgid "``{m,n}``" -msgstr "" +msgstr "``{m,n}``" msgid "" "Causes the resulting RE to match from *m* to *n* repetitions of the " @@ -250,7 +248,7 @@ msgid "" msgstr "" msgid "``{m,n}?``" -msgstr "" +msgstr "``{m,n}?``" msgid "" "Causes the resulting RE to match from *m* to *n* repetitions of the " @@ -261,7 +259,7 @@ msgid "" msgstr "" msgid "``{m,n}+``" -msgstr "" +msgstr "``{m,n}+``" msgid "" "Causes the resulting RE to match from *m* to *n* repetitions of the " @@ -276,7 +274,7 @@ msgid "" msgstr "" msgid "``\\``" -msgstr "" +msgstr "``\\``" msgid "" "Either escapes special characters (permitting you to match characters like " @@ -295,7 +293,7 @@ msgid "" msgstr "" msgid "``[]``" -msgstr "" +msgstr "``[]``" msgid "Used to indicate a set of characters. In a set:" msgstr "" @@ -322,8 +320,8 @@ msgstr "" msgid "" "Character classes such as ``\\w`` or ``\\S`` (defined below) are also " -"accepted inside a set, although the characters they match depends on " -"whether :const:`ASCII` or :const:`LOCALE` mode is in force." +"accepted inside a set, although the characters they match depend on the " +"flags_ used." msgstr "" msgid "" @@ -357,7 +355,7 @@ msgid "" msgstr "" msgid "``|``" -msgstr "" +msgstr "``|``" msgid "" "``A|B``, where *A* and *B* can be arbitrary REs, creates a regular " @@ -372,7 +370,7 @@ msgid "" msgstr "" msgid "``(...)``" -msgstr "" +msgstr "``(...)``" msgid "" "Matches whatever regular expression is inside the parentheses, and indicates " @@ -384,7 +382,7 @@ msgid "" msgstr "" msgid "``(?...)``" -msgstr "" +msgstr "``(?...)``" msgid "" "This is an extension notation (a ``'?'`` following a ``'('`` is not " @@ -395,26 +393,47 @@ msgid "" msgstr "" msgid "``(?aiLmsux)``" -msgstr "" +msgstr "``(?aiLmsux)``" msgid "" "(One or more letters from the set ``'a'``, ``'i'``, ``'L'``, ``'m'``, " -"``'s'``, ``'u'``, ``'x'``.) The group matches the empty string; the letters " -"set the corresponding flags: :const:`re.A` (ASCII-only matching), :const:`re." -"I` (ignore case), :const:`re.L` (locale dependent), :const:`re.M` (multi-" -"line), :const:`re.S` (dot matches all), :const:`re.U` (Unicode matching), " -"and :const:`re.X` (verbose), for the entire regular expression. (The flags " -"are described in :ref:`contents-of-module-re`.) This is useful if you wish " -"to include the flags as part of the regular expression, instead of passing a " -"*flag* argument to the :func:`re.compile` function. Flags should be used " -"first in the expression string." +"``'s'``, ``'u'``, ``'x'``.) The group matches the empty string; the letters " +"set the corresponding flags for the entire regular expression:" +msgstr "" + +msgid ":const:`re.A` (ASCII-only matching)" +msgstr "" + +msgid ":const:`re.I` (ignore case)" +msgstr "" + +msgid ":const:`re.L` (locale dependent)" +msgstr "" + +msgid ":const:`re.M` (multi-line)" +msgstr "" + +msgid ":const:`re.S` (dot matches all)" +msgstr "" + +msgid ":const:`re.U` (Unicode matching)" +msgstr "" + +msgid ":const:`re.X` (verbose)" +msgstr "" + +msgid "" +"(The flags are described in :ref:`contents-of-module-re`.) This is useful if " +"you wish to include the flags as part of the regular expression, instead of " +"passing a *flag* argument to the :func:`re.compile` function. Flags should " +"be used first in the expression string." msgstr "" msgid "This construction can only be used at the start of the expression." msgstr "" msgid "``(?:...)``" -msgstr "" +msgstr "``(?:...)``" msgid "" "A non-capturing version of regular parentheses. Matches whatever regular " @@ -424,17 +443,16 @@ msgid "" msgstr "" msgid "``(?aiLmsux-imsx:...)``" -msgstr "" +msgstr "``(?aiLmsux-imsx:...)``" msgid "" "(Zero or more letters from the set ``'a'``, ``'i'``, ``'L'``, ``'m'``, " "``'s'``, ``'u'``, ``'x'``, optionally followed by ``'-'`` followed by one or " "more letters from the ``'i'``, ``'m'``, ``'s'``, ``'x'``.) The letters set " -"or remove the corresponding flags: :const:`re.A` (ASCII-only matching), :" -"const:`re.I` (ignore case), :const:`re.L` (locale dependent), :const:`re.M` " -"(multi-line), :const:`re.S` (dot matches all), :const:`re.U` (Unicode " -"matching), and :const:`re.X` (verbose), for the part of the expression. (The " -"flags are described in :ref:`contents-of-module-re`.)" +"or remove the corresponding flags for the part of the expression:" +msgstr "" + +msgid "(The flags are described in :ref:`contents-of-module-re`.)" msgstr "" msgid "" @@ -443,7 +461,7 @@ msgid "" "one of them appears in an inline group, it overrides the matching mode in " "the enclosing group. In Unicode patterns ``(?a:...)`` switches to ASCII-" "only matching, and ``(?u:...)`` switches to Unicode matching (default). In " -"byte pattern ``(?L:...)`` switches to locale depending matching, and ``(?" +"bytes patterns ``(?L:...)`` switches to locale dependent matching, and ``(?" "a:...)`` switches to ASCII-only matching (default). This override is only in " "effect for the narrow inline group, and the original matching mode is " "restored outside of the group." @@ -453,7 +471,7 @@ msgid "The letters ``'a'``, ``'L'`` and ``'u'`` also can be used in a group." msgstr "" msgid "``(?>...)``" -msgstr "" +msgstr "``(?>...)``" msgid "" "Attempts to match ``...`` as if it was a separate regular expression, and if " @@ -469,7 +487,7 @@ msgid "" msgstr "" msgid "``(?P...)``" -msgstr "" +msgstr "``(?P...)``" msgid "" "Similar to regular parentheses, but the substring matched by the group is " @@ -498,7 +516,7 @@ msgid "``(?P=quote)`` (as shown)" msgstr "" msgid "``\\1``" -msgstr "" +msgstr "``\\1``" msgid "when processing match object *m*" msgstr "" @@ -507,16 +525,16 @@ msgid "``m.group('quote')``" msgstr "" msgid "``m.end('quote')`` (etc.)" -msgstr "" +msgstr "``m.end('quote')`` (etc.)" msgid "in a string passed to the *repl* argument of ``re.sub()``" msgstr "" msgid "``\\g``" -msgstr "" +msgstr "``\\g``" msgid "``\\g<1>``" -msgstr "" +msgstr "``\\g<1>``" msgid "" "Group *name* containing characters outside the ASCII range (``b'\\x00'``-" @@ -532,13 +550,13 @@ msgid "" msgstr "" msgid "``(?#...)``" -msgstr "" +msgstr "``(?#...)``" msgid "A comment; the contents of the parentheses are simply ignored." msgstr "" msgid "``(?=...)``" -msgstr "" +msgstr "``(?=...)``" msgid "" "Matches if ``...`` matches next, but doesn't consume any of the string. " @@ -556,7 +574,7 @@ msgid "" msgstr "" msgid "``(?<=...)``" -msgstr "" +msgstr "``(?<=...)``" msgid "" "Matches if the current position in the string is preceded by a match for " @@ -578,7 +596,7 @@ msgid "Added support for group references of fixed length." msgstr "" msgid "``(?`. 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 "" "If zero or more characters at the beginning of *string* match the regular " -"expression *pattern*, return a corresponding :ref:`match object `. Return ``None`` if the string does not match the pattern; note " -"that this is different from a zero-length match." +"expression *pattern*, return a corresponding :class:`~re.Match`. Return " +"``None`` if the string does not match the pattern; note that this is " +"different from a zero-length match." msgstr "" msgid "" @@ -973,9 +1046,8 @@ msgstr "" msgid "" "If the whole *string* matches the regular expression *pattern*, return a " -"corresponding :ref:`match object `. Return ``None`` if the " -"string does not match the pattern; note that this is different from a zero-" -"length match." +"corresponding :class:`~re.Match`. Return ``None`` if the string does not " +"match the pattern; note that this is different from a zero-length match." msgstr "" msgid "" @@ -1028,10 +1100,10 @@ msgid "Non-empty matches can now start just after a previous empty match." msgstr "" msgid "" -"Return an :term:`iterator` yielding :ref:`match objects ` " -"over all non-overlapping matches for the RE *pattern* in *string*. The " -"*string* is scanned left-to-right, and matches are returned in the order " -"found. Empty matches are included in the result." +"Return an :term:`iterator` yielding :class:`~re.Match` objects over all non-" +"overlapping matches for the RE *pattern* in *string*. The *string* is " +"scanned left-to-right, and matches are returned in the order found. Empty " +"matches are included in the result." msgstr "" msgid "" @@ -1049,11 +1121,11 @@ msgstr "" msgid "" "If *repl* is a function, it is called for every non-overlapping occurrence " -"of *pattern*. The function takes a single :ref:`match object ` argument, and returns the replacement string. For example::" +"of *pattern*. The function takes a single :class:`~re.Match` argument, and " +"returns the replacement string. For example::" msgstr "" -msgid "The pattern may be a string or a :ref:`pattern object `." +msgid "The pattern may be a string or a :class:`~re.Pattern`." msgstr "" msgid "" @@ -1155,17 +1227,20 @@ msgstr "" msgid "Regular Expression Objects" msgstr "" +msgid "Compiled regular expression object returned by :func:`re.compile`." +msgstr "" + msgid "" -"Compiled regular expression objects support the following methods and " -"attributes:" +":py:class:`re.Pattern` supports ``[]`` to indicate a Unicode (str) or bytes " +"pattern. See :ref:`types-genericalias`." msgstr "" msgid "" "Scan through *string* looking for the first location where this regular " -"expression produces a match, and return a corresponding :ref:`match object " -"`. 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 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 "" @@ -1187,9 +1262,9 @@ msgstr "" msgid "" "If zero or more characters at the *beginning* of *string* match this regular " -"expression, return a corresponding :ref:`match object `. " -"Return ``None`` if the string does not match the pattern; note that this is " -"different from a zero-length match." +"expression, return a corresponding :class:`~re.Match`. Return ``None`` if " +"the string does not match the pattern; note that this is different from a " +"zero-length match." msgstr "" msgid "" @@ -1204,9 +1279,8 @@ msgstr "" msgid "" "If the whole *string* matches this regular expression, return a " -"corresponding :ref:`match object `. Return ``None`` if the " -"string does not match the pattern; note that this is different from a zero-" -"length match." +"corresponding :class:`~re.Match`. Return ``None`` if the string does not " +"match the pattern; note that this is different from a zero-length match." msgstr "" msgid "Identical to the :func:`split` function, using the compiled pattern." @@ -1233,7 +1307,7 @@ 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 :data:`UNICODE` if the pattern is a Unicode string." +"such as :py:const:`~re.UNICODE` if the pattern is a Unicode string." msgstr "" msgid "The number of capturing groups in the pattern." @@ -1262,7 +1336,12 @@ msgid "" "you can test whether there was a match with a simple ``if`` statement::" msgstr "" -msgid "Match objects support the following methods and attributes:" +msgid "Match object returned by successful ``match``\\ es and ``search``\\ es." +msgstr "" + +msgid "" +":py:class:`re.Match` supports ``[]`` to indicate a Unicode (str) or bytes " +"match. See :ref:`types-genericalias`." msgstr "" msgid "" @@ -1270,7 +1349,8 @@ msgid "" "string *template*, as done by the :meth:`~Pattern.sub` method. Escapes such " "as ``\\n`` are converted to the appropriate characters, and numeric " "backreferences (``\\1``, ``\\2``) and named backreferences (``\\g<1>``, " -"``\\g``) are replaced by the contents of the corresponding group." +"``\\g``) are replaced by the contents of the corresponding group. The " +"backreference ``\\g<0>`` will be replaced by the entire match." msgstr "" msgid "" @@ -1430,74 +1510,74 @@ msgid "Simulating scanf()" msgstr "" msgid "" -"Python does not currently have an equivalent to :c:func:`scanf`. Regular " +"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 " +"func:`!scanf` format strings. The table below offers some more-or-less " +"equivalent mappings between :c:func:`!scanf` format tokens and regular " "expressions." msgstr "" -msgid ":c:func:`scanf` Token" +msgid ":c:func:`!scanf` Token" msgstr "" msgid "Regular Expression" msgstr "" msgid "``%c``" -msgstr "" +msgstr "``%c``" msgid "``%5c``" -msgstr "" +msgstr "``%5c``" msgid "``.{5}``" -msgstr "" +msgstr "``.{5}``" msgid "``%d``" -msgstr "" +msgstr "``%d``" msgid "``[-+]?\\d+``" -msgstr "" +msgstr "``[-+]?\\d+``" msgid "``%e``, ``%E``, ``%f``, ``%g``" -msgstr "" +msgstr "``%e``, ``%E``, ``%f``, ``%g``" msgid "``[-+]?(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?``" -msgstr "" +msgstr "``[-+]?(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?``" msgid "``%i``" -msgstr "" +msgstr "``%i``" msgid "``[-+]?(0[xX][\\dA-Fa-f]+|0[0-7]*|\\d+)``" -msgstr "" +msgstr "``[-+]?(0[xX][\\dA-Fa-f]+|0[0-7]*|\\d+)``" msgid "``%o``" -msgstr "" +msgstr "``%o``" msgid "``[-+]?[0-7]+``" -msgstr "" +msgstr "``[-+]?[0-7]+``" msgid "``%s``" -msgstr "" +msgstr "``%s``" msgid "``\\S+``" -msgstr "" +msgstr "``\\S+``" msgid "``%u``" -msgstr "" +msgstr "``%u``" msgid "``\\d+``" -msgstr "" +msgstr "``\\d+``" msgid "``%x``, ``%X``" -msgstr "" +msgstr "``%x``, ``%X``" msgid "``[-+]?(0[xX])?[\\dA-Fa-f]+``" -msgstr "" +msgstr "``[-+]?(0[xX])?[\\dA-Fa-f]+``" msgid "To extract the filename and numbers from a string like ::" msgstr "" -msgid "you would use a :c:func:`scanf` format like ::" +msgid "you would use a :c:func:`!scanf` format like ::" msgstr "" msgid "The equivalent regular expression would be ::" @@ -1590,10 +1670,10 @@ msgstr "" msgid "" "If one wants more information about all matches of a pattern than the " -"matched text, :func:`finditer` is useful as it provides :ref:`match objects " -"` instead of strings. Continuing with the previous example, " -"if a writer wanted to find all of the adverbs *and their positions* in some " -"text, they would use :func:`finditer` in the following manner::" +"matched text, :func:`finditer` is useful as it provides :class:`~re.Match` " +"objects instead of strings. Continuing with the previous example, if a " +"writer wanted to find all of the adverbs *and their positions* in some text, " +"they would use :func:`finditer` in the following manner::" msgstr "" msgid "Raw String Notation" @@ -1637,3 +1717,159 @@ msgid "" "first edition covered writing good regular expression patterns in great " "detail." msgstr "" + +msgid ". (dot)" +msgstr "" + +msgid "in regular expressions" +msgstr "" + +msgid "^ (caret)" +msgstr "" + +msgid "$ (dollar)" +msgstr "$ (dollar)" + +msgid "* (asterisk)" +msgstr "* (asterysk)" + +msgid "+ (plus)" +msgstr "" + +msgid "? (question mark)" +msgstr "" + +msgid "*?" +msgstr "" + +msgid "+?" +msgstr "" + +msgid "??" +msgstr "" + +msgid "*+" +msgstr "" + +msgid "++" +msgstr "" + +msgid "?+" +msgstr "" + +msgid "{} (curly brackets)" +msgstr "" + +msgid "\\ (backslash)" +msgstr "" + +msgid "[] (square brackets)" +msgstr "" + +msgid "- (minus)" +msgstr "" + +msgid "| (vertical bar)" +msgstr "" + +msgid "() (parentheses)" +msgstr "" + +msgid "(?" +msgstr "" + +msgid "(?:" +msgstr "(?:" + +msgid "(?P<" +msgstr "" + +msgid "(?P=" +msgstr "" + +msgid "(?#" +msgstr "" + +msgid "(?=" +msgstr "" + +msgid "(?!" +msgstr "" + +msgid "(?<=" +msgstr "" + +msgid "(?, YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`readline` --- GNU readline interface" +msgstr "" + +msgid "" +"The :mod:`readline` module defines a number of functions to facilitate " +"completion and reading/writing of history files from the Python interpreter. " +"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." +msgstr "" + +msgid "" +"Readline keybindings may be configured via an initialization file, typically " +"``.inputrc`` in your home directory. See `Readline Init File `_ in " +"the GNU Readline manual for information about the format and allowable " +"constructs of that file, and the capabilities of the Readline library in " +"general." +msgstr "" + +msgid "" +"The underlying Readline library API may be implemented by the ``libedit`` " +"library instead of GNU readline. On macOS the :mod:`readline` module detects " +"which library is being used at run time." +msgstr "" + +msgid "" +"The configuration file for ``libedit`` is different from that of GNU " +"readline. If you programmatically load configuration strings you can check " +"for the text \"libedit\" in :const:`readline.__doc__` to differentiate " +"between GNU readline and libedit." +msgstr "" + +msgid "" +"If you use *editline*/``libedit`` readline emulation on macOS, the " +"initialization file located in your home directory is named ``.editrc``. For " +"example, the following content in ``~/.editrc`` will turn ON *vi* " +"keybindings and TAB completion::" +msgstr "" + +msgid "Init file" +msgstr "" + +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." +msgstr "" + +msgid "" +"Execute a readline initialization file. The default filename is the last " +"filename used. This calls :c:func:`rl_read_init_file` in the underlying " +"library." +msgstr "" + +msgid "Line buffer" +msgstr "" + +msgid "The following functions operate on the line buffer:" +msgstr "" + +msgid "" +"Return the current contents of the line buffer (:c:data:`rl_line_buffer` in " +"the underlying library)." +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." +msgstr "" + +msgid "" +"Change what's displayed on the screen to reflect the current contents of the " +"line buffer. This calls :c:func:`rl_redisplay` in the underlying library." +msgstr "" + +msgid "History file" +msgstr "" + +msgid "The following functions operate on a history file:" +msgstr "" + +msgid "" +"Load a readline history file, and append it to the history list. The default " +"filename is :file:`~/.history`. This calls :c:func:`read_history` in the " +"underlying library." +msgstr "" + +msgid "" +"Save the history list to a readline history file, overwriting any existing " +"file. The default filename is :file:`~/.history`. This calls :c:func:" +"`write_history` in the underlying library." +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." +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 library. " +"Negative values imply unlimited history file size." +msgstr "" + +msgid "History list" +msgstr "" + +msgid "The following functions operate on a global history list:" +msgstr "" + +msgid "" +"Clear the current history. This calls :c:func:`clear_history` in the " +"underlying library. The Python function only exists if Python was compiled " +"for a version of the library that supports it." +msgstr "" + +msgid "" +"Return the number of items currently in the history. (This is different " +"from :func:`get_history_length`, which returns the maximum number of lines " +"that will be written to a history file.)" +msgstr "" + +msgid "" +"Return the current contents of history item at *index*. The item index is " +"one-based. This calls :c:func:`history_get` in the underlying library." +msgstr "" + +msgid "" +"Remove history item specified by its position from the history. The position " +"is zero-based. This calls :c:func:`remove_history` in the underlying " +"library." +msgstr "" + +msgid "" +"Replace history item specified by its position with *line*. The position is " +"zero-based. This calls :c:func:`replace_history_entry` in the underlying " +"library." +msgstr "" + +msgid "" +"Append *line* to the history buffer, as if it was the last line typed. This " +"calls :c:func:`add_history` in the underlying library." +msgstr "" + +msgid "" +"Enable or disable automatic calls to :c:func:`add_history` when reading " +"input via readline. The *enabled* argument should be a Boolean value that " +"when true, enables auto history, and that when false, disables auto history." +msgstr "" + +msgid "" +"Auto history is enabled by default, and changes to this do not persist " +"across multiple sessions." +msgstr "" + +msgid "Startup hooks" +msgstr "" + +msgid "" +"Set or remove the function invoked by the :c:data:`rl_startup_hook` callback " +"of the underlying library. If *function* is specified, it will be used as " +"the new hook function; if omitted or ``None``, any function already " +"installed is removed. The hook is called with no arguments just before " +"readline prints the first prompt." +msgstr "" + +msgid "" +"Set or remove the function invoked by the :c:data:`rl_pre_input_hook` " +"callback of the underlying library. If *function* is specified, it will be " +"used as the new hook function; if omitted or ``None``, any function already " +"installed is removed. The hook is called with no arguments after the first " +"prompt has been printed and just before readline starts reading input " +"characters. This function only exists if Python was compiled for a version " +"of the library that supports it." +msgstr "" + +msgid "Completion" +msgstr "" + +msgid "" +"The following functions relate to implementing a custom word completion " +"function. This is typically operated by the Tab key, and can suggest and " +"automatically complete a word being typed. By default, Readline is set up " +"to be used by :mod:`rlcompleter` to complete Python identifiers for the " +"interactive interpreter. If the :mod:`readline` module is to be used with a " +"custom completer, a different set of word delimiters should be set." +msgstr "" + +msgid "" +"Set or remove the completer function. If *function* is specified, it will " +"be used as the new completer function; if omitted or ``None``, any completer " +"function already installed is removed. The completer function is called as " +"``function(text, state)``, for *state* in ``0``, ``1``, ``2``, ..., until it " +"returns a non-string value. It should return the next possible completion " +"starting with *text*." +msgstr "" + +msgid "" +"The installed completer function is invoked by the *entry_func* callback " +"passed to :c:func:`rl_completion_matches` in the underlying library. The " +"*text* string comes from the first parameter to the :c:data:" +"`rl_attempted_completion_function` callback of the underlying library." +msgstr "" + +msgid "" +"Get the completer function, or ``None`` if no completer function has been " +"set." +msgstr "" + +msgid "" +"Get the type of completion being attempted. This returns the :c:data:" +"`rl_completion_type` variable in the underlying library as an integer." +msgstr "" + +msgid "" +"Get the beginning or ending index of the completion scope. These indexes are " +"the *start* and *end* arguments passed to the :c:data:" +"`rl_attempted_completion_function` callback of the underlying library. The " +"values may be different in the same input editing scenario based on the " +"underlying C readline implementation. Ex: libedit is known to behave " +"differently than libreadline." +msgstr "" + +msgid "" +"Set or get the word delimiters for completion. These determine the start of " +"the word to be considered for completion (the completion scope). These " +"functions access the :c:data:`rl_completer_word_break_characters` variable " +"in the underlying library." +msgstr "" + +msgid "" +"Set or remove the completion display function. If *function* is specified, " +"it will be used as the new completion display function; if omitted or " +"``None``, any completion display function already installed is removed. " +"This sets or clears the :c:data:`rl_completion_display_matches_hook` " +"callback in the underlying library. The completion display function is " +"called as ``function(substitution, [matches], longest_match_length)`` once " +"each time matches need to be displayed." +msgstr "" + +msgid "Example" +msgstr "Przykład" + +msgid "" +"The following example demonstrates how to use the :mod:`readline` module's " +"history reading and writing functions to automatically load and save a " +"history file named :file:`.python_history` from the user's home directory. " +"The code below would normally be executed automatically during interactive " +"sessions from the user's :envvar:`PYTHONSTARTUP` file. ::" +msgstr "" + +msgid "" +"This code is actually automatically run when Python is run in :ref:" +"`interactive mode ` (see :ref:`rlcompleter-config`)." +msgstr "" + +msgid "" +"The following example achieves the same goal but supports concurrent " +"interactive sessions, by only appending the new history. ::" +msgstr "" + +msgid "" +"The following example extends the :class:`code.InteractiveConsole` class to " +"support history save/restore. ::" +msgstr "" diff --git a/library/reprlib.po b/library/reprlib.po new file mode 100644 index 0000000000..31268d66e3 --- /dev/null +++ b/library/reprlib.po @@ -0,0 +1,149 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`reprlib` --- Alternate :func:`repr` implementation" +msgstr "" + +msgid "**Source code:** :source:`Lib/reprlib.py`" +msgstr "" + +msgid "" +"The :mod:`!reprlib` module provides a means for producing object " +"representations with limits on the size of the resulting strings. This is " +"used in the Python debugger and may be useful in other contexts as well." +msgstr "" + +msgid "This module provides a class, an instance, and a function:" +msgstr "" + +msgid "" +"Class which provides formatting services useful in implementing functions " +"similar to the built-in :func:`repr`; size limits for different object " +"types are added to avoid the generation of representations which are " +"excessively long." +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." +msgstr "" + +msgid "" +"This is the :meth:`~Repr.repr` method of ``aRepr``. It returns a string " +"similar to that returned by the built-in function of the same name, but with " +"limits on most sizes." +msgstr "" + +msgid "" +"In addition to size-limiting tools, the module also provides a decorator for " +"detecting recursive calls to :meth:`~object.__repr__` and substituting a " +"placeholder string instead." +msgstr "" + +msgid "" +"Decorator for :meth:`~object.__repr__` methods to detect recursive calls " +"within the same thread. If a recursive call is made, the *fillvalue* is " +"returned, otherwise, the usual :meth:`!__repr__` call is made. For example:" +msgstr "" + +msgid "Repr Objects" +msgstr "" + +msgid "" +":class:`Repr` instances provide several attributes which can be used to " +"provide size limits for the representations of different object types, and " +"methods which format specific object types." +msgstr "" + +msgid "" +"This string is displayed for recursive references. It defaults to ``...``." +msgstr "" + +msgid "" +"Depth limit on the creation of recursive representations. The default is " +"``6``." +msgstr "" + +msgid "" +"Limits on the number of entries represented for the named object type. The " +"default is ``4`` for :attr:`maxdict`, ``5`` for :attr:`maxarray`, and ``6`` " +"for the others." +msgstr "" + +msgid "" +"Maximum number of characters in the representation for an integer. Digits " +"are dropped from the middle. The default is ``40``." +msgstr "" + +msgid "" +"Limit on the number of characters in the representation of the string. Note " +"that the \"normal\" representation of the string is used as the character " +"source: if escape sequences are needed in the representation, these may be " +"mangled when the representation is shortened. The default is ``30``." +msgstr "" + +msgid "" +"This limit is used to control the size of object types for which no specific " +"formatting method is available on the :class:`Repr` object. It is applied in " +"a similar manner as :attr:`maxstring`. The default is ``20``." +msgstr "" + +msgid "" +"The equivalent to the built-in :func:`repr` that uses the formatting imposed " +"by the instance." +msgstr "" + +msgid "" +"Recursive implementation used by :meth:`.repr`. This uses the type of *obj* " +"to determine which formatting method to call, passing it *obj* and *level*. " +"The type-specific methods should call :meth:`repr1` to perform recursive " +"formatting, with ``level - 1`` for the value of *level* in the recursive " +"call." +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)``." +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 " +"modify the handling of types already supported. This example shows how " +"special support for file objects could be added:" +msgstr "" + +msgid "..." +msgstr "..." + +msgid "placeholder" +msgstr "" diff --git a/library/resource.po b/library/resource.po new file mode 100644 index 0000000000..8a5164d4f5 --- /dev/null +++ b/library/resource.po @@ -0,0 +1,480 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`resource` --- Resource usage information" +msgstr "" + +msgid "" +"This module provides basic mechanisms for measuring and controlling system " +"resources utilized by a program." +msgstr "" + +msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." +msgstr "" + +msgid "" +"Symbolic constants are used to specify particular system resources and to " +"request usage information about either the current process or its children." +msgstr "" + +msgid "An :exc:`OSError` is raised on syscall failure." +msgstr "" + +msgid "A deprecated alias of :exc:`OSError`." +msgstr "" + +msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`." +msgstr "" + +msgid "Resource Limits" +msgstr "" + +msgid "" +"Resources usage can be limited using the :func:`setrlimit` function " +"described below. Each resource is controlled by a pair of limits: a soft " +"limit and a hard limit. The soft limit is the current limit, and may be " +"lowered or raised by a process over time. The soft limit can never exceed " +"the hard limit. The hard limit can be lowered to any value greater than the " +"soft limit, but not raised. (Only processes with the effective UID of the " +"super-user can raise a hard limit.)" +msgstr "" + +msgid "" +"The specific resources that can be limited are system dependent. They are " +"described in the :manpage:`getrlimit(2)` man page. The resources listed " +"below are supported when the underlying operating system supports them; " +"resources which cannot be checked or controlled by the operating system are " +"not defined in this module for those platforms." +msgstr "" + +msgid "Constant used to represent the limit for an unlimited resource." +msgstr "" + +msgid "" +"Returns a tuple ``(soft, hard)`` with the current soft and hard limits of " +"*resource*. Raises :exc:`ValueError` if an invalid resource is specified, " +"or :exc:`error` if the underlying system call fails unexpectedly." +msgstr "" + +msgid "" +"Sets new limits of consumption of *resource*. The *limits* argument must be " +"a tuple ``(soft, hard)`` of two integers describing the new limits. A value " +"of :data:`~resource.RLIM_INFINITY` can be used to request a limit that is " +"unlimited." +msgstr "" + +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 :data:`~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." +msgstr "" + +msgid "" +"``setrlimit`` may also raise :exc:`error` if the underlying system call " +"fails." +msgstr "" + +msgid "VxWorks only supports setting :data:`RLIMIT_NOFILE`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``resource.setrlimit`` with " +"arguments ``resource``, ``limits``." +msgstr "" + +msgid "" +"Combines :func:`setrlimit` and :func:`getrlimit` in one function and " +"supports to get and set the resources limits of an arbitrary process. If " +"*pid* is 0, then the call applies to the current process. *resource* and " +"*limits* have the same meaning as in :func:`setrlimit`, except that *limits* " +"is optional." +msgstr "" + +msgid "" +"When *limits* is not given the function returns the *resource* limit of the " +"process *pid*. When *limits* is given the *resource* limit of the process is " +"set and the former resource limit is returned." +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." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``resource.prlimit`` with " +"arguments ``pid``, ``resource``, ``limits``." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.36 with glibc >= 2.13." +msgstr "" + +msgid "" +"These symbols define resources whose consumption can be controlled using " +"the :func:`setrlimit` and :func:`getrlimit` functions described below. The " +"values of these symbols are exactly the constants used by C programs." +msgstr "" + +msgid "" +"The Unix man page for :manpage:`getrlimit(2)` lists the available resources. " +"Note that not all systems use the same symbol or same value to denote the " +"same resource. This module does not attempt to mask platform differences " +"--- symbols not defined for a platform will not be available from this " +"module on that platform." +msgstr "" + +msgid "" +"The maximum size (in bytes) of a core file that the current process can " +"create. This may result in the creation of a partial core file if a larger " +"core would be required to contain the entire process image." +msgstr "" + +msgid "" +"The maximum amount of processor time (in seconds) that a process can use. If " +"this limit is exceeded, a :const:`SIGXCPU` signal is sent to the process. " +"(See the :mod:`signal` module documentation for information about how to " +"catch this signal and do something useful, e.g. flush open files to disk.)" +msgstr "" + +msgid "The maximum size of a file which the process may create." +msgstr "" + +msgid "The maximum size (in bytes) of the process's heap." +msgstr "" + +msgid "" +"The maximum size (in bytes) of the call stack for the current process. This " +"only affects the stack of the main thread in a multi-threaded process." +msgstr "" + +msgid "" +"The maximum resident set size that should be made available to the process." +msgstr "" + +msgid "The maximum number of processes the current process may create." +msgstr "" + +msgid "The maximum number of open file descriptors for the current process." +msgstr "" + +msgid "The BSD name for :const:`RLIMIT_NOFILE`." +msgstr "" + +msgid "The maximum address space which may be locked in memory." +msgstr "" + +msgid "The largest area of mapped memory which the process may occupy." +msgstr "" + +msgid ":ref:`Availability `: FreeBSD >= 11." +msgstr "" + +msgid "" +"The maximum area (in bytes) of address space which may be taken by the " +"process." +msgstr "" + +msgid "The number of bytes that can be allocated for POSIX message queues." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.8." +msgstr "" + +msgid "The ceiling for the process's nice level (calculated as 20 - rlim_cur)." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.12." +msgstr "" + +msgid "The ceiling of the real-time priority." +msgstr "" + +msgid "" +"The time limit (in microseconds) on CPU time that a process can spend under " +"real-time scheduling without making a blocking syscall." +msgstr "" + +msgid ":ref:`Availability `: Linux >= 2.6.25." +msgstr "" + +msgid "The number of signals which the process may queue." +msgstr "" + +msgid "" +"The maximum size (in bytes) of socket buffer usage for this user. This " +"limits the amount of network memory, and hence the amount of mbufs, that " +"this user may hold at any time." +msgstr "" + +msgid ":ref:`Availability `: FreeBSD." +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." +msgstr "" + +msgid "The maximum number of pseudo-terminals created by this user id." +msgstr "" + +msgid "The maximum number of kqueues this user id is allowed to create." +msgstr "" + +msgid "Resource Usage" +msgstr "" + +msgid "These functions are used to retrieve resource usage information:" +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." +msgstr "" + +msgid "A simple example::" +msgstr "" + +msgid "" +"The fields of the return value each describe how a particular system " +"resource has been used, e.g. amount of time spent running is user mode or " +"number of times the process was swapped out of main memory. Some values are " +"dependent on the clock tick internal, e.g. the amount of memory the process " +"is using." +msgstr "" + +msgid "" +"For backward compatibility, the return value is also accessible as a tuple " +"of 16 elements." +msgstr "" + +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:" +msgstr "" + +msgid "Index" +msgstr "" + +msgid "Field" +msgstr "Pole" + +msgid "Resource" +msgstr "" + +msgid "``0``" +msgstr "``0``" + +msgid ":attr:`ru_utime`" +msgstr ":attr:`ru_utime`" + +msgid "time in user mode (float seconds)" +msgstr "" + +msgid "``1``" +msgstr "``1``" + +msgid ":attr:`ru_stime`" +msgstr ":attr:`ru_stime`" + +msgid "time in system mode (float seconds)" +msgstr "" + +msgid "``2``" +msgstr "``2``" + +msgid ":attr:`ru_maxrss`" +msgstr ":attr:`ru_maxrss`" + +msgid "maximum resident set size" +msgstr "" + +msgid "``3``" +msgstr "``3``" + +msgid ":attr:`ru_ixrss`" +msgstr ":attr:`ru_ixrss`" + +msgid "shared memory size" +msgstr "" + +msgid "``4``" +msgstr "``4``" + +msgid ":attr:`ru_idrss`" +msgstr ":attr:`ru_idrss`" + +msgid "unshared memory size" +msgstr "" + +msgid "``5``" +msgstr "``5``" + +msgid ":attr:`ru_isrss`" +msgstr ":attr:`ru_isrss`" + +msgid "unshared stack size" +msgstr "" + +msgid "``6``" +msgstr "``6``" + +msgid ":attr:`ru_minflt`" +msgstr ":attr:`ru_minflt`" + +msgid "page faults not requiring I/O" +msgstr "" + +msgid "``7``" +msgstr "``7``" + +msgid ":attr:`ru_majflt`" +msgstr ":attr:`ru_majflt`" + +msgid "page faults requiring I/O" +msgstr "" + +msgid "``8``" +msgstr "``8``" + +msgid ":attr:`ru_nswap`" +msgstr ":attr:`ru_nswap`" + +msgid "number of swap outs" +msgstr "" + +msgid "``9``" +msgstr "``9``" + +msgid ":attr:`ru_inblock`" +msgstr ":attr:`ru_inblock`" + +msgid "block input operations" +msgstr "" + +msgid "``10``" +msgstr "``10``" + +msgid ":attr:`ru_oublock`" +msgstr ":attr:`ru_oublock`" + +msgid "block output operations" +msgstr "" + +msgid "``11``" +msgstr "``11``" + +msgid ":attr:`ru_msgsnd`" +msgstr ":attr:`ru_msgsnd`" + +msgid "messages sent" +msgstr "" + +msgid "``12``" +msgstr "``12``" + +msgid ":attr:`ru_msgrcv`" +msgstr ":attr:`ru_msgrcv`" + +msgid "messages received" +msgstr "" + +msgid "``13``" +msgstr "``13``" + +msgid ":attr:`ru_nsignals`" +msgstr ":attr:`ru_nsignals`" + +msgid "signals received" +msgstr "" + +msgid "``14``" +msgstr "``14``" + +msgid ":attr:`ru_nvcsw`" +msgstr ":attr:`ru_nvcsw`" + +msgid "voluntary context switches" +msgstr "" + +msgid "``15``" +msgstr "``15``" + +msgid ":attr:`ru_nivcsw`" +msgstr ":attr:`ru_nivcsw`" + +msgid "involuntary context switches" +msgstr "" + +msgid "" +"This function will raise a :exc:`ValueError` if an invalid *who* parameter " +"is specified. It may also raise :exc:`error` exception in unusual " +"circumstances." +msgstr "" + +msgid "" +"Returns the number of bytes in a system page. (This need not be the same as " +"the hardware page size.)" +msgstr "" + +msgid "" +"The following :const:`!RUSAGE_\\*` symbols are passed to the :func:" +"`getrusage` function to specify which processes information should be " +"provided for." +msgstr "" + +msgid "" +"Pass to :func:`getrusage` to request resources consumed by the calling " +"process, which is the sum of resources used by all threads in the process." +msgstr "" + +msgid "" +"Pass to :func:`getrusage` to request resources consumed by child processes " +"of the calling process which have been terminated and waited for." +msgstr "" + +msgid "" +"Pass to :func:`getrusage` to request resources consumed by both the current " +"process and child processes. May not be available on all systems." +msgstr "" + +msgid "" +"Pass to :func:`getrusage` to request resources consumed by the current " +"thread. May not be available on all systems." +msgstr "" diff --git a/library/rlcompleter.po b/library/rlcompleter.po new file mode 100644 index 0000000000..fa6a329aa8 --- /dev/null +++ b/library/rlcompleter.po @@ -0,0 +1,85 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`rlcompleter` --- Completion function for GNU readline" +msgstr "" + +msgid "**Source code:** :source:`Lib/rlcompleter.py`" +msgstr "" + +msgid "" +"The :mod:`!rlcompleter` module defines a completion function suitable to be " +"passed to :func:`~readline.set_completer` in the :mod:`readline` module." +msgstr "" + +msgid "" +"When this module is imported on a Unix platform with the :mod:`readline` " +"module available, an instance of the :class:`Completer` class is " +"automatically created and its :meth:`~Completer.complete` method is set as " +"the :ref:`readline completer `. The method provides " +"completion of valid Python :ref:`identifiers and keywords `." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +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`)." +msgstr "" + +msgid "" +"On platforms without :mod:`readline`, the :class:`Completer` class defined " +"by this module can still be used for custom purposes." +msgstr "" + +msgid "Completer objects have the following method:" +msgstr "" + +msgid "Return the next possible completion for *text*." +msgstr "" + +msgid "" +"When called by the :mod:`readline` module, this method is called " +"successively with ``state == 0, 1, 2, ...`` until the method returns " +"``None``." +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)." +msgstr "" + +msgid "" +"If called for a dotted name, it will try to evaluate anything without " +"obvious side-effects (functions will not be evaluated, but it can generate " +"calls to :meth:`~object.__getattr__`) up to the last part, and find matches " +"for the rest via the :func:`dir` function. Any exception raised during the " +"evaluation of the expression is caught, silenced and :const:`None` is " +"returned." +msgstr "" diff --git a/library/runpy.po b/library/runpy.po index 6738d9ff25..3888d0481b 100644 --- a/library/runpy.po +++ b/library/runpy.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 "" "The *mod_name* argument should be an absolute module name. If the module " "name refers to a package rather than a normal module, then that package is " -"imported and the ``__main__`` submodule within that package is then executed " -"and the resulting module globals dictionary returned." +"imported and the :mod:`__main__` submodule within that package is then " +"executed and the resulting module globals dictionary returned." msgstr "" msgid "" @@ -110,7 +110,7 @@ msgstr "" msgid "" "Note that this manipulation of :mod:`sys` is not thread-safe. Other threads " "may see the partially initialised module, as well as the altered list of " -"arguments. It is recommended that the :mod:`sys` module be left alone when " +"arguments. It is recommended that the ``sys`` module be left alone when " "invoking this function from threaded code." msgstr "" @@ -120,7 +120,7 @@ msgid "" msgstr "" msgid "" -"Added ability to execute packages by looking for a ``__main__`` submodule." +"Added ability to execute packages by looking for a :mod:`__main__` submodule." msgstr "" msgid "Added ``__cached__`` global variable (see :pep:`3147`)." @@ -137,18 +137,19 @@ msgid "" "Execute the code at the named filesystem location and return the resulting " "module globals dictionary. As with a script name supplied to the CPython " "command line, the supplied path may refer to a Python source file, a " -"compiled bytecode file or a valid sys.path entry containing a ``__main__`` " -"module (e.g. a zipfile containing a top-level ``__main__.py`` file)." +"compiled bytecode file or a valid :data:`sys.path` entry containing a :mod:" +"`__main__` module (e.g. a zipfile containing a top-level ``__main__.py`` " +"file)." msgstr "" msgid "" "For a simple script, the specified code is simply executed in a fresh module " -"namespace. For a valid sys.path entry (typically a zipfile or directory), " -"the entry is first added to the beginning of ``sys.path``. The function then " -"looks for and executes a :mod:`__main__` module using the updated path. Note " -"that there is no special protection against invoking an existing :mod:" -"`__main__` entry located elsewhere on ``sys.path`` if there is no such " -"module at the specified location." +"namespace. For a valid :data:`sys.path` entry (typically a zipfile or " +"directory), the entry is first added to the beginning of ``sys.path``. The " +"function then looks for and executes a :mod:`__main__` module using the " +"updated path. Note that there is no special protection against invoking an " +"existing ``__main__`` entry located elsewhere on ``sys.path`` if there is no " +"such module at the specified location." msgstr "" msgid "" @@ -172,18 +173,18 @@ msgid "" msgstr "" msgid "" -"If the supplied path is a reference to a valid sys.path entry, then " -"``__spec__`` will be set appropriately for the imported ``__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." +"If the supplied 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." msgstr "" msgid "" -"A number of alterations are also made to the :mod:`sys` module. Firstly, " -"``sys.path`` may be altered as described above. ``sys.argv[0]`` is updated " -"with the value of ``path_name`` and ``sys.modules[__name__]`` is updated " -"with a temporary module object for the module being executed. All " +"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 ``path_name`` 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." msgstr "" @@ -191,9 +192,9 @@ msgstr "" msgid "" "Note that, unlike :func:`run_module`, the alterations made to :mod:`sys` are " "not optional in this function as these adjustments are essential to allowing " -"the execution of sys.path entries. As the thread-safety limitations still " -"apply, use of this function in threaded code should be either serialised " -"with the import lock or delegated to a separate process." +"the execution of :data:`sys.path` entries. As the thread-safety limitations " +"still apply, use of this function in threaded code should be either " +"serialised with the import lock or delegated to a separate process." msgstr "" msgid "" @@ -204,8 +205,8 @@ msgstr "" msgid "" "Updated to take advantage of the module spec feature added by :pep:`451`. " "This allows ``__cached__`` to be set correctly in the case where " -"``__main__`` is imported from a valid sys.path entry rather than being " -"executed directly." +"``__main__`` is imported from a valid :data:`sys.path` entry rather than " +"being executed directly." msgstr "" msgid ":pep:`338` -- Executing modules as scripts" @@ -233,4 +234,4 @@ msgid "module" msgstr "moduł" msgid "__main__" -msgstr "" +msgstr "__main__" diff --git a/library/sched.po b/library/sched.po new file mode 100644 index 0000000000..fa3d9f91f5 --- /dev/null +++ b/library/sched.po @@ -0,0 +1,138 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`sched` --- Event scheduler" +msgstr "" + +msgid "**Source code:** :source:`Lib/sched.py`" +msgstr "" + +msgid "" +"The :mod:`sched` module defines a class which implements a general purpose " +"event scheduler:" +msgstr "" + +msgid "" +"The :class:`scheduler` class defines a generic interface to scheduling " +"events. It needs two functions to actually deal with the \"outside world\" " +"--- *timefunc* should be callable without arguments, and return a number " +"(the \"time\", in any units whatsoever). The *delayfunc* function should be " +"callable with one argument, compatible with the output of *timefunc*, and " +"should delay that many time units. *delayfunc* will also be called with the " +"argument ``0`` after each event is run to allow other threads an opportunity " +"to run in multi-threaded applications." +msgstr "" + +msgid "*timefunc* and *delayfunc* parameters are optional." +msgstr "" + +msgid "" +":class:`scheduler` class can be safely used in multi-threaded environments." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "Scheduler Objects" +msgstr "" + +msgid ":class:`scheduler` instances have the following methods and attributes:" +msgstr "" + +msgid "" +"Schedule a new event. The *time* argument should be a numeric type " +"compatible with the return value of the *timefunc* function passed to the " +"constructor. Events scheduled for the same *time* will be executed in the " +"order of their *priority*. A lower number represents a higher priority." +msgstr "" + +msgid "" +"Executing the event means executing ``action(*argument, **kwargs)``. " +"*argument* is a sequence holding the positional arguments for *action*. " +"*kwargs* is a dictionary holding the keyword arguments for *action*." +msgstr "" + +msgid "" +"Return value is an event which may be used for later cancellation of the " +"event (see :meth:`cancel`)." +msgstr "" + +msgid "*argument* parameter is optional." +msgstr "" + +msgid "*kwargs* parameter was added." +msgstr "" + +msgid "" +"Schedule an event for *delay* more time units. Other than the relative time, " +"the other arguments, the effect and the return value are the same as those " +"for :meth:`enterabs`." +msgstr "" + +msgid "" +"Remove the event from the queue. If *event* is not an event currently in the " +"queue, this method will raise a :exc:`ValueError`." +msgstr "" + +msgid "Return ``True`` if the event queue is empty." +msgstr "" + +msgid "" +"Run all scheduled events. This method will wait (using the *delayfunc* " +"function passed to the constructor) for the next event, then execute it and " +"so on until there are no more scheduled events." +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)." +msgstr "" + +msgid "" +"Either *action* or *delayfunc* can raise an exception. In either case, the " +"scheduler will maintain a consistent state and propagate the exception. If " +"an exception is raised by *action*, the event will not be attempted in " +"future calls to :meth:`run`." +msgstr "" + +msgid "" +"If a sequence of events takes longer to run than the time available before " +"the next event, the scheduler will simply fall behind. No events will be " +"dropped; the calling code is responsible for canceling events which are no " +"longer pertinent." +msgstr "" + +msgid "*blocking* parameter was added." +msgstr "" + +msgid "" +"Read-only attribute returning a list of upcoming events in the order they " +"will be run. Each event is shown as a :term:`named tuple` with the " +"following fields: time, priority, action, argument, kwargs." +msgstr "" + +msgid "event scheduling" +msgstr "" diff --git a/library/select.po b/library/select.po index d045f1b20b..27fb2dfbc1 100644 --- a/library/select.po +++ b/library/select.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2021, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# m_aciek , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.10\n" +"Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-06-29 12:56+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: m_aciek , 2021\n" -"Language-Team: Polish (https://www.transifex.com/python-doc/teams/5390/pl/)\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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" @@ -27,13 +27,13 @@ msgid ":mod:`select` --- Waiting for I/O completion" 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." +"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." msgstr "" msgid "" @@ -43,6 +43,15 @@ msgid "" "precise control over the OS-level primitives used." msgstr "" +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + msgid "The module defines the following:" msgstr "" @@ -59,10 +68,10 @@ msgid "" msgstr "" msgid "" -":c:func:`devpoll` objects are linked to the number of file descriptors " +":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." +"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 `." @@ -78,8 +87,8 @@ msgstr "" msgid "" "*sizehint* informs epoll about the expected number of events to be " -"registered. It must be positive, or `-1` to use the default. It is only " -"used on older systems where :c:func:`epoll_create1` is not available; " +"registered. It must be positive, or ``-1`` to use the default. It is only " +"used on older systems where :c:func:`!epoll_create1` is not available; " "otherwise it has no effect (though its value is still checked)." msgstr "" @@ -131,7 +140,7 @@ msgid "" msgstr "" msgid "" -"This is a straightforward interface to the Unix :c:func:`select` system " +"This is a straightforward interface to the Unix :c:func:`!select` system " "call. The first three arguments are iterables of 'waitable objects': either " "integers representing file descriptors or objects with a parameterless " "method named :meth:`~io.IOBase.fileno` returning such an integer:" @@ -174,8 +183,9 @@ msgstr "" msgid "" "File objects on Windows are not acceptable, but sockets are. On Windows, " -"the underlying :c:func:`select` function is provided by the WinSock library, " -"and does not handle file descriptors that don't originate from WinSock." +"the underlying :c:func:`!select` function is provided by the WinSock " +"library, and does not handle file descriptors that don't originate from " +"WinSock." msgstr "" msgid "" @@ -187,7 +197,7 @@ 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 " +"select`, :func:`!poll` or another interface in this module. This doesn't " "apply to other kind of file-like objects such as sockets." msgstr "" @@ -201,13 +211,13 @@ msgid "``/dev/poll`` Polling Objects" msgstr "" msgid "" -"Solaris and derivatives have ``/dev/poll``. While :c:func:`select` is " -"O(highest file descriptor) and :c:func:`poll` is O(number of file " -"descriptors), ``/dev/poll`` is O(active file descriptors)." +"Solaris and derivatives have ``/dev/poll``. While :c:func:`!select` is *O*\\ " +"(*highest file descriptor*) and :c:func:`!poll` is *O*\\ (*number of file " +"descriptors*), ``/dev/poll`` is *O*\\ (*active file descriptors*)." msgstr "" msgid "" -"``/dev/poll`` behaviour is very close to the standard :c:func:`poll` object." +"``/dev/poll`` behaviour is very close to the standard :c:func:`!poll` object." msgstr "" msgid "Close the file descriptor of the polling object." @@ -229,7 +239,7 @@ msgstr "" msgid "" "*eventmask* is an optional bitmask describing the type of events you want to " -"check for. The constants are the same that with :c:func:`poll` object. The " +"check for. The constants are the same that with :c:func:`!poll` object. The " "default value is a combination of the constants :const:`POLLIN`, :const:" "`POLLPRI`, and :const:`POLLOUT`." msgstr "" @@ -237,7 +247,7 @@ msgstr "" msgid "" "Registering a file descriptor that's already registered is not an error, but " "the result is undefined. The appropriate action is to unregister or modify " -"it first. This is an important difference compared with :c:func:`poll`." +"it first. This is an important difference compared with :c:func:`!poll`." msgstr "" msgid "" @@ -257,7 +267,7 @@ msgid "" msgstr "" msgid "" -"Polls the set of registered file descriptors, and returns a possibly-empty " +"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:" @@ -273,7 +283,7 @@ msgid "Edge and Level Trigger Polling (epoll) Objects" msgstr "" msgid "https://linux.die.net/man/4/epoll" -msgstr "" +msgstr "https://linux.die.net/man/4/epoll" msgid "*eventmask*" msgstr "" @@ -285,43 +295,43 @@ msgid "Meaning" msgstr "Znaczenie" msgid ":const:`EPOLLIN`" -msgstr "" +msgstr ":const:`EPOLLIN`" msgid "Available for read" msgstr "" msgid ":const:`EPOLLOUT`" -msgstr "" +msgstr ":const:`EPOLLOUT`" msgid "Available for write" msgstr "" msgid ":const:`EPOLLPRI`" -msgstr "" +msgstr ":const:`EPOLLPRI`" msgid "Urgent data for read" msgstr "" msgid ":const:`EPOLLERR`" -msgstr "" +msgstr ":const:`EPOLLERR`" msgid "Error condition happened on the assoc. fd" msgstr "" msgid ":const:`EPOLLHUP`" -msgstr "" +msgstr ":const:`EPOLLHUP`" msgid "Hang up happened on the assoc. fd" msgstr "" msgid ":const:`EPOLLET`" -msgstr "" +msgstr ":const:`EPOLLET`" msgid "Set Edge Trigger behavior, the default is Level Trigger behavior" msgstr "" msgid ":const:`EPOLLONESHOT`" -msgstr "" +msgstr ":const:`EPOLLONESHOT`" msgid "" "Set one-shot behavior. After one event is pulled out, the fd is internally " @@ -329,7 +339,7 @@ msgid "" msgstr "" msgid ":const:`EPOLLEXCLUSIVE`" -msgstr "" +msgstr ":const:`EPOLLEXCLUSIVE`" msgid "" "Wake only one epoll object when the associated fd has an event. The default " @@ -337,38 +347,38 @@ msgid "" msgstr "" msgid ":const:`EPOLLRDHUP`" -msgstr "" +msgstr ":const:`EPOLLRDHUP`" msgid "" "Stream socket peer closed connection or shut down writing half of connection." msgstr "" msgid ":const:`EPOLLRDNORM`" -msgstr "" +msgstr ":const:`EPOLLRDNORM`" msgid "Equivalent to :const:`EPOLLIN`" msgstr "" msgid ":const:`EPOLLRDBAND`" -msgstr "" +msgstr ":const:`EPOLLRDBAND`" msgid "Priority data band can be read." msgstr "" msgid ":const:`EPOLLWRNORM`" -msgstr "" +msgstr ":const:`EPOLLWRNORM`" msgid "Equivalent to :const:`EPOLLOUT`" msgstr "" msgid ":const:`EPOLLWRBAND`" -msgstr "" +msgstr ":const:`EPOLLWRBAND`" msgid "Priority data may be written." msgstr "" msgid ":const:`EPOLLMSG`" -msgstr "" +msgstr ":const:`EPOLLMSG`" msgid "Ignored." msgstr "" @@ -409,14 +419,14 @@ msgid "Polling Objects" msgstr "" msgid "" -"The :c:func:`poll` system call, supported on most Unix systems, provides " +"The :c:func:`!poll` system call, supported on most Unix systems, provides " "better scalability for network servers that service many, many clients at " -"the same time. :c:func:`poll` scales better because the system call only " -"requires listing the file descriptors of interest, while :c:func:`select` " +"the same time. :c:func:`!poll` scales better because the system call only " +"requires listing the file descriptors of interest, while :c:func:`!select` " "builds a bitmap, turns on bits for the fds of interest, and then afterward " -"the whole bitmap has to be linearly scanned again. :c:func:`select` is " -"O(highest file descriptor), while :c:func:`poll` is O(number of file " -"descriptors)." +"the whole bitmap has to be linearly scanned again. :c:func:`!select` is " +"*O*\\ (*highest file descriptor*), while :c:func:`!poll` is *O*\\ (*number " +"of file descriptors*)." msgstr "" msgid "" @@ -427,44 +437,44 @@ msgid "" msgstr "" msgid ":const:`POLLIN`" -msgstr "" +msgstr ":const:`POLLIN`" msgid "There is data to read" msgstr "" msgid ":const:`POLLPRI`" -msgstr "" +msgstr ":const:`POLLPRI`" msgid "There is urgent data to read" msgstr "" msgid ":const:`POLLOUT`" -msgstr "" +msgstr ":const:`POLLOUT`" msgid "Ready for output: writing will not block" msgstr "" msgid ":const:`POLLERR`" -msgstr "" +msgstr ":const:`POLLERR`" msgid "Error condition of some sort" msgstr "" msgid ":const:`POLLHUP`" -msgstr "" +msgstr ":const:`POLLHUP`" msgid "Hung up" msgstr "" msgid ":const:`POLLRDHUP`" -msgstr "" +msgstr ":const:`POLLRDHUP`" msgid "" "Stream socket peer closed connection, or shut down writing half of connection" msgstr "" msgid ":const:`POLLNVAL`" -msgstr "" +msgstr ":const:`POLLNVAL`" msgid "Invalid request: descriptor not open" msgstr "" @@ -487,7 +497,7 @@ msgid "" msgstr "" msgid "" -"Polls the set of registered file descriptors, and returns a possibly-empty " +"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:" @@ -528,8 +538,8 @@ msgstr "" msgid "Kevent Objects" msgstr "" -msgid "https://www.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2" -msgstr "" +msgid "https://man.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2" +msgstr "https://man.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2" msgid "" "Value used to identify the event. The interpretation depends on the filter " @@ -542,51 +552,51 @@ msgid "Name of the kernel filter." msgstr "" msgid ":const:`KQ_FILTER_READ`" -msgstr "" +msgstr ":const:`KQ_FILTER_READ`" msgid "Takes a descriptor and returns whenever there is data available to read" msgstr "" msgid ":const:`KQ_FILTER_WRITE`" -msgstr "" +msgstr ":const:`KQ_FILTER_WRITE`" msgid "" "Takes a descriptor and returns whenever there is data available to write" msgstr "" msgid ":const:`KQ_FILTER_AIO`" -msgstr "" +msgstr ":const:`KQ_FILTER_AIO`" msgid "AIO requests" msgstr "" msgid ":const:`KQ_FILTER_VNODE`" -msgstr "" +msgstr ":const:`KQ_FILTER_VNODE`" msgid "" "Returns when one or more of the requested events watched in *fflag* occurs" msgstr "" msgid ":const:`KQ_FILTER_PROC`" -msgstr "" +msgstr ":const:`KQ_FILTER_PROC`" msgid "Watch for events on a process id" msgstr "" msgid ":const:`KQ_FILTER_NETDEV`" -msgstr "" +msgstr ":const:`KQ_FILTER_NETDEV`" -msgid "Watch for events on a network device [not available on Mac OS X]" +msgid "Watch for events on a network device [not available on macOS]" msgstr "" msgid ":const:`KQ_FILTER_SIGNAL`" -msgstr "" +msgstr ":const:`KQ_FILTER_SIGNAL`" msgid "Returns whenever the watched signal is delivered to the process" msgstr "" msgid ":const:`KQ_FILTER_TIMER`" -msgstr "" +msgstr ":const:`KQ_FILTER_TIMER`" msgid "Establishes an arbitrary timer" msgstr "" @@ -595,58 +605,58 @@ msgid "Filter action." msgstr "" msgid ":const:`KQ_EV_ADD`" -msgstr "" +msgstr ":const:`KQ_EV_ADD`" msgid "Adds or modifies an event" msgstr "" msgid ":const:`KQ_EV_DELETE`" -msgstr "" +msgstr ":const:`KQ_EV_DELETE`" msgid "Removes an event from the queue" msgstr "" msgid ":const:`KQ_EV_ENABLE`" -msgstr "" +msgstr ":const:`KQ_EV_ENABLE`" msgid "Permitscontrol() to returns the event" msgstr "" msgid ":const:`KQ_EV_DISABLE`" -msgstr "" +msgstr ":const:`KQ_EV_DISABLE`" msgid "Disablesevent" msgstr "" msgid ":const:`KQ_EV_ONESHOT`" -msgstr "" +msgstr ":const:`KQ_EV_ONESHOT`" msgid "Removes event after first occurrence" msgstr "" msgid ":const:`KQ_EV_CLEAR`" -msgstr "" +msgstr ":const:`KQ_EV_CLEAR`" msgid "Reset the state after an event is retrieved" msgstr "" msgid ":const:`KQ_EV_SYSFLAGS`" -msgstr "" +msgstr ":const:`KQ_EV_SYSFLAGS`" msgid "internal event" msgstr "" msgid ":const:`KQ_EV_FLAG1`" -msgstr "" +msgstr ":const:`KQ_EV_FLAG1`" msgid ":const:`KQ_EV_EOF`" -msgstr "" +msgstr ":const:`KQ_EV_EOF`" msgid "Filter specific EOF condition" msgstr "" msgid ":const:`KQ_EV_ERROR`" -msgstr "" +msgstr ":const:`KQ_EV_ERROR`" msgid "See return values" msgstr "" @@ -658,7 +668,7 @@ msgid ":const:`KQ_FILTER_READ` and :const:`KQ_FILTER_WRITE` filter flags:" msgstr "" msgid ":const:`KQ_NOTE_LOWAT`" -msgstr "" +msgstr ":const:`KQ_NOTE_LOWAT`" msgid "low water mark of a socket buffer" msgstr "" @@ -667,43 +677,43 @@ msgid ":const:`KQ_FILTER_VNODE` filter flags:" msgstr "" msgid ":const:`KQ_NOTE_DELETE`" -msgstr "" +msgstr ":const:`KQ_NOTE_DELETE`" msgid "*unlink()* was called" msgstr "" msgid ":const:`KQ_NOTE_WRITE`" -msgstr "" +msgstr ":const:`KQ_NOTE_WRITE`" msgid "a write occurred" msgstr "" msgid ":const:`KQ_NOTE_EXTEND`" -msgstr "" +msgstr ":const:`KQ_NOTE_EXTEND`" msgid "the file was extended" msgstr "" msgid ":const:`KQ_NOTE_ATTRIB`" -msgstr "" +msgstr ":const:`KQ_NOTE_ATTRIB`" msgid "an attribute was changed" msgstr "" msgid ":const:`KQ_NOTE_LINK`" -msgstr "" +msgstr ":const:`KQ_NOTE_LINK`" msgid "the link count has changed" msgstr "" msgid ":const:`KQ_NOTE_RENAME`" -msgstr "" +msgstr ":const:`KQ_NOTE_RENAME`" msgid "the file was renamed" msgstr "" msgid ":const:`KQ_NOTE_REVOKE`" -msgstr "" +msgstr ":const:`KQ_NOTE_REVOKE`" msgid "access to the file was revoked" msgstr "" @@ -712,67 +722,67 @@ msgid ":const:`KQ_FILTER_PROC` filter flags:" msgstr "" msgid ":const:`KQ_NOTE_EXIT`" -msgstr "" +msgstr ":const:`KQ_NOTE_EXIT`" msgid "the process has exited" msgstr "" msgid ":const:`KQ_NOTE_FORK`" -msgstr "" +msgstr ":const:`KQ_NOTE_FORK`" msgid "the process has called *fork()*" msgstr "" msgid ":const:`KQ_NOTE_EXEC`" -msgstr "" +msgstr ":const:`KQ_NOTE_EXEC`" msgid "the process has executed a new process" msgstr "" msgid ":const:`KQ_NOTE_PCTRLMASK`" -msgstr "" +msgstr ":const:`KQ_NOTE_PCTRLMASK`" msgid "internal filter flag" msgstr "" msgid ":const:`KQ_NOTE_PDATAMASK`" -msgstr "" +msgstr ":const:`KQ_NOTE_PDATAMASK`" msgid ":const:`KQ_NOTE_TRACK`" -msgstr "" +msgstr ":const:`KQ_NOTE_TRACK`" msgid "follow a process across *fork()*" msgstr "" msgid ":const:`KQ_NOTE_CHILD`" -msgstr "" +msgstr ":const:`KQ_NOTE_CHILD`" msgid "returned on the child process for *NOTE_TRACK*" msgstr "" msgid ":const:`KQ_NOTE_TRACKERR`" -msgstr "" +msgstr ":const:`KQ_NOTE_TRACKERR`" msgid "unable to attach to a child" msgstr "" -msgid ":const:`KQ_FILTER_NETDEV` filter flags (not available on Mac OS X):" +msgid ":const:`KQ_FILTER_NETDEV` filter flags (not available on macOS):" msgstr "" msgid ":const:`KQ_NOTE_LINKUP`" -msgstr "" +msgstr ":const:`KQ_NOTE_LINKUP`" msgid "link is up" msgstr "" msgid ":const:`KQ_NOTE_LINKDOWN`" -msgstr "" +msgstr ":const:`KQ_NOTE_LINKDOWN`" msgid "link is down" msgstr "" msgid ":const:`KQ_NOTE_LINKINV`" -msgstr "" +msgstr ":const:`KQ_NOTE_LINKINV`" msgid "link state is invalid" msgstr "" @@ -782,3 +792,12 @@ msgstr "" msgid "User defined value." msgstr "" + +msgid "socket() (in module socket)" +msgstr "" + +msgid "popen() (in module os)" +msgstr "" + +msgid "WinSock" +msgstr "" diff --git a/library/selectors.po b/library/selectors.po index e2bfcd3944..55c0dc200f 100644 --- a/library/selectors.po +++ b/library/selectors.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 -# Tomasz Rodzen , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Tomasz Rodzen , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +43,8 @@ msgid "" "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:`fileno()` method, or a raw file descriptor. See :term:" -"`file object`." +"object with a :meth:`~io.IOBase.fileno` method, or a raw file descriptor. " +"See :term:`file object`." msgstr "" msgid "" @@ -63,7 +61,7 @@ msgid "" msgstr "" msgid ":mod:`select`" -msgstr "" +msgstr ":mod:`select`" msgid "Low-level I/O multiplexing module." msgstr "" @@ -95,15 +93,9 @@ msgstr "Stała" msgid "Meaning" msgstr "Znaczenie" -msgid ":const:`EVENT_READ`" -msgstr "" - msgid "Available for read" msgstr "" -msgid ":const:`EVENT_WRITE`" -msgstr "" - msgid "Available for write" msgstr "" @@ -173,8 +165,8 @@ msgid "Change a registered file object's monitored events or attached data." msgstr "" msgid "" -"This is equivalent to :meth:`BaseSelector.unregister(fileobj)` followed by :" -"meth:`BaseSelector.register(fileobj, events, data)`, except that it can be " +"This is equivalent to ``BaseSelector.unregister(fileobj)`` followed by " +"``BaseSelector.register(fileobj, events, data)``, except that it can be " "implemented more efficiently." msgstr "" diff --git a/library/shelve.po b/library/shelve.po index f70cfb617a..237261c4f0 100644 --- a/library/shelve.po +++ b/library/shelve.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,9 +48,9 @@ msgid "" msgstr "" msgid "" -"By default, pickles created with :data:`pickle.DEFAULT_PROTOCOL` are used to " -"serialize values. The version of the pickle protocol can be specified with " -"the *protocol* parameter." +"By default, pickles created with :const:`pickle.DEFAULT_PROTOCOL` are used " +"to serialize values. The version of the pickle protocol can be specified " +"with the *protocol* parameter." msgstr "" msgid "" @@ -68,7 +68,7 @@ msgid "" msgstr "" msgid "" -":data:`pickle.DEFAULT_PROTOCOL` is now used as the default pickle protocol." +":const:`pickle.DEFAULT_PROTOCOL` is now used as the default pickle protocol." msgstr "" msgid "Accepts :term:`path-like object` for filename." @@ -136,15 +136,20 @@ msgid "" "implementation used." msgstr "" +msgid "" +"On macOS :mod:`dbm.ndbm` can silently corrupt the database file on updates, " +"which can cause hard crashes when trying to read from the database." +msgstr "" + msgid "" "A subclass of :class:`collections.abc.MutableMapping` which stores pickled " "values in the *dict* object." msgstr "" msgid "" -"By default, pickles created with :data:`pickle.DEFAULT_PROTOCOL` are used to " -"serialize values. The version of the pickle protocol can be specified with " -"the *protocol* parameter. See the :mod:`pickle` documentation for a " +"By default, pickles created with :const:`pickle.DEFAULT_PROTOCOL` are used " +"to serialize values. The version of the pickle protocol can be specified " +"with the *protocol* parameter. See the :mod:`pickle` documentation for a " "discussion of the pickle protocols." msgstr "" @@ -174,13 +179,13 @@ msgid "Added context manager support." msgstr "" msgid "" -"A subclass of :class:`Shelf` which exposes :meth:`first`, :meth:`!next`, :" -"meth:`previous`, :meth:`last` and :meth:`set_location` which 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*, " +"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 "" @@ -195,7 +200,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "" "To summarize the interface (``key`` is a string, ``data`` is an arbitrary " @@ -209,7 +214,7 @@ msgid "Generic interface to ``dbm``-style databases." msgstr "" msgid "Module :mod:`pickle`" -msgstr "" +msgstr "moduł :mod:`pickle`" msgid "Object serialization used by :mod:`shelve`." msgstr "" diff --git a/library/site.po b/library/site.po index 06e7ad5388..a7eb3e503e 100644 --- a/library/site.po +++ b/library/site.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +40,7 @@ msgid "" "path and add a few builtins, unless :option:`-S` was used. In that case, " "this module can be safely imported with no automatic modifications to the " "module search path or additions to the builtins. To explicitly trigger the " -"usual site-specific additions, call the :func:`site.main` function." +"usual site-specific additions, call the :func:`main` function." msgstr "" msgid "" @@ -120,27 +119,34 @@ msgid "" "because it is not mentioned in either path configuration file." msgstr "" +msgid ":mod:`sitecustomize`" +msgstr ":mod:`sitecustomize`" + msgid "" "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:`name` attribute equals to " -"``'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." +"its subclass exception, and the exception's :attr:`~ImportError.name` " +"attribute equals to ``'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." msgstr "" +msgid ":mod:`usercustomize`" +msgstr ":mod:`usercustomize`" + msgid "" "After this, an attempt is made to import a module named :mod:" "`usercustomize`, which can perform arbitrary user-specific customizations, " -"if :data:`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:`name` " -"attribute equals to ``'usercustomize'``, it is silently ignored." +"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 to ``'usercustomize'``, it is silently " +"ignored." msgstr "" msgid "" @@ -197,7 +203,7 @@ msgid "" "` for macOS framework builds, and :file:`{%APPDATA%}\\\\Python` for " "Windows. This value is used by Distutils to compute the installation " "directories for scripts, data files, Python modules, etc. for the :ref:`user " -"installation scheme `. See also :envvar:" +"installation scheme `. See also :envvar:" "`PYTHONUSERBASE`." msgstr "" @@ -286,7 +292,7 @@ msgid "directory" msgstr "" msgid "# (hash)" -msgstr "# (kratka)" +msgstr "# (hash)" msgid "comment" msgstr "komentarz" @@ -295,19 +301,13 @@ msgid "statement" msgstr "instrukcja" msgid "import" -msgstr "" +msgstr "import" msgid "package" -msgstr "" +msgstr "pakiet" msgid "configuration" msgstr "" msgid "file" -msgstr "" - -msgid "sitecustomize" -msgstr "" - -msgid "usercustomize" -msgstr "" +msgstr "plik" diff --git a/library/smtpd.po b/library/smtpd.po index aa43cabb18..97d65b545f 100644 --- a/library/smtpd.po +++ b/library/smtpd.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/smtplib.po b/library/smtplib.po new file mode 100644 index 0000000000..e808e858b9 --- /dev/null +++ b/library/smtplib.po @@ -0,0 +1,638 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`smtplib` --- SMTP protocol client" +msgstr "" + +msgid "**Source code:** :source:`Lib/smtplib.py`" +msgstr "" + +msgid "" +"The :mod:`smtplib` module defines an SMTP client session object that can be " +"used to send mail to any internet machine with an SMTP or ESMTP listener " +"daemon. For details of SMTP and ESMTP operation, consult :rfc:`821` (Simple " +"Mail Transfer Protocol) and :rfc:`1869` (SMTP Service Extensions)." +msgstr "" + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + +msgid "" +"An :class:`SMTP` instance encapsulates an SMTP connection. It has methods " +"that support a full repertoire of SMTP and ESMTP operations. If the optional " +"*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." +msgstr "" + +msgid "" +"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.::" +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``smtplib.send`` with arguments " +"``self``, ``data``." +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." +msgstr "" + +msgid "Support for the :keyword:`with` statement was added." +msgstr "" + +msgid "source_address argument was added." +msgstr "" + +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" +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:`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 "" +"*keyfile* and *certfile* are a legacy alternative to *context*, and can " +"point to a PEM formatted private key and certificate chain file for the SSL " +"connection." +msgstr "" + +msgid "*context* 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`)." +msgstr "" + +msgid "" +"*keyfile* and *certfile* are deprecated in favor of *context*. Please use :" +"meth:`ssl.SSLContext.load_cert_chain` instead, or let :func:`ssl." +"create_default_context` select the system's trusted CA certificates for you." +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:" +"`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 "" +"Authentication is supported, using the regular SMTP mechanism. When using a " +"Unix socket, LMTP generally don't support or require any authentication, but " +"your mileage might vary." +msgstr "" + +msgid "The optional *timeout* parameter was added." +msgstr "" + +msgid "A nice selection of exceptions is defined as well:" +msgstr "" + +msgid "" +"Subclass of :exc:`OSError` that is the base exception class for all the " +"other exceptions provided by this module." +msgstr "" + +msgid "SMTPException became subclass of :exc:`OSError`" +msgstr "" + +msgid "" +"This exception is raised when the server unexpectedly disconnects, or when " +"an attempt is made to use the :class:`SMTP` instance before connecting it to " +"a server." +msgstr "" + +msgid "" +"Base class for all exceptions that include an SMTP error code. These " +"exceptions are generated in some instances when the SMTP server returns an " +"error code. The error code is stored in the :attr:`smtp_code` attribute of " +"the error, and the :attr:`smtp_error` attribute is set to 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." +msgstr "" + +msgid "" +"All recipient addresses refused. The errors for each recipient are " +"accessible through the attribute :attr:`recipients`, which is a dictionary " +"of exactly the same sort as :meth:`SMTP.sendmail` returns." +msgstr "" + +msgid "The SMTP server refused to accept the message data." +msgstr "" + +msgid "Error occurred during establishment of a connection with the server." +msgstr "" + +msgid "The server refused our ``HELO`` message." +msgstr "" + +msgid "The command or option attempted is not supported by the server." +msgstr "" + +msgid "" +"SMTP authentication went wrong. Most probably the server didn't accept the " +"username/password combination provided." +msgstr "" + +msgid ":rfc:`821` - Simple Mail Transfer Protocol" +msgstr "" + +msgid "" +"Protocol definition for SMTP. This document covers the model, operating " +"procedure, and protocol details for SMTP." +msgstr "" + +msgid ":rfc:`1869` - SMTP Service Extensions" +msgstr "" + +msgid "" +"Definition of the ESMTP extensions for SMTP. This describes a framework for " +"extending SMTP with new commands, supporting dynamic discovery of the " +"commands provided by the server, and defines a few additional commands." +msgstr "" + +msgid "SMTP Objects" +msgstr "" + +msgid "An :class:`SMTP` instance has the following methods:" +msgstr "" + +msgid "" +"Set the debug output level. A value of 1 or ``True`` for *level* results in " +"debug messages for connection and for all messages sent to and received from " +"the server. A value of 2 for *level* results in these messages being " +"timestamped." +msgstr "" + +msgid "Added debuglevel 2." +msgstr "" + +msgid "" +"Send a command *cmd* to the server. The optional argument *args* is simply " +"concatenated to the command, separated by a space." +msgstr "" + +msgid "" +"This returns a 2-tuple composed of a numeric response code and the actual " +"response line (multiline responses are joined into one long line.)" +msgstr "" + +msgid "" +"In normal operation it should not be necessary to call this method " +"explicitly. It is used to implement other methods and may be useful for " +"testing private extensions." +msgstr "" + +msgid "" +"If the connection to the server is lost while waiting for the reply, :exc:" +"`SMTPServerDisconnected` will be raised." +msgstr "" + +msgid "" +"Connect to a host on a given port. The defaults are to connect to the local " +"host at the standard SMTP port (25). If the hostname ends with a colon " +"(``':'``) followed by a number, that suffix will be stripped off and the " +"number interpreted as the port number to use. This method is automatically " +"invoked by the constructor if a host is specified during instantiation. " +"Returns a 2-tuple of the response code and message sent by the server in its " +"connection response." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``smtplib.connect`` with " +"arguments ``self``, ``host``, ``port``." +msgstr "" + +msgid "" +"Identify yourself to the SMTP server using ``HELO``. The hostname argument " +"defaults to the fully qualified domain name of the local host. The message " +"returned by the server is stored as the :attr:`helo_resp` attribute of the " +"object." +msgstr "" + +msgid "" +"In normal operation it should not be necessary to call this method " +"explicitly. It will be implicitly called by the :meth:`sendmail` when " +"necessary." +msgstr "" + +msgid "" +"Identify yourself to an ESMTP server using ``EHLO``. The hostname argument " +"defaults to the fully qualified domain name of the local host. Examine the " +"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)." +msgstr "" + +msgid "" +"Unless you wish to use :meth:`has_extn` before sending mail, it should not " +"be necessary to call this method explicitly. It will be implicitly called " +"by :meth:`sendmail` when necessary." +msgstr "" + +msgid "" +"This method calls :meth:`ehlo` and/or :meth:`helo` if there has been no " +"previous ``EHLO`` or ``HELO`` command this session. It tries ESMTP ``EHLO`` " +"first." +msgstr "" + +msgid ":exc:`SMTPHeloError`" +msgstr ":exc:`SMTPHeloError`" + +msgid "The server didn't reply properly to the ``HELO`` greeting." +msgstr "" + +msgid "" +"Return :const:`True` if *name* is in the set of SMTP service extensions " +"returned by the server, :const:`False` otherwise. Case is ignored." +msgstr "" + +msgid "" +"Check the validity of an address on this server using SMTP ``VRFY``. Returns " +"a tuple consisting of code 250 and a full :rfc:`822` address (including " +"human name) if the user address is valid. Otherwise returns an SMTP error " +"code of 400 or greater and an error string." +msgstr "" + +msgid "Many sites disable SMTP ``VRFY`` in order to foil spammers." +msgstr "" + +msgid "" +"Log in on an SMTP server that requires authentication. The arguments are the " +"username and the password to authenticate with. If there has been no " +"previous ``EHLO`` or ``HELO`` command this session, this method tries ESMTP " +"``EHLO`` first. This method will return normally if the authentication was " +"successful, or may raise the following exceptions:" +msgstr "" + +msgid ":exc:`SMTPAuthenticationError`" +msgstr ":exc:`SMTPAuthenticationError`" + +msgid "The server didn't accept the username/password combination." +msgstr "" + +msgid ":exc:`SMTPNotSupportedError`" +msgstr ":exc:`SMTPNotSupportedError`" + +msgid "The ``AUTH`` command is not supported by the server." +msgstr "" + +msgid ":exc:`SMTPException`" +msgstr ":exc:`SMTPException`" + +msgid "No suitable authentication method was found." +msgstr "" + +msgid "" +"Each of the authentication methods supported by :mod:`smtplib` are tried in " +"turn if they are advertised as supported by the server. See :meth:`auth` " +"for a list of supported authentication methods. *initial_response_ok* is " +"passed through to :meth:`auth`." +msgstr "" + +msgid "" +"Optional keyword argument *initial_response_ok* specifies whether, for " +"authentication methods that support it, an \"initial response\" as specified " +"in :rfc:`4954` can be sent along with the ``AUTH`` command, rather than " +"requiring a challenge/response." +msgstr "" + +msgid "" +":exc:`SMTPNotSupportedError` may be raised, and the *initial_response_ok* " +"parameter was added." +msgstr "" + +msgid "" +"Issue an ``SMTP`` ``AUTH`` command for the specified authentication " +"*mechanism*, and handle the challenge response via *authobject*." +msgstr "" + +msgid "" +"*mechanism* specifies which authentication mechanism is to be used as " +"argument to the ``AUTH`` command; the valid values are those listed in the " +"``auth`` element of :attr:`esmtp_features`." +msgstr "" + +msgid "" +"*authobject* must be a callable object taking an optional single argument:" +msgstr "" + +msgid "data = authobject(challenge=None)" +msgstr "" + +msgid "" +"If optional keyword argument *initial_response_ok* is true, ``authobject()`` " +"will be called first with no argument. It can return the :rfc:`4954` " +"\"initial response\" ASCII ``str`` which will be encoded and sent with the " +"``AUTH`` command as below. If the ``authobject()`` does not support an " +"initial response (e.g. because it requires a challenge), it should return " +"``None`` when called with ``challenge=None``. If *initial_response_ok* is " +"false, then ``authobject()`` will not be called first with ``None``." +msgstr "" + +msgid "" +"If the initial response check returns ``None``, or if *initial_response_ok* " +"is false, ``authobject()`` will be called to process the server's challenge " +"response; the *challenge* argument it is passed will be a ``bytes``. It " +"should return ASCII ``str`` *data* that will be base64 encoded and sent to " +"the server." +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." +msgstr "" + +msgid "" +"User code does not normally need to call ``auth`` directly, but can instead " +"call the :meth:`login` method, which will try each of the above mechanisms " +"in turn, in the order listed. ``auth`` is exposed to facilitate the " +"implementation of authentication methods not (or not yet) supported directly " +"by :mod:`smtplib`." +msgstr "" + +msgid "" +"Put the SMTP connection in TLS (Transport Layer Security) mode. All SMTP " +"commands that follow will be encrypted. You should then call :meth:`ehlo` " +"again." +msgstr "" + +msgid "" +"If *keyfile* and *certfile* are provided, they are used to create an :class:" +"`ssl.SSLContext`." +msgstr "" + +msgid "" +"Optional *context* parameter is an :class:`ssl.SSLContext` object; This is " +"an alternative to using a keyfile and a certfile and if specified both " +"*keyfile* and *certfile* should be ``None``." +msgstr "" + +msgid "" +"If there has been no previous ``EHLO`` or ``HELO`` command this session, " +"this method tries ESMTP ``EHLO`` first." +msgstr "" + +msgid "The server does not support the STARTTLS extension." +msgstr "" + +msgid ":exc:`RuntimeError`" +msgstr ":exc:`RuntimeError`" + +msgid "SSL/TLS support is not available to your Python interpreter." +msgstr "" + +msgid "" +"The method now supports hostname check with :attr:`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`." +msgstr "" + +msgid "" +"Send mail. The required arguments are an :rfc:`822` from-address string, a " +"list of :rfc:`822` to-address strings (a bare string will be treated as a " +"list with 1 address), and a message string. The caller may pass a list of " +"ESMTP options (such as ``8bitmime``) to be used in ``MAIL FROM`` commands as " +"*mail_options*. ESMTP options (such as ``DSN`` commands) that should be used " +"with all ``RCPT`` commands can be passed as *rcpt_options*. (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 "" +"The *from_addr* and *to_addrs* parameters are used to construct the message " +"envelope used by the transport agents. ``sendmail`` does not modify the " +"message headers in any way." +msgstr "" + +msgid "" +"*msg* may be a string containing characters in the ASCII range, or a byte " +"string. A string is encoded to bytes using the ascii codec, and lone " +"``\\r`` and ``\\n`` characters are converted to ``\\r\\n`` characters. A " +"byte string is not modified." +msgstr "" + +msgid "" +"If there has been no previous ``EHLO`` or ``HELO`` command this session, " +"this method tries ESMTP ``EHLO`` first. If the server does ESMTP, message " +"size and each of the specified options will be passed to it (if the option " +"is in the feature set the server advertises). If ``EHLO`` fails, ``HELO`` " +"will be tried and ESMTP options suppressed." +msgstr "" + +msgid "" +"This method will return normally if the mail is accepted for at least one " +"recipient. Otherwise it will raise an exception. That is, if this method " +"does not raise an exception, then someone should get your mail. If this " +"method does not raise an exception, it returns a dictionary, with one entry " +"for each recipient that was refused. Each entry contains a tuple of the " +"SMTP error code and the accompanying error message sent by the server." +msgstr "" + +msgid "" +"If ``SMTPUTF8`` is included in *mail_options*, and the server supports it, " +"*from_addr* and *to_addrs* may contain non-ASCII characters." +msgstr "" + +msgid "This method may raise the following exceptions:" +msgstr "" + +msgid ":exc:`SMTPRecipientsRefused`" +msgstr ":exc:`SMTPRecipientsRefused`" + +msgid "" +"All recipients were refused. Nobody got the mail. The :attr:`recipients` " +"attribute of the exception object is a dictionary with information about the " +"refused recipients (like the one returned when at least one recipient was " +"accepted)." +msgstr "" + +msgid ":exc:`SMTPSenderRefused`" +msgstr ":exc:`SMTPSenderRefused`" + +msgid "The server didn't accept the *from_addr*." +msgstr "" + +msgid ":exc:`SMTPDataError`" +msgstr ":exc:`SMTPDataError`" + +msgid "" +"The server replied with an unexpected error code (other than a refusal of a " +"recipient)." +msgstr "" + +msgid "" +"``SMTPUTF8`` was given in the *mail_options* but is not supported by the " +"server." +msgstr "" + +msgid "" +"Unless otherwise noted, the connection will be open even after an exception " +"is raised." +msgstr "" + +msgid "*msg* may be a byte string." +msgstr "" + +msgid "" +"``SMTPUTF8`` support added, and :exc:`SMTPNotSupportedError` may be raised " +"if ``SMTPUTF8`` is specified but the server does not support it." +msgstr "" + +msgid "" +"This is a convenience method for calling :meth:`sendmail` with the message " +"represented by an :class:`email.message.Message` object. The arguments have " +"the same meaning as for :meth:`sendmail`, except that *msg* is a ``Message`` " +"object." +msgstr "" + +msgid "" +"If *from_addr* is ``None`` or *to_addrs* is ``None``, ``send_message`` fills " +"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:`SMTPNotSupported` " +"error 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``)." +msgstr "" + +msgid "" +"Terminate the SMTP session and close the connection. Return the result of " +"the SMTP ``QUIT`` command." +msgstr "" + +msgid "" +"Low-level methods corresponding to the standard SMTP/ESMTP commands " +"``HELP``, ``RSET``, ``NOOP``, ``MAIL``, ``RCPT``, and ``DATA`` are also " +"supported. Normally these do not need to be called directly, so they are not " +"documented here. For details, consult the module code." +msgstr "" + +msgid "SMTP Example" +msgstr "" + +msgid "" +"This example prompts the user for addresses needed in the message envelope " +"('To' and 'From' addresses), and the message to be delivered. Note that the " +"headers to be included with the message must be included in the message as " +"entered; this example doesn't do any processing of the :rfc:`822` headers. " +"In particular, the 'To' and 'From' addresses must be included in the message " +"headers explicitly. ::" +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`." +msgstr "" + +msgid "SMTP" +msgstr "" + +msgid "protocol" +msgstr "" + +msgid "Simple Mail Transfer Protocol" +msgstr "" diff --git a/library/sndhdr.po b/library/sndhdr.po index ceddf2c064..22db4ef2bd 100644 --- a/library/sndhdr.po +++ b/library/sndhdr.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -155,7 +155,7 @@ msgid "" msgstr "" msgid "Example:" -msgstr "" +msgstr "Przykład:" msgid "A-LAW" msgstr "" diff --git a/library/socket.po b/library/socket.po index 325b722b05..a94502de6a 100644 --- a/library/socket.po +++ b/library/socket.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Michał Biliński , 2021 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,11 +53,11 @@ msgstr "" msgid "" "The Python interface is a straightforward transliteration of the Unix system " "call and library interface for sockets to Python's object-oriented style: " -"the :func:`.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 operations is " -"automatic, and buffer length is implicit on send operations." +"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 " +"operations is automatic, and buffer length is implicit on send operations." msgstr "" msgid "Module :mod:`socketserver`" @@ -270,16 +269,14 @@ msgstr "" msgid "" ":const:`AF_PACKET` is a low-level interface directly to network devices. The " -"packets are represented by the tuple ``(ifname, proto[, pkttype[, hatype[, " +"addresses are represented by the tuple ``(ifname, proto[, pkttype[, hatype[, " "addr]]])`` where:" msgstr "" msgid "*ifname* - String specifying the device name." msgstr "" -msgid "" -"*proto* - An in network-byte-order integer specifying the Ethernet protocol " -"number." +msgid "*proto* - An integer specifying the Ethernet protocol number." msgstr "" msgid "*pkttype* - Optional integer specifying the packet type:" @@ -399,7 +396,7 @@ msgid "" "value is a pair ``(error, string)`` representing an error returned by a " "library call. *string* represents the description of *error*, as returned " "by the :c:func:`gai_strerror` C function. The numeric *error* value will " -"match one of the :const:`EAI_\\*` constants defined in this module." +"match one of the :const:`!EAI_\\*` constants defined in this module." msgstr "" msgid "A deprecated alias of :exc:`TimeoutError`." @@ -426,16 +423,22 @@ msgstr "" msgid "" "These constants represent the address (and protocol) families, used for the " -"first argument to :func:`.socket`. If the :const:`AF_UNIX` constant is not " -"defined then this protocol is unsupported. More constants may be available " -"depending on the system." +"first argument to :func:`~socket.socket`. If the :const:`AF_UNIX` constant " +"is not defined then this protocol is unsupported. More constants may be " +"available depending on the system." +msgstr "" + +msgid "" +":const:`AF_UNSPEC` means that :func:`getaddrinfo` should return socket " +"addresses for any address family (either IPv4, IPv6, or any other) that can " +"be used." msgstr "" msgid "" "These constants represent the socket types, used for the second argument to :" -"func:`.socket`. More constants may be available depending on the system. " -"(Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to be generally " -"useful.)" +"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 "" msgid "" @@ -455,10 +458,10 @@ 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:`setsockopt` and :meth:" -"`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 "" @@ -684,9 +687,9 @@ 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` function above. The default family is :" -"const:`AF_UNIX` if defined on the platform; otherwise, the default is :const:" -"`AF_INET`." +"number are as for the :func:`~socket.socket` function above. The default " +"family 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 `." @@ -775,14 +778,14 @@ msgstr "" msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " -"object's :meth:`fileno` method) and build a socket object from the result. " -"Address family, socket type and protocol number are as for the :func:`." -"socket` function above. 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 standard " -"input or output (such as a server started by the Unix inet daemon). The " -"socket is assumed to be in blocking mode." +"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 above. 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 " +"standard input or output (such as a server started by the Unix inet " +"daemon). The socket is assumed to be in blocking mode." msgstr "" msgid "" @@ -837,13 +840,13 @@ msgstr "" msgid "" "In these tuples, *family*, *type*, *proto* are all integers and are meant to " -"be passed to the :func:`.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." +"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." msgstr "" msgid "" @@ -893,8 +896,8 @@ msgid ":ref:`Availability `: not WASI." msgstr "" msgid "" -"Translate a host name to IPv4 address format, extended interface. Return a " -"triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the host's " +"Translate a host name to IPv4 address format, extended interface. Return a 3-" +"tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the host's " "primary host name, *aliaslist* is a (possibly empty) list of alternative " "host names for the same address, and *ipaddrlist* is a list of IPv4 " "addresses for the same interface on the same host (often but not always a " @@ -919,7 +922,7 @@ msgid "" msgstr "" msgid "" -"Return a triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " +"Return a 3-tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " "the primary host name responding to the given *ip_address*, *aliaslist* is a " "(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 " @@ -956,10 +959,10 @@ 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` " -"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 "" @@ -1166,10 +1169,10 @@ msgid "" msgstr "" msgid "UUID: ``{FB605B73-AAC2-49A6-9A2F-25416AEA0573}``" -msgstr "" +msgstr "UUID: ``{FB605B73-AAC2-49A6-9A2F-25416AEA0573}``" msgid "name: ``ethernet_32770``" -msgstr "" +msgstr "name: ``ethernet_32770``" msgid "friendly name: ``vEthernet (nat)``" msgstr "" @@ -1198,7 +1201,7 @@ 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:" -"`sendmsg` for the documentation of these parameters." +"`~socket.sendmsg` for the documentation of these parameters." msgstr "" msgid "" @@ -1208,8 +1211,8 @@ msgstr "" msgid "" "Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket " -"*sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`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 "Any truncated integers at the end of the list of file descriptors." @@ -1357,20 +1360,21 @@ msgstr "" msgid "" "Return the value of the given socket option (see the Unix man page :manpage:" -"`getsockopt(2)`). The needed symbolic constants (:const:`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)." +"`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 "" "Return ``True`` if socket is in blocking mode, ``False`` if in non-blocking." msgstr "" -msgid "This is equivalent to checking ``socket.gettimeout() == 0``." +msgid "This is equivalent to checking ``socket.gettimeout() != 0``." msgstr "" msgid "" @@ -1383,7 +1387,7 @@ msgid "platform" msgstr "" msgid "Windows" -msgstr "" +msgstr "Windows" msgid "" "The :meth:`ioctl` method is a limited interface to the WSAIoctl system " @@ -1440,7 +1444,8 @@ msgstr "" 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*. See the Unix manual page :manpage:" +"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." msgstr "" @@ -1537,7 +1542,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "" "Receive data from the socket, writing it into *buffer* instead of creating a " @@ -1690,8 +1695,8 @@ 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 the :mod:" -"`socket` module (:const:`SO_\\*` etc.). The value can be an integer, " +"`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 later " "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 " @@ -1808,18 +1813,18 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +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`, :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`, :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. ::" @@ -1830,7 +1835,7 @@ msgid "" "and IPv6. The server side will listen to the first address family available " "(it should listen to both instead). On most of IPv6-ready systems, IPv6 will " "take precedence and the server may not accept IPv4 traffic. The client side " -"will try to connect to the all addresses returned as a result of the name " +"will try to connect to all the addresses returned as a result of the name " "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" @@ -1866,7 +1871,7 @@ msgid "" msgstr "" msgid "" -"There is a :mod:`socket` flag to set, in order to prevent this, :data:" +"There is a :mod:`socket` flag to set, in order to prevent this, :const:" "`socket.SO_REUSEADDR`::" msgstr "" @@ -1900,16 +1905,16 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "socket" msgstr "" msgid "I/O control" -msgstr "" +msgstr "Kontrola I/O" msgid "buffering" -msgstr "" +msgstr "buforowanie" msgid "module" msgstr "moduł" diff --git a/library/socketserver.po b/library/socketserver.po index d38f7b4f1e..6e27223e38 100644 --- a/library/socketserver.po +++ b/library/socketserver.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -137,24 +137,29 @@ msgid "" msgstr "" msgid "" -":meth:`socketserver.ForkingMixIn.server_close` waits until all child " -"processes complete, except if :attr:`socketserver.ForkingMixIn." -"block_on_close` attribute is false." +":meth:`ForkingMixIn.server_close ` waits until all " +"child processes complete, except if :attr:`block_on_close` attribute is " +"``False``." msgstr "" msgid "" -":meth:`socketserver.ThreadingMixIn.server_close` waits until all non-daemon " -"threads complete, except if :attr:`socketserver.ThreadingMixIn." -"block_on_close` attribute is false. Use daemonic threads by setting :data:" -"`ThreadingMixIn.daemon_threads` to ``True`` to not wait until threads " -"complete." +":meth:`ThreadingMixIn.server_close ` waits until " +"all non-daemon threads complete, except if :attr:`block_on_close` attribute " +"is ``False``." msgstr "" msgid "" -":meth:`socketserver.ForkingMixIn.server_close` and :meth:`socketserver." -"ThreadingMixIn.server_close` now waits until all child processes and non-" -"daemonic threads complete. Add a new :attr:`socketserver.ForkingMixIn." -"block_on_close` class attribute to opt-in for the pre-3.7 behaviour." +"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." msgstr "" msgid "These classes are pre-defined using the mix-in classes." @@ -393,15 +398,15 @@ msgstr "" 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:`self.request`; the " -"client address as :attr:`self.client_address`; and the server instance as :" -"attr:`self.server`, in case it needs access to per-server information." +"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." msgstr "" msgid "" -"The type of :attr:`self.request` is different for datagram or stream " -"services. For stream services, :attr:`self.request` is a socket object; for " -"datagram services, :attr:`self.request` is a pair of string and socket." +"The type of :attr:`request` is different for datagram or stream services. " +"For stream services, :attr:`request` is a socket object; for datagram " +"services, :attr:`request` is a pair of string and socket." msgstr "" msgid "" @@ -410,20 +415,36 @@ msgid "" "an exception, this function will not be called." msgstr "" +msgid "" +"The *new* :class:`socket.socket` object to be used to communicate with the " +"client." +msgstr "" + +msgid "Client address returned by :meth:`BaseServer.get_request`." +msgstr "" + +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:`self.rfile` and :attr:`self.wfile` attributes. The :attr:" -"`self.rfile` and :attr:`self.wfile` attributes can be read or written, " -"respectively, to get the request data or return data to the client. The :" -"attr:`!rfile` attributes support the :class:`io.BufferedIOBase` readable " -"interface, and :attr:`!wfile` attributes support the :class:`!io." -"BufferedIOBase` writable interface." +"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." +msgstr "" + +msgid "" +"A file object to which the reply is written. Support the :class:`io." +"BufferedIOBase` writable interface" msgstr "" msgid "" -":attr:`StreamRequestHandler.wfile` also supports the :class:`io." -"BufferedIOBase` writable interface." +":attr:`wfile` also supports the :class:`io.BufferedIOBase` writable " +"interface." msgstr "" msgid "Examples" @@ -445,7 +466,8 @@ msgid "" "The difference is that the ``readline()`` call in the second handler will " "call ``recv()`` multiple times until it encounters a newline character, " "while the single ``recv()`` call in the first handler will just return what " -"has been sent from the client in one ``sendall()`` call." +"has been received so far from the client's ``sendall()`` call (typically all " +"of it, but this is not guaranteed by the TCP protocol)." msgstr "" msgid "This is the client side::" diff --git a/library/spwd.po b/library/spwd.po index a0860b788c..b646f2a4d9 100644 --- a/library/spwd.po +++ b/library/spwd.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -60,7 +61,7 @@ msgid "Index" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Meaning" msgstr "Znaczenie" @@ -93,7 +94,7 @@ msgid "Date of last change" msgstr "" msgid "3" -msgstr "" +msgstr "3" msgid "``sp_min``" msgstr "" @@ -111,7 +112,7 @@ msgid "Maximum number of days between changes" msgstr "" msgid "5" -msgstr "" +msgstr "5" msgid "``sp_warn``" msgstr "" @@ -120,7 +121,7 @@ msgid "Number of days before password expires to warn user about it" msgstr "" msgid "6" -msgstr "" +msgstr "6" msgid "``sp_inact``" msgstr "" diff --git a/library/sqlite3.po b/library/sqlite3.po index fba14bd163..f24be11a6b 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Stefan Ocetkiewicz , 2023 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +65,7 @@ msgid "" msgstr "" msgid "https://www.sqlite.org" -msgstr "" +msgstr "https://www.sqlite.org" msgid "" "The SQLite web page; the documentation describes the syntax and the " @@ -198,19 +197,19 @@ msgid ":ref:`sqlite3-howtos` for further reading:" msgstr "" msgid ":ref:`sqlite3-placeholders`" -msgstr "" +msgstr ":ref:`sqlite3-placeholders`" msgid ":ref:`sqlite3-adapters`" -msgstr "" +msgstr ":ref:`sqlite3-adapters`" msgid ":ref:`sqlite3-converters`" -msgstr "" +msgstr ":ref:`sqlite3-converters`" msgid ":ref:`sqlite3-connection-context-manager`" -msgstr "" +msgstr ":ref:`sqlite3-connection-context-manager`" msgid ":ref:`sqlite3-howto-row-factory`" -msgstr "" +msgstr ":ref:`sqlite3-howto-row-factory`" msgid "" ":ref:`sqlite3-explanation` for in-depth background on transaction control." @@ -226,11 +225,12 @@ msgid "Open a connection to an SQLite database." msgstr "" msgid "Parameters" -msgstr "" +msgstr "parametry" msgid "" -"The path to the database file to be opened. Pass ``\":memory:\"`` to open a " -"connection to a database that is in RAM instead of on disk." +"The path to the database file to be opened. You can pass ``\":memory:\"`` to " +"create an `SQLite database existing only in memory `_, and open a connection to it." msgstr "" msgid "" @@ -299,14 +299,14 @@ msgid "" "argument ``connection_handle``." msgstr "" -msgid "The *uri* parameter." +msgid "Added the *uri* parameter." msgstr "" msgid "" "*database* can now also be a :term:`path-like object`, not only a string." msgstr "" -msgid "The ``sqlite3.connect/handle`` auditing event." +msgid "Added the ``sqlite3.connect/handle`` auditing event." msgstr "" msgid "" @@ -339,14 +339,14 @@ msgid "" msgstr "" msgid "" -"Register an *adapter* callable to adapt the Python type *type* into an " -"SQLite type. The adapter is called with a Python object of type *type* as " +"Register an *adapter* :term:`callable` to adapt the Python type *type* into " +"an SQLite type. The adapter is called with a Python object of type *type* as " "its sole argument, and must return a value of a :ref:`type that SQLite " "natively understands `." msgstr "" msgid "" -"Register the *converter* callable to convert SQLite objects of type " +"Register the *converter* :term:`callable` to convert SQLite objects of type " "*typename* into a Python object of a specific type. The converter is invoked " "for all SQLite values of type *typename*; it is passed a :class:`bytes` " "object and should return an object of the desired Python type. Consult the " @@ -388,8 +388,8 @@ msgid "" msgstr "" msgid "" -"Flags that should be returned by the *authorizer_callback* callable passed " -"to :meth:`Connection.set_authorizer`, to indicate whether:" +"Flags that should be returned by the *authorizer_callback* :term:`callable` " +"passed to :meth:`Connection.set_authorizer`, to indicate whether:" msgstr "" msgid "Access is allowed (:const:`!SQLITE_OK`)," @@ -491,7 +491,7 @@ msgid "serialized" msgstr "" msgid "3" -msgstr "" +msgstr "3" msgid "Threads may share the module, connections and cursors" msgstr "" @@ -519,15 +519,15 @@ msgid "" msgstr "" msgid ":ref:`sqlite3-connection-shortcuts`" -msgstr "" +msgstr ":ref:`sqlite3-connection-shortcuts`" msgid "An SQLite database connection has the following attributes and methods:" msgstr "" msgid "" "Create and return a :class:`Cursor` object. The cursor method accepts a " -"single optional parameter *factory*. If supplied, this must be a 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 "" @@ -607,9 +607,9 @@ msgid "" msgstr "" msgid "" -"A callable that is called when the SQL function is invoked. The callable " -"must return :ref:`a type natively supported by SQLite `. Set " -"to ``None`` to remove an existing SQL function." +"A :term:`callable` that is called when the SQL function is invoked. The " +"callable must return :ref:`a type natively supported by SQLite `. Set to ``None`` to remove an existing SQL function." msgstr "" msgid "" @@ -621,11 +621,11 @@ msgstr "" msgid "If *deterministic* is used with SQLite versions older than 3.8.3." msgstr "" -msgid "The *deterministic* parameter." +msgid "Added the *deterministic* parameter." msgstr "" msgid "Example:" -msgstr "" +msgstr "Przykład:" msgid "Create or remove a user-defined SQL aggregate function." msgstr "" @@ -745,11 +745,11 @@ msgid "" msgstr "" msgid "" -"Register 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." +"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." msgstr "" msgid "" @@ -775,7 +775,7 @@ msgid "Added support for disabling the authorizer using ``None``." msgstr "" msgid "" -"Register callable *progress_handler* to be invoked for every *n* " +"Register :term:`callable` *progress_handler* to be invoked for every *n* " "instructions of the SQLite virtual machine. This is useful if you want to " "get called from SQLite during long-running operations, for example to update " "a GUI." @@ -793,8 +793,8 @@ msgid "" msgstr "" msgid "" -"Register callable *trace_callback* to be invoked for each SQL statement that " -"is actually executed by the SQLite backend." +"Register :term:`callable` *trace_callback* to be invoked for each SQL " +"statement that is actually executed by the SQLite backend." msgstr "" msgid "" @@ -859,6 +859,9 @@ msgid "" "dump`` command in the :program:`sqlite3` shell." msgstr "" +msgid ":ref:`sqlite3-howto-encoding`" +msgstr ":ref:`sqlite3-howto-encoding`" + msgid "Create a backup of an SQLite database." msgstr "" @@ -876,10 +879,10 @@ msgid "" msgstr "" msgid "" -"If set to a callable, it is invoked with three integer arguments for every " -"backup iteration: the *status* of the last iteration, the *remaining* number " -"of pages still to be copied, and the *total* number of pages. Defaults to " -"``None``." +"If set to a :term:`callable`, it is invoked with three integer arguments for " +"every backup iteration: the *status* of the last iteration, the *remaining* " +"number of pages still to be copied, and the *total* number of pages. " +"Defaults to ``None``." msgstr "" msgid "" @@ -1013,10 +1016,12 @@ msgid "See :ref:`sqlite3-howto-row-factory` for more details." msgstr "" msgid "" -"A callable that accepts a :class:`bytes` parameter and returns a text " -"representation of it. The callable is invoked for SQLite values with the " -"``TEXT`` data type. By default, this attribute is set to :class:`str`. If " -"you want to return ``bytes`` instead, set *text_factory* to ``bytes``." +"A :term:`callable` that accepts a :class:`bytes` parameter and returns a " +"text representation of it. The callable is invoked for SQLite values with " +"the ``TEXT`` data type. By default, this attribute is set to :class:`str`." +msgstr "" + +msgid "See :ref:`sqlite3-howto-encoding` for more details." msgstr "" msgid "" @@ -1044,8 +1049,8 @@ msgid "A :class:`Cursor` instance has the following attributes and methods." msgstr "" msgid "" -"Execute SQL 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." @@ -1088,7 +1093,7 @@ msgid "" msgstr "" msgid "" -"If *sql* contains more than one SQL statement, or is not a DML statment." +"If *sql* contains more than one SQL statement, or is not a DML statement." msgstr "" msgid "" @@ -1275,9 +1280,9 @@ msgstr "" msgid "" "Set the current access position of the blob to *offset*. The *origin* " -"argument defaults to :data:`os.SEEK_SET` (absolute blob positioning). Other " -"values for *origin* are :data:`os.SEEK_CUR` (seek relative to the current " -"position) and :data:`os.SEEK_END` (seek relative to the blob’s end)." +"argument defaults to :const:`os.SEEK_SET` (absolute blob positioning). Other " +"values for *origin* are :const:`os.SEEK_CUR` (seek relative to the current " +"position) and :const:`os.SEEK_END` (seek relative to the blob’s end)." msgstr "" msgid "PrepareProtocol objects" @@ -1397,28 +1402,28 @@ msgid "``None``" msgstr "``None`` - z ang. - ``Żaden``" msgid "``NULL``" -msgstr "" +msgstr "``NULL``" msgid ":class:`int`" -msgstr "" +msgstr ":class:`int`" msgid "``INTEGER``" msgstr "" msgid ":class:`float`" -msgstr "" +msgstr ":class:`float`" msgid "``REAL``" msgstr "" msgid ":class:`str`" -msgstr "" +msgstr ":class:`str`" msgid "``TEXT``" msgstr "" msgid ":class:`bytes`" -msgstr "" +msgstr ":class:`bytes`" msgid "``BLOB``" msgstr "" @@ -1630,7 +1635,8 @@ msgstr "" msgid "" "The context manager neither implicitly opens a new transaction nor closes " -"the connection." +"the connection. If you need a closing context manager, consider using :meth:" +"`contextlib.closing`." msgstr "" msgid "How to work with SQLite URIs" @@ -1681,6 +1687,13 @@ msgstr "" msgid "Queries now return :class:`!Row` objects:" msgstr "" +msgid "" +"The ``FROM`` clause can be omitted in the ``SELECT`` statement, as in the " +"above example. In such cases, SQLite returns a single row with columns " +"defined by expressions, e.g. literals, with the given aliases ``expr AS " +"alias``." +msgstr "" + msgid "" "You can create a custom :attr:`~Cursor.row_factory` that returns each row as " "a :class:`dict`, with column names mapped to values:" @@ -1702,6 +1715,39 @@ msgid "" "`~collections.namedtuple`." msgstr "" +msgid "How to handle non-UTF-8 text encodings" +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." +msgstr "" + +msgid "" +"Because of SQLite's `flexible typing`_, it is not uncommon to encounter " +"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`:" +msgstr "" + +msgid "" +"For invalid UTF-8 or arbitrary data in stored in ``TEXT`` table columns, you " +"can use the following technique, borrowed from the :ref:`unicode-howto`:" +msgstr "" + +msgid "" +"The :mod:`!sqlite3` module API does not support strings containing " +"surrogates." +msgstr "" + +msgid ":ref:`unicode-howto`" +msgstr ":ref:`unicode-howto`" + msgid "Explanation" msgstr "Wytłumaczenie" diff --git a/library/ssl.po b/library/ssl.po index 6a775b365f..374d826ddd 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Maciej Olko , 2021 -# Michał Biliński , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Michał Biliński , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 @@ msgstr "" msgid "" "Some behavior may be platform dependent, since calls are made to the " "operating system socket APIs. The installed version of OpenSSL may also " -"cause variations in behavior. For example, TLSv1.3 with OpenSSL version " -"1.1.1." +"cause variations in behavior. For example, TLSv1.3 comes with OpenSSL " +"version 1.1.1." msgstr "" msgid "" @@ -150,7 +148,7 @@ 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 :data:`~Purpose.SERVER_AUTH` as *purpose* sets :data:" +"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 " @@ -324,7 +322,7 @@ msgstr "" msgid "" "Mix the given *bytes* into the SSL pseudo-random number generator. The " "parameter *entropy* (a float) is a lower bound on the entropy contained in " -"string (so you can always use :const:`0.0`). See :rfc:`1750` for more " +"string (so you can always use ``0.0``). See :rfc:`1750` for more " "information on sources of entropy." msgstr "" @@ -469,7 +467,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid ":ref:`Availability `: Windows." msgstr "" @@ -762,8 +760,8 @@ msgid "" msgstr "" msgid "" -"The option is deprecated since OpenSSL 1.1.0. It was added to 2.7.15, 3.6.3 " -"and 3.7.0 for backwards compatibility with OpenSSL 1.0.2." +"The option is deprecated since OpenSSL 1.1.0. It was added to 2.7.15 and " +"3.6.3 for backwards compatibility with OpenSSL 1.0.2." msgstr "" msgid "" @@ -1490,9 +1488,9 @@ msgstr "" msgid "" "The *purpose* flag specifies what kind of CA certificates are loaded. The " -"default settings :data:`Purpose.SERVER_AUTH` loads certificates, that are " +"default settings :const:`Purpose.SERVER_AUTH` loads certificates, that are " "flagged and trusted for TLS web server authentication (client side " -"sockets). :data:`Purpose.CLIENT_AUTH` loads CA certificates for client " +"sockets). :const:`Purpose.CLIENT_AUTH` loads CA certificates for client " "certificate verification on the server side." msgstr "" @@ -1720,7 +1718,7 @@ 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 :data:`~socket.SOCK_STREAM` socket; other socket types are unsupported." +"a :const:`~socket.SOCK_STREAM` socket; other socket types are unsupported." msgstr "" msgid "" @@ -1767,6 +1765,11 @@ msgstr "" msgid "*session*, see :attr:`~SSLSocket.session`." msgstr "" +msgid "" +"To wrap an :class:`SSLSocket` in another :class:`SSLSocket`, use :meth:" +"`SSLContext.wrap_bio`." +msgstr "" + msgid "" "Always allow a server_hostname to be passed, even if OpenSSL does not have " "SNI." @@ -1917,7 +1920,7 @@ msgid "" msgstr "" msgid "" -"The flag had no effect with OpenSSL before version 1.1.1k. Python 3.8.9, " +"The flag had no effect with OpenSSL before version 1.1.1l. Python 3.8.9, " "3.9.3, and 3.10 include workarounds for previous versions." msgstr "" @@ -2258,61 +2261,61 @@ msgid "The following methods are available:" msgstr "" msgid ":attr:`~SSLSocket.context`" -msgstr "" +msgstr ":attr:`~SSLSocket.context`" msgid ":attr:`~SSLSocket.server_side`" -msgstr "" +msgstr ":attr:`~SSLSocket.server_side`" msgid ":attr:`~SSLSocket.server_hostname`" -msgstr "" +msgstr ":attr:`~SSLSocket.server_hostname`" msgid ":attr:`~SSLSocket.session`" -msgstr "" +msgstr ":attr:`~SSLSocket.session`" msgid ":attr:`~SSLSocket.session_reused`" -msgstr "" +msgstr ":attr:`~SSLSocket.session_reused`" msgid ":meth:`~SSLSocket.read`" -msgstr "" +msgstr ":meth:`~SSLSocket.read`" msgid ":meth:`~SSLSocket.write`" -msgstr "" +msgstr ":meth:`~SSLSocket.write`" msgid ":meth:`~SSLSocket.getpeercert`" -msgstr "" +msgstr ":meth:`~SSLSocket.getpeercert`" msgid ":meth:`~SSLSocket.selected_alpn_protocol`" -msgstr "" +msgstr ":meth:`~SSLSocket.selected_alpn_protocol`" msgid ":meth:`~SSLSocket.selected_npn_protocol`" -msgstr "" +msgstr ":meth:`~SSLSocket.selected_npn_protocol`" msgid ":meth:`~SSLSocket.cipher`" -msgstr "" +msgstr ":meth:`~SSLSocket.cipher`" msgid ":meth:`~SSLSocket.shared_ciphers`" -msgstr "" +msgstr ":meth:`~SSLSocket.shared_ciphers`" msgid ":meth:`~SSLSocket.compression`" -msgstr "" +msgstr ":meth:`~SSLSocket.compression`" msgid ":meth:`~SSLSocket.pending`" -msgstr "" +msgstr ":meth:`~SSLSocket.pending`" msgid ":meth:`~SSLSocket.do_handshake`" -msgstr "" +msgstr ":meth:`~SSLSocket.do_handshake`" msgid ":meth:`~SSLSocket.verify_client_post_handshake`" -msgstr "" +msgstr ":meth:`~SSLSocket.verify_client_post_handshake`" msgid ":meth:`~SSLSocket.unwrap`" -msgstr "" +msgstr ":meth:`~SSLSocket.unwrap`" msgid ":meth:`~SSLSocket.get_channel_binding`" -msgstr "" +msgstr ":meth:`~SSLSocket.get_channel_binding`" msgid ":meth:`~SSLSocket.version`" -msgstr "" +msgstr ":meth:`~SSLSocket.version`" msgid "" "When compared to :class:`SSLSocket`, this object lacks the following " @@ -2489,7 +2492,7 @@ msgid "" msgstr "" msgid "" -"The SSL context created above will only allow TLSv1.2 and later (if " +"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." @@ -2631,7 +2634,7 @@ msgid "Mozilla" msgstr "" msgid "OpenSSL" -msgstr "" +msgstr "OpenSSL" msgid "(use in module ssl)" msgstr "" diff --git a/library/stat.po b/library/stat.po new file mode 100644 index 0000000000..cb1f15d202 --- /dev/null +++ b/library/stat.po @@ -0,0 +1,334 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`stat` --- Interpreting :func:`~os.stat` results" +msgstr "" + +msgid "**Source code:** :source:`Lib/stat.py`" +msgstr "" + +msgid "" +"The :mod:`stat` module defines constants and functions for interpreting the " +"results of :func:`os.stat`, :func:`os.fstat` and :func:`os.lstat` (if they " +"exist). For complete details about the :c:func:`stat`, :c:func:`!fstat` " +"and :c:func:`!lstat` calls, consult the documentation for your system." +msgstr "" + +msgid "The stat module is backed by a C implementation." +msgstr "" + +msgid "" +"The :mod:`stat` module defines the following functions to test for specific " +"file types:" +msgstr "" + +msgid "Return non-zero if the mode is from a directory." +msgstr "" + +msgid "Return non-zero if the mode is from a character special device file." +msgstr "" + +msgid "Return non-zero if the mode is from a block special device file." +msgstr "" + +msgid "Return non-zero if the mode is from a regular file." +msgstr "" + +msgid "Return non-zero if the mode is from a FIFO (named pipe)." +msgstr "" + +msgid "Return non-zero if the mode is from a symbolic link." +msgstr "" + +msgid "Return non-zero if the mode is from a socket." +msgstr "" + +msgid "Return non-zero if the mode is from a door." +msgstr "" + +msgid "Return non-zero if the mode is from an event port." +msgstr "" + +msgid "Return non-zero if the mode is from a whiteout." +msgstr "" + +msgid "" +"Two additional functions are defined for more general manipulation of the " +"file's mode:" +msgstr "" + +msgid "" +"Return the portion of the file's mode that can be set by :func:`os.chmod`\\ " +"---that is, the file's permission bits, plus the sticky bit, set-group-id, " +"and set-user-id bits (on systems that support them)." +msgstr "" + +msgid "" +"Return the portion of the file's mode that describes the file type (used by " +"the :func:`!S_IS\\*` functions above)." +msgstr "" + +msgid "" +"Normally, you would use the :func:`!os.path.is\\*` functions for testing the " +"type of a file; the functions here are useful when you are doing multiple " +"tests of the same file and wish to avoid the overhead of the :c:func:`stat` " +"system call for each test. These are also useful when checking for " +"information about a file that isn't handled by :mod:`os.path`, like the " +"tests for block and character devices." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +"An additional utility function is provided to convert a file's mode in a " +"human readable string:" +msgstr "" + +msgid "Convert a file's mode to a string of the form '-rwxrwxrwx'." +msgstr "" + +msgid "" +"The function supports :data:`S_IFDOOR`, :data:`S_IFPORT` and :data:`S_IFWHT`." +msgstr "" + +msgid "" +"All the variables below are simply symbolic indexes into the 10-tuple " +"returned by :func:`os.stat`, :func:`os.fstat` or :func:`os.lstat`." +msgstr "" + +msgid "Inode protection mode." +msgstr "" + +msgid "Inode number." +msgstr "" + +msgid "Device inode resides on." +msgstr "" + +msgid "Number of links to the inode." +msgstr "" + +msgid "User id of the owner." +msgstr "" + +msgid "Group id of the owner." +msgstr "" + +msgid "" +"Size in bytes of a plain file; amount of data waiting on some special files." +msgstr "" + +msgid "Time of last access." +msgstr "" + +msgid "Time of last modification." +msgstr "" + +msgid "" +"The \"ctime\" as reported by the operating system. On some systems (like " +"Unix) is the time of the last metadata change, and, on others (like " +"Windows), is the creation time (see platform documentation for details)." +msgstr "" + +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." +msgstr "" + +msgid "The variables below define the flags used in the :data:`ST_MODE` field." +msgstr "" + +msgid "" +"Use of the functions above is more portable than use of the first set of " +"flags:" +msgstr "" + +msgid "Socket." +msgstr "" + +msgid "Symbolic link." +msgstr "" + +msgid "Regular file." +msgstr "" + +msgid "Block device." +msgstr "" + +msgid "Directory." +msgstr "" + +msgid "Character device." +msgstr "" + +msgid "FIFO." +msgstr "" + +msgid "Door." +msgstr "" + +msgid "Event port." +msgstr "" + +msgid "Whiteout." +msgstr "" + +msgid "" +":data:`S_IFDOOR`, :data:`S_IFPORT` or :data:`S_IFWHT` are defined as 0 when " +"the platform does not have support for the file types." +msgstr "" + +msgid "" +"The following flags can also be used in the *mode* argument of :func:`os." +"chmod`:" +msgstr "" + +msgid "Set UID bit." +msgstr "" + +msgid "" +"Set-group-ID bit. This bit has several special uses. For a directory it " +"indicates that BSD semantics is to be used for that directory: files created " +"there inherit their group ID from the directory, not from the effective " +"group ID of the creating process, and directories created there will also " +"get the :data:`S_ISGID` bit set. For a file that does not have the group " +"execution bit (:data:`S_IXGRP`) set, the set-group-ID bit indicates " +"mandatory file/record locking (see also :data:`S_ENFMT`)." +msgstr "" + +msgid "" +"Sticky bit. When this bit is set on a directory it means that a file in " +"that directory can be renamed or deleted only by the owner of the file, by " +"the owner of the directory, or by a privileged process." +msgstr "" + +msgid "Mask for file owner permissions." +msgstr "" + +msgid "Owner has read permission." +msgstr "" + +msgid "Owner has write permission." +msgstr "" + +msgid "Owner has execute permission." +msgstr "" + +msgid "Mask for group permissions." +msgstr "" + +msgid "Group has read permission." +msgstr "" + +msgid "Group has write permission." +msgstr "" + +msgid "Group has execute permission." +msgstr "" + +msgid "Mask for permissions for others (not in group)." +msgstr "" + +msgid "Others have read permission." +msgstr "" + +msgid "Others have write permission." +msgstr "" + +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." +msgstr "" + +msgid "Unix V7 synonym for :data:`S_IRUSR`." +msgstr "" + +msgid "Unix V7 synonym for :data:`S_IWUSR`." +msgstr "" + +msgid "Unix V7 synonym for :data:`S_IXUSR`." +msgstr "" + +msgid "" +"The following flags can be used in the *flags* argument of :func:`os." +"chflags`:" +msgstr "" + +msgid "Do not dump the file." +msgstr "" + +msgid "The file may not be changed." +msgstr "" + +msgid "The file may only be appended to." +msgstr "" + +msgid "The directory is opaque when viewed through a union stack." +msgstr "" + +msgid "The file may not be renamed or deleted." +msgstr "" + +msgid "The file is stored compressed (macOS 10.6+)." +msgstr "" + +msgid "The file should not be displayed in a GUI (macOS 10.5+)." +msgstr "" + +msgid "The file may be archived." +msgstr "" + +msgid "The file is a snapshot file." +msgstr "" + +msgid "" +"See the \\*BSD or macOS systems man page :manpage:`chflags(2)` for more " +"information." +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." +msgstr "" + +msgid "" +"On Windows, the following constants are available for comparing against the " +"``st_reparse_tag`` member returned by :func:`os.lstat`. These are well-known " +"constants, but are not an exhaustive list." +msgstr "" diff --git a/library/statistics.po b/library/statistics.po new file mode 100644 index 0000000000..e73c872e74 --- /dev/null +++ b/library/statistics.po @@ -0,0 +1,914 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`statistics` --- Mathematical statistics functions" +msgstr "" + +msgid "**Source code:** :source:`Lib/statistics.py`" +msgstr "" + +msgid "" +"This module provides functions for calculating mathematical statistics of " +"numeric (:class:`~numbers.Real`-valued) data." +msgstr "" + +msgid "" +"The module is not intended to be a competitor to third-party libraries such " +"as `NumPy `_, `SciPy `_, or " +"proprietary full-featured statistics packages aimed at professional " +"statisticians such as Minitab, SAS and Matlab. It is aimed at the level of " +"graphing and scientific calculators." +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)``." +msgstr "" + +msgid "" +"Some datasets use ``NaN`` (not a number) values to represent missing data. " +"Since NaNs have unusual comparison semantics, they cause surprising or " +"undefined behaviors in the statistics functions that sort data or that count " +"occurrences. The functions affected are ``median()``, ``median_low()``, " +"``median_high()``, ``median_grouped()``, ``mode()``, ``multimode()``, and " +"``quantiles()``. The ``NaN`` values should be stripped before calling these " +"functions::" +msgstr "" + +msgid "Averages and measures of central location" +msgstr "" + +msgid "" +"These functions calculate an average or typical value from a population or " +"sample." +msgstr "" + +msgid ":func:`mean`" +msgstr ":func:`mean`" + +msgid "Arithmetic mean (\"average\") of data." +msgstr "" + +msgid ":func:`fmean`" +msgstr ":func:`fmean`" + +msgid "Fast, floating point arithmetic mean, with optional weighting." +msgstr "" + +msgid ":func:`geometric_mean`" +msgstr ":func:`geometric_mean`" + +msgid "Geometric mean of data." +msgstr "" + +msgid ":func:`harmonic_mean`" +msgstr ":func:`harmonic_mean`" + +msgid "Harmonic mean of data." +msgstr "" + +msgid ":func:`median`" +msgstr ":func:`median`" + +msgid "Median (middle value) of data." +msgstr "" + +msgid ":func:`median_low`" +msgstr ":func:`median_low`" + +msgid "Low median of data." +msgstr "" + +msgid ":func:`median_high`" +msgstr ":func:`median_high`" + +msgid "High median of data." +msgstr "" + +msgid ":func:`median_grouped`" +msgstr ":func:`median_grouped`" + +msgid "Median, or 50th percentile, of grouped data." +msgstr "" + +msgid ":func:`mode`" +msgstr ":func:`mode`" + +msgid "Single mode (most common value) of discrete or nominal data." +msgstr "" + +msgid ":func:`multimode`" +msgstr ":func:`multimode`" + +msgid "List of modes (most common values) of discrete or nominal data." +msgstr "" + +msgid ":func:`quantiles`" +msgstr ":func:`quantiles`" + +msgid "Divide data into intervals with equal probability." +msgstr "" + +msgid "Measures of spread" +msgstr "" + +msgid "" +"These functions calculate a measure of how much the population or sample " +"tends to deviate from the typical or average values." +msgstr "" + +msgid ":func:`pstdev`" +msgstr ":func:`pstdev`" + +msgid "Population standard deviation of data." +msgstr "" + +msgid ":func:`pvariance`" +msgstr ":func:`pvariance`" + +msgid "Population variance of data." +msgstr "" + +msgid ":func:`stdev`" +msgstr ":func:`stdev`" + +msgid "Sample standard deviation of data." +msgstr "" + +msgid ":func:`variance`" +msgstr ":func:`variance`" + +msgid "Sample variance of data." +msgstr "" + +msgid "Statistics for relations between two inputs" +msgstr "" + +msgid "" +"These functions calculate statistics regarding relations between two inputs." +msgstr "" + +msgid ":func:`covariance`" +msgstr ":func:`covariance`" + +msgid "Sample covariance for two variables." +msgstr "" + +msgid ":func:`correlation`" +msgstr ":func:`correlation`" + +msgid "Pearson's correlation coefficient for two variables." +msgstr "" + +msgid ":func:`linear_regression`" +msgstr ":func:`linear_regression`" + +msgid "Slope and intercept for simple linear regression." +msgstr "" + +msgid "Function details" +msgstr "" + +msgid "" +"Note: The functions do not require the data given to them to be sorted. " +"However, for reading convenience, most of the examples show sorted sequences." +msgstr "" + +msgid "" +"Return the sample arithmetic mean of *data* which can be a sequence or " +"iterable." +msgstr "" + +msgid "" +"The arithmetic mean is the sum of the data divided by the number of data " +"points. It is commonly called \"the average\", although it is only one of " +"many different mathematical averages. It is a measure of the central " +"location of the data." +msgstr "" + +msgid "If *data* is empty, :exc:`StatisticsError` will be raised." +msgstr "" + +msgid "Some examples of use:" +msgstr "" + +msgid "" +"The mean is strongly affected by `outliers `_ and is not necessarily a typical example of the data points. For " +"a more robust, although less efficient, measure of `central tendency " +"`_, see :func:`median`." +msgstr "" + +msgid "" +"The sample mean gives an unbiased estimate of the true population mean, so " +"that when taken on average over all the possible samples, ``mean(sample)`` " +"converges on the true mean of the entire population. If *data* represents " +"the entire population rather than a sample, then ``mean(data)`` is " +"equivalent to calculating the true population mean μ." +msgstr "" + +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 " +"dataset is empty, raises a :exc:`StatisticsError`." +msgstr "" + +msgid "" +"Optional weighting is supported. For example, a professor assigns a grade " +"for a course by weighting quizzes at 20%, homework at 20%, a midterm exam at " +"30%, and a final exam at 30%:" +msgstr "" + +msgid "" +"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*." +msgstr "" + +msgid "Convert *data* to floats and compute the geometric mean." +msgstr "" + +msgid "" +"The geometric mean indicates the central tendency or typical value of the " +"*data* using the product of the values (as opposed to the arithmetic mean " +"which uses their sum)." +msgstr "" + +msgid "" +"Raises a :exc:`StatisticsError` if the input dataset is empty, if it " +"contains a zero, or if it contains a negative value. The *data* may be a " +"sequence or iterable." +msgstr "" + +msgid "" +"No special efforts are made to achieve exact results. (However, this may " +"change in the future.)" +msgstr "" + +msgid "" +"Return the harmonic mean of *data*, a sequence or iterable of real-valued " +"numbers. If *weights* is omitted or *None*, then equal weighting is assumed." +msgstr "" + +msgid "" +"The harmonic mean is the reciprocal of the arithmetic :func:`mean` of the " +"reciprocals of the data. For example, the harmonic mean of three values *a*, " +"*b* and *c* will be equivalent to ``3/(1/a + 1/b + 1/c)``. If one of the " +"values is zero, the result will be zero." +msgstr "" + +msgid "" +"The harmonic mean is a type of average, a measure of the central location of " +"the data. It is often appropriate when averaging ratios or rates, for " +"example speeds." +msgstr "" + +msgid "" +"Suppose a car travels 10 km at 40 km/hr, then another 10 km at 60 km/hr. " +"What is the average speed?" +msgstr "" + +msgid "" +"Suppose a car travels 40 km/hr for 5 km, and when traffic clears, speeds-up " +"to 60 km/hr for the remaining 30 km of the journey. What is the average " +"speed?" +msgstr "" + +msgid "" +":exc:`StatisticsError` is raised if *data* is empty, any element is less " +"than zero, or if the weighted sum isn't positive." +msgstr "" + +msgid "" +"The current algorithm has an early-out when it encounters a zero in the " +"input. This means that the subsequent inputs are not tested for validity. " +"(This behavior may change in the future.)" +msgstr "" + +msgid "" +"Return the median (middle value) of numeric data, using the common \"mean of " +"middle two\" method. If *data* is empty, :exc:`StatisticsError` is raised. " +"*data* can be a sequence or iterable." +msgstr "" + +msgid "" +"The median is a robust measure of central location and is less affected by " +"the presence of outliers. When the number of data points is odd, the middle " +"data point is returned:" +msgstr "" + +msgid "" +"When the number of data points is even, the median is interpolated by taking " +"the average of the two middle values:" +msgstr "" + +msgid "" +"This is suited for when your data is discrete, and you don't mind that the " +"median may not be an actual data point." +msgstr "" + +msgid "" +"If the data is ordinal (supports order operations) but not numeric (doesn't " +"support addition), consider using :func:`median_low` or :func:`median_high` " +"instead." +msgstr "" + +msgid "" +"Return the low median of numeric data. If *data* is empty, :exc:" +"`StatisticsError` is raised. *data* can be a sequence or iterable." +msgstr "" + +msgid "" +"The low median is always a member of the data set. When the number of data " +"points is odd, the middle value is returned. When it is even, the smaller " +"of the two middle values is returned." +msgstr "" + +msgid "" +"Use the low median when your data are discrete and you prefer the median to " +"be an actual data point rather than interpolated." +msgstr "" + +msgid "" +"Return the high median of data. If *data* is empty, :exc:`StatisticsError` " +"is raised. *data* can be a sequence or iterable." +msgstr "" + +msgid "" +"The high median is always a member of the data set. When the number of data " +"points is odd, the middle value is returned. When it is even, the larger of " +"the two middle values is returned." +msgstr "" + +msgid "" +"Use the high median when your data are discrete and you prefer the median to " +"be an actual data point rather than interpolated." +msgstr "" + +msgid "" +"Return the median of grouped continuous data, calculated as the 50th " +"percentile, using interpolation. If *data* is empty, :exc:`StatisticsError` " +"is raised. *data* can be a sequence or iterable." +msgstr "" + +msgid "" +"In the following example, the data are rounded, so that each value " +"represents the midpoint of data classes, e.g. 1 is the midpoint of the class " +"0.5--1.5, 2 is the midpoint of 1.5--2.5, 3 is the midpoint of 2.5--3.5, " +"etc. With the data given, the middle value falls somewhere in the class " +"3.5--4.5, and interpolation is used to estimate it:" +msgstr "" + +msgid "" +"Optional argument *interval* represents the class interval, and defaults to " +"1. Changing the class interval naturally will change the interpolation:" +msgstr "" + +msgid "" +"This function does not check whether the data points are at least *interval* " +"apart." +msgstr "" + +msgid "" +"Under some circumstances, :func:`median_grouped` may coerce data points to " +"floats. This behaviour is likely to change in the future." +msgstr "" + +msgid "" +"\"Statistics for the Behavioral Sciences\", Frederick J Gravetter and Larry " +"B Wallnau (8th Edition)." +msgstr "" + +msgid "" +"The `SSMEDIAN `_ function in the Gnome Gnumeric " +"spreadsheet, including `this discussion `_." +msgstr "" + +msgid "" +"Return the single most common data point from discrete or nominal *data*. " +"The mode (when it exists) is the most typical value and serves as a measure " +"of central location." +msgstr "" + +msgid "" +"If there are multiple modes with the same frequency, returns the first one " +"encountered in the *data*. If the smallest or largest of those is desired " +"instead, use ``min(multimode(data))`` or ``max(multimode(data))``. If the " +"input *data* is empty, :exc:`StatisticsError` is raised." +msgstr "" + +msgid "" +"``mode`` assumes discrete data and returns a single value. This is the " +"standard treatment of the mode as commonly taught in schools:" +msgstr "" + +msgid "" +"The mode is unique in that it is the only statistic in this package that " +"also applies to nominal (non-numeric) data:" +msgstr "" + +msgid "" +"Now handles multimodal datasets by returning the first mode encountered. " +"Formerly, it raised :exc:`StatisticsError` when more than one mode was found." +msgstr "" + +msgid "" +"Return a list of the most frequently occurring values in the order they were " +"first encountered in the *data*. Will return more than one result if there " +"are multiple modes or an empty list if the *data* is empty:" +msgstr "" + +msgid "" +"Return the population standard deviation (the square root of the population " +"variance). See :func:`pvariance` for arguments and other details." +msgstr "" + +msgid "" +"Return the population variance of *data*, a non-empty sequence or iterable " +"of real-valued numbers. Variance, or second moment about the mean, is a " +"measure of the variability (spread or dispersion) of data. A large variance " +"indicates that the data is spread out; a small variance indicates it is " +"clustered closely around the mean." +msgstr "" + +msgid "" +"If the optional second argument *mu* is given, it is typically the mean of " +"the *data*. It can also be used to compute the second moment around a point " +"that is not the mean. If it is missing or ``None`` (the default), the " +"arithmetic mean is automatically calculated." +msgstr "" + +msgid "" +"Use this function to calculate the variance from the entire population. To " +"estimate the variance from a sample, the :func:`variance` function is " +"usually a better choice." +msgstr "" + +msgid "Raises :exc:`StatisticsError` if *data* is empty." +msgstr "" + +msgid "Examples:" +msgstr "Przykłady:" + +msgid "" +"If you have already calculated the mean of your data, you can pass it as the " +"optional second argument *mu* to avoid recalculation:" +msgstr "" + +msgid "Decimals and Fractions are supported:" +msgstr "" + +msgid "" +"When called with the entire population, this gives the population variance " +"σ². When called on a sample instead, this is the biased sample variance s², " +"also known as variance with N degrees of freedom." +msgstr "" + +msgid "" +"If you somehow know the true population mean μ, you may use this function to " +"calculate the variance of a sample, giving the known population mean as the " +"second argument. Provided the data points are a random sample of the " +"population, the result will be an unbiased estimate of the population " +"variance." +msgstr "" + +msgid "" +"Return the sample standard deviation (the square root of the sample " +"variance). See :func:`variance` for arguments and other details." +msgstr "" + +msgid "" +"Return the sample variance of *data*, an iterable of at least two real-" +"valued numbers. Variance, or second moment about the mean, is a measure of " +"the variability (spread or dispersion) of data. A large variance indicates " +"that the data is spread out; a small variance indicates it is clustered " +"closely around the mean." +msgstr "" + +msgid "" +"If the optional second argument *xbar* is given, it should be the mean of " +"*data*. If it is missing or ``None`` (the default), the mean is " +"automatically calculated." +msgstr "" + +msgid "" +"Use this function when your data is a sample from a population. To calculate " +"the variance from the entire population, see :func:`pvariance`." +msgstr "" + +msgid "Raises :exc:`StatisticsError` if *data* has fewer than two values." +msgstr "" + +msgid "" +"If you have already calculated the mean of your data, you can pass it as the " +"optional second argument *xbar* to avoid recalculation:" +msgstr "" + +msgid "" +"This function does not attempt to verify that you have passed the actual " +"mean as *xbar*. Using arbitrary values for *xbar* can lead to invalid or " +"impossible results." +msgstr "" + +msgid "Decimal and Fraction values are supported:" +msgstr "" + +msgid "" +"This is the sample variance s² with Bessel's correction, also known as " +"variance with N-1 degrees of freedom. Provided that the data points are " +"representative (e.g. independent and identically distributed), the result " +"should be an unbiased estimate of the true population variance." +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." +msgstr "" + +msgid "" +"Divide *data* into *n* continuous intervals with equal probability. Returns " +"a list of ``n - 1`` cut points separating the intervals." +msgstr "" + +msgid "" +"Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " +"*n* to 100 for percentiles which gives the 99 cuts points that separate " +"*data* into 100 equal sized groups. Raises :exc:`StatisticsError` if *n* is " +"not least 1." +msgstr "" + +msgid "" +"The *data* can be any iterable containing sample data. For meaningful " +"results, the number of data points in *data* should be larger than *n*. " +"Raises :exc:`StatisticsError` if there are not at least two data points." +msgstr "" + +msgid "" +"The cut points are linearly interpolated from the two nearest data points. " +"For example, if a cut point falls one-third of the distance between two " +"sample values, ``100`` and ``112``, the cut-point will evaluate to ``104``." +msgstr "" + +msgid "" +"The *method* for computing quantiles can be varied depending on whether the " +"*data* includes or excludes the lowest and highest possible values from the " +"population." +msgstr "" + +msgid "" +"The default *method* is \"exclusive\" and is used for data sampled from a " +"population that can have more extreme values than found in the samples. The " +"portion of the population falling below the *i-th* of *m* sorted data points " +"is computed as ``i / (m + 1)``. Given nine sample values, the method sorts " +"them and assigns the following percentiles: 10%, 20%, 30%, 40%, 50%, 60%, " +"70%, 80%, 90%." +msgstr "" + +msgid "" +"Setting the *method* to \"inclusive\" is used for describing population data " +"or for samples that are known to include the most extreme values from the " +"population. The minimum value in *data* is treated as the 0th percentile " +"and the maximum value is treated as the 100th percentile. The portion of the " +"population falling below the *i-th* of *m* sorted data points is computed as " +"``(i - 1) / (m - 1)``. Given 11 sample values, the method sorts them and " +"assigns the following percentiles: 0%, 10%, 20%, 30%, 40%, 50%, 60%, 70%, " +"80%, 90%, 100%." +msgstr "" + +msgid "" +"Return the sample covariance of two inputs *x* and *y*. Covariance is a " +"measure of the joint variability of two inputs." +msgstr "" + +msgid "" +"Both inputs must be of the same length (no less than two), otherwise :exc:" +"`StatisticsError` is raised." +msgstr "" + +msgid "" +"Return the `Pearson's correlation coefficient `_ for two inputs. Pearson's correlation " +"coefficient *r* takes values between -1 and +1. It measures the strength and " +"direction of the linear relationship, where +1 means very strong, positive " +"linear relationship, -1 very strong, negative linear relationship, and 0 no " +"linear relationship." +msgstr "" + +msgid "" +"Both inputs must be of the same length (no less than two), and need not to " +"be constant, otherwise :exc:`StatisticsError` is raised." +msgstr "" + +msgid "" +"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:" +msgstr "" + +msgid "*y = slope \\* x + intercept + noise*" +msgstr "" + +msgid "" +"where ``slope`` and ``intercept`` are the regression parameters that are " +"estimated, and ``noise`` represents the variability of the data that was not " +"explained by the linear regression (it is equal to the difference between " +"predicted and actual values of the dependent variable)." +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." +msgstr "" + +msgid "" +"For example, we can use the `release dates of the Monty Python films " +"`_ to predict the " +"cumulative number of Monty Python films that would have been produced by " +"2019 assuming that they had kept the pace." +msgstr "" + +msgid "" +"If *proportional* is true, the independent variable *x* and the dependent " +"variable *y* are assumed to be directly proportional. The data is fit to a " +"line passing through the origin. Since the *intercept* will always be 0.0, " +"the underlying linear function simplifies to:" +msgstr "" + +msgid "*y = slope \\* x + noise*" +msgstr "" + +msgid "Added support for *proportional*." +msgstr "" + +msgid "Exceptions" +msgstr "Wyjątki" + +msgid "A single exception is defined:" +msgstr "" + +msgid "Subclass of :exc:`ValueError` for statistics-related exceptions." +msgstr "" + +msgid ":class:`NormalDist` objects" +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." +msgstr "" + +msgid "" +"Normal distributions arise from the `Central Limit Theorem `_ and have a wide range of " +"applications in statistics." +msgstr "" + +msgid "" +"Returns a new *NormalDist* object where *mu* represents the `arithmetic mean " +"`_ and *sigma* represents the " +"`standard deviation `_." +msgstr "" + +msgid "If *sigma* is negative, raises :exc:`StatisticsError`." +msgstr "" + +msgid "" +"A read-only property for the `arithmetic mean `_ of a normal distribution." +msgstr "" + +msgid "" +"A read-only property for the `median `_ of a normal distribution." +msgstr "" + +msgid "" +"A read-only property for the `mode `_ of a normal distribution." +msgstr "" + +msgid "" +"A read-only property for the `standard deviation `_ of a normal distribution." +msgstr "" + +msgid "" +"A read-only property for the `variance `_ of a normal distribution. Equal to the square of the standard " +"deviation." +msgstr "" + +msgid "" +"Makes a normal distribution instance with *mu* and *sigma* parameters " +"estimated from the *data* using :func:`fmean` and :func:`stdev`." +msgstr "" + +msgid "" +"The *data* can be any :term:`iterable` and should consist of values that can " +"be converted to type :class:`float`. If *data* does not contain at least " +"two elements, raises :exc:`StatisticsError` because it takes at least one " +"point to estimate a central value and at least two points to estimate " +"dispersion." +msgstr "" + +msgid "" +"Generates *n* random samples for a given mean and standard deviation. " +"Returns a :class:`list` of :class:`float` values." +msgstr "" + +msgid "" +"If *seed* is given, creates a new instance of the underlying random number " +"generator. This is useful for creating reproducible results, even in a " +"multi-threading context." +msgstr "" + +msgid "" +"Using a `probability density function (pdf) `_, compute the relative likelihood that a " +"random variable *X* will be near the given value *x*. Mathematically, it is " +"the limit of the ratio ``P(x <= X < x+dx) / dx`` as *dx* approaches zero." +msgstr "" + +msgid "" +"The relative likelihood is computed as the probability of a sample occurring " +"in a narrow range divided by the width of the range (hence the word " +"\"density\"). Since the likelihood is relative to other points, its value " +"can be greater than ``1.0``." +msgstr "" + +msgid "" +"Using a `cumulative distribution function (cdf) `_, compute the probability that a " +"random variable *X* will be less than or equal to *x*. Mathematically, it " +"is written ``P(X <= x)``." +msgstr "" + +msgid "" +"Compute the inverse cumulative distribution function, also known as the " +"`quantile function `_ or " +"the `percent-point `_ " +"function. Mathematically, it is written ``x : P(X <= x) = p``." +msgstr "" + +msgid "" +"Finds the value *x* of the random variable *X* such that the probability of " +"the variable being less than or equal to that value equals the given " +"probability *p*." +msgstr "" + +msgid "" +"Measures the agreement between two normal probability distributions. Returns " +"a value between 0.0 and 1.0 giving `the overlapping area for the two " +"probability density functions `_." +msgstr "" + +msgid "" +"Divide the normal distribution into *n* continuous intervals with equal " +"probability. Returns a list of (n - 1) cut points separating the intervals." +msgstr "" + +msgid "" +"Set *n* to 4 for quartiles (the default). Set *n* to 10 for deciles. Set " +"*n* to 100 for percentiles which gives the 99 cuts points that separate the " +"normal distribution into 100 equal sized groups." +msgstr "" + +msgid "" +"Compute the `Standard Score `_ describing *x* in terms of the number of standard " +"deviations above or below the mean of the normal distribution: ``(x - " +"mean) / stdev``." +msgstr "" + +msgid "" +"Instances of :class:`NormalDist` support addition, subtraction, " +"multiplication and division by a constant. These operations are used for " +"translation and scaling. For example:" +msgstr "" + +msgid "" +"Dividing a constant by an instance of :class:`NormalDist` is not supported " +"because the result wouldn't be normally distributed." +msgstr "" + +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:" +msgstr "" + +msgid ":class:`NormalDist` Examples and Recipes" +msgstr "" + +msgid ":class:`NormalDist` readily solves classic probability problems." +msgstr "" + +msgid "" +"For example, given `historical data for SAT exams `_ showing that scores are " +"normally distributed with a mean of 1060 and a standard deviation of 195, " +"determine the percentage of students with test scores between 1100 and 1200, " +"after rounding to the nearest whole number:" +msgstr "" + +msgid "" +"Find the `quartiles `_ and `deciles " +"`_ for the SAT scores:" +msgstr "" + +msgid "" +"To estimate the distribution for a model than isn't easy to solve " +"analytically, :class:`NormalDist` can generate input samples for a `Monte " +"Carlo simulation `_:" +msgstr "" + +msgid "" +"Normal distributions can be used to approximate `Binomial distributions " +"`_ when the sample " +"size is large and when the probability of a successful trial is near 50%." +msgstr "" + +msgid "" +"For example, an open source conference has 750 attendees and two rooms with " +"a 500 person capacity. There is a talk about Python and another about Ruby. " +"In previous conferences, 65% of the attendees preferred to listen to Python " +"talks. Assuming the population preferences haven't changed, what is the " +"probability that the Python room will stay within its capacity limits?" +msgstr "" + +msgid "Normal distributions commonly arise in machine learning problems." +msgstr "" + +msgid "" +"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 "" + +msgid "" +"We're given a training dataset with measurements for eight people. The " +"measurements are assumed to be normally distributed, so we summarize the " +"data with :class:`NormalDist`:" +msgstr "" + +msgid "" +"Next, we encounter a new person whose feature measurements are known but " +"whose gender is unknown:" +msgstr "" + +msgid "" +"Starting with a 50% `prior probability `_ of being male or female, we compute the posterior as " +"the prior times the product of likelihoods for the feature measurements " +"given the gender:" +msgstr "" + +msgid "" +"The final prediction goes to the largest posterior. This is known as the " +"`maximum a posteriori `_ or MAP:" +msgstr "" diff --git a/library/stdtypes.po b/library/stdtypes.po index 0bfc49574e..e20fe930d0 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:19+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 "Built-in Types" -msgstr "Typy wbudowane" +msgstr "Wbudowane typy" msgid "" "The following sections describe the standard types that are built into the " @@ -60,12 +61,12 @@ msgstr "" msgid "" "By default, an object is considered true unless its class defines either a :" -"meth:`__bool__` method that returns ``False`` or a :meth:`__len__` method " -"that returns zero, when called with the object. [1]_ Here are most of the " -"built-in objects considered false:" +"meth:`~object.__bool__` method that returns ``False`` or a :meth:`~object." +"__len__` method that returns zero, when called with the object. [1]_ Here " +"are most of the built-in objects considered false:" msgstr "" -msgid "constants defined to be false: ``None`` and ``False``." +msgid "constants defined to be false: ``None`` and ``False``" msgstr "" msgid "" @@ -101,7 +102,7 @@ msgid "Notes" msgstr "Notatki" msgid "``x or y``" -msgstr "" +msgstr "``x or y``" msgid "if *x* is true, then *x*, else *y*" msgstr "" @@ -119,7 +120,7 @@ msgid "\\(2)" msgstr "\\(2)" msgid "``not x``" -msgstr "" +msgstr "``not x``" msgid "if *x* is false, then ``True``, else ``False``" msgstr "" @@ -163,49 +164,49 @@ msgid "Meaning" msgstr "Znaczenie" msgid "``<``" -msgstr "" +msgstr "``<``" msgid "strictly less than" msgstr "" msgid "``<=``" -msgstr "" +msgstr "``<=``" msgid "less than or equal" msgstr "" msgid "``>``" -msgstr "" +msgstr "``>``" msgid "strictly greater than" msgstr "" msgid "``>=``" -msgstr "" +msgstr "``>=``" msgid "greater than or equal" msgstr "" msgid "``==``" -msgstr "" +msgstr "``==``" msgid "equal" msgstr "" msgid "``!=``" -msgstr "" +msgstr "``!=``" msgid "not equal" msgstr "" msgid "``is``" -msgstr "" +msgstr "``is``" msgid "object identity" msgstr "" msgid "``is not``" -msgstr "" +msgstr "``is not``" msgid "negated object identity" msgstr "" @@ -242,7 +243,7 @@ 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:`__contains__` method." +"implement the :meth:`~object.__contains__` method." msgstr "" msgid "Numeric Types --- :class:`int`, :class:`float`, :class:`complex`" @@ -295,55 +296,58 @@ msgid "Full documentation" msgstr "" msgid "``x + y``" -msgstr "" +msgstr "``x + y``" msgid "sum of *x* and *y*" msgstr "" msgid "``x - y``" -msgstr "" +msgstr "``x - y``" msgid "difference of *x* and *y*" msgstr "" msgid "``x * y``" -msgstr "" +msgstr "``x * y``" msgid "product of *x* and *y*" msgstr "" msgid "``x / y``" -msgstr "" +msgstr "``x / y``" msgid "quotient of *x* and *y*" msgstr "" msgid "``x // y``" -msgstr "" +msgstr "``x // y``" msgid "floored quotient of *x* and *y*" msgstr "" -msgid "``x % y``" +msgid "\\(1)\\(2)" msgstr "" +msgid "``x % y``" +msgstr "``x % y``" + msgid "remainder of ``x / y``" msgstr "" msgid "``-x``" -msgstr "" +msgstr "``-x``" msgid "*x* negated" msgstr "" msgid "``+x``" -msgstr "" +msgstr "``+x``" msgid "*x* unchanged" msgstr "" msgid "``abs(x)``" -msgstr "" +msgstr "``abs(x)``" msgid "absolute value or magnitude of *x*" msgstr "" @@ -352,7 +356,7 @@ msgid ":func:`abs`" msgstr ":func:`abs`" msgid "``int(x)``" -msgstr "" +msgstr "``int(x)``" msgid "*x* converted to integer" msgstr "" @@ -364,7 +368,7 @@ msgid ":func:`int`" msgstr ":func:`int`" msgid "``float(x)``" -msgstr "" +msgstr "``float(x)``" msgid "*x* converted to floating point" msgstr "" @@ -376,7 +380,7 @@ msgid ":func:`float`" msgstr ":func:`float`" msgid "``complex(re, im)``" -msgstr "" +msgstr "``complex(re, im)``" msgid "" "a complex number with real part *re*, imaginary part *im*. *im* defaults to " @@ -390,13 +394,13 @@ msgid ":func:`complex`" msgstr ":func:`complex`" msgid "``c.conjugate()``" -msgstr "" +msgstr "``c.conjugate()``" msgid "conjugate of the complex number *c*" msgstr "" msgid "``divmod(x, y)``" -msgstr "" +msgstr "``divmod(x, y)``" msgid "the pair ``(x // y, x % y)``" msgstr "" @@ -405,7 +409,7 @@ msgid ":func:`divmod`" msgstr ":func:`divmod`" msgid "``pow(x, y)``" -msgstr "" +msgstr "``pow(x, y)``" msgid "*x* to the power *y*" msgstr "" @@ -417,11 +421,13 @@ msgid ":func:`pow`" msgstr ":func:`pow`" msgid "``x ** y``" -msgstr "" +msgstr "``x ** y``" msgid "" -"Also referred to as integer division. The resultant value is a whole " -"integer, though the result's type is not necessarily int. The result is " +"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 "" @@ -513,7 +519,7 @@ msgid "This table lists the bitwise operations sorted in ascending priority:" msgstr "" msgid "``x | y``" -msgstr "" +msgstr "``x | y``" msgid "bitwise :dfn:`or` of *x* and *y*" msgstr "" @@ -522,19 +528,19 @@ msgid "\\(4)" msgstr "\\(4)" msgid "``x ^ y``" -msgstr "" +msgstr "``x ^ y``" msgid "bitwise :dfn:`exclusive or` of *x* and *y*" msgstr "" msgid "``x & y``" -msgstr "" +msgstr "``x & y``" msgid "bitwise :dfn:`and` of *x* and *y*" msgstr "" msgid "``x << n``" -msgstr "" +msgstr "``x << n``" msgid "*x* shifted left by *n* bits" msgstr "" @@ -543,7 +549,7 @@ msgid "(1)(2)" msgstr "(1)(2)" msgid "``x >> n``" -msgstr "" +msgstr "``x >> n``" msgid "*x* shifted right by *n* bits" msgstr "" @@ -552,7 +558,7 @@ msgid "(1)(3)" msgstr "" msgid "``~x``" -msgstr "" +msgstr "``~x``" msgid "the bits of *x* inverted" msgstr "" @@ -598,7 +604,7 @@ msgid "" msgstr "" msgid "Equivalent to::" -msgstr "" +msgstr "Odpowiednik::" msgid "" "Return the number of ones in the binary representation of the absolute value " @@ -759,8 +765,8 @@ msgid "" "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:`modulus` attribute " -"of :data:`sys.hash_info`." +"value of ``P`` is made available to Python as the :attr:`~sys.hash_info." +"modulus` attribute of :data:`sys.hash_info`." msgstr "" msgid "" @@ -872,11 +878,12 @@ msgstr "" msgid "" "Python's :term:`generator`\\s provide a convenient way to implement the " -"iterator protocol. If a container object's :meth:`__iter__` method is " -"implemented as a generator, it will automatically return an iterator object " -"(technically, a generator object) supplying the :meth:`__iter__` and :meth:" -"`~generator.__next__` methods. More information about generators can be " -"found in :ref:`the documentation for the yield expression `." +"iterator protocol. If a container object's :meth:`~iterator.__iter__` " +"method is implemented as a generator, it will automatically return an " +"iterator object (technically, a generator object) supplying the :meth:`!" +"__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`" @@ -926,7 +933,7 @@ msgid "``False`` if an item of *s* is equal to *x*, else ``True``" msgstr "" msgid "``s + t``" -msgstr "" +msgstr "``s + t``" msgid "the concatenation of *s* and *t*" msgstr "" @@ -944,13 +951,13 @@ msgid "(2)(7)" msgstr "" msgid "``s[i]``" -msgstr "" +msgstr "``s[i]``" msgid "*i*\\ th item of *s*, origin 0" msgstr "" msgid "``s[i:j]``" -msgstr "" +msgstr "``s[i:j]``" msgid "slice of *s* from *i* to *j*" msgstr "" @@ -959,7 +966,7 @@ msgid "(3)(4)" msgstr "" msgid "``s[i:j:k]``" -msgstr "" +msgstr "``s[i:j:k]``" msgid "slice of *s* from *i* to *j* with step *k*" msgstr "" @@ -968,25 +975,25 @@ msgid "(3)(5)" msgstr "" msgid "``len(s)``" -msgstr "" +msgstr "``len(s)``" msgid "length of *s*" msgstr "" msgid "``min(s)``" -msgstr "" +msgstr "``min(s)``" msgid "smallest item of *s*" msgstr "" msgid "``max(s)``" -msgstr "" +msgstr "``max(s)``" msgid "largest item of *s*" msgstr "" msgid "``s.index(x[, i[, j]])``" -msgstr "" +msgstr "``s.index(x[, i[, j]])``" msgid "" "index of the first occurrence of *x* in *s* (at or after index *i* and " @@ -997,7 +1004,7 @@ msgid "\\(8)" msgstr "" msgid "``s.count(x)``" -msgstr "" +msgstr "``s.count(x)``" msgid "total number of occurrences of *x* in *s*" msgstr "" @@ -1148,7 +1155,7 @@ msgid "" msgstr "" msgid "``s[i] = x``" -msgstr "" +msgstr "``s[i] = x``" msgid "item *i* of *s* is replaced by *x*" msgstr "" @@ -1161,7 +1168,7 @@ msgid "" msgstr "" msgid "``del s[i:j]``" -msgstr "" +msgstr "``del s[i:j]``" msgid "same as ``s[i:j] = []``" msgstr "" @@ -1173,26 +1180,26 @@ msgid "the elements of ``s[i:j:k]`` are replaced by those of *t*" msgstr "" msgid "``del s[i:j:k]``" -msgstr "" +msgstr "``del s[i:j:k]``" msgid "removes the elements of ``s[i:j:k]`` from the list" msgstr "" msgid "``s.append(x)``" -msgstr "" +msgstr "``s.append(x)``" msgid "" "appends *x* to the end of the sequence (same as ``s[len(s):len(s)] = [x]``)" msgstr "" msgid "``s.clear()``" -msgstr "" +msgstr "``s.clear()``" msgid "removes all items from *s* (same as ``del s[:]``)" msgstr "" msgid "``s.copy()``" -msgstr "" +msgstr "``s.copy()``" msgid "creates a shallow copy of *s* (same as ``s[:]``)" msgstr "" @@ -1206,13 +1213,13 @@ msgid "" msgstr "" msgid "``s *= n``" -msgstr "" +msgstr "``s *= n``" msgid "updates *s* with its contents repeated *n* times" msgstr "" msgid "``s.insert(i, x)``" -msgstr "" +msgstr "``s.insert(i, x)``" msgid "" "inserts *x* into *s* at the index given by *i* (same as ``s[i:i] = [x]``)" @@ -1225,13 +1232,13 @@ msgid "retrieves the item at *i* and also removes it from *s*" msgstr "" msgid "``s.remove(x)``" -msgstr "" +msgstr "``s.remove(x)``" msgid "remove the first item from *s* where ``s[i]`` is equal to *x*" msgstr "" msgid "``s.reverse()``" -msgstr "" +msgstr "``s.reverse()``" msgid "reverses the items of *s* in place" msgstr "" @@ -1346,6 +1353,8 @@ 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 " @@ -1364,6 +1373,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`." msgid "" "While a list is being sorted, the effect of attempting to mutate, or even " @@ -1528,7 +1539,7 @@ msgid "" msgstr "" msgid "" -"The :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " +"Added the :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " "attributes." msgstr "" @@ -1571,8 +1582,8 @@ msgstr "" msgid "" "See :ref:`strings` for more about the various forms of string literal, " -"including supported escape sequences, and the ``r`` (\"raw\") prefix that " -"disables most escape sequence processing." +"including supported :ref:`escape sequences `, and the " +"``r`` (\"raw\") prefix that disables most escape sequence processing." msgstr "" msgid "" @@ -2079,19 +2090,19 @@ msgid "Description" msgstr "Opis" msgid "``\\n``" -msgstr "" +msgstr "``\\n``" msgid "Line Feed" msgstr "" msgid "``\\r``" -msgstr "" +msgstr "``\\r``" msgid "Carriage Return" msgstr "" msgid "``\\r\\n``" -msgstr "" +msgstr "``\\r\\n``" msgid "Carriage Return + Line Feed" msgstr "" @@ -2109,37 +2120,37 @@ msgid "Form Feed" msgstr "" msgid "``\\x1c``" -msgstr "" +msgstr "``\\x1c``" msgid "File Separator" msgstr "" msgid "``\\x1d``" -msgstr "" +msgstr "``\\x1d``" msgid "Group Separator" msgstr "" msgid "``\\x1e``" -msgstr "" +msgstr "``\\x1e``" msgid "Record Separator" msgstr "" msgid "``\\x85``" -msgstr "" +msgstr "``\\x85``" msgid "Next Line (C1 Control Code)" msgstr "" msgid "``\\u2028``" -msgstr "" +msgstr "``\\u2028``" msgid "Line Separator" msgstr "" msgid "``\\u2029``" -msgstr "" +msgstr "``\\u2029``" msgid "Paragraph Separator" msgstr "" @@ -2209,8 +2220,8 @@ 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:`__getitem__`, typically a :term:`mapping` or :term:" -"`sequence`. When indexed by a Unicode ordinal (an integer), the table " +"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` " @@ -2332,20 +2343,20 @@ msgid "Flag" msgstr "" msgid "``'#'``" -msgstr "" +msgstr "``'#'``" msgid "" "The value conversion will use the \"alternate form\" (where defined below)." msgstr "" msgid "``'0'``" -msgstr "" +msgstr "``'0'``" msgid "The conversion will be zero padded for numeric values." msgstr "" msgid "``'-'``" -msgstr "" +msgstr "``'-'``" msgid "" "The converted value is left adjusted (overrides the ``'0'`` conversion if " @@ -2353,7 +2364,7 @@ msgid "" msgstr "" msgid "``' '``" -msgstr "" +msgstr "``' '``" msgid "" "(a space) A blank should be left before a positive number (or empty string) " @@ -2361,7 +2372,7 @@ msgid "" msgstr "" msgid "``'+'``" -msgstr "" +msgstr "``'+'``" msgid "" "A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " @@ -2389,7 +2400,7 @@ msgid "``'i'``" msgstr "``'i'``" msgid "``'o'``" -msgstr "" +msgstr "``'o'``" msgid "Signed octal value." msgstr "" @@ -2401,25 +2412,25 @@ msgid "Obsolete type -- it is identical to ``'d'``." msgstr "" msgid "``'x'``" -msgstr "" +msgstr "``'x'``" msgid "Signed hexadecimal (lowercase)." msgstr "" msgid "``'X'``" -msgstr "" +msgstr "``'X'``" msgid "Signed hexadecimal (uppercase)." msgstr "" msgid "``'e'``" -msgstr "" +msgstr "``'e'``" msgid "Floating point exponential format (lowercase)." msgstr "" msgid "``'E'``" -msgstr "" +msgstr "``'E'``" msgid "Floating point exponential format (uppercase)." msgstr "" @@ -2431,10 +2442,10 @@ msgid "Floating point decimal format." msgstr "" msgid "``'F'``" -msgstr "" +msgstr "``'F'``" msgid "``'g'``" -msgstr "" +msgstr "``'g'``" msgid "" "Floating point format. Uses lowercase exponential format if exponent is less " @@ -2442,7 +2453,7 @@ msgid "" msgstr "" msgid "``'G'``" -msgstr "" +msgstr "``'G'``" msgid "" "Floating point format. Uses uppercase exponential format if exponent is less " @@ -2450,31 +2461,31 @@ msgid "" msgstr "" msgid "``'c'``" -msgstr "" +msgstr "``'c'``" msgid "Single character (accepts integer or single character string)." msgstr "" msgid "``'r'``" -msgstr "" +msgstr "``'r'``" msgid "String (converts any Python object using :func:`repr`)." msgstr "" msgid "``'s'``" -msgstr "" +msgstr "``'s'``" msgid "String (converts any Python object using :func:`str`)." msgstr "" msgid "``'a'``" -msgstr "" +msgstr "``'a'``" msgid "String (converts any Python object using :func:`ascii`)." msgstr "" msgid "``'%'``" -msgstr "" +msgstr "``'%'``" msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" @@ -2514,7 +2525,7 @@ msgid "If precision is ``N``, the output is truncated to ``N`` characters." msgstr "" msgid "See :pep:`237`." -msgstr "" +msgstr "Zob. :pep:`237`." msgid "" "Since Python strings have an explicit length, ``%s`` conversions do not " @@ -3250,7 +3261,7 @@ msgstr "``'b'``" msgid "" "Bytes (any object that follows the :ref:`buffer protocol ` or " -"has :meth:`__bytes__`)." +"has :meth:`~object.__bytes__`)." msgstr "" msgid "" @@ -3457,7 +3468,8 @@ 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." +"'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::" @@ -3741,9 +3753,9 @@ msgid "" msgstr "" msgid "" -"Note, the *elem* argument to the :meth:`__contains__`, :meth:`remove`, and :" -"meth:`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:" +"`remove`, and :meth:`discard` methods may be a set. To support searching " +"for an equivalent frozenset, a temporary one is created from *elem*." msgstr "" msgid "Mapping Types --- :class:`dict`" @@ -4116,8 +4128,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:`__exit__` " -"method has actually failed." +"context management code to easily detect whether or not an :meth:`~object." +"__exit__` method has actually failed." msgstr "" msgid "" @@ -4270,136 +4282,136 @@ msgid "" msgstr "" msgid ":class:`tuple`" -msgstr "" +msgstr ":class:`tuple`" msgid ":class:`list`" -msgstr "" +msgstr ":class:`list`" msgid ":class:`dict`" -msgstr "" +msgstr ":class:`dict`" msgid ":class:`set`" -msgstr "" +msgstr ":class:`set`" msgid ":class:`frozenset`" -msgstr "" +msgstr ":class:`frozenset`" msgid ":class:`type`" -msgstr "" +msgstr ":class:`type`" msgid ":class:`collections.deque`" -msgstr "" +msgstr ":class:`collections.deque`" msgid ":class:`collections.defaultdict`" -msgstr "" +msgstr ":class:`collections.defaultdict`" msgid ":class:`collections.OrderedDict`" -msgstr "" +msgstr ":class:`collections.OrderedDict`" msgid ":class:`collections.Counter`" -msgstr "" +msgstr ":class:`collections.Counter`" msgid ":class:`collections.ChainMap`" -msgstr "" +msgstr ":class:`collections.ChainMap`" msgid ":class:`collections.abc.Awaitable`" -msgstr "" +msgstr ":class:`collections.abc.Awaitable`" msgid ":class:`collections.abc.Coroutine`" -msgstr "" +msgstr ":class:`collections.abc.Coroutine`" msgid ":class:`collections.abc.AsyncIterable`" -msgstr "" +msgstr ":class:`collections.abc.AsyncIterable`" msgid ":class:`collections.abc.AsyncIterator`" -msgstr "" +msgstr ":class:`collections.abc.AsyncIterator`" msgid ":class:`collections.abc.AsyncGenerator`" -msgstr "" +msgstr ":class:`collections.abc.AsyncGenerator`" msgid ":class:`collections.abc.Iterable`" -msgstr "" +msgstr ":class:`collections.abc.Iterable`" msgid ":class:`collections.abc.Iterator`" -msgstr "" +msgstr ":class:`collections.abc.Iterator`" msgid ":class:`collections.abc.Generator`" -msgstr "" +msgstr ":class:`collections.abc.Generator`" msgid ":class:`collections.abc.Reversible`" -msgstr "" +msgstr ":class:`collections.abc.Reversible`" msgid ":class:`collections.abc.Container`" -msgstr "" +msgstr ":class:`collections.abc.Container`" msgid ":class:`collections.abc.Collection`" -msgstr "" +msgstr ":class:`collections.abc.Collection`" msgid ":class:`collections.abc.Callable`" -msgstr "" +msgstr ":class:`collections.abc.Callable`" msgid ":class:`collections.abc.Set`" -msgstr "" +msgstr ":class:`collections.abc.Set`" msgid ":class:`collections.abc.MutableSet`" -msgstr "" +msgstr ":class:`collections.abc.MutableSet`" msgid ":class:`collections.abc.Mapping`" -msgstr "" +msgstr ":class:`collections.abc.Mapping`" msgid ":class:`collections.abc.MutableMapping`" -msgstr "" +msgstr ":class:`collections.abc.MutableMapping`" msgid ":class:`collections.abc.Sequence`" -msgstr "" +msgstr ":class:`collections.abc.Sequence`" msgid ":class:`collections.abc.MutableSequence`" -msgstr "" +msgstr ":class:`collections.abc.MutableSequence`" msgid ":class:`collections.abc.ByteString`" -msgstr "" +msgstr ":class:`collections.abc.ByteString`" msgid ":class:`collections.abc.MappingView`" -msgstr "" +msgstr ":class:`collections.abc.MappingView`" msgid ":class:`collections.abc.KeysView`" -msgstr "" +msgstr ":class:`collections.abc.KeysView`" msgid ":class:`collections.abc.ItemsView`" -msgstr "" +msgstr ":class:`collections.abc.ItemsView`" msgid ":class:`collections.abc.ValuesView`" -msgstr "" +msgstr ":class:`collections.abc.ValuesView`" msgid ":class:`contextlib.AbstractContextManager`" -msgstr "" +msgstr ":class:`contextlib.AbstractContextManager`" msgid ":class:`contextlib.AbstractAsyncContextManager`" -msgstr "" +msgstr ":class:`contextlib.AbstractAsyncContextManager`" msgid ":class:`dataclasses.Field`" -msgstr "" +msgstr ":class:`dataclasses.Field`" msgid ":class:`functools.cached_property`" -msgstr "" +msgstr ":class:`functools.cached_property`" msgid ":class:`functools.partialmethod`" -msgstr "" +msgstr ":class:`functools.partialmethod`" msgid ":class:`os.PathLike`" -msgstr "" +msgstr ":class:`os.PathLike`" msgid ":class:`queue.LifoQueue`" -msgstr "" +msgstr ":class:`queue.LifoQueue`" msgid ":class:`queue.Queue`" -msgstr "" +msgstr ":class:`queue.Queue`" msgid ":class:`queue.PriorityQueue`" -msgstr "" +msgstr ":class:`queue.PriorityQueue`" msgid ":class:`queue.SimpleQueue`" -msgstr "" +msgstr ":class:`queue.SimpleQueue`" msgid ":ref:`re.Pattern `" msgstr "" @@ -4408,28 +4420,28 @@ msgid ":ref:`re.Match `" msgstr "" msgid ":class:`shelve.BsdDbShelf`" -msgstr "" +msgstr ":class:`shelve.BsdDbShelf`" msgid ":class:`shelve.DbfilenameShelf`" -msgstr "" +msgstr ":class:`shelve.DbfilenameShelf`" msgid ":class:`shelve.Shelf`" -msgstr "" +msgstr ":class:`shelve.Shelf`" msgid ":class:`types.MappingProxyType`" -msgstr "" +msgstr ":class:`types.MappingProxyType`" msgid ":class:`weakref.WeakKeyDictionary`" -msgstr "" +msgstr ":class:`weakref.WeakKeyDictionary`" msgid ":class:`weakref.WeakMethod`" -msgstr "" +msgstr ":class:`weakref.WeakMethod`" msgid ":class:`weakref.WeakSet`" -msgstr "" +msgstr ":class:`weakref.WeakSet`" msgid ":class:`weakref.WeakValueDictionary`" -msgstr "" +msgstr ":class:`weakref.WeakValueDictionary`" msgid "Special Attributes of ``GenericAlias`` objects" msgstr "" @@ -4505,6 +4517,14 @@ msgid "" "class:`float`::" msgstr "" +msgid "" +"The ``|`` operand 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 "" @@ -4530,8 +4550,8 @@ msgid "" msgstr "" msgid "" -"However, union objects containing :ref:`parameterized generics ` cannot be used::" +"However, :ref:`parameterized generics ` in union objects " +"cannot be checked::" msgstr "" msgid "" @@ -4541,9 +4561,9 @@ msgid "" 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::" +"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 ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." @@ -4615,32 +4635,34 @@ msgstr "" msgid "" "Methods are functions that are called using the attribute notation. There " -"are two flavors: built-in methods (such as :meth:`append` on lists) and " -"class instance methods. Built-in methods are described with the types that " -"support them." +"are two flavors: :ref:`built-in methods ` (such as :meth:" +"`append` on lists) and :ref:`class instance method `. " +"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 :dfn:" -"`instance method`) object. When called, it will add the ``self`` argument to " -"the argument list. Bound methods have two special read-only attributes: ``m." -"__self__`` is the object on which the method operates, and ``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, " +"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 function objects, bound method objects support getting arbitrary " -"attributes. However, since method attributes are actually stored on the " -"underlying function object (``meth.__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::" +"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 "See :ref:`types` for more information." +msgid "See :ref:`instance-methods` for more information." msgstr "" msgid "Code Objects" @@ -4652,12 +4674,13 @@ msgid "" "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:" -"`__code__` attribute. See also the :mod:`code` module." +"`~function.__code__` attribute. See also the :mod:`code` module." msgstr "" msgid "" -"Accessing ``__code__`` raises an :ref:`auditing event ` ``object." -"__getattr__`` with arguments ``obj`` and ``\"__code__\"``." +"Accessing :attr:`~function.__code__` raises an :ref:`auditing event " +"` ``object.__getattr__`` with arguments ``obj`` and " +"``\"__code__\"``." msgstr "" msgid "" @@ -4665,6 +4688,9 @@ msgid "" "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 "" @@ -4709,11 +4735,11 @@ 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 ``NotImplemented`` object. " -"``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 ``NotImplemented``." +msgid "It is written as :code:`NotImplemented`." msgstr "" msgid "Boolean Values" @@ -4736,8 +4762,9 @@ msgid "Internal Objects" msgstr "" msgid "" -"See :ref:`types` for this information. It describes stack frame objects, " -"traceback objects, and slice objects." +"See :ref:`types` for this information. It describes :ref:`stack frame " +"objects `, :ref:`traceback objects `, and " +"slice objects." msgstr "" msgid "Special Attributes" @@ -4845,10 +4872,10 @@ msgid "``int(string, base)`` for all bases that are not a power of 2." msgstr "" msgid "``str(integer)``." -msgstr "" +msgstr "``str(integer)``." msgid "``repr(integer)``." -msgstr "" +msgstr "``repr(integer)``." msgid "" "any other string conversion to base 10, for example ``f\"{integer}\"``, " @@ -4915,7 +4942,7 @@ msgid "" msgstr "" msgid "" -"Information about the default and minimum can be found in :attr:`sys." +"Information about the default and minimum can be found in :data:`sys." "int_info`:" msgstr "" @@ -4958,7 +4985,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "If you need to disable it entirely, set it to ``0``." msgstr "" @@ -5012,7 +5039,7 @@ msgid "value" msgstr "" msgid "Boolean" -msgstr "" +msgstr "Wartość logiczna" msgid "operations" msgstr "" @@ -5057,7 +5084,7 @@ msgid "comparison" msgstr "" msgid "==" -msgstr "" +msgstr "==" msgid "< (less)" msgstr "" @@ -5081,7 +5108,7 @@ msgid "is not" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "numeric" msgstr "" @@ -5123,10 +5150,10 @@ msgid "floating point" msgstr "" msgid "complex number" -msgstr "" +msgstr "liczba zespolona" msgid "C" -msgstr "" +msgstr "C" msgid "language" msgstr "" @@ -5147,7 +5174,7 @@ msgid "arithmetic" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "int" msgstr "int" @@ -5171,7 +5198,7 @@ msgid "- (minus)" msgstr "" msgid "* (asterisk)" -msgstr "* (asterisk)" +msgstr "* (asterysk)" msgid "/ (slash)" msgstr "" @@ -5243,10 +5270,10 @@ msgid "protocol" msgstr "" msgid "iterator" -msgstr "" +msgstr "iterator" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "iteration" msgstr "" @@ -5258,7 +5285,7 @@ msgid "iteration over" msgstr "" msgid "len" -msgstr "" +msgstr "len" msgid "min" msgstr "" @@ -5303,7 +5330,7 @@ msgid "immutable" msgstr "" msgid "tuple" -msgstr "" +msgstr "tuple" msgid "hash" msgstr "" @@ -5312,13 +5339,13 @@ msgid "mutable" msgstr "" msgid "list" -msgstr "" +msgstr "lista" msgid "bytearray" msgstr "" msgid "type" -msgstr "" +msgstr "typ" msgid "assignment" msgstr "" @@ -5354,7 +5381,7 @@ msgid "range" msgstr "" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "text sequence type" msgstr "" @@ -5381,7 +5408,7 @@ msgid "re" msgstr "" msgid "universal newlines" -msgstr "" +msgstr "uniwersalne nowe linie" msgid "str.splitlines method" msgstr "" @@ -5414,7 +5441,7 @@ msgid ". (dot)" msgstr "" msgid "# (hash)" -msgstr "# (kratka)" +msgstr "# (hash)" msgid "space" msgstr "" @@ -5438,7 +5465,7 @@ msgid "formatting" msgstr "" msgid "bytes (%)" -msgstr "" +msgstr "bytes (%)" msgid "bytearray (%)" msgstr "" @@ -5447,16 +5474,16 @@ msgid "interpolation" msgstr "" msgid "set" -msgstr "" +msgstr "zestaw" msgid "mapping" msgstr "" msgid "dictionary" -msgstr "" +msgstr "słownik" msgid "__missing__()" -msgstr "" +msgstr "__missing__()" msgid "context manager" msgstr "" @@ -5468,7 +5495,7 @@ msgid "context management" msgstr "" msgid "annotation" -msgstr "" +msgstr "adnotacja" msgid "type annotation; type hint" msgstr "" @@ -5489,7 +5516,7 @@ msgid "union" msgstr "" msgid "method" -msgstr "" +msgstr "metoda" msgid "code" msgstr "" @@ -5504,16 +5531,16 @@ msgid "__code__ (function object attribute)" msgstr "" msgid "exec" -msgstr "" +msgstr "exec" msgid "eval" msgstr "" msgid "..." -msgstr "" +msgstr "..." msgid "ellipsis literal" -msgstr "" +msgstr "Literalny zapis wielokropka" msgid "values" msgstr "" diff --git a/library/string.po b/library/string.po index fdefcdbd1b..3dbdc80529 100644 --- a/library/string.po +++ b/library/string.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -237,16 +237,17 @@ msgstr "" msgid "" "The *field_name* itself begins with an *arg_name* that is either a number or " "a keyword. If it's a number, it refers to a positional argument, and if " -"it's a keyword, it refers to a named keyword argument. If the numerical " -"arg_names in a format string are 0, 1, 2, ... in sequence, they can all be " -"omitted (not just some) and the numbers 0, 1, 2, ... will be automatically " -"inserted in that order. Because *arg_name* is 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 :func:" -"`__getitem__`." +"it's a keyword, it refers to a named keyword argument. An *arg_name* is " +"treated as a number if a call to :meth:`str.isdecimal` on the string would " +"return true. If the numerical arg_names in a format string are 0, 1, 2, ... " +"in sequence, they can all be omitted (not just some) and the numbers 0, 1, " +"2, ... will be automatically inserted in that order. Because *arg_name* is " +"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 :func:`__getitem__`." msgstr "" msgid "" @@ -349,7 +350,7 @@ msgid "Meaning" msgstr "Znaczenie" msgid "``'<'``" -msgstr "" +msgstr "``'<'``" msgid "" "Forces the field to be left-aligned within the available space (this is the " @@ -357,7 +358,7 @@ msgid "" msgstr "" msgid "``'>'``" -msgstr "" +msgstr "``'>'``" msgid "" "Forces the field to be right-aligned within the available space (this is the " @@ -365,7 +366,7 @@ msgid "" msgstr "" msgid "``'='``" -msgstr "" +msgstr "``'='``" msgid "" "Forces the padding to be placed after the sign (if any) but before the " @@ -375,7 +376,7 @@ msgid "" msgstr "" msgid "``'^'``" -msgstr "" +msgstr "``'^'``" msgid "Forces the field to be centered within the available space." msgstr "" @@ -392,7 +393,7 @@ msgid "" msgstr "" msgid "``'+'``" -msgstr "" +msgstr "``'+'``" msgid "" "indicates that a sign should be used for both positive as well as negative " @@ -400,7 +401,7 @@ msgid "" msgstr "" msgid "``'-'``" -msgstr "" +msgstr "``'-'``" msgid "" "indicates that a sign should be used only for negative numbers (this is the " @@ -491,10 +492,10 @@ msgid "The available string presentation types are:" msgstr "" msgid "Type" -msgstr "" +msgstr "Typ" msgid "``'s'``" -msgstr "" +msgstr "``'s'``" msgid "String format. This is the default type for strings and may be omitted." msgstr "" @@ -515,7 +516,7 @@ msgid "Binary format. Outputs the number in base 2." msgstr "" msgid "``'c'``" -msgstr "" +msgstr "``'c'``" msgid "" "Character. Converts the integer to the corresponding unicode character " @@ -529,13 +530,13 @@ msgid "Decimal Integer. Outputs the number in base 10." msgstr "" msgid "``'o'``" -msgstr "" +msgstr "``'o'``" msgid "Octal format. Outputs the number in base 8." msgstr "" msgid "``'x'``" -msgstr "" +msgstr "``'x'``" msgid "" "Hex format. Outputs the number in base 16, using lower-case letters for the " @@ -543,7 +544,7 @@ msgid "" msgstr "" msgid "``'X'``" -msgstr "" +msgstr "``'X'``" msgid "" "Hex format. Outputs the number in base 16, using upper-case letters for the " @@ -552,7 +553,7 @@ msgid "" msgstr "" msgid "``'n'``" -msgstr "" +msgstr "``'n'``" msgid "" "Number. This is the same as ``'d'``, except that it uses the current locale " @@ -575,7 +576,7 @@ msgid "" msgstr "" msgid "``'e'``" -msgstr "" +msgstr "``'e'``" msgid "" "Scientific notation. For a given precision ``p``, formats the number in " @@ -589,7 +590,7 @@ msgid "" msgstr "" msgid "``'E'``" -msgstr "" +msgstr "``'E'``" msgid "" "Scientific notation. Same as ``'e'`` except it uses an upper case 'E' as the " @@ -610,7 +611,7 @@ msgid "" msgstr "" msgid "``'F'``" -msgstr "" +msgstr "``'F'``" msgid "" "Fixed-point notation. Same as ``'f'``, but converts ``nan`` to ``NAN`` and " @@ -618,7 +619,7 @@ msgid "" msgstr "" msgid "``'g'``" -msgstr "" +msgstr "``'g'``" msgid "" "General format. For a given precision ``p >= 1``, this rounds the number to " @@ -655,7 +656,7 @@ msgid "" msgstr "" msgid "``'G'``" -msgstr "" +msgstr "``'G'``" msgid "" "General format. Same as ``'g'`` except switches to ``'E'`` if the number " @@ -668,7 +669,7 @@ msgid "" msgstr "" msgid "``'%'``" -msgstr "" +msgstr "``'%'``" msgid "" "Percentage. Multiplies the number by 100 and displays in fixed (``'f'``) " @@ -977,7 +978,7 @@ msgid "z" msgstr "" msgid "# (hash)" -msgstr "# (kratka)" +msgstr "# (hash)" msgid ", (comma)" msgstr "" @@ -986,7 +987,7 @@ msgid "_ (underscore)" msgstr "" msgid "$ (dollar)" -msgstr "" +msgstr "$ (dollar)" msgid "in template strings" msgstr "" diff --git a/library/struct.po b/library/struct.po index 1b1ae52fcf..8e85abe5ef 100644 --- a/library/struct.po +++ b/library/struct.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Tomasz Rodzen , 2021 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -146,7 +145,7 @@ msgid "" msgstr "" msgid "Character" -msgstr "" +msgstr "Znak" msgid "Byte order" msgstr "" @@ -158,13 +157,13 @@ msgid "Alignment" msgstr "" msgid "``@``" -msgstr "" +msgstr "``@``" msgid "native" msgstr "" msgid "``=``" -msgstr "" +msgstr "``=``" msgid "standard" msgstr "" @@ -173,19 +172,19 @@ msgid "none" msgstr "" msgid "``<``" -msgstr "" +msgstr "``<``" msgid "little-endian" msgstr "" msgid "``>``" -msgstr "" +msgstr "``>``" msgid "big-endian" msgstr "" msgid "``!``" -msgstr "" +msgstr "``!``" msgid "network (= big-endian)" msgstr "" @@ -193,6 +192,20 @@ msgstr "" msgid "If the first character is not one of these, ``'@'`` is assumed." msgstr "" +msgid "" +"The number 1023 (``0x3ff`` in hexadecimal) has the following byte " +"representations:" +msgstr "" + +msgid "``03 ff`` in big-endian (``>``)" +msgstr "" + +msgid "``ff 03`` in little-endian (``<``)" +msgstr "" + +msgid "Python example:" +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-" @@ -272,7 +285,7 @@ msgid "Notes" msgstr "Notatki" msgid "``x``" -msgstr "" +msgstr "``x``" msgid "pad byte" msgstr "" @@ -284,10 +297,10 @@ msgid "\\(7)" msgstr "" msgid "``c``" -msgstr "" +msgstr "``c``" msgid ":c:expr:`char`" -msgstr "" +msgstr ":c:expr:`char`" msgid "bytes of length 1" msgstr "" @@ -296,7 +309,7 @@ msgid "1" msgstr "1" msgid "``b``" -msgstr "" +msgstr "``b``" msgid ":c:expr:`signed char`" msgstr "" @@ -308,7 +321,7 @@ msgid "\\(1), \\(2)" msgstr "" msgid "``B``" -msgstr "" +msgstr "``B``" msgid ":c:expr:`unsigned char`" msgstr "" @@ -317,10 +330,10 @@ msgid "\\(2)" msgstr "\\(2)" msgid "``?``" -msgstr "" +msgstr "``?``" msgid ":c:expr:`_Bool`" -msgstr "" +msgstr ":c:expr:`_Bool`" msgid "bool" msgstr "" @@ -329,49 +342,49 @@ msgid "\\(1)" msgstr "\\(1)" msgid "``h``" -msgstr "" +msgstr "``h``" msgid ":c:expr:`short`" -msgstr "" +msgstr ":c:expr:`short`" msgid "2" msgstr "2" msgid "``H``" -msgstr "" +msgstr "``H``" msgid ":c:expr:`unsigned short`" msgstr "" msgid "``i``" -msgstr "" +msgstr "``i``" msgid ":c:expr:`int`" -msgstr "" +msgstr ":c:expr:`int`" msgid "4" msgstr "4" msgid "``I``" -msgstr "" +msgstr "``I``" msgid ":c:expr:`unsigned int`" msgstr "" msgid "``l``" -msgstr "" +msgstr "``l``" msgid ":c:expr:`long`" -msgstr "" +msgstr ":c:expr:`long`" msgid "``L``" -msgstr "" +msgstr "``L``" msgid ":c:expr:`unsigned long`" msgstr "" msgid "``q``" -msgstr "" +msgstr "``q``" msgid ":c:expr:`long long`" msgstr "" @@ -380,28 +393,28 @@ msgid "8" msgstr "8" msgid "``Q``" -msgstr "" +msgstr "``Q``" msgid ":c:expr:`unsigned long long`" msgstr "" msgid "``n``" -msgstr "" +msgstr "``n``" -msgid ":c:expr:`ssize_t`" -msgstr "" +msgid ":c:type:`ssize_t`" +msgstr ":c:type:`ssize_t`" msgid "\\(3)" msgstr "\\(3)" msgid "``N``" -msgstr "" +msgstr "``N``" -msgid ":c:expr:`size_t`" -msgstr "" +msgid ":c:type:`size_t`" +msgstr ":c:type:`size_t`" msgid "``e``" -msgstr "" +msgstr "``e``" msgid "\\(6)" msgstr "" @@ -413,22 +426,22 @@ msgid "\\(4)" msgstr "\\(4)" msgid "``f``" -msgstr "" +msgstr "``f``" msgid ":c:expr:`float`" -msgstr "" +msgstr ":c:expr:`float`" msgid "``d``" -msgstr "" +msgstr "``d``" msgid ":c:expr:`double`" -msgstr "" +msgstr ":c:expr:`double`" msgid "``s``" -msgstr "" +msgstr "``s``" msgid ":c:expr:`char[]`" -msgstr "" +msgstr ":c:expr:`char[]`" msgid "bytes" msgstr "" @@ -437,13 +450,13 @@ msgid "\\(9)" msgstr "" msgid "``p``" -msgstr "" +msgstr "``p``" msgid "\\(8)" msgstr "" msgid "``P``" -msgstr "" +msgstr "``P``" msgid ":c:expr:`void \\*`" msgstr "" @@ -465,11 +478,11 @@ msgstr "" msgid "" "When attempting to pack a non-integer using any of the integer conversion " -"codes, if the non-integer has a :meth:`__index__` method then that method is " -"called to convert the argument to an integer before packing." +"codes, if the non-integer has a :meth:`~object.__index__` method then that " +"method is called to convert the argument to an integer before packing." msgstr "" -msgid "Added use of the :meth:`__index__` method for non-integers." +msgid "Added use of the :meth:`~object.__index__` method for non-integers." msgstr "" msgid "" @@ -611,13 +624,13 @@ msgid "Packed binary storage of homogeneous data." msgstr "" msgid "Module :mod:`json`" -msgstr "" +msgstr "moduł :mod:`json`" msgid "JSON encoder and decoder." msgstr "" msgid "Module :mod:`pickle`" -msgstr "" +msgstr "moduł :mod:`pickle`" msgid "Python object serialization." msgstr "" @@ -748,7 +761,7 @@ msgid "" msgstr "" msgid "C" -msgstr "" +msgstr "C" msgid "structures" msgstr "" diff --git a/library/subprocess.po b/library/subprocess.po index df96f83b9f..d8f1e43b75 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,26 +77,29 @@ msgstr "" msgid "" "If *capture_output* is true, stdout and stderr will be captured. When used, " -"the internal :class:`Popen` object is automatically created with " -"``stdout=PIPE`` and ``stderr=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, use ``stdout=PIPE`` and " -"``stderr=STDOUT`` instead of *capture_output*." +"the internal :class:`Popen` object is automatically created with *stdout* " +"and *stdin* 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*." msgstr "" msgid "" -"The *timeout* argument is passed 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." +"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=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 "" @@ -125,7 +127,7 @@ msgid "" msgstr "" msgid "Examples::" -msgstr "" +msgstr "Przykłady::" msgid "Added *encoding* and *errors* parameters" msgstr "" @@ -306,7 +308,7 @@ msgid "" "binary streams. No encoding or line ending conversion is performed." msgstr "" -msgid "Added *encoding* and *errors* parameters." +msgid "Added the *encoding* and *errors* parameters." msgstr "" msgid "Added the *text* parameter as an alias for *universal_newlines*." @@ -466,12 +468,12 @@ msgid "" msgstr "" msgid "" -":const:`0` means unbuffered (read and write are one system call and can " -"return short)" +"``0`` means unbuffered (read and write are one system call and can return " +"short)" msgstr "" msgid "" -":const:`1` means line buffered (only usable if ``text=True`` or " +"``1`` means line buffered (only usable if ``text=True`` or " "``universal_newlines=True``)" msgstr "" @@ -486,9 +488,9 @@ msgstr "" msgid "" "*bufsize* now defaults to -1 to enable buffering by default to match the " "behavior that most code expects. In versions prior to Python 3.2.4 and " -"3.3.1 it incorrectly defaulted to :const:`0` which was unbuffered and " -"allowed short reads. This was unintentional and did not match the behavior " -"of Python 2 as most code expected." +"3.3.1 it incorrectly defaulted to ``0`` which was unbuffered and allowed " +"short reads. This was unintentional and did not match the behavior of " +"Python 2 as most code expected." msgstr "" msgid "" @@ -550,10 +552,10 @@ msgid "" msgstr "" msgid "" -"If *close_fds* is true, all file descriptors except :const:`0`, :const:`1` " -"and :const:`2` will be closed before the child process is executed. " -"Otherwise when *close_fds* is false, file descriptors obey their inheritable " -"flag as described in :ref:`fd_inheritance`." +"If *close_fds* is true, all file descriptors except ``0``, ``1`` and ``2`` " +"will be closed before the child process is executed. Otherwise when " +"*close_fds* is false, file descriptors obey their inheritable flag as " +"described in :ref:`fd_inheritance`." msgstr "" msgid "" @@ -688,45 +690,47 @@ msgstr "" msgid "" "If given, *startupinfo* will be a :class:`STARTUPINFO` object, which is " -"passed to the underlying ``CreateProcess`` function. *creationflags*, if " -"given, can be one or more of the following flags:" +"passed to the underlying ``CreateProcess`` function." msgstr "" -msgid ":data:`CREATE_NEW_CONSOLE`" +msgid "If given, *creationflags*, can be one or more of the following flags:" msgstr "" +msgid ":data:`CREATE_NEW_CONSOLE`" +msgstr ":data:`CREATE_NEW_CONSOLE`" + msgid ":data:`CREATE_NEW_PROCESS_GROUP`" -msgstr "" +msgstr ":data:`CREATE_NEW_PROCESS_GROUP`" msgid ":data:`ABOVE_NORMAL_PRIORITY_CLASS`" -msgstr "" +msgstr ":data:`ABOVE_NORMAL_PRIORITY_CLASS`" msgid ":data:`BELOW_NORMAL_PRIORITY_CLASS`" -msgstr "" +msgstr ":data:`BELOW_NORMAL_PRIORITY_CLASS`" msgid ":data:`HIGH_PRIORITY_CLASS`" -msgstr "" +msgstr ":data:`HIGH_PRIORITY_CLASS`" msgid ":data:`IDLE_PRIORITY_CLASS`" -msgstr "" +msgstr ":data:`IDLE_PRIORITY_CLASS`" msgid ":data:`NORMAL_PRIORITY_CLASS`" -msgstr "" +msgstr ":data:`NORMAL_PRIORITY_CLASS`" msgid ":data:`REALTIME_PRIORITY_CLASS`" -msgstr "" +msgstr ":data:`REALTIME_PRIORITY_CLASS`" msgid ":data:`CREATE_NO_WINDOW`" -msgstr "" +msgstr ":data:`CREATE_NO_WINDOW`" msgid ":data:`DETACHED_PROCESS`" -msgstr "" +msgstr ":data:`DETACHED_PROCESS`" msgid ":data:`CREATE_DEFAULT_ERROR_MODE`" -msgstr "" +msgstr ":data:`CREATE_DEFAULT_ERROR_MODE`" msgid ":data:`CREATE_BREAKAWAY_FROM_JOB`" -msgstr "" +msgstr ":data:`CREATE_BREAKAWAY_FROM_JOB`" msgid "" "*pipesize* can be used to change the size of the pipe when :data:`PIPE` is " @@ -735,7 +739,7 @@ msgid "" "platforms will ignore this parameter." msgstr "" -msgid "The ``pipesize`` parameter was added." +msgid "Added the *pipesize* parameter." msgstr "" msgid "" @@ -802,8 +806,8 @@ msgstr "" msgid "" "All of the functions and methods that accept a *timeout* parameter, such as :" -"func:`call` and :meth:`Popen.communicate` will raise :exc:`TimeoutExpired` " -"if the timeout expires before the process exits." +"func:`run` and :meth:`Popen.communicate` will raise :exc:`TimeoutExpired` if " +"the timeout expires before the process exits." msgstr "" msgid "" @@ -817,8 +821,8 @@ msgid "Security Considerations" msgstr "" msgid "" -"Unlike some other popen functions, this implementation will never implicitly " -"call a system shell. This means that all characters, including shell " +"Unlike some other popen functions, this library will not implicitly choose " +"to call a system shell. This means that all characters, including shell " "metacharacters, can safely be passed to child processes. If the shell is " "invoked explicitly, via ``shell=True``, it is the application's " "responsibility to ensure that all whitespace and metacharacters are quoted " @@ -828,6 +832,16 @@ msgid "" "escaping." msgstr "" +msgid "" +"On Windows, batch files (:file:`*.bat` or :file:`*.cmd`) may be launched by " +"the operating system in a system shell regardless of the arguments passed to " +"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." +msgstr "" + msgid "Popen Objects" msgstr "" @@ -858,9 +872,10 @@ msgid "" msgstr "" msgid "" -"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`." +"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`." msgstr "" msgid "*timeout* was added." @@ -917,9 +932,9 @@ msgid "" msgstr "" msgid "" -"Stop the child. On POSIX OSs the method sends SIGTERM to the child. On " -"Windows the Win32 API function :c:func:`TerminateProcess` is called to stop " -"the child." +"Stop the child. On POSIX OSs the method sends :py:const:`~signal.SIGTERM` to " +"the child. On Windows the Win32 API function :c:func:`!TerminateProcess` is " +"called to stop the child." msgstr "" msgid "" @@ -1357,7 +1372,7 @@ msgstr "" msgid "Return code handling translates as follows::" msgstr "" -msgid "Replacing functions from the :mod:`popen2` module" +msgid "Replacing functions from the :mod:`!popen2` module" msgstr "" msgid "" @@ -1422,9 +1437,6 @@ msgid "" "`~Popen.returncode`." msgstr "" -msgid "Added *encoding* and *errors* arguments." -msgstr "" - msgid "Return output (stdout and stderr) of executing *cmd* in a shell." msgstr "" @@ -1476,7 +1488,7 @@ msgid "" msgstr "" msgid ":mod:`shlex`" -msgstr "" +msgstr ":mod:`shlex`" msgid "Module which provides function to parse and escape command lines." msgstr "" @@ -1492,14 +1504,14 @@ msgstr "" msgid "" "If you ever encounter a presumed highly unusual situation where you need to " -"prevent ``vfork()`` from being used by Python, you can set the :attr:" +"prevent ``vfork()`` from being used by Python, you can set the :const:" "`subprocess._USE_VFORK` attribute to a false value." msgstr "" msgid "" "Setting this has no impact on use of ``posix_spawn()`` which could use " "``vfork()`` internally within its libc implementation. There is a similar :" -"attr:`subprocess._USE_POSIX_SPAWN` attribute if you need to prevent use of " +"const:`subprocess._USE_POSIX_SPAWN` attribute if you need to prevent use of " "that." msgstr "" @@ -1523,7 +1535,7 @@ msgid "``_USE_VFORK``" msgstr "" msgid "universal newlines" -msgstr "" +msgstr "uniwersalne nowe linie" msgid "subprocess module" msgstr "" diff --git a/library/sunau.po b/library/sunau.po index bbf413f30e..5d54169698 100644 --- a/library/sunau.po +++ b/library/sunau.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +47,7 @@ msgid "" msgstr "" msgid "Field" -msgstr "" +msgstr "Pole" msgid "Contents" msgstr "Zawartość" @@ -108,13 +109,13 @@ msgid "" msgstr "" msgid "``'r'``" -msgstr "" +msgstr "``'r'``" msgid "Read only mode." msgstr "" msgid "``'w'``" -msgstr "" +msgstr "``'w'``" msgid "Write only mode." msgstr "" @@ -225,7 +226,7 @@ msgid "" msgstr "" msgid "Returns ``None``." -msgstr "" +msgstr "Returns ``None``." msgid "Raise an error." msgstr "" diff --git a/library/symtable.po b/library/symtable.po index 41945a4627..4a87ad6434 100644 --- a/library/symtable.po +++ b/library/symtable.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -94,7 +94,7 @@ msgid "Return a list of the nested symbol tables." msgstr "" msgid "" -"A namespace for a function or method. This class inherits :class:" +"A namespace for a function or method. This class inherits from :class:" "`SymbolTable`." msgstr "" @@ -113,7 +113,7 @@ msgstr "" msgid "Return a tuple containing names of free variables in this function." msgstr "" -msgid "A namespace of a class. This class inherits :class:`SymbolTable`." +msgid "A namespace of a class. This class inherits from :class:`SymbolTable`." msgstr "" msgid "Return a tuple containing the names of methods declared in the class." diff --git a/library/sys.po b/library/sys.po index 7276b8bc8b..86d3f14a75 100644 --- a/library/sys.po +++ b/library/sys.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,11 +68,6 @@ msgid "" "mod:`ctypes`) should be completely removed or closely monitored." msgstr "" -msgid "" -"Raises an :ref:`auditing event ` ``sys.addaudithook`` with no " -"arguments." -msgstr "" - msgid "" "Calling :func:`sys.addaudithook` will itself raise an auditing event named " "``sys.addaudithook`` with no arguments. If any existing hooks raise an " @@ -190,13 +185,19 @@ msgid "" "other way --- ``modules.keys()`` only lists the imported modules.)" msgstr "" -msgid "See also the :attr:`sys.stdlib_module_names` list." +msgid "See also the :data:`sys.stdlib_module_names` list." msgstr "" msgid "" "Call ``func(*args)``, while tracing is enabled. The tracing state is saved, " "and restored afterwards. This is intended to be called from a debugger from " -"a checkpoint, to recursively debug some other code." +"a checkpoint, to recursively debug or profile some other code." +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." msgstr "" msgid "A string containing the copyright pertaining to the Python interpreter." @@ -343,37 +344,19 @@ msgid "" "in the future." msgstr "" -msgid "Attribute" -msgstr "" - -msgid "Explanation" -msgstr "Wytłumaczenie" - -msgid ":const:`emscripten_version`" -msgstr "" - msgid "" "Emscripten version as tuple of ints (major, minor, micro), e.g. ``(3, 1, " "8)``." msgstr "" -msgid ":const:`runtime`" -msgstr "" - msgid "" "Runtime string, e.g. browser user agent, ``'Node.js v14.18.2'``, or " "``'UNKNOWN'``." msgstr "" -msgid ":const:`pthreads`" -msgstr "" - msgid "``True`` if Python is compiled with Emscripten pthreads support." msgstr "" -msgid ":const:`shared_memory`" -msgstr "" - msgid "``True`` if Python is compiled with shared memory support." msgstr "" @@ -406,13 +389,13 @@ msgid "" msgstr "" msgid "" -"When an exception is raised and uncaught, the interpreter calls ``sys." -"excepthook`` with three arguments, the exception class, exception instance, " -"and a traceback object. In an interactive session this happens just before " -"control is returned to the prompt; in a Python program this happens just " -"before the program exits. The handling of such top-level exceptions can be " -"customized by assigning another three-argument function to ``sys." -"excepthook``." +"When an exception other than :exc:`SystemExit` is raised and uncaught, the " +"interpreter calls ``sys.excepthook`` with three arguments, the exception " +"class, exception instance, and a traceback object. In an interactive " +"session this happens just before control is returned to the prompt; in a " +"Python program this happens just before the program exits. The handling of " +"such top-level exceptions can be customized by assigning another three-" +"argument function to ``sys.excepthook``." msgstr "" msgid "" @@ -444,10 +427,10 @@ msgid "" msgstr "" msgid "__breakpointhook__" -msgstr "" +msgstr "__breakpointhook__" msgid "__unraisablehook__" -msgstr "" +msgstr "__unraisablehook__" msgid "" "This function, when called while an exception handler is executing (such as " @@ -545,113 +528,59 @@ msgid "" "The attributes are read only." msgstr "" -msgid "attribute" -msgstr "atrybut" - -msgid "flag" -msgstr "" - -msgid ":const:`debug`" -msgstr "" - msgid ":option:`-d`" -msgstr "" - -msgid ":const:`inspect`" -msgstr "" +msgstr ":option:`-d`" msgid ":option:`-i`" -msgstr "" - -msgid ":const:`interactive`" -msgstr "" - -msgid ":const:`isolated`" -msgstr "" +msgstr ":option:`-i`" msgid ":option:`-I`" -msgstr "" - -msgid ":const:`optimize`" -msgstr "" +msgstr ":option:`-I`" msgid ":option:`-O` or :option:`-OO`" msgstr "" -msgid ":const:`dont_write_bytecode`" -msgstr "" - msgid ":option:`-B`" -msgstr "" - -msgid ":const:`no_user_site`" -msgstr "" +msgstr ":option:`-B`" msgid ":option:`-s`" -msgstr "" - -msgid ":const:`no_site`" -msgstr "" +msgstr ":option:`-s`" msgid ":option:`-S`" -msgstr "" - -msgid ":const:`ignore_environment`" -msgstr "" +msgstr ":option:`-S`" msgid ":option:`-E`" -msgstr "" - -msgid ":const:`verbose`" -msgstr "" +msgstr ":option:`-E`" msgid ":option:`-v`" -msgstr "" - -msgid ":const:`bytes_warning`" -msgstr "" +msgstr ":option:`-v`" msgid ":option:`-b`" -msgstr "" - -msgid ":const:`quiet`" -msgstr "" +msgstr ":option:`-b`" msgid ":option:`-q`" -msgstr "" - -msgid ":const:`hash_randomization`" -msgstr "" +msgstr ":option:`-q`" msgid ":option:`-R`" -msgstr "" - -msgid ":const:`dev_mode`" -msgstr "" +msgstr ":option:`-R`" msgid ":option:`-X dev <-X>` (:ref:`Python Development Mode `)" msgstr "" -msgid ":const:`utf8_mode`" -msgstr "" - msgid ":option:`-X utf8 <-X>`" msgstr "" -msgid ":const:`safe_path`" -msgstr "" - msgid ":option:`-P`" -msgstr "" - -msgid ":const:`int_max_str_digits`" -msgstr "" +msgstr ":option:`-P`" msgid "" ":option:`-X int_max_str_digits <-X>` (:ref:`integer string conversion length " "limitation `)" msgstr "" +msgid ":option:`-X warn_default_encoding <-X>`" +msgstr "" + msgid "Added ``quiet`` attribute for the new :option:`-q` flag." msgstr "" @@ -670,6 +599,11 @@ msgid "" "``utf8`` flag." msgstr "" +msgid "" +"Added ``warn_default_encoding`` attribute for :option:`-X` " +"``warn_default_encoding`` flag." +msgstr "" + msgid "Added the ``safe_path`` attribute for :option:`-P` option." msgstr "" @@ -685,86 +619,71 @@ msgid "" "floating types', for details." msgstr "" -msgid "float.h macro" +msgid "Attributes of the :data:`!float_info` :term:`named tuple`" msgstr "" -msgid "explanation" -msgstr "" +msgid "attribute" +msgstr "atrybut" -msgid "``epsilon``" +msgid "float.h macro" msgstr "" -msgid "``DBL_EPSILON``" +msgid "explanation" msgstr "" +msgid ":c:macro:`!DBL_EPSILON`" +msgstr ":c:macro:`!DBL_EPSILON`" + msgid "" "difference between 1.0 and the least value greater than 1.0 that is " -"representable as a float" +"representable as a float." msgstr "" msgid "See also :func:`math.ulp`." msgstr "" -msgid "``dig``" -msgstr "" - -msgid "``DBL_DIG``" -msgstr "" +msgid ":c:macro:`!DBL_DIG`" +msgstr ":c:macro:`!DBL_DIG`" msgid "" -"maximum number of decimal digits that can be faithfully represented in a " -"float; see below" -msgstr "" - -msgid "``mant_dig``" +"The maximum number of decimal digits that can be faithfully represented in a " +"float; see below." msgstr "" -msgid "``DBL_MANT_DIG``" -msgstr "" +msgid ":c:macro:`!DBL_MANT_DIG`" +msgstr ":c:macro:`!DBL_MANT_DIG`" msgid "" -"float precision: the number of base-``radix`` digits in the significand of a " -"float" -msgstr "" - -msgid "``max``" +"Float precision: the number of base-``radix`` digits in the significand of a " +"float." msgstr "" -msgid "``DBL_MAX``" -msgstr "" +msgid ":c:macro:`!DBL_MAX`" +msgstr ":c:macro:`!DBL_MAX`" -msgid "maximum representable positive finite float" +msgid "The maximum representable positive finite float." msgstr "" -msgid "``max_exp``" -msgstr "" - -msgid "``DBL_MAX_EXP``" -msgstr "" +msgid ":c:macro:`!DBL_MAX_EXP`" +msgstr ":c:macro:`!DBL_MAX_EXP`" msgid "" -"maximum integer *e* such that ``radix**(e-1)`` is a representable finite " -"float" +"The maximum integer *e* such that ``radix**(e-1)`` is a representable finite " +"float." msgstr "" -msgid "``max_10_exp``" -msgstr "" - -msgid "``DBL_MAX_10_EXP``" -msgstr "" +msgid ":c:macro:`!DBL_MAX_10_EXP`" +msgstr ":c:macro:`!DBL_MAX_10_EXP`" msgid "" -"maximum integer *e* such that ``10**e`` is in the range of representable " -"finite floats" +"The maximum integer *e* such that ``10**e`` is in the range of representable " +"finite floats." msgstr "" -msgid "``min``" -msgstr "" - -msgid "``DBL_MIN``" -msgstr "" +msgid ":c:macro:`!DBL_MIN`" +msgstr ":c:macro:`!DBL_MIN`" -msgid "minimum representable positive *normalized* float" +msgid "The minimum representable positive *normalized* float." msgstr "" msgid "" @@ -772,54 +691,57 @@ msgid "" "*denormalized* representable float." msgstr "" -msgid "``min_exp``" -msgstr "" +msgid ":c:macro:`!DBL_MIN_EXP`" +msgstr ":c:macro:`!DBL_MIN_EXP`" -msgid "``DBL_MIN_EXP``" +msgid "" +"The minimum integer *e* such that ``radix**(e-1)`` is a normalized float." msgstr "" -msgid "minimum integer *e* such that ``radix**(e-1)`` is a normalized float" -msgstr "" +msgid ":c:macro:`!DBL_MIN_10_EXP`" +msgstr ":c:macro:`!DBL_MIN_10_EXP`" -msgid "``min_10_exp``" +msgid "The minimum integer *e* such that ``10**e`` is a normalized float." msgstr "" -msgid "``DBL_MIN_10_EXP``" -msgstr "" +msgid ":c:macro:`!FLT_RADIX`" +msgstr ":c:macro:`!FLT_RADIX`" -msgid "minimum integer *e* such that ``10**e`` is a normalized float" +msgid "The radix of exponent representation." msgstr "" -msgid "``radix``" +msgid ":c:macro:`!FLT_ROUNDS`" +msgstr ":c:macro:`!FLT_ROUNDS`" + +msgid "" +"An integer representing the rounding mode for floating-point arithmetic. " +"This reflects the value of the system :c:macro:`!FLT_ROUNDS` macro at " +"interpreter startup time:" msgstr "" -msgid "``FLT_RADIX``" +msgid "``-1``: indeterminable" msgstr "" -msgid "radix of exponent representation" +msgid "``0``: toward zero" msgstr "" -msgid "``rounds``" +msgid "``1``: to nearest" msgstr "" -msgid "``FLT_ROUNDS``" +msgid "``2``: toward positive infinity" msgstr "" -msgid "" -"integer representing the rounding mode for floating-point arithmetic. This " -"reflects the value of the system ``FLT_ROUNDS`` macro at interpreter startup " -"time: ``-1`` indeterminable, ``0`` toward zero, ``1`` to nearest, ``2`` " -"toward positive infinity, ``3`` toward negative infinity" +msgid "``3``: toward negative infinity" msgstr "" msgid "" -"All other values for ``FLT_ROUNDS`` characterize implementation-defined " -"rounding behavior." +"All other values for :c:macro:`!FLT_ROUNDS` characterize implementation-" +"defined rounding behavior." 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." +"``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 "" @@ -866,7 +788,7 @@ msgstr "" msgid "" "Return the current value of the flags that are used for :c:func:`dlopen` " "calls. Symbolic names for the flag values can be found in the :mod:`os` " -"module (``RTLD_xxx`` constants, e.g. :data:`os.RTLD_LAZY`)." +"module (:samp:`RTLD_{xxx}` constants, e.g. :const:`os.RTLD_LAZY`)." msgstr "" msgid ":ref:`Availability `: Unix." @@ -930,6 +852,12 @@ msgid "" "reference as an argument to :func:`getrefcount`." msgstr "" +msgid "" +"Note that the returned value may not actually reflect how many references to " +"the object are actually held. Consequently, do not rely on the returned " +"value to be accurate, other than a value of 0 or 1." +msgstr "" + msgid "" "Return the current value of the recursion limit, the maximum depth of the " "Python interpreter stack. This limit prevents infinite recursion from " @@ -1012,7 +940,7 @@ msgid "" "first 5 elements are retrievable by indexing." msgstr "" -msgid "*platform* will be :const:`2 (VER_PLATFORM_WIN32_NT)`." +msgid "*platform* will be ``2`` (VER_PLATFORM_WIN32_NT)." msgstr "" msgid "*product_type* may be one of the following values:" @@ -1024,27 +952,27 @@ msgstr "Stała" msgid "Meaning" msgstr "Znaczenie" -msgid ":const:`1 (VER_NT_WORKSTATION)`" +msgid "``1`` (VER_NT_WORKSTATION)" msgstr "" msgid "The system is a workstation." msgstr "" -msgid ":const:`2 (VER_NT_DOMAIN_CONTROLLER)`" +msgid "``2`` (VER_NT_DOMAIN_CONTROLLER)" msgstr "" msgid "The system is a domain controller." msgstr "" -msgid ":const:`3 (VER_NT_SERVER)`" +msgid "``3`` (VER_NT_SERVER)" msgstr "" msgid "The system is a server, but not a domain controller." msgstr "" msgid "" -"This function wraps the Win32 :c:func:`GetVersionEx` function; see the " -"Microsoft documentation on :c:func:`OSVERSIONINFOEX` for more information " +"This function wraps the Win32 :c:func:`!GetVersionEx` function; see the " +"Microsoft documentation on :c:func:`!OSVERSIONINFOEX` for more information " "about these fields." msgstr "" @@ -1101,52 +1029,28 @@ msgid "" "For more details about hashing of numeric types, see :ref:`numeric-hash`." msgstr "" -msgid ":const:`width`" -msgstr "" - -msgid "width in bits used for hash values" -msgstr "" - -msgid ":const:`modulus`" -msgstr "" - -msgid "prime modulus P used for numeric hash scheme" -msgstr "" - -msgid ":const:`inf`" -msgstr "" - -msgid "hash value returned for a positive infinity" -msgstr "" - -msgid ":const:`nan`" +msgid "The width in bits used for hash values" msgstr "" -msgid "(this attribute is no longer used)" +msgid "The prime modulus P used for numeric hash scheme" msgstr "" -msgid ":const:`imag`" +msgid "The hash value returned for a positive infinity" msgstr "" -msgid "multiplier used for the imaginary part of a complex number" +msgid "(This attribute is no longer used)" msgstr "" -msgid ":const:`algorithm`" +msgid "The multiplier used for the imaginary part of a complex number" msgstr "" -msgid "name of the algorithm for hashing of str, bytes, and memoryview" +msgid "The name of the algorithm for hashing of str, bytes, and memoryview" msgstr "" -msgid ":const:`hash_bits`" +msgid "The internal output size of the hash algorithm" msgstr "" -msgid "internal output size of the hash algorithm" -msgstr "" - -msgid ":const:`seed_bits`" -msgstr "" - -msgid "size of the seed key of the hash algorithm" +msgid "The size of the seed key of the hash algorithm" msgstr "" msgid "Added *algorithm*, *hash_bits* and *seed_bits*" @@ -1224,37 +1128,27 @@ msgid "" "representation of integers. The attributes are read only." msgstr "" -msgid ":const:`bits_per_digit`" -msgstr "" - msgid "" -"number of bits held in each digit. Python integers are stored internally in " -"base ``2**int_info.bits_per_digit``" -msgstr "" - -msgid ":const:`sizeof_digit`" +"The number of bits held in each digit. Python integers are stored internally " +"in base ``2**int_info.bits_per_digit``." msgstr "" -msgid "size in bytes of the C type used to represent a digit" -msgstr "" - -msgid ":const:`default_max_str_digits`" +msgid "The size in bytes of the C type used to represent a digit." msgstr "" msgid "" -"default value for :func:`sys.get_int_max_str_digits` when it is not " +"The default value for :func:`sys.get_int_max_str_digits` when it is not " "otherwise explicitly configured." msgstr "" -msgid ":const:`str_digits_check_threshold`" -msgstr "" - msgid "" -"minimum non-zero value for :func:`sys.set_int_max_str_digits`, :envvar:" +"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 ``default_max_str_digits`` and ``str_digits_check_threshold``." +msgid "" +"Added :attr:`~int_info.default_max_str_digits` and :attr:`~int_info." +"str_digits_check_threshold`." msgstr "" msgid "" @@ -1341,7 +1235,7 @@ msgid "" msgstr "" msgid ":class:`importlib.abc.MetaPathFinder`" -msgstr "" +msgstr ":class:`importlib.abc.MetaPathFinder`" msgid "" "The abstract base class defining the interface of finder objects on :data:" @@ -1349,7 +1243,7 @@ msgid "" msgstr "" msgid ":class:`importlib.machinery.ModuleSpec`" -msgstr "" +msgstr ":class:`importlib.machinery.ModuleSpec`" msgid "" "The concrete class which :meth:`~importlib.abc.MetaPathFinder.find_spec` " @@ -1380,7 +1274,11 @@ msgid "" "executable." msgstr "" -msgid "See also :data:`sys.argv`." +msgid "" +"The elements of :data:`sys.orig_argv` are the arguments to the Python " +"interpreter, while the elements of :data:`sys.argv` are the arguments to the " +"user's program. Arguments consumed by the interpreter itself will be present " +"in :data:`sys.orig_argv` and missing from :data:`sys.argv`." msgstr "" msgid "" @@ -1466,7 +1364,7 @@ msgid "System" msgstr "" msgid "``platform`` value" -msgstr "" +msgstr "``platform`` value" msgid "AIX" msgstr "" @@ -1484,19 +1382,19 @@ msgid "Linux" msgstr "" msgid "``'linux'``" -msgstr "" +msgstr "``'linux'``" msgid "WASI" msgstr "" msgid "``'wasi'``" -msgstr "" +msgstr "``'wasi'``" msgid "Windows" -msgstr "" +msgstr "Windows" msgid "``'win32'``" -msgstr "" +msgstr "``'win32'``" msgid "Windows/Cygwin" msgstr "" @@ -1511,21 +1409,21 @@ msgid "``'darwin'``" msgstr "" msgid "" -"On Linux, :attr:`sys.platform` doesn't contain the major version anymore. It " +"On Linux, :data:`sys.platform` doesn't contain the major version anymore. It " "is always ``'linux'``, instead of ``'linux2'`` or ``'linux3'``. Since older " "Python versions include the version number, it is recommended to always use " "the ``startswith`` idiom presented above." msgstr "" msgid "" -"On AIX, :attr:`sys.platform` doesn't contain the major version anymore. It " +"On AIX, :data:`sys.platform` doesn't contain the major version anymore. It " "is always ``'aix'``, instead of ``'aix5'`` or ``'aix7'``. Since older " "Python versions include the version number, it is recommended to always use " "the ``startswith`` idiom presented above." msgstr "" msgid "" -":attr:`os.name` has a coarser granularity. :func:`os.uname` gives system-" +":data:`os.name` has a coarser granularity. :func:`os.uname` gives system-" "dependent version information." msgstr "" @@ -1595,8 +1493,8 @@ 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 (``RTLD_xxx`` constants, e.g. :" -"data:`os.RTLD_LAZY`)." +"values can be found in the :mod:`os` module (:samp:`RTLD_{xxx}` constants, e." +"g. :const:`os.RTLD_LAZY`)." msgstr "" msgid "" @@ -1619,6 +1517,12 @@ msgid "" "in the profile function will cause itself unset." 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`." +msgstr "" + msgid "" "Profile functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -1626,11 +1530,6 @@ msgid "" "depends on the event type." msgstr "" -msgid "" -"Raises an :ref:`auditing event ` ``sys.setprofile`` with no " -"arguments." -msgstr "" - msgid "The events have the following meaning:" msgstr "" @@ -1643,7 +1542,7 @@ msgid "" msgstr "" msgid "``'return'``" -msgstr "" +msgstr "``'return'``" msgid "" "A function (or other code block) is about to return. The profile function " @@ -1652,7 +1551,7 @@ msgid "" msgstr "" msgid "``'c_call'``" -msgstr "" +msgstr "``'c_call'``" msgid "" "A C function is about to be called. This may be an extension function or a " @@ -1660,17 +1559,22 @@ msgid "" msgstr "" msgid "``'c_return'``" -msgstr "" +msgstr "``'c_return'``" msgid "A C function has returned. *arg* is the C function object." msgstr "" msgid "``'c_exception'``" -msgstr "" +msgstr "``'c_exception'``" msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" +msgid "" +"Raises an :ref:`auditing event ` ``sys.setprofile`` with no " +"arguments." +msgstr "" + msgid "" "Set the maximum depth of the Python interpreter stack to *limit*. This " "limit prevents infinite recursion from causing an overflow of the C stack " @@ -1727,9 +1631,8 @@ msgid "" msgstr "" msgid "" -"The local trace function should return a reference to itself (or to another " -"function for further tracing in that scope), or ``None`` to turn off tracing " -"in that scope." +"The local trace function should return a reference to itself, or to another " +"function which would then be used as the local trace function for the scope." msgstr "" msgid "" @@ -1737,6 +1640,11 @@ msgid "" "like ``settrace(None)`` is called." msgstr "" +msgid "" +"Tracing is disabled while calling the trace function (e.g. a function set " +"by :func:`!settrace`). For recursive tracing see :func:`call_tracing`." +msgstr "" + msgid "" "A function is called (or some other code block entered). The global trace " "function is called; *arg* is ``None``; the return value specifies the local " @@ -1751,8 +1659,8 @@ msgid "" "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:`f_trace_lines` to :" -"const:`False` on that frame." +"events may be disabled for a frame by setting :attr:`~frame.f_trace_lines` " +"to :const:`False` on that :ref:`frame `." msgstr "" msgid "" @@ -1779,7 +1687,8 @@ msgid "" "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:" -"`f_trace_opcodes` to :const:`True` on the frame." +"`~frame.f_trace_opcodes` to :const:`True` on the :ref:`frame `." msgstr "" msgid "" @@ -1816,8 +1725,8 @@ msgid "" msgstr "" msgid "" -"``'opcode'`` event type added; :attr:`f_trace_lines` and :attr:" -"`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 "" @@ -1958,7 +1867,7 @@ msgid "" "However, if you are writing a library (and do not control in which context " "its code will be executed), be aware that the standard streams may be " "replaced with file-like objects like :class:`io.StringIO` which do not " -"support the :attr:`~io.BufferedIOBase.buffer` attribute." +"support the :attr:`!buffer` attribute." msgstr "" msgid "" @@ -2000,54 +1909,45 @@ msgid "" "listed." msgstr "" -msgid "See also the :attr:`sys.builtin_module_names` list." +msgid "See also the :data:`sys.builtin_module_names` list." msgstr "" msgid "" "A :term:`named tuple` holding information about the thread implementation." msgstr "" -msgid ":const:`name`" +msgid "The name of the thread implementation:" msgstr "" -msgid "Name of the thread implementation:" +msgid "``\"nt\"``: Windows threads" msgstr "" -msgid "``'nt'``: Windows threads" -msgstr "" - -msgid "``'pthread'``: POSIX threads" +msgid "``\"pthread\"``: POSIX threads" msgstr "" msgid "" -"``'pthread-stubs'``: stub POSIX threads (on WebAssembly platforms without " +"``\"pthread-stubs\"``: stub POSIX threads (on WebAssembly platforms without " "threading support)" msgstr "" -msgid "``'solaris'``: Solaris threads" -msgstr "" - -msgid ":const:`lock`" +msgid "``\"solaris\"``: Solaris threads" msgstr "" -msgid "Name of the lock implementation:" +msgid "The name of the lock implementation:" msgstr "" -msgid "``'semaphore'``: a lock uses a semaphore" +msgid "``\"semaphore\"``: a lock uses a semaphore" msgstr "" -msgid "``'mutex+cond'``: a lock uses a mutex and a condition variable" +msgid "``\"mutex+cond\"``: a lock uses a mutex and a condition variable" msgstr "" msgid "``None`` if this information is unknown" msgstr "" -msgid ":const:`version`" -msgstr "" - msgid "" -"Name and version of the thread library. It is a string, or ``None`` if this " -"information is unknown." +"The name and version of the thread library. It is a string, or ``None`` if " +"this information is unknown." msgstr "" msgid "" @@ -2070,24 +1970,25 @@ msgstr "" msgid "The *unraisable* argument has the following attributes:" msgstr "" -msgid "*exc_type*: Exception type." +msgid ":attr:`!exc_type`: Exception type." msgstr "" -msgid "*exc_value*: Exception value, can be ``None``." +msgid ":attr:`!exc_value`: Exception value, can be ``None``." msgstr "" -msgid "*exc_traceback*: Exception traceback, can be ``None``." +msgid ":attr:`!exc_traceback`: Exception traceback, can be ``None``." msgstr "" -msgid "*err_msg*: Error message, can be ``None``." +msgid ":attr:`!err_msg`: Error message, can be ``None``." msgstr "" -msgid "*object*: Object causing the exception, can be ``None``." +msgid ":attr:`!object`: Object causing the exception, can be ``None``." msgstr "" msgid "" -"The default hook formats *err_msg* and *object* as: ``f'{err_msg}: {object!" -"r}'``; use \"Exception ignored in\" error message if *err_msg* is ``None``." +"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``." msgstr "" msgid "" @@ -2095,19 +1996,19 @@ msgid "" "exceptions are handled." msgstr "" -msgid "" -"Storing *exc_value* using a custom hook can create a reference cycle. It " -"should be cleared explicitly to break the reference cycle when the exception " -"is no longer needed." +msgid ":func:`excepthook` which handles uncaught exceptions." msgstr "" msgid "" -"Storing *object* using a custom hook can resurrect it if it is set to an " -"object which is being finalized. Avoid storing *object* after the custom " -"hook completes to avoid resurrecting objects." +"Storing :attr:`!exc_value` using a custom hook can create a reference cycle. " +"It should be cleared explicitly to break the reference cycle when the " +"exception is no longer needed." msgstr "" -msgid "See also :func:`excepthook` which handles uncaught exceptions." +msgid "" +"Storing :attr:`!object` using a custom hook can resurrect it if it is set to " +"an object which is being finalized. Avoid storing :attr:`!object` after the " +"custom hook completes to avoid resurrecting objects." msgstr "" msgid "" @@ -2116,10 +2017,10 @@ msgid "" msgstr "" msgid "" -"Raise an auditing event ``sys.unraisablehook`` with arguments ``hook``, " -"``unraisable`` when an exception that cannot be handled occurs. The " -"``unraisable`` object is the same as what will be passed to the hook. If no " -"hook has been set, ``hook`` may be ``None``." +"Raise an auditing event ``sys.unraisablehook`` with arguments *hook*, " +"*unraisable* when an exception that cannot be handled occurs. The " +"*unraisable* object is the same as what will be passed to the hook. If no " +"hook has been set, *hook* may be ``None``." msgstr "" msgid "" @@ -2187,7 +2088,7 @@ msgid "auditing" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "traceback" msgstr "" @@ -2220,10 +2121,10 @@ msgid "prompts, interpreter" msgstr "" msgid ">>>" -msgstr "" +msgstr ">>>" msgid "interpreter prompt" msgstr "" msgid "..." -msgstr "" +msgstr "..." diff --git a/library/syslog.po b/library/syslog.po index b831fb3242..e105c2bd28 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -32,21 +32,15 @@ msgid "" "facility." msgstr "" +msgid ":ref:`Availability `: Unix, not Emscripten, not WASI." +msgstr "" + 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:`SysLogHandler`." msgstr "" -msgid ":ref:`Availability `: not Emscripten, not WASI." -msgstr "" - -msgid "" -"This module does not work or is not available on WebAssembly platforms " -"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " -"more information." -msgstr "" - msgid "The module defines the following functions:" msgstr "" diff --git a/library/tarfile.po b/library/tarfile.po new file mode 100644 index 0000000000..bffd0eb3f9 --- /dev/null +++ b/library/tarfile.po @@ -0,0 +1,1443 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-06-06 16:13+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`tarfile` --- Read and write tar archive files" +msgstr "" + +msgid "**Source code:** :source:`Lib/tarfile.py`" +msgstr "" + +msgid "" +"The :mod:`tarfile` module makes it possible to read and write tar archives, " +"including those using gzip, bz2 and lzma compression. Use the :mod:`zipfile` " +"module to read or write :file:`.zip` files, or the higher-level functions " +"in :ref:`shutil `." +msgstr "" + +msgid "Some facts and figures:" +msgstr "" + +msgid "" +"reads and writes :mod:`gzip`, :mod:`bz2` and :mod:`lzma` compressed archives " +"if the respective modules are available." +msgstr "" + +msgid "read/write support for the POSIX.1-1988 (ustar) format." +msgstr "" + +msgid "" +"read/write support for the GNU tar format including *longname* and " +"*longlink* extensions, read-only support for all variants of the *sparse* " +"extension including restoration of sparse files." +msgstr "" + +msgid "read/write support for the POSIX.1-2001 (pax) format." +msgstr "" + +msgid "" +"handles directories, regular files, hardlinks, symbolic links, fifos, " +"character devices and block devices and is able to acquire and restore file " +"information like timestamp, access permissions and owner." +msgstr "" + +msgid "Added support for :mod:`lzma` compression." +msgstr "" + +msgid "" +"Return a :class:`TarFile` object for the pathname *name*. For detailed " +"information on :class:`TarFile` objects and the keyword arguments that are " +"allowed, see :ref:`tarfile-objects`." +msgstr "" + +msgid "" +"*mode* has to be a string of the form ``'filemode[:compression]'``, it " +"defaults to ``'r'``. Here is a full list of mode combinations:" +msgstr "" + +msgid "mode" +msgstr "" + +msgid "action" +msgstr "" + +msgid "``'r' or 'r:*'``" +msgstr "" + +msgid "Open for reading with transparent compression (recommended)." +msgstr "" + +msgid "``'r:'``" +msgstr "``'r:'``" + +msgid "Open for reading exclusively without compression." +msgstr "" + +msgid "``'r:gz'``" +msgstr "``'r:gz'``" + +msgid "Open for reading with gzip compression." +msgstr "" + +msgid "``'r:bz2'``" +msgstr "``'r:bz2'``" + +msgid "Open for reading with bzip2 compression." +msgstr "" + +msgid "``'r:xz'``" +msgstr "``'r:xz'``" + +msgid "Open for reading with lzma compression." +msgstr "" + +msgid "``'x'`` or ``'x:'``" +msgstr "" + +msgid "" +"Create a tarfile exclusively without compression. Raise a :exc:" +"`FileExistsError` exception if it already exists." +msgstr "" + +msgid "``'x:gz'``" +msgstr "``'x:gz'``" + +msgid "" +"Create a tarfile with gzip compression. Raise a :exc:`FileExistsError` " +"exception if it already exists." +msgstr "" + +msgid "``'x:bz2'``" +msgstr "``'x:bz2'``" + +msgid "" +"Create a tarfile with bzip2 compression. Raise a :exc:`FileExistsError` " +"exception if it already exists." +msgstr "" + +msgid "``'x:xz'``" +msgstr "``'x:xz'``" + +msgid "" +"Create a tarfile with lzma compression. Raise a :exc:`FileExistsError` " +"exception if it already exists." +msgstr "" + +msgid "``'a' or 'a:'``" +msgstr "" + +msgid "" +"Open for appending with no compression. The file is created if it does not " +"exist." +msgstr "" + +msgid "``'w' or 'w:'``" +msgstr "" + +msgid "Open for uncompressed writing." +msgstr "" + +msgid "``'w:gz'``" +msgstr "``'w:gz'``" + +msgid "Open for gzip compressed writing." +msgstr "" + +msgid "``'w:bz2'``" +msgstr "``'w:bz2'``" + +msgid "Open for bzip2 compressed writing." +msgstr "" + +msgid "``'w:xz'``" +msgstr "``'w:xz'``" + +msgid "Open for lzma compressed writing." +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." +msgstr "" + +msgid "" +"If *fileobj* is specified, it is used as an alternative to a :term:`file " +"object` opened in binary mode for *name*. It is supposed to be at position 0." +msgstr "" + +msgid "" +"For modes ``'w:gz'``, ``'r:gz'``, ``'w:bz2'``, ``'r:bz2'``, ``'x:gz'``, ``'x:" +"bz2'``, :func:`tarfile.open` accepts the keyword argument *compresslevel* " +"(default ``9``) to specify the compression level of the file." +msgstr "" + +msgid "" +"For modes ``'w:xz'`` and ``'x:xz'``, :func:`tarfile.open` accepts the " +"keyword argument *preset* to specify the compression level of the file." +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:" +msgstr "" + +msgid "Mode" +msgstr "" + +msgid "Action" +msgstr "" + +msgid "``'r|*'``" +msgstr "``'r|*'``" + +msgid "Open a *stream* of tar blocks for reading with transparent compression." +msgstr "" + +msgid "``'r|'``" +msgstr "``'r|'``" + +msgid "Open a *stream* of uncompressed tar blocks for reading." +msgstr "" + +msgid "``'r|gz'``" +msgstr "``'r|gz'``" + +msgid "Open a gzip compressed *stream* for reading." +msgstr "" + +msgid "``'r|bz2'``" +msgstr "``'r|bz2'``" + +msgid "Open a bzip2 compressed *stream* for reading." +msgstr "" + +msgid "``'r|xz'``" +msgstr "``'r|xz'``" + +msgid "Open an lzma compressed *stream* for reading." +msgstr "" + +msgid "``'w|'``" +msgstr "``'w|'``" + +msgid "Open an uncompressed *stream* for writing." +msgstr "" + +msgid "``'w|gz'``" +msgstr "``'w|gz'``" + +msgid "Open a gzip compressed *stream* for writing." +msgstr "" + +msgid "``'w|bz2'``" +msgstr "``'w|bz2'``" + +msgid "Open a bzip2 compressed *stream* for writing." +msgstr "" + +msgid "``'w|xz'``" +msgstr "``'w|xz'``" + +msgid "Open an lzma compressed *stream* for writing." +msgstr "" + +msgid "The ``'x'`` (exclusive creation) mode was added." +msgstr "" + +msgid "The *name* parameter accepts a :term:`path-like object`." +msgstr "" + +msgid "" +"Class for reading and writing tar archives. Do not use this class directly: " +"use :func:`tarfile.open` instead. See :ref:`tarfile-objects`." +msgstr "" + +msgid "" +"Return :const:`True` if *name* is a tar archive file, that the :mod:" +"`tarfile` module can read. *name* may be a :class:`str`, file, or file-like " +"object." +msgstr "" + +msgid "Support for file and file-like objects." +msgstr "" + +msgid "The :mod:`tarfile` module defines the following exceptions:" +msgstr "" + +msgid "Base class for all :mod:`tarfile` exceptions." +msgstr "" + +msgid "" +"Is raised when a tar archive is opened, that either cannot be handled by " +"the :mod:`tarfile` module or is somehow invalid." +msgstr "" + +msgid "" +"Is raised when a compression method is not supported or when the data cannot " +"be decoded properly." +msgstr "" + +msgid "" +"Is raised for the limitations that are typical for stream-like :class:" +"`TarFile` objects." +msgstr "" + +msgid "" +"Is raised for *non-fatal* errors when using :meth:`TarFile.extract`, but " +"only if :attr:`TarFile.errorlevel`\\ ``== 2``." +msgstr "" + +msgid "Is raised by :meth:`TarInfo.frombuf` if the buffer it gets is invalid." +msgstr "" + +msgid "" +"Base class for members :ref:`refused ` by filters." +msgstr "" + +msgid "" +"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." +msgstr "" + +msgid "Raised to refuse extracting a member outside the destination directory." +msgstr "" + +msgid "Raised to refuse extracting a special file (e.g. a device or pipe)." +msgstr "" + +msgid "Raised to refuse extracting a symbolic link with an absolute path." +msgstr "" + +msgid "" +"Raised to refuse extracting a symbolic link pointing outside the destination " +"directory." +msgstr "" + +msgid "" +"Raised to refuse emulating a link (hard or symbolic) by extracting another " +"archive member, when that member would be rejected by the filter location. " +"The exception that was raised to reject the replacement member is available " +"as :attr:`!BaseException.__context__`." +msgstr "" + +msgid "The following constants are available at the module level:" +msgstr "" + +msgid "" +"The default character encoding: ``'utf-8'`` on Windows, the value returned " +"by :func:`sys.getfilesystemencoding` otherwise." +msgstr "" + +msgid "A regular file :attr:`~TarInfo.type`." +msgstr "" + +msgid "A link (inside tarfile) :attr:`~TarInfo.type`." +msgstr "" + +msgid "A symbolic link :attr:`~TarInfo.type`." +msgstr "" + +msgid "A character special device :attr:`~TarInfo.type`." +msgstr "" + +msgid "A block special device :attr:`~TarInfo.type`." +msgstr "" + +msgid "A directory :attr:`~TarInfo.type`." +msgstr "" + +msgid "A FIFO special device :attr:`~TarInfo.type`." +msgstr "" + +msgid "A contiguous file :attr:`~TarInfo.type`." +msgstr "" + +msgid "A GNU tar longname :attr:`~TarInfo.type`." +msgstr "" + +msgid "A GNU tar longlink :attr:`~TarInfo.type`." +msgstr "" + +msgid "A GNU tar sparse file :attr:`~TarInfo.type`." +msgstr "" + +msgid "" +"Each of the following constants defines a tar archive format that the :mod:" +"`tarfile` module is able to create. See section :ref:`tar-formats` for " +"details." +msgstr "" + +msgid "POSIX.1-1988 (ustar) format." +msgstr "" + +msgid "GNU tar format." +msgstr "" + +msgid "POSIX.1-2001 (pax) format." +msgstr "" + +msgid "" +"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`." +msgstr "" + +msgid "Module :mod:`zipfile`" +msgstr "" + +msgid "Documentation of the :mod:`zipfile` standard module." +msgstr "" + +msgid ":ref:`archiving-operations`" +msgstr ":ref:`archiving-operations`" + +msgid "" +"Documentation of the higher-level archiving facilities provided by the " +"standard :mod:`shutil` module." +msgstr "" + +msgid "" +"`GNU tar manual, Basic Tar Format `_" +msgstr "" + +msgid "Documentation for tar archive files, including GNU tar extensions." +msgstr "" + +msgid "TarFile Objects" +msgstr "" + +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." +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." +msgstr "" + +msgid "Added support for the context management protocol." +msgstr "" + +msgid "" +"All following arguments are optional and can be accessed as instance " +"attributes as well." +msgstr "" + +msgid "" +"*name* is the pathname of the archive. *name* may be a :term:`path-like " +"object`. It can be omitted if *fileobj* is given. In this case, the file " +"object's :attr:`!name` attribute is used if it exists." +msgstr "" + +msgid "" +"*mode* is either ``'r'`` to read from an existing archive, ``'a'`` to append " +"data to an existing file, ``'w'`` to create a new file overwriting an " +"existing one, or ``'x'`` to create a new file only if it does not already " +"exist." +msgstr "" + +msgid "" +"If *fileobj* is given, it is used for reading or writing data. If it can be " +"determined, *mode* is overridden by *fileobj*'s mode. *fileobj* will be used " +"from position 0." +msgstr "" + +msgid "*fileobj* is not closed, when :class:`TarFile` is closed." +msgstr "" + +msgid "" +"*format* controls the archive format for writing. It must be one of the " +"constants :const:`USTAR_FORMAT`, :const:`GNU_FORMAT` or :const:`PAX_FORMAT` " +"that are defined at module level. When reading, format will be automatically " +"detected, even if different formats are present in a single archive." +msgstr "" + +msgid "" +"The *tarinfo* argument can be used to replace the default :class:`TarInfo` " +"class with a different one." +msgstr "" + +msgid "" +"If *dereference* is :const:`False`, add symbolic and hard links to the " +"archive. If it is :const:`True`, add the content of the target files to the " +"archive. This has no effect on systems that do not support symbolic links." +msgstr "" + +msgid "" +"If *ignore_zeros* is :const:`False`, treat an empty block as the end of the " +"archive. If it is :const:`True`, skip empty (and invalid) blocks and try to " +"get as many members as possible. This is only useful for reading " +"concatenated or damaged archives." +msgstr "" + +msgid "" +"*debug* can be set from ``0`` (no debug messages) up to ``3`` (all debug " +"messages). The messages are written to ``sys.stderr``." +msgstr "" + +msgid "" +"*errorlevel* controls how extraction errors are handled, see :attr:`the " +"corresponding attribute `." +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." +msgstr "" + +msgid "" +"The *pax_headers* argument is an optional dictionary of strings which will " +"be added as a pax global header if *format* is :const:`PAX_FORMAT`." +msgstr "" + +msgid "Use ``'surrogateescape'`` as the default for the *errors* argument." +msgstr "" + +msgid "" +"Alternative constructor. The :func:`tarfile.open` function is actually a " +"shortcut to this classmethod." +msgstr "" + +msgid "" +"Return a :class:`TarInfo` object for member *name*. If *name* can not be " +"found in the archive, :exc:`KeyError` is raised." +msgstr "" + +msgid "" +"If a member occurs more than once in the archive, its last occurrence is " +"assumed to be the most up-to-date version." +msgstr "" + +msgid "" +"Return the members of the archive as a list of :class:`TarInfo` objects. The " +"list has the same order as the members in the archive." +msgstr "" + +msgid "" +"Return the members as a list of their names. It has the same order as the " +"list returned by :meth:`getmembers`." +msgstr "" + +msgid "" +"Print a table of contents to ``sys.stdout``. If *verbose* is :const:`False`, " +"only the names of the members are printed. If it is :const:`True`, output " +"similar to that of :program:`ls -l` is produced. If optional *members* is " +"given, it must be a subset of the list returned by :meth:`getmembers`." +msgstr "" + +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." +msgstr "" + +msgid "" +"Extract all members from the archive to the current working directory or " +"directory *path*. If optional *members* is given, it must be a subset of the " +"list returned by :meth:`getmembers`. Directory information like owner, " +"modification time and permissions are set after all members have been " +"extracted. This is done to work around two problems: A directory's " +"modification time is reset each time a file is created in it. And, if a " +"directory's permissions do not allow writing, extracting files to it will " +"fail." +msgstr "" + +msgid "" +"If *numeric_owner* is :const:`True`, the uid and gid numbers from the " +"tarfile are used to set the owner/group for the extracted files. Otherwise, " +"the named values from the tarfile are used." +msgstr "" + +msgid "" +"The *filter* argument, which was added in Python 3.11.4, specifies how " +"``members`` are modified or rejected before extraction. See :ref:`tarfile-" +"extraction-filter` for details. It is recommended to set this explicitly " +"depending on which *tar* features you need to support." +msgstr "" + +msgid "" +"Never extract archives from untrusted sources without prior inspection. It " +"is possible that files are created outside of *path*, e.g. members that have " +"absolute filenames starting with ``\"/\"`` or filenames with two dots ``\".." +"\"``." +msgstr "" + +msgid "" +"Set ``filter='data'`` to prevent the most dangerous security issues, and " +"read the :ref:`tarfile-extraction-filter` section for details." +msgstr "" + +msgid "Added the *numeric_owner* parameter." +msgstr "" + +msgid "The *path* parameter accepts a :term:`path-like object`." +msgstr "" + +msgid "Added the *filter* parameter." +msgstr "" + +msgid "" +"Extract a member from the archive to the current working directory, using " +"its full name. Its file information is extracted as accurately as possible. " +"*member* may be a filename or a :class:`TarInfo` object. You can specify a " +"different directory using *path*. *path* may be a :term:`path-like object`. " +"File attributes (owner, mtime, mode) are set unless *set_attrs* is false." +msgstr "" + +msgid "" +"The *numeric_owner* and *filter* arguments are the same as for :meth:" +"`extractall`." +msgstr "" + +msgid "" +"The :meth:`extract` method does not take care of several extraction issues. " +"In most cases you should consider using the :meth:`extractall` method." +msgstr "" + +msgid "See the warning for :meth:`extractall`." +msgstr "" + +msgid "Added the *set_attrs* parameter." +msgstr "" + +msgid "" +"Extract a member from the archive as a file object. *member* may be a " +"filename or a :class:`TarInfo` object. If *member* is a regular file or a " +"link, an :class:`io.BufferedReader` object is returned. For all other " +"existing members, :const:`None` is returned. If *member* does not appear in " +"the archive, :exc:`KeyError` is raised." +msgstr "" + +msgid "Return an :class:`io.BufferedReader` object." +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." +msgstr "" + +msgid "" +"Some exceptions, e.g. ones caused by wrong argument types or data " +"corruption, are always raised." +msgstr "" + +msgid "" +"Custom :ref:`extraction filters ` should raise :" +"exc:`FilterError` for *fatal* errors and :exc:`ExtractError` for *non-fatal* " +"ones." +msgstr "" + +msgid "" +"Note that when an exception is raised, the archive may be partially " +"extracted. It is the user’s responsibility to clean up." +msgstr "" + +msgid "" +"The :ref:`extraction filter ` used as a default " +"for the *filter* argument of :meth:`~TarFile.extract` and :meth:`~TarFile." +"extractall`." +msgstr "" + +msgid "" +"The attribute may be ``None`` or a callable. String names are not allowed " +"for this attribute, unlike the *filter* argument to :meth:`~TarFile.extract`." +msgstr "" + +msgid "" +"If ``extraction_filter`` is ``None`` (the default), calling an extraction " +"method without a *filter* argument will use the :func:`fully_trusted " +"` filter for compatibility with previous Python " +"versions." +msgstr "" + +msgid "" +"In Python 3.12+, leaving ``extraction_filter=None`` will emit a " +"``DeprecationWarning``." +msgstr "" + +msgid "" +"In Python 3.14+, leaving ``extraction_filter=None`` will cause extraction " +"methods to use the :func:`data ` filter by default." +msgstr "" + +msgid "" +"The attribute may be set on instances or overridden in subclasses. It also " +"is possible to set it on the ``TarFile`` class itself to set a global " +"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." +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." +msgstr "" + +msgid "Recursion adds entries in sorted order." +msgstr "" + +msgid "" +"Add the :class:`TarInfo` object *tarinfo* to the archive. If *fileobj* is " +"given, it 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 "" +"Create a :class:`TarInfo` object from the result of :func:`os.stat` or " +"equivalent on an existing file. The file is either named by *name*, or " +"specified as a :term:`file object` *fileobj* with a file descriptor. *name* " +"may be a :term:`path-like object`. If given, *arcname* specifies an " +"alternative name for the file in the archive, otherwise, the name is taken " +"from *fileobj*’s :attr:`~io.FileIO.name` attribute, or the *name* argument. " +"The name should be a text string." +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." +msgstr "" + +msgid "" +"Close the :class:`TarFile`. In write mode, two finishing zero blocks are " +"appended to the archive." +msgstr "" + +msgid "A dictionary containing key-value pairs of pax global headers." +msgstr "" + +msgid "TarInfo Objects" +msgstr "" + +msgid "" +"A :class:`TarInfo` object represents one member in a :class:`TarFile`. Aside " +"from storing all required attributes of a file (like file type, size, time, " +"permissions, owner etc.), it provides some useful methods to determine its " +"type. It does *not* contain the file's data itself." +msgstr "" + +msgid "" +":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." +msgstr "" + +msgid "" +"Several attributes can be set to ``None`` to indicate that a piece of " +"metadata is unused or unknown. Different :class:`TarInfo` methods handle " +"``None`` differently:" +msgstr "" + +msgid "" +"The :meth:`~TarFile.extract` or :meth:`~TarFile.extractall` methods will " +"ignore the corresponding metadata, leaving it set to a default." +msgstr "" + +msgid ":meth:`~TarFile.addfile` will fail." +msgstr "" + +msgid ":meth:`~TarFile.list` will print a placeholder string." +msgstr "" + +msgid "Added :meth:`~TarInfo.replace` and handling of ``None``." +msgstr "" + +msgid "Create a :class:`TarInfo` object." +msgstr "" + +msgid "Create and return a :class:`TarInfo` object from string buffer *buf*." +msgstr "" + +msgid "Raises :exc:`HeaderError` if the buffer is invalid." +msgstr "" + +msgid "" +"Read the next member from the :class:`TarFile` object *tarfile* and return " +"it as a :class:`TarInfo` object." +msgstr "" + +msgid "" +"Create a string buffer from a :class:`TarInfo` object. For information on " +"the arguments see the constructor of the :class:`TarFile` class." +msgstr "" + +msgid "A ``TarInfo`` object has the following public data attributes:" +msgstr "" + +msgid "Name of the archive member." +msgstr "" + +msgid "Size in bytes." +msgstr "" + +msgid "" +"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." +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." +msgstr "" + +msgid "" +"Name of the target file name, which is only present in :class:`TarInfo` " +"objects of type :const:`LNKTYPE` and :const:`SYMTYPE`." +msgstr "" + +msgid "" +"For symbolic links (``SYMTYPE``), the *linkname* is relative to the " +"directory that contains the link. For hard links (``LNKTYPE``), the " +"*linkname* is relative to the root of the archive." +msgstr "" + +msgid "User ID of the user who originally stored this member." +msgstr "" + +msgid "Group ID of the user who originally stored this member." +msgstr "" + +msgid "User name." +msgstr "" + +msgid "Group name." +msgstr "" + +msgid "Header checksum." +msgstr "" + +msgid "Device major number." +msgstr "" + +msgid "Device minor number." +msgstr "" + +msgid "The tar header starts here." +msgstr "" + +msgid "The file's data starts here." +msgstr "" + +msgid "Sparse member information." +msgstr "" + +msgid "" +"A dictionary containing key-value pairs of an associated pax extended header." +msgstr "" + +msgid "" +"Return a *new* copy of the :class:`!TarInfo` object with the given " +"attributes changed. For example, to return a ``TarInfo`` with the group name " +"set to ``'staff'``, use::" +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 " +"``TarInfo`` object." +msgstr "" + +msgid "A :class:`TarInfo` object also provides some convenient query methods:" +msgstr "" + +msgid "Return :const:`True` if the :class:`TarInfo` object is a regular file." +msgstr "" + +msgid "Same as :meth:`isfile`." +msgstr "" + +msgid "Return :const:`True` if it is a directory." +msgstr "" + +msgid "Return :const:`True` if it is a symbolic link." +msgstr "" + +msgid "Return :const:`True` if it is a hard link." +msgstr "" + +msgid "Return :const:`True` if it is a character device." +msgstr "" + +msgid "Return :const:`True` if it is a block device." +msgstr "" + +msgid "Return :const:`True` if it is a FIFO." +msgstr "" + +msgid "" +"Return :const:`True` if it is one of character device, block device or FIFO." +msgstr "" + +msgid "Extraction filters" +msgstr "" + +msgid "" +"The *tar* format is designed to capture all details of a UNIX-like " +"filesystem, which makes it very powerful. Unfortunately, the features make " +"it easy to create tar files that have unintended -- and possibly malicious " +"-- effects when extracted. For example, extracting a tar file can overwrite " +"arbitrary files in various ways (e.g. by using absolute paths, ``..`` path " +"components, or symlinks that affect later members)." +msgstr "" + +msgid "" +"In most cases, the full functionality is not needed. Therefore, *tarfile* " +"supports extraction filters: a mechanism to limit functionality, and thus " +"mitigate some of the security issues." +msgstr "" + +msgid ":pep:`706`" +msgstr ":pep:`706`" + +msgid "Contains further motivation and rationale behind the design." +msgstr "" + +msgid "" +"The *filter* argument to :meth:`TarFile.extract` or :meth:`~TarFile." +"extractall` can be:" +msgstr "" + +msgid "" +"the string ``'fully_trusted'``: Honor all metadata as specified in the " +"archive. Should be used if the user trusts the archive completely, or " +"implements their own complex verification." +msgstr "" + +msgid "" +"the string ``'tar'``: Honor most *tar*-specific features (i.e. features of " +"UNIX-like filesystems), but block features that are very likely to be " +"surprising or malicious. See :func:`tar_filter` for details." +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." +msgstr "" + +msgid "``None`` (default): Use :attr:`TarFile.extraction_filter`." +msgstr "" + +msgid "" +"If that is also ``None`` (the default), the ``'fully_trusted'`` filter will " +"be used (for compatibility with earlier versions of Python)." +msgstr "" + +msgid "In Python 3.12, the default will emit a ``DeprecationWarning``." +msgstr "" + +msgid "" +"In Python 3.14, the ``'data'`` filter will become the default instead. It's " +"possible to switch earlier; see :attr:`TarFile.extraction_filter`." +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 " +"members)::" +msgstr "" + +msgid "" +"The callable is called just before each member is extracted, so it can take " +"the current state of the disk into account. It can:" +msgstr "" + +msgid "" +"return a :class:`TarInfo` object which will be used instead of the metadata " +"in the archive, or" +msgstr "" + +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." +msgstr "" + +msgid "Default named filters" +msgstr "" + +msgid "" +"The pre-defined, named filters are available as functions, so they can be " +"reused in custom filters:" +msgstr "" + +msgid "Return *member* unchanged." +msgstr "" + +msgid "This implements the ``'fully_trusted'`` filter." +msgstr "" + +msgid "Implements the ``'tar'`` filter." +msgstr "" + +msgid "Strip leading slashes (``/`` and :data:`os.sep`) from filenames." +msgstr "" + +msgid "" +":ref:`Refuse ` to extract files with absolute " +"paths (in case the name is absolute even after stripping slashes, e.g. ``C:/" +"foo`` on Windows). This raises :class:`~tarfile.AbsolutePathError`." +msgstr "" + +msgid "" +":ref:`Refuse ` to extract files whose absolute " +"path (after following symlinks) would end up outside the destination. This " +"raises :class:`~tarfile.OutsideDestinationError`." +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 "" +"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." +msgstr "" + +msgid "" +":ref:`Refuse ` to extract links (hard or soft) " +"that link to absolute paths, or ones that link outside the destination." +msgstr "" + +msgid "" +"This raises :class:`~tarfile.AbsoluteLinkError` or :class:`~tarfile." +"LinkOutsideDestinationError`." +msgstr "" + +msgid "" +"Note that such files are refused even on platforms that do not support " +"symbolic links." +msgstr "" + +msgid "" +":ref:`Refuse ` to extract device files (including " +"pipes). This raises :class:`~tarfile.SpecialFileError`." +msgstr "" + +msgid "For regular files, including hard links:" +msgstr "" + +msgid "" +"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`)." +msgstr "" + +msgid "" +"For other files (directories), set ``mode`` to ``None``, so that extraction " +"methods skip applying permission bits." +msgstr "" + +msgid "" +"Set user and group info (``uid``, ``gid``, ``uname``, ``gname``) to " +"``None``, so that extraction methods skip setting it." +msgstr "" + +msgid "Link targets are now normalized." +msgstr "" + +msgid "Filter errors" +msgstr "" + +msgid "" +"When a filter refuses to extract a file, it will raise an appropriate " +"exception, a subclass of :class:`~tarfile.FilterError`. This will abort the " +"extraction if :attr:`TarFile.errorlevel` is 1 or more. With ``errorlevel=0`` " +"the error will be logged and the member will be skipped, but extraction will " +"continue." +msgstr "" + +msgid "Hints for further verification" +msgstr "" + +msgid "" +"Even with ``filter='data'``, *tarfile* is not suited for extracting " +"untrusted files without prior inspection. Among other issues, the pre-" +"defined filters do not prevent denial-of-service attacks. Users should do " +"additional checks." +msgstr "" + +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." +msgstr "" + +msgid "Disallow symbolic links if you do not need the functionality." +msgstr "" + +msgid "" +"When working with untrusted data, use external (e.g. OS-level) limits on " +"disk, memory and CPU usage." +msgstr "" + +msgid "" +"Check filenames against an allow-list of characters (to filter out control " +"characters, confusables, foreign path separators, etc.)." +msgstr "" + +msgid "" +"Check that filenames have expected extensions (discouraging files that " +"execute when you “click on them”, or extension-less files like Windows " +"special device names)." +msgstr "" + +msgid "" +"Limit the number of extracted files, total size of extracted data, filename " +"length (including symlink length), and size of individual files." +msgstr "" + +msgid "Check for files that would be shadowed on case-insensitive filesystems." +msgstr "" + +msgid "Also note that:" +msgstr "" + +msgid "" +"Tar files may contain multiple versions of the same file. Later ones are " +"expected to overwrite any earlier ones. This feature is crucial to allow " +"updating tape archives, but can be abused maliciously." +msgstr "" + +msgid "" +"*tarfile* does not protect against issues with “live” data, e.g. an attacker " +"tinkering with the destination (or source) directory while extraction (or " +"archiving) is in progress." +msgstr "" + +msgid "Supporting older Python versions" +msgstr "" + +msgid "" +"Extraction filters were added to Python 3.12, and are backported to older " +"versions as security updates. To check whether the feature is available, use " +"e.g. ``hasattr(tarfile, 'data_filter')`` rather than checking the Python " +"version." +msgstr "" + +msgid "" +"The following examples show how to support Python versions with and without " +"the feature. Note that setting ``extraction_filter`` will affect any " +"subsequent operations." +msgstr "" + +msgid "Fully trusted archive::" +msgstr "" + +msgid "" +"Use the ``'data'`` filter if available, but revert to Python 3.11 behavior " +"(``'fully_trusted'``) if this feature is not available::" +msgstr "" + +msgid "Use the ``'data'`` filter; *fail* if it is not available::" +msgstr "" + +msgid "or::" +msgstr "lub::" + +msgid "Use the ``'data'`` filter; *warn* if it is not available::" +msgstr "" + +msgid "Stateful extraction filter example" +msgstr "" + +msgid "" +"While *tarfile*'s extraction methods take a simple *filter* callable, custom " +"filters may be more complex objects with an internal state. It may be useful " +"to write these as context managers, to be used like this::" +msgstr "" + +msgid "Such a filter can be written as, for example::" +msgstr "" + +msgid "Command-Line Interface" +msgstr "" + +msgid "" +"The :mod:`tarfile` module provides a simple command-line interface to " +"interact with tar archives." +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:" +msgstr "" + +msgid "Passing a directory is also acceptable:" +msgstr "" + +msgid "" +"If you want to extract a tar archive into the current directory, use the :" +"option:`-e` option:" +msgstr "" + +msgid "" +"You can also extract a tar archive into a different directory by passing the " +"directory's name:" +msgstr "" + +msgid "For a list of the files in a tar archive, use the :option:`-l` option:" +msgstr "" + +msgid "Command-line options" +msgstr "" + +msgid "List files in a tarfile." +msgstr "" + +msgid "Create tarfile from source files." +msgstr "" + +msgid "" +"Extract tarfile into the current directory if *output_dir* is not specified." +msgstr "" + +msgid "Test whether the tarfile is valid or not." +msgstr "" + +msgid "Verbose output." +msgstr "" + +msgid "" +"Specifies the *filter* for ``--extract``. See :ref:`tarfile-extraction-" +"filter` for details. Only string names are accepted (that is, " +"``fully_trusted``, ``tar``, and ``data``)." +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid "How to extract an entire tar archive to the current working directory::" +msgstr "" + +msgid "" +"How to extract a subset of a tar archive with :meth:`TarFile.extractall` " +"using a generator function instead of a list::" +msgstr "" + +msgid "How to create an uncompressed tar archive from a list of filenames::" +msgstr "" + +msgid "The same example using the :keyword:`with` statement::" +msgstr "" + +msgid "" +"How to read a gzip compressed tar archive and display some member " +"information::" +msgstr "" + +msgid "" +"How to create an archive and reset the user information using the *filter* " +"parameter in :meth:`TarFile.add`::" +msgstr "" + +msgid "Supported tar formats" +msgstr "" + +msgid "" +"There are three tar formats that can be created with the :mod:`tarfile` " +"module:" +msgstr "" + +msgid "" +"The POSIX.1-1988 ustar format (:const:`USTAR_FORMAT`). It supports filenames " +"up to a length of at best 256 characters and linknames up to 100 characters. " +"The maximum file size is 8 GiB. This is an old and limited but widely " +"supported format." +msgstr "" + +msgid "" +"The GNU tar format (:const:`GNU_FORMAT`). It supports long filenames and " +"linknames, files bigger than 8 GiB and sparse files. It is the de facto " +"standard on GNU/Linux systems. :mod:`tarfile` fully supports the GNU tar " +"extensions for long names, sparse file support is read-only." +msgstr "" + +msgid "" +"The POSIX.1-2001 pax format (:const:`PAX_FORMAT`). It is the most flexible " +"format with virtually no limits. It supports long filenames and linknames, " +"large files and stores pathnames in a portable way. Modern tar " +"implementations, including GNU tar, bsdtar/libarchive and star, fully " +"support extended *pax* features; some old or unmaintained libraries may not, " +"but should treat *pax* archives as if they were in the universally supported " +"*ustar* format. It is the current default format for new archives." +msgstr "" + +msgid "" +"It extends the existing *ustar* format with extra headers for information " +"that cannot be stored otherwise. There are two flavours of pax headers: " +"Extended headers only affect the subsequent file header, global headers are " +"valid for the complete archive and affect all following files. All the data " +"in a pax header is encoded in *UTF-8* for portability reasons." +msgstr "" + +msgid "" +"There are some more variants of the tar format which can be read, but not " +"created:" +msgstr "" + +msgid "" +"The ancient V7 format. This is the first tar format from Unix Seventh " +"Edition, storing only regular files and directories. Names must not be " +"longer than 100 characters, there is no user/group name information. Some " +"archives have miscalculated header checksums in case of fields with non-" +"ASCII characters." +msgstr "" + +msgid "" +"The SunOS tar extended format. This format is a variant of the POSIX.1-2001 " +"pax format, but is not compatible." +msgstr "" + +msgid "Unicode issues" +msgstr "" + +msgid "" +"The tar format was originally conceived to make backups on tape drives with " +"the main focus on preserving file system information. Nowadays tar archives " +"are commonly used for file distribution and exchanging archives over " +"networks. One problem of the original format (which is the basis of all " +"other formats) is that there is no concept of supporting different character " +"encodings. For example, an ordinary tar archive created on a *UTF-8* system " +"cannot be read correctly on a *Latin-1* system if it contains non-*ASCII* " +"characters. Textual metadata (like filenames, linknames, user/group names) " +"will appear damaged. Unfortunately, there is no way to autodetect the " +"encoding of an archive. The pax format was designed to solve this problem. " +"It stores non-ASCII metadata using the universal character encoding *UTF-8*." +msgstr "" + +msgid "" +"The details of character conversion in :mod:`tarfile` are controlled by the " +"*encoding* and *errors* keyword arguments of the :class:`TarFile` class." +msgstr "" + +msgid "" +"*encoding* defines the character encoding to use for the metadata in the " +"archive. The default value is :func:`sys.getfilesystemencoding` or " +"``'ascii'`` as a fallback. Depending on whether the archive is read or " +"written, the metadata must be either decoded or encoded. If *encoding* is " +"not set appropriately, this conversion may fail." +msgstr "" + +msgid "" +"The *errors* argument defines how characters are treated that cannot be " +"converted. Possible values are listed in section :ref:`error-handlers`. The " +"default scheme is ``'surrogateescape'`` which Python also uses for its file " +"system calls, see :ref:`os-filenames`." +msgstr "" + +msgid "" +"For :const:`PAX_FORMAT` archives (the default), *encoding* is generally not " +"needed because all the metadata is stored using *UTF-8*. *encoding* is only " +"used in the rare cases when binary pax headers are decoded or when strings " +"with surrogate characters are stored." +msgstr "" diff --git a/library/tempfile.po b/library/tempfile.po index eb1c962042..c40991e395 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -33,9 +33,9 @@ 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 context " -"managers. :func:`mkstemp` and :func:`mkdtemp` are lower-level functions " -"which require manual cleanup." +"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 +63,9 @@ msgid "" msgstr "" msgid "" -"The resulting object can be used as a 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 "" @@ -88,8 +88,8 @@ msgid "" msgstr "" msgid "" -"The :py:data:`os.O_TMPFILE` flag is used if it is available and works (Linux-" -"specific, requires Linux kernel 3.11 or later)." +"The :py:const:`os.O_TMPFILE` flag is used if it is available and works " +"(Linux-specific, requires Linux kernel 3.11 or later)." msgstr "" msgid "" @@ -102,7 +102,7 @@ msgid "" "argument ``fullpath``." msgstr "" -msgid "The :py:data:`os.O_TMPFILE` flag is now used if available." +msgid "The :py:const:`os.O_TMPFILE` flag is now used if available." msgstr "" msgid "Added *errors* parameter." @@ -129,24 +129,25 @@ msgstr "" 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:`fileno` method is called, at which point the contents are " -"written to disk and operation proceeds as with :func:`TemporaryFile`." +"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`." msgstr "" msgid "" -"The resulting file has one additional method, :func:`rollover`, which causes " -"the file to roll over to an on-disk file regardless of its size." +"The resulting file has one additional method, :meth:`!rollover`, which " +"causes the file to roll over to an on-disk file regardless of its size." msgstr "" msgid "" -"The returned object is a file-like object whose :attr:`_file` attribute is " +"The returned object is a file-like object whose :attr:`!_file` attribute is " "either an :class:`io.BytesIO` or :class:`io.TextIOWrapper` object (depending " "on whether binary or text *mode* was specified) or a true file object, " -"depending on whether :func:`rollover` has been called. This file-like " +"depending on whether :meth:`rollover` has been called. This file-like " "object can be used in a :keyword:`with` statement, just like a normal file." msgstr "" -msgid "the truncate method now accepts a ``size`` argument." +msgid "the truncate method now accepts a *size* argument." msgstr "" msgid "" @@ -157,26 +158,26 @@ msgstr "" msgid "" "This class securely creates a temporary directory using the same rules as :" -"func:`mkdtemp`. The resulting object can be used as a 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." +"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." msgstr "" msgid "" -"The directory name can be retrieved from the :attr:`name` attribute of the " -"returned object. When the returned object is used as a context manager, " -"the :attr:`name` will be assigned to the target of the :keyword:`!as` clause " -"in the :keyword:`with` statement, if there is one." +"The directory name can be retrieved from the :attr:`!name` attribute of the " +"returned object. When the returned object is used as a :term:`context " +"manager`, the :attr:`!name` will be assigned to the target of the :keyword:`!" +"as` clause in the :keyword:`with` statement, if there is one." msgstr "" msgid "" -"The directory can be explicitly cleaned up by calling the :func:`cleanup` " +"The directory can be explicitly cleaned up by calling the :meth:`!cleanup` " "method. If *ignore_cleanup_errors* is true, any unhandled exceptions during " "explicit or implicit cleanup (such as a :exc:`PermissionError` removing open " "files on Windows) will be ignored, and the remaining removable items deleted " "on a \"best-effort\" basis. Otherwise, errors will be raised in whatever " -"context cleanup occurs (the :func:`cleanup` call, exiting the context " +"context cleanup occurs (the :meth:`!cleanup` call, exiting the context " "manager, when the object is garbage-collected or during interpreter " "shutdown)." msgstr "" @@ -408,4 +409,4 @@ msgid "file name" msgstr "" msgid "file" -msgstr "" +msgstr "plik" diff --git a/library/termios.po b/library/termios.po new file mode 100644 index 0000000000..c8edd19d73 --- /dev/null +++ b/library/termios.po @@ -0,0 +1,140 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`termios` --- POSIX style tty control" +msgstr "" + +msgid "" +"This module provides an interface to the POSIX calls for tty I/O control. " +"For a complete description of these calls, see :manpage:`termios(3)` Unix " +"manual page. It is only available for those Unix versions that support " +"POSIX *termios* style tty I/O control configured during installation." +msgstr "" + +msgid ":ref:`Availability `: Unix." +msgstr "" + +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." +msgstr "" + +msgid "" +"This module also defines all the constants needed to work with the functions " +"provided here; these have the same name as their counterparts in C. Please " +"refer to your system documentation for more information on using these " +"terminal control interfaces." +msgstr "" + +msgid "The module defines the following functions:" +msgstr "" + +msgid "" +"Return a list containing the tty attributes for file descriptor *fd*, as " +"follows: ``[iflag, oflag, cflag, lflag, ispeed, ospeed, cc]`` where *cc* is " +"a list of the tty special characters (each a string of length 1, except the " +"items with indices :const:`VMIN` and :const:`VTIME`, which are integers when " +"these fields are defined). The interpretation of the flags and the speeds " +"as well as the indexing in the *cc* array must be done using the symbolic " +"constants defined in the :mod:`termios` module." +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 " +"determines when the attributes are changed:" +msgstr "" + +msgid "Change attributes immediately." +msgstr "" + +msgid "Change attributes after transmitting all queued output." +msgstr "" + +msgid "" +"Change attributes after transmitting all queued output and discarding all " +"queued input." +msgstr "" + +msgid "" +"Send a break on file descriptor *fd*. A zero *duration* sends a break for " +"0.25--0.5 seconds; a nonzero *duration* has a system dependent meaning." +msgstr "" + +msgid "" +"Wait until all output written to file descriptor *fd* has been transmitted." +msgstr "" + +msgid "" +"Discard queued data on file descriptor *fd*. The *queue* selector specifies " +"which queue: :const:`TCIFLUSH` for the input queue, :const:`TCOFLUSH` for " +"the output queue, or :const:`TCIOFLUSH` for both queues." +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 "" +"Return a tuple ``(ws_row, ws_col)`` containing the tty window size for file " +"descriptor *fd*. Requires :const:`termios.TIOCGWINSZ` or :const:`termios." +"TIOCGSIZE`." +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." +msgstr "" + +msgid "Module :mod:`tty`" +msgstr "" + +msgid "Convenience functions for common terminal control operations." +msgstr "" + +msgid "Example" +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::" +msgstr "" + +msgid "POSIX" +msgstr "POSIX" + +msgid "I/O control" +msgstr "Kontrola I/O" + +msgid "tty" +msgstr "" diff --git a/library/text.po b/library/text.po index b3e3d15fa9..caedbd8b11 100644 --- a/library/text.po +++ b/library/text.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/textwrap.po b/library/textwrap.po index 3cc93d6184..1e66ac3ab5 100644 --- a/library/textwrap.po +++ b/library/textwrap.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +70,7 @@ msgid "" "First the whitespace in *text* is collapsed (all whitespace is replaced by " "single spaces). If the result fits in the *width*, it is returned. " "Otherwise, enough words are dropped from the end so that the remaining words " -"plus the :attr:`placeholder` fit within :attr:`width`::" +"plus the *placeholder* fit within *width*::" msgstr "" msgid "" @@ -163,7 +163,7 @@ msgstr "" msgid "" "(default: ``True``) If true, then all tab characters in *text* will be " -"expanded to spaces using the :meth:`expandtabs` method of *text*." +"expanded to spaces using the :meth:`~str.expandtabs` method of *text*." msgstr "" msgid "" @@ -219,8 +219,8 @@ msgid "" "However, the sentence detection algorithm is imperfect: it assumes that a " "sentence ending consists of a lowercase letter followed by one of ``'.'``, " "``'!'``, or ``'?'``, possibly followed by one of ``'\"'`` or ``\"'\"``, " -"followed by a space. One problem with this is algorithm is that it is " -"unable to detect the difference between \"Dr.\" in ::" +"followed by a space. One problem with this algorithm is that it is unable " +"to detect the difference between \"Dr.\" in ::" msgstr "" msgid "and \"Spot.\" in ::" @@ -282,7 +282,7 @@ msgid "" msgstr "" msgid "..." -msgstr "" +msgstr "..." msgid "placeholder" msgstr "" diff --git a/library/time.po b/library/time.po index 1b05e1baad..914831c3cb 100644 --- a/library/time.po +++ b/library/time.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stefan Ocetkiewicz , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,9 +91,9 @@ 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 this, " -"where available)." +"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 "" @@ -108,14 +108,14 @@ msgid "See :class:`struct_time` for a description of these objects." msgstr "" msgid "" -"The :class:`struct_time` type was extended to provide the :attr:`tm_gmtoff` " -"and :attr:`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:`tm_gmtoff` and :attr:`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:" @@ -137,19 +137,19 @@ msgid ":class:`struct_time` in UTC" msgstr "" msgid ":func:`gmtime`" -msgstr "" +msgstr ":func:`gmtime`" msgid ":class:`struct_time` in local time" msgstr "" msgid ":func:`localtime`" -msgstr "" +msgstr ":func:`localtime`" msgid ":func:`calendar.timegm`" -msgstr "" +msgstr ":func:`calendar.timegm`" msgid ":func:`mktime`" -msgstr "" +msgstr ":func:`mktime`" msgid "Functions" msgstr "Zadania" @@ -249,19 +249,19 @@ msgid "" msgstr "" msgid "``'monotonic'``: :func:`time.monotonic`" -msgstr "" +msgstr "``'monotonic'``: :func:`time.monotonic`" msgid "``'perf_counter'``: :func:`time.perf_counter`" -msgstr "" +msgstr "``'perf_counter'``: :func:`time.perf_counter`" msgid "``'process_time'``: :func:`time.process_time`" -msgstr "" +msgstr "``'process_time'``: :func:`time.process_time`" msgid "``'thread_time'``: :func:`time.thread_time`" -msgstr "" +msgstr "``'thread_time'``: :func:`time.thread_time`" msgid "``'time'``: :func:`time.time`" -msgstr "" +msgstr "``'time'``: :func:`time.time`" msgid "The result has the following attributes:" msgstr "" @@ -412,17 +412,17 @@ msgstr "" msgid "Or use ``select()`` (resolution: 1 microsecond)." msgstr "" -msgid "" -"On Unix, the ``clock_nanosleep()`` and ``nanosleep()`` functions are now " -"used if available. On Windows, a waitable timer is now used." -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)." msgstr "" +msgid "" +"On Unix, the ``clock_nanosleep()`` and ``nanosleep()`` functions are now " +"used if available. On Windows, a waitable timer is now used." +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* " @@ -452,91 +452,103 @@ msgid "Notes" msgstr "Notatki" msgid "``%a``" -msgstr "" +msgstr "``%a``" msgid "Locale's abbreviated weekday name." msgstr "" msgid "``%A``" -msgstr "" +msgstr "``%A``" msgid "Locale's full weekday name." msgstr "" msgid "``%b``" -msgstr "" +msgstr "``%b``" msgid "Locale's abbreviated month name." msgstr "" msgid "``%B``" -msgstr "" +msgstr "``%B``" msgid "Locale's full month name." msgstr "" msgid "``%c``" -msgstr "" +msgstr "``%c``" msgid "Locale's appropriate date and time representation." msgstr "" msgid "``%d``" -msgstr "" +msgstr "``%d``" msgid "Day of the month as a decimal number [01,31]." msgstr "" -msgid "``%H``" +msgid "``%f``" +msgstr "``%f``" + +msgid "Microseconds as a decimal number" msgstr "" +msgid "[000000,999999]." +msgstr "" + +msgid "\\(1)" +msgstr "\\(1)" + +msgid "``%H``" +msgstr "``%H``" + msgid "Hour (24-hour clock) as a decimal number [00,23]." msgstr "" msgid "``%I``" -msgstr "" +msgstr "``%I``" msgid "Hour (12-hour clock) as a decimal number [01,12]." msgstr "" msgid "``%j``" -msgstr "" +msgstr "``%j``" msgid "Day of the year as a decimal number [001,366]." msgstr "" msgid "``%m``" -msgstr "" +msgstr "``%m``" msgid "Month as a decimal number [01,12]." msgstr "" msgid "``%M``" -msgstr "" +msgstr "``%M``" msgid "Minute as a decimal number [00,59]." msgstr "" msgid "``%p``" -msgstr "" +msgstr "``%p``" msgid "Locale's equivalent of either AM or PM." msgstr "" -msgid "\\(1)" -msgstr "\\(1)" +msgid "\\(2)" +msgstr "\\(2)" msgid "``%S``" -msgstr "" +msgstr "``%S``" msgid "Second as a decimal number [00,61]." msgstr "" -msgid "\\(2)" -msgstr "\\(2)" +msgid "\\(3)" +msgstr "\\(3)" msgid "``%U``" -msgstr "" +msgstr "``%U``" msgid "" "Week number of the year (Sunday as the first day of the week) as a decimal " @@ -544,17 +556,17 @@ msgid "" "considered to be in week 0." msgstr "" -msgid "\\(3)" -msgstr "\\(3)" +msgid "\\(4)" +msgstr "\\(4)" msgid "``%w``" -msgstr "" +msgstr "``%w``" msgid "Weekday as a decimal number [0(Sunday),6]." msgstr "" msgid "``%W``" -msgstr "" +msgstr "``%W``" msgid "" "Week number of the year (Monday as the first day of the week) as a decimal " @@ -563,31 +575,31 @@ msgid "" msgstr "" msgid "``%x``" -msgstr "" +msgstr "``%x``" msgid "Locale's appropriate date representation." msgstr "" msgid "``%X``" -msgstr "" +msgstr "``%X``" msgid "Locale's appropriate time representation." msgstr "" msgid "``%y``" -msgstr "" +msgstr "``%y``" msgid "Year without century as a decimal number [00,99]." msgstr "" msgid "``%Y``" -msgstr "" +msgstr "``%Y``" msgid "Year with century as a decimal number." msgstr "" msgid "``%z``" -msgstr "" +msgstr "``%z``" msgid "" "Time zone offset indicating a positive or negative time difference from UTC/" @@ -596,13 +608,13 @@ msgid "" msgstr "" msgid "``%Z``" -msgstr "" +msgstr "``%Z``" msgid "Time zone name (no characters if no time zone exists). Deprecated. [1]_" msgstr "" msgid "``%%``" -msgstr "" +msgstr "``%%``" msgid "A literal ``'%'`` character." msgstr "" @@ -610,6 +622,13 @@ msgstr "" 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 `." +msgstr "" + msgid "" "When used with the :func:`strptime` function, the ``%p`` directive only " "affects the output hour field if the ``%I`` directive is used to parse the " @@ -690,7 +709,7 @@ msgid "Index" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Values" msgstr "" @@ -698,35 +717,23 @@ msgstr "" msgid "0" msgstr "0" -msgid ":attr:`tm_year`" -msgstr "" - msgid "(for example, 1993)" msgstr "" msgid "1" msgstr "1" -msgid ":attr:`tm_mon`" -msgstr "" - msgid "range [1, 12]" msgstr "" msgid "2" msgstr "2" -msgid ":attr:`tm_mday`" -msgstr "" - msgid "range [1, 31]" msgstr "" msgid "3" -msgstr "" - -msgid ":attr:`tm_hour`" -msgstr "" +msgstr "3" msgid "range [0, 23]" msgstr "" @@ -734,60 +741,39 @@ msgstr "" msgid "4" msgstr "4" -msgid ":attr:`tm_min`" -msgstr "" - msgid "range [0, 59]" msgstr "" msgid "5" -msgstr "" +msgstr "5" -msgid ":attr:`tm_sec`" -msgstr "" - -msgid "range [0, 61]; see **(2)** in :func:`strftime` description" +msgid "range [0, 61]; see :ref:`Note (2) ` in :func:`strftime`" msgstr "" msgid "6" -msgstr "" +msgstr "6" -msgid ":attr:`tm_wday`" -msgstr "" - -msgid "range [0, 6], Monday is 0" +msgid "range [0, 6]; Monday is 0" msgstr "" msgid "7" msgstr "" -msgid ":attr:`tm_yday`" -msgstr "" - msgid "range [1, 366]" msgstr "" msgid "8" msgstr "8" -msgid ":attr:`tm_isdst`" -msgstr "" - msgid "0, 1 or -1; see below" msgstr "" msgid "N/A" msgstr "" -msgid ":attr:`tm_zone`" -msgstr "" - msgid "abbreviation of timezone name" msgstr "" -msgid ":attr:`tm_gmtoff`" -msgstr "" - msgid "offset east of UTC in seconds" msgstr "" @@ -912,7 +898,7 @@ msgid "" msgstr "" msgid "``start[/time], end[/time]``" -msgstr "" +msgstr "``start[/time], end[/time]``" msgid "" "Indicates when to change to and back from DST. The format of the start and " @@ -920,7 +906,7 @@ msgid "" msgstr "" msgid ":samp:`J{n}`" -msgstr "" +msgstr ":samp:`J{n}`" msgid "" "The Julian day *n* (1 <= *n* <= 365). Leap days are not counted, so in all " @@ -928,7 +914,7 @@ msgid "" msgstr "" msgid ":samp:`{n}`" -msgstr "" +msgstr ":samp:`{n}`" msgid "" "The zero-based Julian day (0 <= *n* <= 365). Leap days are counted, and it " @@ -936,7 +922,7 @@ msgid "" msgstr "" msgid ":samp:`M{m}.{n}.{d}`" -msgstr "" +msgstr ":samp:`M{m}.{n}.{d}`" msgid "" "The *d*'th day (0 <= *d* <= 6) of week *n* of month *m* of the year (1 <= " @@ -1084,8 +1070,8 @@ msgid "" "`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:`tm_gmtoff` and :attr:`tm_zone` results from :func:`localtime` to " -"obtain timezone information." +"attr:`~struct_time.tm_gmtoff` and :attr:`~struct_time.tm_zone` results from :" +"func:`localtime` to obtain timezone information." msgstr "" msgid "Module :mod:`datetime`" diff --git a/library/timeit.po b/library/timeit.po index 382da38ab3..62c94fd38f 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stefan Ocetkiewicz , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -84,7 +83,9 @@ msgstr "" msgid "Default value of *repeat* changed from 3 to 5." msgstr "" -msgid "The default timer, which is always :func:`time.perf_counter`." +msgid "" +"The default timer, which is always time.perf_counter(), returns float " +"seconds. An alternative, time.perf_counter_ns, returns integer nanoseconds." msgstr "" msgid ":func:`time.perf_counter` is now the default timer." @@ -124,10 +125,10 @@ msgstr "" msgid "" "Time *number* executions of the main statement. This executes the setup " "statement once, and then returns the time it takes to execute the main " -"statement a number of times, measured in seconds as a float. The argument is " -"the number of times through the loop, defaulting to one million. The main " -"statement, the setup statement and the timer function to be used are passed " -"to the constructor." +"statement a number of times. The default timer returns seconds as a float. " +"The argument is the number of times through the loop, defaulting to one " +"million. The main statement, the setup statement and the timer function to " +"be used are passed to the constructor." msgstr "" msgid "" @@ -147,7 +148,7 @@ msgid "" "the total time >= 0.2 second, returning the eventual (number of loops, time " "taken for that number of loops). It calls :meth:`.timeit` with increasing " "numbers from the sequence 1, 2, 5, 10, 20, 50, ... until the time taken is " -"at least 0.2 second." +"at least 0.2 seconds." msgstr "" msgid "" diff --git a/library/tk.po b/library/tk.po index d99bc17b44..a4ea0ff177 100644 --- a/library/tk.po +++ b/library/tk.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# rmaster1211 , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: rmaster1211 , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/tkinter.colorchooser.po b/library/tkinter.colorchooser.po new file mode 100644 index 0000000000..dc9c532f1b --- /dev/null +++ b/library/tkinter.colorchooser.po @@ -0,0 +1,49 @@ +# 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:15+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:`tkinter.colorchooser` --- Color choosing dialog" +msgstr "" + +msgid "**Source code:** :source:`Lib/tkinter/colorchooser.py`" +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." +msgstr "" + +msgid "" +"Create a color choosing dialog. A call to this method will show the window, " +"wait for the user to make a selection, and return the selected color (or " +"``None``) to the caller." +msgstr "" + +msgid "Module :mod:`tkinter.commondialog`" +msgstr "" + +msgid "Tkinter standard dialog module" +msgstr "" diff --git a/library/tkinter.dnd.po b/library/tkinter.dnd.po new file mode 100644 index 0000000000..052a0cc1d1 --- /dev/null +++ b/library/tkinter.dnd.po @@ -0,0 +1,98 @@ +# 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:15+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:`tkinter.dnd` --- Drag and drop support" +msgstr "" + +msgid "**Source code:** :source:`Lib/tkinter/dnd.py`" +msgstr "" + +msgid "" +"This is experimental and due to be deprecated when it is replaced with the " +"Tk DND." +msgstr "" + +msgid "" +"The :mod:`tkinter.dnd` module provides drag-and-drop support for objects " +"within a single application, within the same window or between windows. To " +"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 " +"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" +msgstr "" + +msgid "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" +msgstr "" + +msgid "If no target widget is found, then the target object is None" +msgstr "" + +msgid "Call to *.dnd_leave(source, event)*" +msgstr "" + +msgid "Call to *.dnd_enter(source, event)*" +msgstr "" + +msgid "Call to *.dnd_commit(source, event)* to notify of drop" +msgstr "" + +msgid "" +"Call to *.dnd_end(target, event)* to signal end of drag-and-drop" +msgstr "" + +msgid "" +"The *DndHandler* class handles drag-and-drop events tracking Motion and " +"ButtonRelease events on the root of the event widget." +msgstr "" + +msgid "Cancel the drag-and-drop process." +msgstr "" + +msgid "Execute end of drag-and-drop functions." +msgstr "" + +msgid "Inspect area below mouse for target objects while drag is performed." +msgstr "" + +msgid "Signal end of drag when the release pattern is triggered." +msgstr "" + +msgid "Factory function for drag-and-drop process." +msgstr "" + +msgid ":ref:`Bindings-and-Events`" +msgstr "" diff --git a/library/tkinter.font.po b/library/tkinter.font.po new file mode 100644 index 0000000000..fce1bed4bb --- /dev/null +++ b/library/tkinter.font.po @@ -0,0 +1,139 @@ +# 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:15+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:`tkinter.font` --- Tkinter font wrapper" +msgstr "" + +msgid "**Source code:** :source:`Lib/tkinter/font.py`" +msgstr "" + +msgid "" +"The :mod:`tkinter.font` module provides the :class:`Font` class for creating " +"and using named fonts." +msgstr "" + +msgid "The different font weights and slants are:" +msgstr "" + +msgid "" +"The :class:`Font` class represents a named font. *Font* instances are given " +"unique names and can be specified by their family, size, and style " +"configuration. Named fonts are Tk's method of creating and identifying fonts " +"as a single object, rather than specifying a font by its attributes with " +"each occurrence." +msgstr "" + +msgid "arguments:" +msgstr "" + +msgid "*font* - font specifier tuple (family, size, options)" +msgstr "" + +msgid "*name* - unique font name" +msgstr "" + +msgid "*exists* - self points to existing named font if true" +msgstr "" + +msgid "additional keyword options (ignored if *font* is specified):" +msgstr "" + +msgid "*family* - font family i.e. Courier, Times" +msgstr "" + +msgid "*size* - font size" +msgstr "" + +msgid "If *size* is positive it is interpreted as size in points." +msgstr "" + +msgid "If *size* is a negative number its absolute value is treated" +msgstr "" + +msgid "as size in pixels." +msgstr "" + +msgid "*weight* - font emphasis (NORMAL, BOLD)" +msgstr "" + +msgid "*slant* - ROMAN, ITALIC" +msgstr "" + +msgid "*underline* - font underlining (0 - none, 1 - underline)" +msgstr "" + +msgid "*overstrike* - font strikeout (0 - none, 1 - strikeout)" +msgstr "" + +msgid "Return the attributes of the font." +msgstr "" + +msgid "Retrieve an attribute of the font." +msgstr "" + +msgid "Modify attributes of the font." +msgstr "" + +msgid "Return new instance of the current font." +msgstr "" + +msgid "" +"Return amount of space the text would occupy on the specified display when " +"formatted in the current font. If no display is specified then the main " +"application window is assumed." +msgstr "" + +msgid "Return font-specific data. Options include:" +msgstr "" + +msgid "*ascent* - distance between baseline and highest point that a" +msgstr "" + +msgid "character of the font can occupy" +msgstr "" + +msgid "*descent* - distance between baseline and lowest point that a" +msgstr "" + +msgid "*linespace* - minimum vertical separation necessary between any two" +msgstr "" + +msgid "characters of the font that ensures no vertical overlap between lines." +msgstr "" + +msgid "*fixed* - 1 if font is fixed-width else 0" +msgstr "" + +msgid "Return the different font families." +msgstr "" + +msgid "Return the names of defined fonts." +msgstr "" + +msgid "Return a :class:`Font` representation of a tk named font." +msgstr "" + +msgid "The *root* parameter was added." +msgstr "" diff --git a/library/tkinter.messagebox.po b/library/tkinter.messagebox.po new file mode 100644 index 0000000000..831925cddd --- /dev/null +++ b/library/tkinter.messagebox.po @@ -0,0 +1,50 @@ +# 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:15+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:`tkinter.messagebox` --- Tkinter message prompts" +msgstr "" + +msgid "**Source code:** :source:`Lib/tkinter/messagebox.py`" +msgstr "" + +msgid "" +"The :mod:`tkinter.messagebox` module provides a template base class as well " +"as a variety of convenience methods for commonly used configurations. The " +"message boxes are modal and will return a subset of (True, False, OK, None, " +"Yes, No) based on the user's selection. Common message box styles and " +"layouts include but are not limited to:" +msgstr "" + +msgid "Create a default information message box." +msgstr "" + +msgid "**Information message box**" +msgstr "" + +msgid "**Warning message boxes**" +msgstr "" + +msgid "**Question message boxes**" +msgstr "" diff --git a/library/tkinter.po b/library/tkinter.po index 2c90a240cf..a4a1ca7aa7 100644 --- a/library/tkinter.po +++ b/library/tkinter.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Krzysztof Abramowicz, 2022 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,11 +111,11 @@ msgid "By Mark Roseman. (ISBN 978-1999149567)" msgstr "" msgid "" -"`Python and Tkinter Programming `_" +"`Python GUI programming with Tkinter `_" msgstr "" -msgid "By Alan Moore. (ISBN 978-1788835886)" +msgid "By Alan D. Moore. (ISBN 978-1788835886)" msgstr "" msgid "`Programming Python `_" @@ -275,7 +275,7 @@ msgid "" "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 :attr:`os.curdir`." +"variable or, if that isn't defined, then :data:`os.curdir`." msgstr "" msgid "" @@ -314,55 +314,55 @@ msgid "The modules that provide Tk support include:" msgstr "" msgid ":mod:`tkinter`" -msgstr "" +msgstr ":mod:`tkinter`" msgid "Main Tkinter module." msgstr "" msgid ":mod:`tkinter.colorchooser`" -msgstr "" +msgstr ":mod:`tkinter.colorchooser`" msgid "Dialog to let the user choose a color." msgstr "" msgid ":mod:`tkinter.commondialog`" -msgstr "" +msgstr ":mod:`tkinter.commondialog`" msgid "Base class for the dialogs defined in the other modules listed here." msgstr "" msgid ":mod:`tkinter.filedialog`" -msgstr "" +msgstr ":mod:`tkinter.filedialog`" msgid "Common dialogs to allow the user to specify a file to open or save." msgstr "" msgid ":mod:`tkinter.font`" -msgstr "" +msgstr ":mod:`tkinter.font`" msgid "Utilities to help work with fonts." msgstr "" msgid ":mod:`tkinter.messagebox`" -msgstr "" +msgstr ":mod:`tkinter.messagebox`" msgid "Access to standard Tk dialog boxes." msgstr "" msgid ":mod:`tkinter.scrolledtext`" -msgstr "" +msgstr ":mod:`tkinter.scrolledtext`" msgid "Text widget with a vertical scroll bar built in." msgstr "" msgid ":mod:`tkinter.simpledialog`" -msgstr "" +msgstr ":mod:`tkinter.simpledialog`" msgid "Basic dialogs and convenience functions." msgstr "" msgid ":mod:`tkinter.ttk`" -msgstr "" +msgstr ":mod:`tkinter.ttk`" msgid "" "Themed widget set introduced in Tk 8.5, providing modern alternatives for " @@ -373,7 +373,7 @@ msgid "Additional modules:" msgstr "" msgid ":mod:`_tkinter`" -msgstr "" +msgstr ":mod:`_tkinter`" msgid "" "A binary module that contains the low-level interface to Tcl/Tk. It is " @@ -384,7 +384,7 @@ msgid "" msgstr "" msgid ":mod:`idlelib`" -msgstr "" +msgstr ":mod:`idlelib`" msgid "" "Python's Integrated Development and Learning Environment (IDLE). Based on :" @@ -392,7 +392,7 @@ msgid "" msgstr "" msgid ":mod:`tkinter.constants`" -msgstr "" +msgstr ":mod:`tkinter.constants`" msgid "" "Symbolic constants that can be used in place of strings when passing various " @@ -401,7 +401,7 @@ msgid "" msgstr "" msgid ":mod:`tkinter.dnd`" -msgstr "" +msgstr ":mod:`tkinter.dnd`" msgid "" "(experimental) Drag-and-drop support for :mod:`tkinter`. This will become " @@ -417,7 +417,7 @@ msgid "" msgstr "" msgid ":mod:`turtle`" -msgstr "" +msgstr ":mod:`turtle`" msgid "Turtle graphics in a Tk window." msgstr "" @@ -536,7 +536,7 @@ msgstr "" msgid "" "When your application uses Tkinter's classes and methods, internally Tkinter " "is assembling strings representing Tcl/Tk commands, and executing those " -"commands in the Tcl interpreter attached to your applicaton's :class:`Tk` " +"commands in the Tcl interpreter attached to your application's :class:`Tk` " "instance." msgstr "" @@ -828,7 +828,7 @@ msgid "Meaning" msgstr "Znaczenie" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "0" msgstr "0" @@ -855,7 +855,7 @@ msgid "``'Relief'``" msgstr "" msgid "3" -msgstr "" +msgstr "3" msgid "default value" msgstr "wartość domyślna" @@ -873,7 +873,7 @@ msgid "``'groove'``" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "" "Of course, the dictionary printed will include all the options available and " @@ -1154,7 +1154,7 @@ msgid "where:" msgstr "" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "" "is a string that denotes the target kind of event. (See the :manpage:" @@ -1193,97 +1193,97 @@ msgid "Tkinter Event Field" msgstr "" msgid "%f" -msgstr "" +msgstr "%f" msgid "focus" msgstr "" msgid "%A" -msgstr "" +msgstr "%A" msgid "char" msgstr "" msgid "%h" -msgstr "" +msgstr "%h" msgid "height" msgstr "" msgid "%E" -msgstr "" +msgstr "%E" msgid "send_event" msgstr "" msgid "%k" -msgstr "" +msgstr "%k" msgid "keycode" msgstr "" msgid "%K" -msgstr "" +msgstr "%K" msgid "keysym" msgstr "" msgid "%s" -msgstr "" +msgstr "%s" msgid "state" msgstr "" msgid "%N" -msgstr "" +msgstr "%N" msgid "keysym_num" msgstr "" msgid "%t" -msgstr "" +msgstr "%t" msgid "time" msgstr "" msgid "%T" -msgstr "" +msgstr "%T" msgid "type" -msgstr "" +msgstr "typ" msgid "%w" -msgstr "" +msgstr "%w" msgid "width" msgstr "" msgid "%W" -msgstr "" +msgstr "%W" msgid "widget" msgstr "" msgid "%x" -msgstr "" +msgstr "%x" msgid "x" msgstr "" msgid "%X" -msgstr "" +msgstr "%X" msgid "x_root" msgstr "" msgid "%y" -msgstr "" +msgstr "%y" msgid "y" msgstr "" msgid "%Y" -msgstr "" +msgstr "%Y" msgid "y_root" msgstr "" diff --git a/library/tkinter.scrolledtext.po b/library/tkinter.scrolledtext.po new file mode 100644 index 0000000000..8a7e82d999 --- /dev/null +++ b/library/tkinter.scrolledtext.po @@ -0,0 +1,56 @@ +# 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:15+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:`tkinter.scrolledtext` --- Scrolled Text Widget" +msgstr "" + +msgid "**Source code:** :source:`Lib/tkinter/scrolledtext.py`" +msgstr "" + +msgid "" +"The :mod:`tkinter.scrolledtext` module provides a class of the same name " +"which implements a basic text widget which has a vertical scroll bar " +"configured to do the \"right thing.\" Using the :class:`ScrolledText` class " +"is a lot easier than setting up a text widget and scroll bar directly." +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." +msgstr "" + +msgid "" +"Should more specific control be necessary, the following attributes are " +"available:" +msgstr "" + +msgid "The frame which surrounds the text and scroll bar widgets." +msgstr "" + +msgid "The scroll bar widget." +msgstr "" diff --git a/library/tkinter.tix.po b/library/tkinter.tix.po new file mode 100644 index 0000000000..0c7c5f9687 --- /dev/null +++ b/library/tkinter.tix.po @@ -0,0 +1,452 @@ +# 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:15+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:`tkinter.tix` --- Extension widgets for Tk" +msgstr "" + +msgid "**Source code:** :source:`Lib/tkinter/tix.py`" +msgstr "" + +msgid "" +"This Tk extension is unmaintained and should not be used in new code. Use :" +"mod:`tkinter.ttk` instead." +msgstr "" + +msgid "" +"The :mod:`tkinter.tix` (Tk Interface Extension) module provides an " +"additional rich set of widgets. Although the standard Tk library has many " +"useful widgets, they are far from complete. The :mod:`tkinter.tix` library " +"provides most of the commonly needed widgets that are missing from standard " +"Tk: :class:`HList`, :class:`ComboBox`, :class:`Control` (a.k.a. SpinBox) and " +"an assortment of scrollable widgets. :mod:`tkinter.tix` also includes many " +"more widgets that are generally useful in a wide range of applications: :" +"class:`NoteBook`, :class:`FileEntry`, :class:`PanedWindow`, etc; there are " +"more than 40 of them." +msgstr "" + +msgid "" +"With all these new widgets, you can introduce new interaction techniques " +"into applications, creating more useful and more intuitive user interfaces. " +"You can design your application by choosing the most appropriate widgets to " +"match the special needs of your application and users." +msgstr "" + +msgid "`Tix Homepage `_" +msgstr "" + +msgid "" +"The home page for :mod:`Tix`. This includes links to additional " +"documentation and downloads." +msgstr "" + +msgid "`Tix Man Pages `_" +msgstr "" + +msgid "On-line version of the man pages and reference material." +msgstr "" + +msgid "" +"`Tix Programming Guide `_" +msgstr "" + +msgid "On-line version of the programmer's reference material." +msgstr "" + +msgid "" +"`Tix Development Applications `_" +msgstr "" + +msgid "" +"Tix applications for development of Tix and Tkinter programs. Tide " +"applications work under Tk or Tkinter, and include :program:`TixInspect`, an " +"inspector to remotely modify and debug Tix/Tk/Tkinter applications." +msgstr "" + +msgid "Using Tix" +msgstr "" + +msgid "" +"Toplevel widget of Tix which represents mostly the main window of an " +"application. It has an associated Tcl interpreter." +msgstr "" + +msgid "" +"Classes in the :mod:`tkinter.tix` module subclasses the classes in the :mod:" +"`tkinter`. The former imports the latter, so to use :mod:`tkinter.tix` with " +"Tkinter, all you need to do is to import one module. In general, you can " +"just import :mod:`tkinter.tix`, and replace the toplevel call to :class:" +"`tkinter.Tk` with :class:`tix.Tk`::" +msgstr "" + +msgid "" +"To use :mod:`tkinter.tix`, you must have the Tix widgets installed, usually " +"alongside your installation of the Tk widgets. To test your installation, " +"try the following::" +msgstr "" + +msgid "Tix Widgets" +msgstr "" + +msgid "" +"`Tix `_ introduces over 40 widget classes to the :mod:`tkinter` repertoire." +msgstr "" + +msgid "Basic Widgets" +msgstr "" + +msgid "" +"A `Balloon `_ that pops up over a widget to provide help. When the user " +"moves the cursor inside a widget to which a Balloon widget has been bound, a " +"small pop-up window with a descriptive message will be shown on the screen." +msgstr "" + +msgid "" +"The `ButtonBox `_ widget creates a box of buttons, such as is commonly " +"used for ``Ok Cancel``." +msgstr "" + +msgid "" +"The `ComboBox `_ widget is similar to the combo box control in MS Windows. " +"The user can select a choice by either typing in the entry subwidget or " +"selecting from the listbox subwidget." +msgstr "" + +msgid "" +"The `Control `_ widget is also known as the :class:`SpinBox` widget. The " +"user can adjust the value by pressing the two arrow buttons or by entering " +"the value directly into the entry. The new value will be checked against the " +"user-defined upper and lower limits." +msgstr "" + +msgid "" +"The `LabelEntry `_ widget packages an entry widget and a label into one " +"mega widget. It can be used to simplify the creation of \"entry-form\" type " +"of interface." +msgstr "" + +msgid "" +"The `LabelFrame `_ widget packages a frame widget and a label into one " +"mega widget. To create widgets inside a LabelFrame widget, one creates the " +"new widgets relative to the :attr:`frame` subwidget and manage them inside " +"the :attr:`frame` subwidget." +msgstr "" + +msgid "" +"The `Meter `_ widget can be used to show the progress of a background job " +"which may take a long time to execute." +msgstr "" + +msgid "" +"The `OptionMenu `_ creates a menu button of options." +msgstr "" + +msgid "" +"The `PopupMenu `_ widget can be used as a replacement of the ``tk_popup`` " +"command. The advantage of the :mod:`Tix` :class:`PopupMenu` widget is it " +"requires less application code to manipulate." +msgstr "" + +msgid "" +"The `Select `_ widget is a container of button subwidgets. It can be used " +"to provide radio-box or check-box style of selection options for the user." +msgstr "" + +msgid "" +"The `StdButtonBox `_ widget is a group of standard buttons for Motif-like " +"dialog boxes." +msgstr "" + +msgid "File Selectors" +msgstr "" + +msgid "" +"The `DirList `_ widget displays a list view of a directory, its previous " +"directories and its sub-directories. The user can choose one of the " +"directories displayed in the list or change to another directory." +msgstr "" + +msgid "" +"The `DirTree `_ widget displays a tree view of a directory, its previous " +"directories and its sub-directories. The user can choose one of the " +"directories displayed in the list or change to another directory." +msgstr "" + +msgid "" +"The `DirSelectDialog `_ widget presents the directories in the file " +"system in a dialog window. The user can use this dialog window to navigate " +"through the file system to select the desired directory." +msgstr "" + +msgid "" +"The :class:`DirSelectBox` is similar to the standard Motif(TM) directory-" +"selection box. It is generally used for the user to choose a directory. " +"DirSelectBox stores the directories mostly recently selected into a ComboBox " +"widget so that they can be quickly selected again." +msgstr "" + +msgid "" +"The `ExFileSelectBox `_ widget is usually embedded in a " +"tixExFileSelectDialog widget. It provides a convenient method for the user " +"to select files. The style of the :class:`ExFileSelectBox` widget is very " +"similar to the standard file dialog on MS Windows 3.1." +msgstr "" + +msgid "" +"The `FileSelectBox `_ is similar to the standard Motif(TM) file-selection " +"box. It is generally used for the user to choose a file. FileSelectBox " +"stores the files mostly recently selected into a :class:`ComboBox` widget so " +"that they can be quickly selected again." +msgstr "" + +msgid "" +"The `FileEntry `_ widget can be used to input a filename. The user can " +"type in the filename manually. Alternatively, the user can press the button " +"widget that sits next to the entry, which will bring up a file selection " +"dialog." +msgstr "" + +msgid "Hierarchical ListBox" +msgstr "" + +msgid "" +"The `HList `_ widget can be used to display any data that have a " +"hierarchical structure, for example, file system directory trees. The list " +"entries are indented and connected by branch lines according to their places " +"in the hierarchy." +msgstr "" + +msgid "" +"The `CheckList `_ widget displays a list of items to be selected by the " +"user. CheckList acts similarly to the Tk checkbutton or radiobutton widgets, " +"except it is capable of handling many more items than checkbuttons or " +"radiobuttons." +msgstr "" + +msgid "" +"The `Tree `_ widget can be used to display hierarchical data in a tree form. The " +"user can adjust the view of the tree by opening or closing parts of the tree." +msgstr "" + +msgid "Tabular ListBox" +msgstr "" + +msgid "" +"The `TList `_ widget can be used to display data in a tabular format. The " +"list entries of a :class:`TList` widget are similar to the entries in the Tk " +"listbox widget. The main differences are (1) the :class:`TList` widget can " +"display the list entries in a two dimensional format and (2) you can use " +"graphical images as well as multiple colors and fonts for the list entries." +msgstr "" + +msgid "Manager Widgets" +msgstr "" + +msgid "" +"The `PanedWindow `_ widget allows the user to interactively manipulate the " +"sizes of several panes. The panes can be arranged either vertically or " +"horizontally. The user changes the sizes of the panes by dragging the " +"resize handle between two panes." +msgstr "" + +msgid "" +"The `ListNoteBook `_ widget is very similar to the :class:`TixNoteBook` " +"widget: it can be used to display many windows in a limited space using a " +"notebook metaphor. The notebook is divided into a stack of pages (windows). " +"At one time only one of these pages can be shown. The user can navigate " +"through these pages by choosing the name of the desired page in the :attr:" +"`hlist` subwidget." +msgstr "" + +msgid "" +"The `NoteBook `_ widget can be used to display many windows in a limited " +"space using a notebook metaphor. The notebook is divided into a stack of " +"pages. At one time only one of these pages can be shown. The user can " +"navigate through these pages by choosing the visual \"tabs\" at the top of " +"the NoteBook widget." +msgstr "" + +msgid "Image Types" +msgstr "" + +msgid "The :mod:`tkinter.tix` module adds:" +msgstr "" + +msgid "" +"`pixmap `_ capabilities to all :mod:`tkinter.tix` and :mod:`tkinter` widgets to " +"create color images from XPM files." +msgstr "" + +msgid "" +"`Compound `_ image types can be used to create images that consists of multiple " +"horizontal lines; each line is composed of a series of items (texts, " +"bitmaps, images or spaces) arranged from left to right. For example, a " +"compound image can be used to display a bitmap and a text string " +"simultaneously in a Tk :class:`Button` widget." +msgstr "" + +msgid "Miscellaneous Widgets" +msgstr "" + +msgid "" +"The `InputOnly `_ widgets are to accept inputs from the user, which can be " +"done with the ``bind`` command (Unix only)." +msgstr "" + +msgid "Form Geometry Manager" +msgstr "" + +msgid "In addition, :mod:`tkinter.tix` augments :mod:`tkinter` by providing:" +msgstr "" + +msgid "" +"The `Form `_ geometry manager based on attachment rules for all Tk widgets." +msgstr "" + +msgid "Tix Commands" +msgstr "" + +msgid "" +"The `tix commands `_ provide access to miscellaneous elements of :mod:`Tix`'s internal " +"state and the :mod:`Tix` application context. Most of the information " +"manipulated by these methods pertains to the application as a whole, or to a " +"screen or display, rather than to a particular window." +msgstr "" + +msgid "To view the current settings, the common usage is::" +msgstr "" + +msgid "" +"Query or modify the configuration options of the Tix application context. If " +"no option is specified, returns a dictionary all of the available options. " +"If option is specified with no value, then the method returns a list " +"describing the one named option (this list will be identical to the " +"corresponding sublist of the value returned if no option is specified). If " +"one or more option-value pairs are specified, then the method modifies the " +"given option(s) to have the given value(s); in this case the method returns " +"an empty string. Option may be any of the configuration options." +msgstr "" + +msgid "" +"Returns the current value of the configuration option given by *option*. " +"Option may be any of the configuration options." +msgstr "" + +msgid "" +"Locates a bitmap file of the name ``name.xpm`` or ``name`` in one of the " +"bitmap directories (see the :meth:`tix_addbitmapdir` method). By using :" +"meth:`tix_getbitmap`, you can avoid hard coding the pathnames of the bitmap " +"files in your application. When successful, it returns the complete pathname " +"of the bitmap file, prefixed with the character ``@``. The returned value " +"can be used to configure the ``bitmap`` option of the Tk and Tix widgets." +msgstr "" + +msgid "" +"Tix maintains a list of directories under which the :meth:`tix_getimage` " +"and :meth:`tix_getbitmap` methods will search for image files. The standard " +"bitmap directory is :file:`$TIX_LIBRARY/bitmaps`. The :meth:" +"`tix_addbitmapdir` method adds *directory* into this list. By using this " +"method, the image files of an applications can also be located using the :" +"meth:`tix_getimage` or :meth:`tix_getbitmap` method." +msgstr "" + +msgid "" +"Returns the file selection dialog that may be shared among different calls " +"from this application. This method will create a file selection dialog " +"widget when it is called the first time. This dialog will be returned by all " +"subsequent calls to :meth:`tix_filedialog`. An optional dlgclass parameter " +"can be passed as a string to specified what type of file selection dialog " +"widget is desired. Possible options are ``tix``, ``FileSelectDialog`` or " +"``tixExFileSelectDialog``." +msgstr "" + +msgid "" +"Locates an image file of the name :file:`name.xpm`, :file:`name.xbm` or :" +"file:`name.ppm` in one of the bitmap directories (see the :meth:" +"`tix_addbitmapdir` method above). If more than one file with the same name " +"(but different extensions) exist, then the image type is chosen according to " +"the depth of the X display: xbm images are chosen on monochrome displays and " +"color images are chosen on color displays. By using :meth:`tix_getimage`, " +"you can avoid hard coding the pathnames of the image files in your " +"application. When successful, this method returns the name of the newly " +"created image, which can be used to configure the ``image`` option of the Tk " +"and Tix widgets." +msgstr "" + +msgid "Gets the options maintained by the Tix scheme mechanism." +msgstr "" + +msgid "" +"Resets the scheme and fontset of the Tix application to *newScheme* and " +"*newFontSet*, respectively. This affects only those widgets created after " +"this call. Therefore, it is best to call the resetoptions method before the " +"creation of any widgets in a Tix application." +msgstr "" + +msgid "" +"The optional parameter *newScmPrio* can be given to reset the priority level " +"of the Tk options set by the Tix schemes." +msgstr "" + +msgid "" +"Because of the way Tk handles the X option database, after Tix has been has " +"imported and inited, it is not possible to reset the color schemes and font " +"sets using the :meth:`tix_config` method. Instead, the :meth:" +"`tix_resetoptions` method must be used." +msgstr "" + +msgid "Tix" +msgstr "" diff --git a/library/tkinter.ttk.po b/library/tkinter.ttk.po new file mode 100644 index 0000000000..8c999922f9 --- /dev/null +++ b/library/tkinter.ttk.po @@ -0,0 +1,1726 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`tkinter.ttk` --- Tk themed widgets" +msgstr "" + +msgid "**Source code:** :source:`Lib/tkinter/ttk.py`" +msgstr "" + +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)." +msgstr "" + +msgid "" +"The basic idea for :mod:`tkinter.ttk` is to separate, to the extent " +"possible, the code implementing a widget's behavior from the code " +"implementing its appearance." +msgstr "" + +msgid "" +"`Tk Widget Styling Support `_" +msgstr "" + +msgid "A document introducing theming support for Tk" +msgstr "" + +msgid "Using Ttk" +msgstr "" + +msgid "To start using Ttk, import its module::" +msgstr "" + +msgid "" +"To override the basic Tk widgets, the import should follow the Tk import::" +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." +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 " +"styling effects." +msgstr "" + +msgid "" +"`Converting existing applications to use Tile widgets `_" +msgstr "" + +msgid "" +"A monograph (using Tcl terminology) about differences typically encountered " +"when moving applications to use the new widgets." +msgstr "" + +msgid "Ttk Widgets" +msgstr "" + +msgid "" +"Ttk comes with 18 widgets, twelve of which already existed in tkinter: :" +"class:`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:" +"`Label`, :class:`LabelFrame`, :class:`Menubutton`, :class:`PanedWindow`, :" +"class:`Radiobutton`, :class:`Scale`, :class:`Scrollbar`, and :class:" +"`Spinbox`. The other six are new: :class:`Combobox`, :class:`Notebook`, :" +"class:`Progressbar`, :class:`Separator`, :class:`Sizegrip` and :class:" +"`Treeview`. And all them are subclasses of :class:`Widget`." +msgstr "" + +msgid "" +"Using the Ttk widgets gives the application an improved look and feel. As " +"discussed above, there are differences in how the styling is coded." +msgstr "" + +msgid "Tk code::" +msgstr "" + +msgid "Ttk code::" +msgstr "" + +msgid "" +"For more information about TtkStyling_, see the :class:`Style` class " +"documentation." +msgstr "" + +msgid "Widget" +msgstr "" + +msgid "" +":class:`ttk.Widget` defines standard options and methods supported by Tk " +"themed widgets and is not supposed to be directly instantiated." +msgstr "" + +msgid "Standard Options" +msgstr "" + +msgid "All the :mod:`ttk` Widgets accept the following options:" +msgstr "" + +msgid "Option" +msgstr "" + +msgid "Description" +msgstr "Opis" + +msgid "class" +msgstr "klasa" + +msgid "" +"Specifies the window class. The class is used when querying the option " +"database for the window's other options, to determine the default bindtags " +"for the window, and to select the widget's default layout and style. This " +"option is read-only, and may only be specified when the window is created." +msgstr "" + +msgid "cursor" +msgstr "" + +msgid "" +"Specifies the mouse cursor to be used for the widget. If set to the empty " +"string (the default), the cursor is inherited for the parent widget." +msgstr "" + +msgid "takefocus" +msgstr "" + +msgid "" +"Determines whether the window accepts the focus during keyboard traversal. " +"0, 1 or an empty string is returned. If 0 is returned, it means that the " +"window should be skipped entirely during keyboard traversal. If 1, it means " +"that the window should receive the input focus as long as it is viewable. " +"And an empty string means that the traversal scripts make the decision about " +"whether or not to focus on the window." +msgstr "" + +msgid "style" +msgstr "styl" + +msgid "May be used to specify a custom widget style." +msgstr "" + +msgid "Scrollable Widget Options" +msgstr "" + +msgid "" +"The following options are supported by widgets that are controlled by a " +"scrollbar." +msgstr "" + +msgid "xscrollcommand" +msgstr "" + +msgid "Used to communicate with horizontal scrollbars." +msgstr "" + +msgid "" +"When the view in the widget's window change, the widget will generate a Tcl " +"command based on the scrollcommand." +msgstr "" + +msgid "" +"Usually this option consists of the method :meth:`Scrollbar.set` of some " +"scrollbar. This will cause the scrollbar to be updated whenever the view in " +"the window changes." +msgstr "" + +msgid "yscrollcommand" +msgstr "" + +msgid "" +"Used to communicate with vertical scrollbars. For some more information, see " +"above." +msgstr "" + +msgid "Label Options" +msgstr "" + +msgid "" +"The following options are supported by labels, buttons and other button-like " +"widgets." +msgstr "" + +msgid "text" +msgstr "" + +msgid "Specifies a text string to be displayed inside the widget." +msgstr "" + +msgid "textvariable" +msgstr "" + +msgid "" +"Specifies a name whose value will be used in place of the text option " +"resource." +msgstr "" + +msgid "underline" +msgstr "" + +msgid "" +"If set, specifies the index (0-based) of a character to underline in the " +"text string. The underline character is used for mnemonic activation." +msgstr "" + +msgid "image" +msgstr "" + +msgid "" +"Specifies an image to display. This is a list of 1 or more elements. The " +"first element is the default image name. The rest of the list if a sequence " +"of statespec/value pairs as defined by :meth:`Style.map`, specifying " +"different images to use when the widget is in a particular state or a " +"combination of states. All images in the list should have the same size." +msgstr "" + +msgid "compound" +msgstr "" + +msgid "" +"Specifies how to display the image relative to the text, in the case both " +"text and images options are present. Valid values are:" +msgstr "" + +msgid "text: display text only" +msgstr "" + +msgid "image: display image only" +msgstr "" + +msgid "" +"top, bottom, left, right: display image above, below, left of, or right of " +"the text, respectively." +msgstr "" + +msgid "none: the default. display the image if present, otherwise the text." +msgstr "" + +msgid "width" +msgstr "" + +msgid "" +"If greater than zero, specifies how much space, in character widths, to " +"allocate for the text label, if less than zero, specifies a minimum width. " +"If zero or unspecified, the natural width of the text label is used." +msgstr "" + +msgid "Compatibility Options" +msgstr "" + +msgid "state" +msgstr "" + +msgid "" +"May be set to \"normal\" or \"disabled\" to control the \"disabled\" state " +"bit. This is a write-only option: setting it changes the widget state, but " +"the :meth:`Widget.state` method does not affect this option." +msgstr "" + +msgid "Widget States" +msgstr "" + +msgid "The widget state is a bitmap of independent state flags." +msgstr "" + +msgid "Flag" +msgstr "" + +msgid "active" +msgstr "" + +msgid "" +"The mouse cursor is over the widget and pressing a mouse button will cause " +"some action to occur" +msgstr "" + +msgid "disabled" +msgstr "" + +msgid "Widget is disabled under program control" +msgstr "" + +msgid "focus" +msgstr "" + +msgid "Widget has keyboard focus" +msgstr "" + +msgid "pressed" +msgstr "" + +msgid "Widget is being pressed" +msgstr "" + +msgid "selected" +msgstr "" + +msgid "" +"\"On\", \"true\", or \"current\" for things like Checkbuttons and " +"radiobuttons" +msgstr "" + +msgid "background" +msgstr "" + +msgid "" +"Windows and Mac have a notion of an \"active\" or foreground window. The " +"*background* state is set for widgets in a background window, and cleared " +"for those in the foreground window" +msgstr "" + +msgid "readonly" +msgstr "" + +msgid "Widget should not allow user modification" +msgstr "" + +msgid "alternate" +msgstr "" + +msgid "A widget-specific alternate display format" +msgstr "" + +msgid "invalid" +msgstr "" + +msgid "The widget's value is invalid" +msgstr "" + +msgid "" +"A state specification is a sequence of state names, optionally prefixed with " +"an exclamation point indicating that the bit is off." +msgstr "" + +msgid "ttk.Widget" +msgstr "" + +msgid "" +"Besides the methods described below, the :class:`ttk.Widget` supports the " +"methods :meth:`tkinter.Widget.cget` and :meth:`tkinter.Widget.configure`." +msgstr "" + +msgid "" +"Returns the name of the element at position *x* *y*, or the empty string if " +"the point does not lie within any element." +msgstr "" + +msgid "*x* and *y* are pixel coordinates relative to the widget." +msgstr "" + +msgid "" +"Test the widget's state. If a callback is not specified, returns ``True`` if " +"the widget state matches *statespec* and ``False`` otherwise. If callback is " +"specified then it is called with args if widget state matches *statespec*." +msgstr "" + +msgid "" +"Modify or inquire widget state. If *statespec* is specified, sets the widget " +"state according to it and return a new *statespec* indicating which flags " +"were changed. If *statespec* is not specified, returns the currently enabled " +"state flags." +msgstr "" + +msgid "*statespec* will usually be a list or a tuple." +msgstr "" + +msgid "Combobox" +msgstr "" + +msgid "" +"The :class:`ttk.Combobox` widget combines a text field with a pop-down list " +"of values. This widget is a subclass of :class:`Entry`." +msgstr "" + +msgid "" +"Besides the methods inherited from :class:`Widget`: :meth:`Widget.cget`, :" +"meth:`Widget.configure`, :meth:`Widget.identify`, :meth:`Widget.instate` " +"and :meth:`Widget.state`, and the following inherited from :class:`Entry`: :" +"meth:`Entry.bbox`, :meth:`Entry.delete`, :meth:`Entry.icursor`, :meth:`Entry." +"index`, :meth:`Entry.insert`, :meth:`Entry.selection`, :meth:`Entry.xview`, " +"it has some other methods, described at :class:`ttk.Combobox`." +msgstr "" + +msgid "Options" +msgstr "" + +msgid "This widget accepts the following specific options:" +msgstr "" + +msgid "exportselection" +msgstr "" + +msgid "" +"Boolean value. If set, the widget selection is linked to the Window Manager " +"selection (which can be returned by invoking Misc.selection_get, for " +"example)." +msgstr "" + +msgid "justify" +msgstr "" + +msgid "" +"Specifies how the text is aligned within the widget. One of \"left\", " +"\"center\", or \"right\"." +msgstr "" + +msgid "height" +msgstr "" + +msgid "Specifies the height of the pop-down listbox, in rows." +msgstr "" + +msgid "postcommand" +msgstr "" + +msgid "" +"A script (possibly registered with Misc.register) that is called immediately " +"before displaying the values. It may specify which values to display." +msgstr "" + +msgid "" +"One of \"normal\", \"readonly\", or \"disabled\". In the \"readonly\" state, " +"the value may not be edited directly, and the user can only selection of the " +"values from the dropdown list. In the \"normal\" state, the text field is " +"directly editable. In the \"disabled\" state, no interaction is possible." +msgstr "" + +msgid "" +"Specifies a name whose value is linked to the widget value. Whenever the " +"value associated with that name changes, the widget value is updated, and " +"vice versa. See :class:`tkinter.StringVar`." +msgstr "" + +msgid "values" +msgstr "" + +msgid "Specifies the list of values to display in the drop-down listbox." +msgstr "" + +msgid "" +"Specifies an integer value indicating the desired width of the entry window, " +"in average-size characters of the widget's font." +msgstr "" + +msgid "Virtual events" +msgstr "" + +msgid "" +"The combobox widgets generates a **<>** virtual event when " +"the user selects an element from the list of values." +msgstr "" + +msgid "ttk.Combobox" +msgstr "" + +msgid "" +"If *newindex* is specified, sets the combobox value to the element position " +"*newindex*. Otherwise, returns the index of the current value or -1 if the " +"current value is not in the values list." +msgstr "" + +msgid "Returns the current value of the combobox." +msgstr "" + +msgid "Sets the value of the combobox to *value*." +msgstr "" + +msgid "Spinbox" +msgstr "" + +msgid "" +"The :class:`ttk.Spinbox` widget is a :class:`ttk.Entry` enhanced with " +"increment and decrement arrows. It can be used for numbers or lists of " +"string values. This widget is a subclass of :class:`Entry`." +msgstr "" + +msgid "" +"Besides the methods inherited from :class:`Widget`: :meth:`Widget.cget`, :" +"meth:`Widget.configure`, :meth:`Widget.identify`, :meth:`Widget.instate` " +"and :meth:`Widget.state`, and the following inherited from :class:`Entry`: :" +"meth:`Entry.bbox`, :meth:`Entry.delete`, :meth:`Entry.icursor`, :meth:`Entry." +"index`, :meth:`Entry.insert`, :meth:`Entry.xview`, it has some other " +"methods, described at :class:`ttk.Spinbox`." +msgstr "" + +msgid "from" +msgstr "" + +msgid "" +"Float value. If set, this is the minimum value to which the decrement " +"button will decrement. Must be spelled as ``from_`` when used as an " +"argument, since ``from`` is a Python keyword." +msgstr "" + +msgid "to" +msgstr "" + +msgid "" +"Float value. If set, this is the maximum value to which the increment " +"button will increment." +msgstr "" + +msgid "increment" +msgstr "" + +msgid "" +"Float value. Specifies the amount which the increment/decrement buttons " +"change the value. Defaults to 1.0." +msgstr "" + +msgid "" +"Sequence of string or float values. If specified, the increment/decrement " +"buttons will cycle through the items in this sequence rather than " +"incrementing or decrementing numbers." +msgstr "" + +msgid "wrap" +msgstr "" + +msgid "" +"Boolean value. If ``True``, increment and decrement buttons will cycle from " +"the ``to`` value to the ``from`` value or the ``from`` value to the ``to`` " +"value, respectively." +msgstr "" + +msgid "format" +msgstr "format" + +msgid "" +"String value. This specifies the format of numbers set by the increment/" +"decrement buttons. It must be in the form \"%W.Pf\", where W is the padded " +"width of the value, P is the precision, and '%' and 'f' are literal." +msgstr "" + +msgid "command" +msgstr "" + +msgid "" +"Python callable. Will be called with no arguments whenever either of the " +"increment or decrement buttons are pressed." +msgstr "" + +msgid "" +"The spinbox widget generates an **<>** virtual event when the " +"user presses , and a **<>** virtual event when the user " +"presses ." +msgstr "" + +msgid "ttk.Spinbox" +msgstr "" + +msgid "Returns the current value of the spinbox." +msgstr "" + +msgid "Sets the value of the spinbox to *value*." +msgstr "" + +msgid "Notebook" +msgstr "" + +msgid "" +"Ttk Notebook widget manages a collection of windows and displays a single " +"one at a time. Each child window is associated with a tab, which the user " +"may select to change the currently displayed window." +msgstr "" + +msgid "" +"If present and greater than zero, specifies the desired height of the pane " +"area (not including internal padding or tabs). Otherwise, the maximum height " +"of all panes is used." +msgstr "" + +msgid "padding" +msgstr "" + +msgid "" +"Specifies the amount of extra space to add around the outside of the " +"notebook. The padding is a list up to four length specifications left top " +"right bottom. If fewer than four elements are specified, bottom defaults to " +"top, right defaults to left, and top defaults to left." +msgstr "" + +msgid "" +"If present and greater than zero, specified the desired width of the pane " +"area (not including internal padding). Otherwise, the maximum width of all " +"panes is used." +msgstr "" + +msgid "Tab Options" +msgstr "" + +msgid "There are also specific options for tabs:" +msgstr "" + +msgid "" +"Either \"normal\", \"disabled\" or \"hidden\". If \"disabled\", then the tab " +"is not selectable. If \"hidden\", then the tab is not shown." +msgstr "" + +msgid "sticky" +msgstr "" + +msgid "" +"Specifies how the child window is positioned within the pane area. Value is " +"a string containing zero or more of the characters \"n\", \"s\", \"e\" or " +"\"w\". Each letter refers to a side (north, south, east or west) that the " +"child window will stick to, as per the :meth:`grid` geometry manager." +msgstr "" + +msgid "" +"Specifies the amount of extra space to add between the notebook and this " +"pane. Syntax is the same as for the option padding used by this widget." +msgstr "" + +msgid "Specifies a text to be displayed in the tab." +msgstr "" + +msgid "" +"Specifies an image to display in the tab. See the option image described in :" +"class:`Widget`." +msgstr "" + +msgid "" +"Specifies how to display the image relative to the text, in the case both " +"options text and image are present. See `Label Options`_ for legal values." +msgstr "" + +msgid "" +"Specifies the index (0-based) of a character to underline in the text " +"string. The underlined character is used for mnemonic activation if :meth:" +"`Notebook.enable_traversal` is called." +msgstr "" + +msgid "Tab Identifiers" +msgstr "" + +msgid "" +"The tab_id present in several methods of :class:`ttk.Notebook` may take any " +"of the following forms:" +msgstr "" + +msgid "An integer between zero and the number of tabs" +msgstr "" + +msgid "The name of a child window" +msgstr "" + +msgid "" +"A positional specification of the form \"@x,y\", which identifies the tab" +msgstr "" + +msgid "" +"The literal string \"current\", which identifies the currently selected tab" +msgstr "" + +msgid "" +"The literal string \"end\", which returns the number of tabs (only valid " +"for :meth:`Notebook.index`)" +msgstr "" + +msgid "Virtual Events" +msgstr "" + +msgid "" +"This widget generates a **<>** virtual event after a new " +"tab is selected." +msgstr "" + +msgid "ttk.Notebook" +msgstr "" + +msgid "Adds a new tab to the notebook." +msgstr "" + +msgid "" +"If window is currently managed by the notebook but hidden, it is restored to " +"its previous position." +msgstr "" + +msgid "See `Tab Options`_ for the list of available options." +msgstr "" + +msgid "" +"Removes the tab specified by *tab_id*, unmaps and unmanages the associated " +"window." +msgstr "" + +msgid "Hides the tab specified by *tab_id*." +msgstr "" + +msgid "" +"The tab will not be displayed, but the associated window remains managed by " +"the notebook and its configuration remembered. Hidden tabs may be restored " +"with the :meth:`add` command." +msgstr "" + +msgid "" +"Returns the name of the tab element at position *x*, *y*, or the empty " +"string if none." +msgstr "" + +msgid "" +"Returns the numeric index of the tab specified by *tab_id*, or the total " +"number of tabs if *tab_id* is the string \"end\"." +msgstr "" + +msgid "Inserts a pane at the specified position." +msgstr "" + +msgid "" +"*pos* is either the string \"end\", an integer index, or the name of a " +"managed child. If *child* is already managed by the notebook, moves it to " +"the specified position." +msgstr "" + +msgid "Selects the specified *tab_id*." +msgstr "" + +msgid "" +"The associated child window will be displayed, and the previously selected " +"window (if different) is unmapped. If *tab_id* is omitted, returns the " +"widget name of the currently selected pane." +msgstr "" + +msgid "Query or modify the options of the specific *tab_id*." +msgstr "" + +msgid "" +"If *kw* is not given, returns a dictionary of the tab option values. If " +"*option* is specified, returns the value of that *option*. Otherwise, sets " +"the options to the corresponding values." +msgstr "" + +msgid "Returns a list of windows managed by the notebook." +msgstr "" + +msgid "" +"Enable keyboard traversal for a toplevel window containing this notebook." +msgstr "" + +msgid "" +"This will extend the bindings for the toplevel window containing the " +"notebook as follows:" +msgstr "" + +msgid "" +":kbd:`Control-Tab`: selects the tab following the currently selected one." +msgstr "" + +msgid "" +":kbd:`Shift-Control-Tab`: selects the tab preceding the currently selected " +"one." +msgstr "" + +msgid "" +":kbd:`Alt-K`: where *K* is the mnemonic (underlined) character of any tab, " +"will select that tab." +msgstr "" + +msgid "" +"Multiple notebooks in a single toplevel may be enabled for traversal, " +"including nested notebooks. However, notebook traversal only works properly " +"if all panes have the notebook they are in as master." +msgstr "" + +msgid "Progressbar" +msgstr "" + +msgid "" +"The :class:`ttk.Progressbar` widget shows the status of a long-running " +"operation. It can operate in two modes: 1) the determinate mode which shows " +"the amount completed relative to the total amount of work to be done and 2) " +"the indeterminate mode which provides an animated display to let the user " +"know that work is progressing." +msgstr "" + +msgid "orient" +msgstr "" + +msgid "" +"One of \"horizontal\" or \"vertical\". Specifies the orientation of the " +"progress bar." +msgstr "" + +msgid "length" +msgstr "" + +msgid "" +"Specifies the length of the long axis of the progress bar (width if " +"horizontal, height if vertical)." +msgstr "" + +msgid "mode" +msgstr "" + +msgid "One of \"determinate\" or \"indeterminate\"." +msgstr "" + +msgid "maximum" +msgstr "" + +msgid "A number specifying the maximum value. Defaults to 100." +msgstr "" + +msgid "value" +msgstr "" + +msgid "" +"The current value of the progress bar. In \"determinate\" mode, this " +"represents the amount of work completed. In \"indeterminate\" mode, it is " +"interpreted as modulo *maximum*; that is, the progress bar completes one " +"\"cycle\" when its value increases by *maximum*." +msgstr "" + +msgid "variable" +msgstr "" + +msgid "" +"A name which is linked to the option value. If specified, the value of the " +"progress bar is automatically set to the value of this name whenever the " +"latter is modified." +msgstr "" + +msgid "phase" +msgstr "" + +msgid "" +"Read-only option. The widget periodically increments the value of this " +"option whenever its value is greater than 0 and, in determinate mode, less " +"than maximum. This option may be used by the current theme to provide " +"additional animation effects." +msgstr "" + +msgid "ttk.Progressbar" +msgstr "" + +msgid "" +"Begin autoincrement mode: schedules a recurring timer event that calls :meth:" +"`Progressbar.step` every *interval* milliseconds. If omitted, *interval* " +"defaults to 50 milliseconds." +msgstr "" + +msgid "Increments the progress bar's value by *amount*." +msgstr "" + +msgid "*amount* defaults to 1.0 if omitted." +msgstr "" + +msgid "" +"Stop autoincrement mode: cancels any recurring timer event initiated by :" +"meth:`Progressbar.start` for this progress bar." +msgstr "" + +msgid "Separator" +msgstr "" + +msgid "" +"The :class:`ttk.Separator` widget displays a horizontal or vertical " +"separator bar." +msgstr "" + +msgid "" +"It has no other methods besides the ones inherited from :class:`ttk.Widget`." +msgstr "" + +msgid "This widget accepts the following specific option:" +msgstr "" + +msgid "" +"One of \"horizontal\" or \"vertical\". Specifies the orientation of the " +"separator." +msgstr "" + +msgid "Sizegrip" +msgstr "" + +msgid "" +"The :class:`ttk.Sizegrip` widget (also known as a grow box) allows the user " +"to resize the containing toplevel window by pressing and dragging the grip." +msgstr "" + +msgid "" +"This widget has neither specific options nor specific methods, besides the " +"ones inherited from :class:`ttk.Widget`." +msgstr "" + +msgid "Platform-specific notes" +msgstr "" + +msgid "" +"On macOS, toplevel windows automatically include a built-in size grip by " +"default. Adding a :class:`Sizegrip` is harmless, since the built-in grip " +"will just mask the widget." +msgstr "" + +msgid "Bugs" +msgstr "" + +msgid "" +"If the containing toplevel's position was specified relative to the right or " +"bottom of the screen (e.g. ....), the :class:`Sizegrip` widget will not " +"resize the window." +msgstr "" + +msgid "This widget supports only \"southeast\" resizing." +msgstr "" + +msgid "Treeview" +msgstr "" + +msgid "" +"The :class:`ttk.Treeview` widget displays a hierarchical collection of " +"items. Each item has a textual label, an optional image, and an optional " +"list of data values. The data values are displayed in successive columns " +"after the tree label." +msgstr "" + +msgid "" +"The order in which data values are displayed may be controlled by setting " +"the widget option ``displaycolumns``. The tree widget can also display " +"column headings. Columns may be accessed by number or symbolic names listed " +"in the widget option columns. See `Column Identifiers`_." +msgstr "" + +msgid "" +"Each item is identified by a unique name. The widget will generate item IDs " +"if they are not supplied by the caller. There is a distinguished root item, " +"named ``{}``. The root item itself is not displayed; its children appear at " +"the top level of the hierarchy." +msgstr "" + +msgid "" +"Each item also has a list of tags, which can be used to associate event " +"bindings with individual items and control the appearance of the item." +msgstr "" + +msgid "" +"The Treeview widget supports horizontal and vertical scrolling, according to " +"the options described in `Scrollable Widget Options`_ and the methods :meth:" +"`Treeview.xview` and :meth:`Treeview.yview`." +msgstr "" + +msgid "columns" +msgstr "" + +msgid "" +"A list of column identifiers, specifying the number of columns and their " +"names." +msgstr "" + +msgid "displaycolumns" +msgstr "" + +msgid "" +"A list of column identifiers (either symbolic or integer indices) specifying " +"which data columns are displayed and the order in which they appear, or the " +"string \"#all\"." +msgstr "" + +msgid "" +"Specifies the number of rows which should be visible. Note: the requested " +"width is determined from the sum of the column widths." +msgstr "" + +msgid "" +"Specifies the internal padding for the widget. The padding is a list of up " +"to four length specifications." +msgstr "" + +msgid "selectmode" +msgstr "" + +msgid "" +"Controls how the built-in class bindings manage the selection. One of " +"\"extended\", \"browse\" or \"none\". If set to \"extended\" (the default), " +"multiple items may be selected. If \"browse\", only a single item will be " +"selected at a time. If \"none\", the selection will not be changed." +msgstr "" + +msgid "" +"Note that the application code and tag bindings can set the selection " +"however they wish, regardless of the value of this option." +msgstr "" + +msgid "show" +msgstr "" + +msgid "" +"A list containing zero or more of the following values, specifying which " +"elements of the tree to display." +msgstr "" + +msgid "tree: display tree labels in column #0." +msgstr "" + +msgid "headings: display the heading row." +msgstr "" + +msgid "The default is \"tree headings\", i.e., show all elements." +msgstr "" + +msgid "" +"**Note**: Column #0 always refers to the tree column, even if show=\"tree\" " +"is not specified." +msgstr "" + +msgid "Item Options" +msgstr "" + +msgid "" +"The following item options may be specified for items in the insert and item " +"widget commands." +msgstr "" + +msgid "The textual label to display for the item." +msgstr "" + +msgid "A Tk Image, displayed to the left of the label." +msgstr "" + +msgid "The list of values associated with the item." +msgstr "" + +msgid "" +"Each item should have the same number of values as the widget option " +"columns. If there are fewer values than columns, the remaining values are " +"assumed empty. If there are more values than columns, the extra values are " +"ignored." +msgstr "" + +msgid "open" +msgstr "otwórz" + +msgid "" +"``True``/``False`` value indicating whether the item's children should be " +"displayed or hidden." +msgstr "" + +msgid "tags" +msgstr "" + +msgid "A list of tags associated with this item." +msgstr "" + +msgid "Tag Options" +msgstr "" + +msgid "The following options may be specified on tags:" +msgstr "" + +msgid "foreground" +msgstr "" + +msgid "Specifies the text foreground color." +msgstr "" + +msgid "Specifies the cell or item background color." +msgstr "" + +msgid "font" +msgstr "" + +msgid "Specifies the font to use when drawing text." +msgstr "" + +msgid "Specifies the item image, in case the item's image option is empty." +msgstr "" + +msgid "Column Identifiers" +msgstr "" + +msgid "Column identifiers take any of the following forms:" +msgstr "" + +msgid "A symbolic name from the list of columns option." +msgstr "" + +msgid "An integer n, specifying the nth data column." +msgstr "" + +msgid "" +"A string of the form #n, where n is an integer, specifying the nth display " +"column." +msgstr "" + +msgid "Notes:" +msgstr "Uwagi:" + +msgid "" +"Item's option values may be displayed in a different order than the order in " +"which they are stored." +msgstr "" + +msgid "" +"Column #0 always refers to the tree column, even if show=\"tree\" is not " +"specified." +msgstr "" + +msgid "" +"A data column number is an index into an item's option values list; a " +"display column number is the column number in the tree where the values are " +"displayed. Tree labels are displayed in column #0. If option displaycolumns " +"is not set, then data column n is displayed in column #n+1. Again, **column " +"#0 always refers to the tree column**." +msgstr "" + +msgid "The Treeview widget generates the following virtual events." +msgstr "" + +msgid "Event" +msgstr "Zdarzenie" + +msgid "<>" +msgstr "" + +msgid "Generated whenever the selection changes." +msgstr "" + +msgid "<>" +msgstr "" + +msgid "Generated just before settings the focus item to open=True." +msgstr "" + +msgid "<>" +msgstr "" + +msgid "Generated just after setting the focus item to open=False." +msgstr "" + +msgid "" +"The :meth:`Treeview.focus` and :meth:`Treeview.selection` methods can be " +"used to determine the affected item or items." +msgstr "" + +msgid "ttk.Treeview" +msgstr "" + +msgid "" +"Returns the bounding box (relative to the treeview widget's window) of the " +"specified *item* in the form (x, y, width, height)." +msgstr "" + +msgid "" +"If *column* is specified, returns the bounding box of that cell. If the " +"*item* is not visible (i.e., if it is a descendant of a closed item or is " +"scrolled offscreen), returns an empty string." +msgstr "" + +msgid "Returns the list of children belonging to *item*." +msgstr "" + +msgid "If *item* is not specified, returns root children." +msgstr "" + +msgid "Replaces *item*'s child with *newchildren*." +msgstr "" + +msgid "" +"Children present in *item* that are not present in *newchildren* are " +"detached from the tree. No items in *newchildren* may be an ancestor of " +"*item*. Note that not specifying *newchildren* results in detaching *item*'s " +"children." +msgstr "" + +msgid "Query or modify the options for the specified *column*." +msgstr "" + +msgid "" +"If *kw* is not given, returns a dict of the column option values. If " +"*option* is specified then the value for that *option* is returned. " +"Otherwise, sets the options to the corresponding values." +msgstr "" + +msgid "The valid options/values are:" +msgstr "" + +msgid "*id*" +msgstr "" + +msgid "Returns the column name. This is a read-only option." +msgstr "" + +msgid "*anchor*: One of the standard Tk anchor values." +msgstr "" + +msgid "" +"Specifies how the text in this column should be aligned with respect to the " +"cell." +msgstr "" + +msgid "*minwidth*: width" +msgstr "" + +msgid "" +"The minimum width of the column in pixels. The treeview widget will not make " +"the column any smaller than specified by this option when the widget is " +"resized or the user drags a column." +msgstr "" + +msgid "*stretch*: ``True``/``False``" +msgstr "" + +msgid "" +"Specifies whether the column's width should be adjusted when the widget is " +"resized." +msgstr "" + +msgid "*width*: width" +msgstr "" + +msgid "The width of the column in pixels." +msgstr "" + +msgid "To configure the tree column, call this with column = \"#0\"" +msgstr "" + +msgid "Delete all specified *items* and all their descendants." +msgstr "" + +msgid "The root item may not be deleted." +msgstr "" + +msgid "Unlinks all of the specified *items* from the tree." +msgstr "" + +msgid "" +"The items and all of their descendants are still present, and may be " +"reinserted at another point in the tree, but will not be displayed." +msgstr "" + +msgid "The root item may not be detached." +msgstr "" + +msgid "Returns ``True`` if the specified *item* is present in the tree." +msgstr "" + +msgid "" +"If *item* is specified, sets the focus item to *item*. Otherwise, returns " +"the current focus item, or '' if there is none." +msgstr "" + +msgid "Query or modify the heading options for the specified *column*." +msgstr "" + +msgid "" +"If *kw* is not given, returns a dict of the heading option values. If " +"*option* is specified then the value for that *option* is returned. " +"Otherwise, sets the options to the corresponding values." +msgstr "" + +msgid "*text*: text" +msgstr "" + +msgid "The text to display in the column heading." +msgstr "" + +msgid "*image*: imageName" +msgstr "" + +msgid "Specifies an image to display to the right of the column heading." +msgstr "" + +msgid "*anchor*: anchor" +msgstr "" + +msgid "" +"Specifies how the heading text should be aligned. One of the standard Tk " +"anchor values." +msgstr "" + +msgid "*command*: callback" +msgstr "" + +msgid "A callback to be invoked when the heading label is pressed." +msgstr "" + +msgid "To configure the tree column heading, call this with column = \"#0\"." +msgstr "" + +msgid "" +"Returns a description of the specified *component* under the point given by " +"*x* and *y*, or the empty string if no such *component* is present at that " +"position." +msgstr "" + +msgid "Returns the item ID of the item at position *y*." +msgstr "" + +msgid "Returns the data column identifier of the cell at position *x*." +msgstr "" + +msgid "The tree column has ID #0." +msgstr "" + +msgid "Returns one of:" +msgstr "" + +msgid "region" +msgstr "" + +msgid "meaning" +msgstr "" + +msgid "heading" +msgstr "" + +msgid "Tree heading area." +msgstr "" + +msgid "separator" +msgstr "" + +msgid "Space between two columns headings." +msgstr "" + +msgid "tree" +msgstr "" + +msgid "The tree area." +msgstr "" + +msgid "cell" +msgstr "" + +msgid "A data cell." +msgstr "" + +msgid "Availability: Tk 8.6." +msgstr "" + +msgid "Returns the element at position *x*, *y*." +msgstr "" + +msgid "" +"Returns the integer index of *item* within its parent's list of children." +msgstr "" + +msgid "" +"Creates a new item and returns the item identifier of the newly created item." +msgstr "" + +msgid "" +"*parent* is the item ID of the parent item, or the empty string to create a " +"new top-level item. *index* is an integer, or the value \"end\", specifying " +"where in the list of parent's children to insert the new item. If *index* is " +"less than or equal to zero, the new node is inserted at the beginning; if " +"*index* is greater than or equal to the current number of children, it is " +"inserted at the end. If *iid* is specified, it is used as the item " +"identifier; *iid* must not already exist in the tree. Otherwise, a new " +"unique identifier is generated." +msgstr "" + +msgid "See `Item Options`_ for the list of available options." +msgstr "" + +msgid "Query or modify the options for the specified *item*." +msgstr "" + +msgid "" +"If no options are given, a dict with options/values for the item is " +"returned. If *option* is specified then the value for that option is " +"returned. Otherwise, sets the options to the corresponding values as given " +"by *kw*." +msgstr "" + +msgid "Moves *item* to position *index* in *parent*'s list of children." +msgstr "" + +msgid "" +"It is illegal to move an item under one of its descendants. If *index* is " +"less than or equal to zero, *item* is moved to the beginning; if greater " +"than or equal to the number of children, it is moved to the end. If *item* " +"was detached it is reattached." +msgstr "" + +msgid "" +"Returns the identifier of *item*'s next sibling, or '' if *item* is the last " +"child of its parent." +msgstr "" + +msgid "" +"Returns the ID of the parent of *item*, or '' if *item* is at the top level " +"of the hierarchy." +msgstr "" + +msgid "" +"Returns the identifier of *item*'s previous sibling, or '' if *item* is the " +"first child of its parent." +msgstr "" + +msgid "An alias for :meth:`Treeview.move`." +msgstr "" + +msgid "Ensure that *item* is visible." +msgstr "" + +msgid "" +"Sets all of *item*'s ancestors open option to ``True``, and scrolls the " +"widget if necessary so that *item* is within the visible portion of the tree." +msgstr "" + +msgid "Returns a tuple of selected items." +msgstr "" + +msgid "" +"``selection()`` no longer takes arguments. For changing the selection state " +"use the following selection methods." +msgstr "" + +msgid "*items* becomes the new selection." +msgstr "" + +msgid "" +"*items* can be passed as separate arguments, not just as a single tuple." +msgstr "" + +msgid "Add *items* to the selection." +msgstr "" + +msgid "Remove *items* from the selection." +msgstr "" + +msgid "Toggle the selection state of each item in *items*." +msgstr "" + +msgid "" +"With one argument, returns a dictionary of column/value pairs for the " +"specified *item*. With two arguments, returns the current value of the " +"specified *column*. With three arguments, sets the value of given *column* " +"in given *item* to the specified *value*." +msgstr "" + +msgid "" +"Bind a callback for the given event *sequence* to the tag *tagname*. When an " +"event is delivered to an item, the callbacks for each of the item's tags " +"option are called." +msgstr "" + +msgid "Query or modify the options for the specified *tagname*." +msgstr "" + +msgid "" +"If *kw* is not given, returns a dict of the option settings for *tagname*. " +"If *option* is specified, returns the value for that *option* for the " +"specified *tagname*. Otherwise, sets the options to the corresponding values " +"for the given *tagname*." +msgstr "" + +msgid "" +"If *item* is specified, returns 1 or 0 depending on whether the specified " +"*item* has the given *tagname*. Otherwise, returns a list of all items that " +"have the specified tag." +msgstr "" + +msgid "Availability: Tk 8.6" +msgstr "" + +msgid "Query or modify horizontal position of the treeview." +msgstr "" + +msgid "Query or modify vertical position of the treeview." +msgstr "" + +msgid "Ttk Styling" +msgstr "" + +msgid "" +"Each widget in :mod:`ttk` is assigned a style, which specifies the set of " +"elements making up the widget and how they are arranged, along with dynamic " +"and default settings for element options. By default the style name is the " +"same as the widget's class name, but it may be overridden by the widget's " +"style option. If you don't know the class name of a widget, use the method :" +"meth:`Misc.winfo_class` (somewidget.winfo_class())." +msgstr "" + +msgid "" +"`Tcl'2004 conference presentation `_" +msgstr "" + +msgid "This document explains how the theme engine works" +msgstr "" + +msgid "This class is used to manipulate the style database." +msgstr "" + +msgid "Query or set the default value of the specified option(s) in *style*." +msgstr "" + +msgid "" +"Each key in *kw* is an option and each value is a string identifying the " +"value for that option." +msgstr "" + +msgid "" +"For example, to change every default button to be a flat button with some " +"padding and a different background color::" +msgstr "" + +msgid "Query or sets dynamic values of the specified option(s) in *style*." +msgstr "" + +msgid "" +"Each key in *kw* is an option and each value should be a list or a tuple " +"(usually) containing statespecs grouped in tuples, lists, or some other " +"preference. A statespec is a compound of one or more states and then a value." +msgstr "" + +msgid "An example may make it more understandable::" +msgstr "" + +msgid "" +"Note that the order of the (states, value) sequences for an option does " +"matter, if the order is changed to ``[('active', 'blue'), ('pressed', " +"'red')]`` in the foreground option, for example, the result would be a blue " +"foreground when the widget were in active or pressed states." +msgstr "" + +msgid "Returns the value specified for *option* in *style*." +msgstr "" + +msgid "" +"If *state* is specified, it is expected to be a sequence of one or more " +"states. If the *default* argument is set, it is used as a fallback value in " +"case no specification for option is found." +msgstr "" + +msgid "To check what font a Button uses by default::" +msgstr "" + +msgid "" +"Define the widget layout for given *style*. If *layoutspec* is omitted, " +"return the layout specification for given style." +msgstr "" + +msgid "" +"*layoutspec*, if specified, is expected to be a list or some other sequence " +"type (excluding strings), where each item should be a tuple and the first " +"item is the layout name and the second item should have the format described " +"in `Layouts`_." +msgstr "" + +msgid "" +"To understand the format, see the following example (it is not intended to " +"do anything useful)::" +msgstr "" + +msgid "" +"Create a new element in the current theme, of the given *etype* which is " +"expected to be either \"image\" or \"from\"." +msgstr "" + +msgid "" +"If \"image\" is used, *args* should contain the default image name followed " +"by statespec/value pairs (this is the imagespec), and *kw* may have the " +"following options:" +msgstr "" + +msgid "border=padding" +msgstr "" + +msgid "" +"padding is a list of up to four integers, specifying the left, top, right, " +"and bottom borders, respectively." +msgstr "" + +msgid "height=height" +msgstr "" + +msgid "" +"Specifies a minimum height for the element. If less than zero, the base " +"image's height is used as a default." +msgstr "" + +msgid "padding=padding" +msgstr "" + +msgid "" +"Specifies the element's interior padding. Defaults to border's value if not " +"specified." +msgstr "" + +msgid "sticky=spec" +msgstr "" + +msgid "" +"Specifies how the image is placed within the final parcel. spec contains " +"zero or more characters \"n\", \"s\", \"w\", or \"e\"." +msgstr "" + +msgid "width=width" +msgstr "" + +msgid "" +"Specifies a minimum width for the element. If less than zero, the base " +"image's width is used as a default." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +"If \"from\" is used as the value of *etype*, :meth:`element_create` will " +"clone an existing element. *args* is expected to contain a themename, from " +"which the element will be cloned, and optionally an element to clone from. " +"If this element to clone from is not specified, an empty element will be " +"used. *kw* is discarded." +msgstr "" + +msgid "Returns the list of elements defined in the current theme." +msgstr "" + +msgid "Returns the list of *elementname*'s options." +msgstr "" + +msgid "Create a new theme." +msgstr "" + +msgid "" +"It is an error if *themename* already exists. If *parent* is specified, the " +"new theme will inherit styles, elements and layouts from the parent theme. " +"If *settings* are present they are expected to have the same syntax used " +"for :meth:`theme_settings`." +msgstr "" + +msgid "" +"Temporarily sets the current theme to *themename*, apply specified " +"*settings* and then restore the previous theme." +msgstr "" + +msgid "" +"Each key in *settings* is a style and each value may contain the keys " +"'configure', 'map', 'layout' and 'element create' and they are expected to " +"have the same format as specified by the methods :meth:`Style.configure`, :" +"meth:`Style.map`, :meth:`Style.layout` and :meth:`Style.element_create` " +"respectively." +msgstr "" + +msgid "As an example, let's change the Combobox for the default theme a bit::" +msgstr "" + +msgid "Returns a list of all known themes." +msgstr "" + +msgid "" +"If *themename* is not given, returns the theme in use. Otherwise, sets the " +"current theme to *themename*, refreshes all widgets and emits a " +"<> event." +msgstr "" + +msgid "Layouts" +msgstr "" + +msgid "" +"A layout can be just ``None``, if it takes no options, or a dict of options " +"specifying how to arrange the element. The layout mechanism uses a " +"simplified version of the pack geometry manager: given an initial cavity, " +"each element is allocated a parcel." +msgstr "" + +msgid "*side*: whichside" +msgstr "" + +msgid "" +"Specifies which side of the cavity to place the element; one of top, right, " +"bottom or left. If omitted, the element occupies the entire cavity." +msgstr "" + +msgid "*sticky*: nswe" +msgstr "" + +msgid "Specifies where the element is placed inside its allocated parcel." +msgstr "" + +msgid "*unit*: 0 or 1" +msgstr "" + +msgid "" +"If set to 1, causes the element and all of its descendants to be treated as " +"a single element for the purposes of :meth:`Widget.identify` et al. It's " +"used for things like scrollbar thumbs with grips." +msgstr "" + +msgid "*children*: [sublayout... ]" +msgstr "" + +msgid "" +"Specifies a list of elements to place inside the element. Each element is a " +"tuple (or other sequence type) where the first item is the layout name, and " +"the other is a `Layout`_." +msgstr "" + +msgid "ttk" +msgstr "" diff --git a/library/tokenize.po b/library/tokenize.po index 860d883425..9ca8d9eee0 100644 --- a/library/tokenize.po +++ b/library/tokenize.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:16+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:20+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -45,6 +44,14 @@ msgid "" "from :func:`tokenize.tokenize`." msgstr "" +msgid "" +"Note that the functions in this module are only designed to parse " +"syntactically valid Python code (code that does not raise when parsed using :" +"func:`ast.parse`). The behavior of the functions in this module is " +"**undefined** when providing invalid Python code and it can change at any " +"point." +msgstr "" + msgid "Tokenizing Input" msgstr "" diff --git a/library/tomllib.po b/library/tomllib.po index 8889c4f415..ad8e82cef8 100644 --- a/library/tomllib.po +++ b/library/tomllib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2022-11-05 19:49+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,14 +99,14 @@ msgstr "" msgid "Python" msgstr "" -msgid "table" +msgid "TOML document" msgstr "" msgid "dict" msgstr "" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "str" msgstr "" @@ -159,4 +159,16 @@ msgid "array" msgstr "" msgid "list" +msgstr "lista" + +msgid "table" +msgstr "" + +msgid "inline table" +msgstr "" + +msgid "array of tables" +msgstr "" + +msgid "list of dicts" msgstr "" diff --git a/library/traceback.po b/library/traceback.po new file mode 100644 index 0000000000..aeb7c4900e --- /dev/null +++ b/library/traceback.po @@ -0,0 +1,494 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Waldemar Stoczkowski, 2023 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Waldemar Stoczkowski, 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:`traceback` --- Print or retrieve a stack traceback" +msgstr "" + +msgid "**Source code:** :source:`Lib/traceback.py`" +msgstr "" + +msgid "" +"This module provides a standard interface to extract, format and print stack " +"traces of Python programs. It exactly mimics the behavior of the Python " +"interpreter when it prints a stack trace. This is useful when you want to " +"print stack traces under program control, such as in a \"wrapper\" around " +"the interpreter." +msgstr "" + +msgid "" +"The module uses :ref:`traceback objects ` --- these are " +"objects of type :class:`types.TracebackType`, which are assigned to the :" +"attr:`~BaseException.__traceback__` field of :class:`BaseException` " +"instances." +msgstr "" + +msgid "Module :mod:`faulthandler`" +msgstr "" + +msgid "" +"Used to dump Python tracebacks explicitly, on a fault, after a timeout, or " +"on a user signal." +msgstr "" + +msgid "Module :mod:`pdb`" +msgstr "" + +msgid "Interactive source code debugger for Python programs." +msgstr "" + +msgid "The module defines the following functions:" +msgstr "" + +msgid "" +"Print up to *limit* stack trace entries from :ref:`traceback object " +"` *tb* (starting from the caller's frame) if *limit* is " +"positive. Otherwise, print the last ``abs(limit)`` entries. If *limit* is " +"omitted or ``None``, all entries are printed. If *file* is omitted or " +"``None``, the output goes to :data:`sys.stderr`; otherwise it should be an " +"open :term:`file ` or :term:`file-like object` to receive the " +"output." +msgstr "" + +msgid "Added negative *limit* support." +msgstr "" + +msgid "" +"Print exception information and stack trace entries from :ref:`traceback " +"object ` *tb* to *file*. This differs from :func:" +"`print_tb` in the following ways:" +msgstr "" + +msgid "" +"if *tb* is not ``None``, it prints a header ``Traceback (most recent call " +"last):``" +msgstr "" + +msgid "it prints the exception type and *value* after the stack trace" +msgstr "" + +msgid "" +"if *type(value)* is :exc:`SyntaxError` and *value* has the appropriate " +"format, it prints the line where the syntax error occurred with a caret " +"indicating the approximate position of the error." +msgstr "" + +msgid "" +"Since Python 3.10, instead of passing *value* and *tb*, an exception object " +"can be passed as the first argument. If *value* and *tb* are provided, the " +"first argument is ignored in order to provide backwards compatibility." +msgstr "" + +msgid "" +"The optional *limit* argument has the same meaning as for :func:`print_tb`. " +"If *chain* is true (the default), then chained exceptions (the :attr:" +"`~BaseException.__cause__` or :attr:`~BaseException.__context__` attributes " +"of the exception) will be printed as well, like the interpreter itself does " +"when printing an unhandled exception." +msgstr "" + +msgid "The *etype* argument is ignored and inferred from the type of *value*." +msgstr "" + +msgid "" +"The *etype* parameter has been renamed to *exc* and is now positional-only." +msgstr "" + +msgid "" +"This is a shorthand for ``print_exception(sys.exception(), limit, file, " +"chain)``." +msgstr "" + +msgid "" +"This is a shorthand for ``print_exception(sys.last_type, sys.last_value, sys." +"last_traceback, limit, file, chain)``. In general it will work only after " +"an exception has reached an interactive prompt (see :data:`sys.last_type`)." +msgstr "" + +msgid "" +"Print up to *limit* stack trace entries (starting from the invocation point) " +"if *limit* is positive. Otherwise, print the last ``abs(limit)`` entries. " +"If *limit* is omitted or ``None``, all entries are printed. The optional *f* " +"argument can be used to specify an alternate :ref:`stack frame ` to start. The optional *file* argument has the same meaning as " +"for :func:`print_tb`." +msgstr "" + +msgid "" +"Return a :class:`StackSummary` object representing a list of \"pre-" +"processed\" stack trace entries extracted from the :ref:`traceback object " +"` *tb*. It is useful for alternate formatting of stack " +"traces. The optional *limit* argument has the same meaning as for :func:" +"`print_tb`. A \"pre-processed\" stack trace entry is a :class:" +"`FrameSummary` object containing attributes :attr:`~FrameSummary.filename`, :" +"attr:`~FrameSummary.lineno`, :attr:`~FrameSummary.name`, and :attr:" +"`~FrameSummary.line` representing the information that is usually printed " +"for a stack trace." +msgstr "" + +msgid "" +"Extract the raw traceback from the current :ref:`stack frame `. The return value has the same format as for :func:`extract_tb`. " +"The optional *f* and *limit* arguments have the same meaning as for :func:" +"`print_stack`." +msgstr "" + +msgid "" +"Given a list of tuples or :class:`FrameSummary` objects as returned by :func:" +"`extract_tb` or :func:`extract_stack`, return a list of strings ready for " +"printing. Each string in the resulting list corresponds to the item with " +"the same index in the argument list. Each string ends in a newline; the " +"strings may contain internal newlines as well, for those items whose source " +"text line is not ``None``." +msgstr "" + +msgid "" +"Format the exception part of a traceback using an exception value such as " +"given by :data:`sys.last_value`. The return value is a list of strings, " +"each ending in a newline. The list contains the exception's message, which " +"is normally a single string; however, for :exc:`SyntaxError` exceptions, it " +"contains several lines that (when printed) display detailed information " +"about where the syntax error occurred. Following the message, the list " +"contains the exception's :attr:`notes `." +msgstr "" + +msgid "" +"Since Python 3.10, instead of passing *value*, an exception object can be " +"passed as the first argument. If *value* is provided, the first argument is " +"ignored in order to provide backwards compatibility." +msgstr "" + +msgid "" +"The returned list now includes any :attr:`notes ` " +"attached to the exception." +msgstr "" + +msgid "" +"Format a stack trace and the exception information. The arguments have the " +"same meaning as the corresponding arguments to :func:`print_exception`. The " +"return value is a list of strings, each ending in a newline and some " +"containing internal newlines. When these lines are concatenated and " +"printed, exactly the same text is printed as does :func:`print_exception`." +msgstr "" + +msgid "" +"This function's behavior and signature were modified to match :func:" +"`print_exception`." +msgstr "" + +msgid "" +"This is like ``print_exc(limit)`` but returns a string instead of printing " +"to a file." +msgstr "" + +msgid "A shorthand for ``format_list(extract_tb(tb, limit))``." +msgstr "" + +msgid "A shorthand for ``format_list(extract_stack(f, limit))``." +msgstr "" + +msgid "" +"Clears the local variables of all the stack frames in a :ref:`traceback " +"` *tb* by calling the :meth:`~frame.clear` method of " +"each :ref:`frame object `." +msgstr "" + +msgid "" +"Walk a stack following :attr:`f.f_back ` from the given frame, " +"yielding the frame and line number for each frame. If *f* is ``None``, the " +"current stack is used. This helper is used with :meth:`StackSummary.extract`." +msgstr "" + +msgid "" +"Walk a traceback following :attr:`~traceback.tb_next` yielding the frame and " +"line number for each frame. This helper is used with :meth:`StackSummary." +"extract`." +msgstr "" + +msgid "The module also defines the following classes:" +msgstr "" + +msgid ":class:`!TracebackException` Objects" +msgstr "" + +msgid "" +":class:`!TracebackException` objects are created from actual exceptions to " +"capture data for later printing in a lightweight fashion." +msgstr "" + +msgid "" +"Capture an exception for later rendering. *limit*, *lookup_lines* and " +"*capture_locals* are as for the :class:`StackSummary` class." +msgstr "" + +msgid "" +"If *compact* is true, only data that is required by :class:`!" +"TracebackException`'s :meth:`format` method is saved in the class " +"attributes. In particular, the :attr:`__context__` field is calculated only " +"if :attr:`__cause__` is ``None`` and :attr:`__suppress_context__` is false." +msgstr "" + +msgid "" +"Note that when locals are captured, they are also shown in the traceback." +msgstr "" + +msgid "" +"*max_group_width* and *max_group_depth* control the formatting of exception " +"groups (see :exc:`BaseExceptionGroup`). The depth refers to the nesting " +"level of the group, and the width refers to the size of a single exception " +"group's exceptions array. The formatted output is truncated when either " +"limit is exceeded." +msgstr "" + +msgid "Added the *compact* parameter." +msgstr "" + +msgid "Added the *max_group_width* and *max_group_depth* parameters." +msgstr "" + +msgid "" +"A :class:`!TracebackException` of the original :attr:`~BaseException." +"__cause__`." +msgstr "" + +msgid "" +"A :class:`!TracebackException` of the original :attr:`~BaseException." +"__context__`." +msgstr "" + +msgid "" +"If ``self`` represents an :exc:`ExceptionGroup`, this field holds a list of :" +"class:`!TracebackException` instances representing the nested exceptions. " +"Otherwise it is ``None``." +msgstr "" + +msgid "" +"The :attr:`~BaseException.__suppress_context__` value from the original " +"exception." +msgstr "" + +msgid "" +"The :attr:`~BaseException.__notes__` value from the original exception, or " +"``None`` if the exception does not have any notes. If it is not ``None`` is " +"it formatted in the traceback after the exception string." +msgstr "" + +msgid "A :class:`StackSummary` representing the traceback." +msgstr "" + +msgid "The class of the original traceback." +msgstr "" + +msgid "For syntax errors - the file name where the error occurred." +msgstr "" + +msgid "For syntax errors - the line number where the error occurred." +msgstr "" + +msgid "" +"For syntax errors - the end line number where the error occurred. Can be " +"``None`` if not present." +msgstr "" + +msgid "For syntax errors - the text where the error occurred." +msgstr "" + +msgid "For syntax errors - the offset into the text where the error occurred." +msgstr "" + +msgid "" +"For syntax errors - the end offset into the text where the error occurred. " +"Can be ``None`` if not present." +msgstr "" + +msgid "For syntax errors - the compiler error message." +msgstr "" + +msgid "" +"Print to *file* (default ``sys.stderr``) the exception information returned " +"by :meth:`format`." +msgstr "" + +msgid "Format the exception." +msgstr "" + +msgid "" +"If *chain* is not ``True``, :attr:`__cause__` and :attr:`__context__` will " +"not be formatted." +msgstr "" + +msgid "" +"The return value is a generator of strings, each ending in a newline and " +"some containing internal newlines. :func:`~traceback.print_exception` is a " +"wrapper around this method which just prints the lines to a file." +msgstr "" + +msgid "Format the exception part of the traceback." +msgstr "" + +msgid "The return value is a generator of strings, each ending in a newline." +msgstr "" + +msgid "" +"The generator emits the exception's message followed by its notes (if it has " +"any). The exception message is normally a single string; however, for :exc:" +"`SyntaxError` exceptions, it consists of several lines that (when printed) " +"display detailed information about where the syntax error occurred." +msgstr "" + +msgid "" +"The exception's :attr:`notes ` are now included in " +"the output." +msgstr "" + +msgid ":class:`!StackSummary` Objects" +msgstr "" + +msgid "" +":class:`!StackSummary` objects represent a call stack ready for formatting." +msgstr "" + +msgid "" +"Construct a :class:`!StackSummary` object from a frame generator (such as is " +"returned by :func:`~traceback.walk_stack` or :func:`~traceback.walk_tb`)." +msgstr "" + +msgid "" +"If *limit* is supplied, only this many frames are taken from *frame_gen*. If " +"*lookup_lines* is ``False``, the returned :class:`FrameSummary` objects will " +"not have read their lines in yet, making the cost of creating the :class:`!" +"StackSummary` cheaper (which may be valuable if it may not actually get " +"formatted). If *capture_locals* is ``True`` the local variables in each :" +"class:`!FrameSummary` are captured as object representations." +msgstr "" + +msgid "" +"Construct a :class:`!StackSummary` object from a supplied list of :class:" +"`FrameSummary` objects or old-style list of tuples. Each tuple should be a " +"4-tuple with *filename*, *lineno*, *name*, *line* as the elements." +msgstr "" + +msgid "" +"Returns a list of strings ready for printing. Each string in the resulting " +"list corresponds to a single :ref:`frame ` from the stack. " +"Each string ends in a newline; the strings may contain internal newlines as " +"well, for those items with source text lines." +msgstr "" + +msgid "" +"For long sequences of the same frame and line, the first few repetitions are " +"shown, followed by a summary line stating the exact number of further " +"repetitions." +msgstr "" + +msgid "Long sequences of repeated frames are now abbreviated." +msgstr "" + +msgid "" +"Returns a string for printing one of the :ref:`frames ` " +"involved in the stack. This method is called for each :class:`FrameSummary` " +"object to be printed by :meth:`StackSummary.format`. If it returns ``None``, " +"the frame is omitted from the output." +msgstr "" + +msgid ":class:`!FrameSummary` Objects" +msgstr "" + +msgid "" +"A :class:`!FrameSummary` object represents a single :ref:`frame ` in a :ref:`traceback `." +msgstr "" + +msgid "" +"Represents a single :ref:`frame ` in the :ref:`traceback " +"` or stack that is being formatted or printed. It may " +"optionally have a stringified version of the frame's locals included in it. " +"If *lookup_line* is ``False``, the source code is not looked up until the :" +"class:`!FrameSummary` has the :attr:`~FrameSummary.line` attribute accessed " +"(which also happens when casting it to a :class:`tuple`). :attr:" +"`~FrameSummary.line` may be directly provided, and will prevent line lookups " +"happening at all. *locals* is an optional local variable dictionary, and if " +"supplied the variable representations are stored in the summary for later " +"display." +msgstr "" + +msgid ":class:`!FrameSummary` instances have the following attributes:" +msgstr "" + +msgid "" +"The filename of the source code for this frame. Equivalent to accessing :" +"attr:`f.f_code.co_filename ` on a :ref:`frame object " +"` *f*." +msgstr "" + +msgid "The line number of the source code for this frame." +msgstr "" + +msgid "" +"Equivalent to accessing :attr:`f.f_code.co_name ` on a :" +"ref:`frame object ` *f*." +msgstr "" + +msgid "" +"A string representing the source code for this frame, with leading and " +"trailing whitespace stripped. If the source is not available, it is ``None``." +msgstr "" + +msgid "Traceback Examples" +msgstr "" + +msgid "" +"This simple example implements a basic read-eval-print loop, similar to (but " +"less useful than) the standard Python interactive interpreter loop. For a " +"more complete implementation of the interpreter loop, refer to the :mod:" +"`code` module. ::" +msgstr "" + +msgid "" +"The following example demonstrates the different ways to print and format " +"the exception and traceback:" +msgstr "" + +msgid "The output for the example would look similar to this:" +msgstr "" + +msgid "" +"The following example shows the different ways to print and format the " +"stack::" +msgstr "" + +msgid "This last example demonstrates the final few formatting functions:" +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "traceback" +msgstr "" + +msgid "^ (caret)" +msgstr "" + +msgid "marker" +msgstr "" diff --git a/library/tracemalloc.po b/library/tracemalloc.po index ec986ae613..9fdbbef8e2 100644 --- a/library/tracemalloc.po +++ b/library/tracemalloc.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:16+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -157,7 +157,7 @@ msgid "" msgstr "" msgid "API" -msgstr "" +msgstr "API" msgid "Functions" msgstr "Zadania" @@ -331,7 +331,7 @@ msgid "" msgstr "" msgid "Examples:" -msgstr "" +msgstr "Przykłady:" msgid "" "``Filter(True, subprocess.__file__)`` only includes traces of the :mod:" @@ -401,7 +401,7 @@ msgid "The :class:`Traceback` class is a sequence of :class:`Frame` instances." msgstr "" msgid "Filename (``str``)." -msgstr "" +msgstr "Filename (``str``)." msgid "Line number (``int``)." msgstr "" @@ -648,4 +648,4 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" diff --git a/library/turtle.po b/library/turtle.po new file mode 100644 index 0000000000..58801ff150 --- /dev/null +++ b/library/turtle.po @@ -0,0 +1,2462 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`turtle` --- Turtle graphics" +msgstr ":mod:`turtle` --- Grafika żółwia" + +msgid "**Source code:** :source:`Lib/turtle.py`" +msgstr "**Kod źródłowy:** :source:`Lib/turtle.py`" + +msgid "Introduction" +msgstr "Wprowadzenie" + +msgid "" +"Turtle graphics is an implementation of `the popular geometric drawing tools " +"introduced in Logo `_, " +"developed by Wally Feurzeig, Seymour Papert and Cynthia Solomon in 1967." +msgstr "" +"Grafika żółwia jest implementacją `popularnych narzędzi do rysowania " +"geometrycznego wprowadzonych w Logo `_, opracowanych przez Wally'ego Feurzeiga, " +"Seymoura Paperta i Cynthię Solomon w 1967 roku." + +msgid "" +"Turtle can draw intricate shapes using programs that repeat simple moves." +msgstr "" +"Żółw może rysować skomplikowane kształty za pomocą programów, które " +"powtarzają proste ruchy." + +msgid "" +"In Python, turtle graphics provides a representation of a physical " +"\"turtle\" (a little robot with a pen) that draws on a sheet of paper on the " +"floor." +msgstr "" +"W Pythonie grafika żółwia zawiera reprezentację fizycznego „żółwia” (małego " +"robota z piórem), który rysuje na kartce papieru na podłodze." + +msgid "" +"It's an effective and well-proven way for learners to encounter programming " +"concepts and interaction with software, as it provides instant, visible " +"feedback. It also provides convenient access to graphical output in general." +msgstr "" +"Jest to skuteczny i sprawdzony sposób na poznanie koncepcji programowania i " +"interakcji z oprogramowaniem, ponieważ zapewnia natychmiastową, widoczną " +"informację zwrotną. Zapewnia również wygodny dostęp do graficznych danych " +"wyjściowych." + +msgid "" +"Turtle drawing was originally created as an educational tool, to be used by " +"teachers in the classroom. For the programmer who needs to produce some " +"graphical output it can be a way to do that without the overhead of " +"introducing more complex or external libraries into their work." +msgstr "" +"Grafika żółwia została pierwotnie stworzona jako narzędzie edukacyjne, do " +"wykorzystania przez nauczycieli w klasach. Dla programistów, którzy muszą " +"tworzyć pewne graficzne dane wyjściowe, może to być sposób na zrobienie ich " +"bez konieczności wprowadzania bardziej złożonych lub zewnętrznych bibliotek " +"do ich pracy." + +msgid "Tutorial" +msgstr "Tutorial" + +msgid "" +"New users should start here. In this tutorial we'll explore some of the " +"basics of turtle drawing." +msgstr "" +"Nowi użytkownicy powinni zacząć tutaj. W tym tutorialu poznamy niektóre z " +"podstaw rysowania żółwi." + +msgid "Starting a turtle environment" +msgstr "Uruchamianie środowiska żółwia" + +msgid "In a Python shell, import all the objects of the ``turtle`` module::" +msgstr "W powłoce Pythona zaimportuj wszystkie obiekty z modułu ``turtle``::" + +msgid "" +"If you run into a ``No module named '_tkinter'`` error, you'll have to " +"install the :mod:`Tk interface package ` on your system." +msgstr "" +"Jeśli napotkasz błąd ``No module named '_tkinter'``, będziesz musiał " +"zainstalować :mod:`pakiet interfejsu Tk ` w swoim systemie." + +msgid "Basic drawing" +msgstr "Podstawowe rysowanie" + +msgid "Send the turtle forward 100 steps::" +msgstr "Wyślij żółwia do przodu o 100 kroków:" + +msgid "" +"You should see (most likely, in a new window on your display) a line drawn " +"by the turtle, heading East. Change the direction of the turtle, so that it " +"turns 120 degrees left (anti-clockwise)::" +msgstr "" +"Powinieneś zobaczyć (najprawdopodobniej w nowym oknie na ekranie) linię " +"narysowaną przez żółwia w kierunku wschodnim. Zmień kierunek żółwia, tak aby " +"obrócił się o 120 stopni w lewo (przeciwnie do ruchu wskazówek zegara)::" + +msgid "Let's continue by drawing a triangle::" +msgstr "Kontynuujmy, rysując trójkąt::" + +msgid "" +"Notice how the turtle, represented by an arrow, points in different " +"directions as you steer it." +msgstr "" +"Zwróć uwagę, jak żółw, reprezentowany przez strzałkę, kieruje się w różnych " +"kierunkach." + +msgid "" +"Experiment with those commands, and also with ``backward()`` and ``right()``." +msgstr "" +"Eksperymentuj z tymi poleceniami, a także z ``backward()`` i ``right()``." + +msgid "Pen control" +msgstr "Kontrola pióra" + +msgid "" +"Try changing the color - for example, ``color('blue')`` - and width of the " +"line - for example, ``width(3)`` - and then drawing again." +msgstr "" +"Spróbuj zmienić kolor – na przykład ``color('blue')`` – i szerokość linii – " +"na przykład ``width(3)`` – a następnie narysuj ponownie." + +msgid "" +"You can also move the turtle around without drawing, by lifting up the pen: " +"``up()`` before moving. To start drawing again, use ``down()``." +msgstr "" +"Żółwia można także przesuwać bez rysowania, podnosząc pióro: ``up()`` przed " +"wykonaniem ruchu. Aby ponownie rozpocząć rysowanie, użyj ``down()``." + +msgid "The turtle's position" +msgstr "Pozycja żółwia" + +msgid "" +"Send your turtle back to its starting-point (useful if it has disappeared " +"off-screen)::" +msgstr "" +"Wyślij żółwia z powrotem do punktu początkowego (przydatne, jeśli zniknął " +"poza ekranem)::" + +msgid "" +"The home position is at the center of the turtle's screen. If you ever need " +"to know them, get the turtle's x-y co-ordinates with::" +msgstr "" +"Pozycja wyjściowa znajduje się na środku ekranu żółwia. Jeśli kiedykolwiek " +"będziesz chciał je poznać, pobierz współrzędne x-y żółwia za pomocą::" + +msgid "Home is at ``(0, 0)``." +msgstr "Pozycja wyjściowa znajduje się pod ``(0, 0)``." + +msgid "" +"And after a while, it will probably help to clear the window so we can start " +"anew::" +msgstr "" +"A po pewnym czasie prawdopodobnie przyda się wyczyścić okno, abyśmy mogli " +"zacząć od nowa::" + +msgid "Making algorithmic patterns" +msgstr "Tworzenie wzorców algorytmicznych" + +msgid "Using loops, it's possible to build up geometric patterns::" +msgstr "Za pomocą pętli można tworzyć geometryczne wzory::" + +msgid "\\ - which of course, are limited only by the imagination!" +msgstr "– które oczywiście ogranicza tylko wyobraźnia!" + +msgid "" +"Let's draw the star shape at the top of this page. We want red lines, filled " +"in with yellow::" +msgstr "" +"Narysujmy kształt gwiazdy z góry tej strony. Potrzebujemy czerwonych linii, " +"wypełnionych kolorem żółtym::" + +msgid "" +"Just as ``up()`` and ``down()`` determine whether lines will be drawn, " +"filling can be turned on and off::" +msgstr "" +"Podobnie jak ``up()`` i ``down()`` określają, czy linie będą rysowane, " +"wypełnianie można włączać i wyłączać::" + +msgid "Next we'll create a loop::" +msgstr "Następnie utworzymy pętlę::" + +msgid "" +"``abs(pos()) < 1`` is a good way to know when the turtle is back at its home " +"position." +msgstr "" +"``abs(pos()) < 1`` to dobry sposób, aby dowiedzieć się, kiedy żółw powróci " +"do pozycji wyjściowej." + +msgid "Finally, complete the filling::" +msgstr "Na koniec uzupełnij wypełnienie::" + +msgid "" +"(Note that filling only actually takes place when you give the " +"``end_fill()`` command.)" +msgstr "" +"(Należy pamiętać, że wypełnianie odbywa się tylko po wydaniu polecenia " +"``end_fill()``.)" + +msgid "How to..." +msgstr "Jak…" + +msgid "This section covers some typical turtle use-cases and approaches." +msgstr "Ta sekcja omawia niektóre typowe przypadki użycia i koncepcje." + +msgid "Get started as quickly as possible" +msgstr "Zacząć najszybciej jak to możliwe" + +msgid "" +"One of the joys of turtle graphics is the immediate, visual feedback that's " +"available from simple commands - it's an excellent way to introduce children " +"to programming ideas, with a minimum of overhead (not just children, of " +"course)." +msgstr "" +"Jedną z zalet grafiki żółwia jest natychmiastowa, wizualna informacja " +"zwrotna dostępna po wykonaniu prostych poleceń – jest to doskonały sposób na " +"wprowadzenie dzieci w idee programowania przy minimalnym nakładzie pracy " +"(oczywiście nie tylko dzieci)." + +msgid "" +"The turtle module makes this possible by exposing all its basic " +"functionality as functions, available with ``from turtle import *``. The :" +"ref:`turtle graphics tutorial ` covers this approach." +msgstr "" +"Żółw moduł umożliwia to, udostępniając wszystkie swoje podstawowe " +"funkcjonalności jako funkcje dostępne przez ``from turtle import *``. :ref:" +"`Tutorial grafiki żółwia ` wykorzystuje to podejście." + +msgid "" +"It's worth noting that many of the turtle commands also have even more terse " +"equivalents, such as ``fd()`` for :func:`forward`. These are especially " +"useful when working with learners for whom typing is not a skill." +msgstr "" +"Warto zauważyć, że wiele poleceń żółwia ma bardziej zwięzłe odpowiedniki, " +"takie jak ``fd()`` dla :func:`forward`. Są one szczególnie przydatne podczas " +"pracy z uczniami, dla których pisanie na klawiaturze jest jeszcze wyzwaniem." + +msgid "" +"You'll need to have the :mod:`Tk interface package ` installed on " +"your system for turtle graphics to work. Be warned that this is not always " +"straightforward, so check this in advance if you're planning to use turtle " +"graphics with a learner." +msgstr "" +"Aby grafika żółwia działała, w systemie musi być zainstalowany :mod:`pakiet " +"interfejsu Tk `. Ostrzegamy, że nie zawsze jest to proste, więc " +"sprawdź to z wyprzedzeniem, jeśli planujesz używać grafiki żółwia z uczniem." + +msgid "Use the ``turtle`` module namespace" +msgstr "Użyć przestrzeni nazw modułu ``turtle``" + +msgid "" +"Using ``from turtle import *`` is convenient - but be warned that it imports " +"a rather large collection of objects, and if you're doing anything but " +"turtle graphics you run the risk of a name conflict (this becomes even more " +"an issue if you're using turtle graphics in a script where other modules " +"might be imported)." +msgstr "" +"Korzystanie z ``from turtle import *`` jest wygodne – ale należy pamiętać, " +"że importuje dość dużą kolekcję obiektów, a jeśli robisz cokolwiek innego " +"niż grafika żółwia, ryzykujesz konflikt nazw (staje się to jeszcze większym " +"problemem, jeśli używasz grafiki żółwia w skrypcie, w którym mogą być " +"importowane inne moduły)." + +msgid "" +"The solution is to use ``import turtle`` - ``fd()`` becomes ``turtle.fd()``, " +"``width()`` becomes ``turtle.width()`` and so on. (If typing \"turtle\" over " +"and over again becomes tedious, use for example ``import turtle as t`` " +"instead.)" +msgstr "" +"Rozwiązaniem jest użycie ``import turtle`` – ``fd()`` staje się ``turtle." +"fd()``, ``width()`` staje się ``turtle.width()`` i tak dalej. (Jeśli " +"wpisywanie „turtle” w kółko staje się uciążliwe, użyj na przykład ``import " +"turtle as t``.)" + +msgid "Use turtle graphics in a script" +msgstr "Użyć grafiki żółwia w skrypcie" + +msgid "" +"It's recommended to use the ``turtle`` module namespace as described " +"immediately above, for example::" +msgstr "" +"Zaleca się korzystanie z przestrzeni nazw modułu ``turtle``, jak opisano " +"bezpośrednio powyżej, na przykład::" + +msgid "" +"Another step is also required though - as soon as the script ends, Python " +"will also close the turtle's window. Add::" +msgstr "" +"Wymagany jest jednak jeszcze jeden krok – gdy tylko skrypt się zakończy, " +"Python zamknie również okno żółwia. Dodaj::" + +msgid "" +"to the end of the script. The script will now wait to be dismissed and will " +"not exit until it is terminated, for example by closing the turtle graphics " +"window." +msgstr "" +"na końcu skryptu. Skrypt będzie teraz czekał na zwolnienie i nie wyjdzie, " +"dopóki nie zostanie zakończony, na przykład przez zamknięcie okna " +"graficznego żółwia." + +msgid "Use object-oriented turtle graphics" +msgstr "Użyć obiektowej grafiki żółwia" + +msgid "" +":ref:`Explanation of the object-oriented interface `" +msgstr ":ref:`Wyjaśnienie interfejsu obiektowego `" + +msgid "" +"Other than for very basic introductory purposes, or for trying things out as " +"quickly as possible, it's more usual and much more powerful to use the " +"object-oriented approach to turtle graphics. For example, this allows " +"multiple turtles on screen at once." +msgstr "" +"Poza bardzo podstawowymi celami wprowadzającymi lub do wypróbowania rzeczy " +"tak szybko, jak to możliwe, bardziej typowe i znacznie bardziej wydajne jest " +"użycie podejścia obiektowego do grafiki żółwia. Pozwala to na przykład na " +"jednoczesne wyświetlanie wielu żółwi na ekranie." + +msgid "" +"In this approach, the various turtle commands are methods of objects (mostly " +"of ``Turtle`` objects). You *can* use the object-oriented approach in the " +"shell, but it would be more typical in a Python script." +msgstr "" +"W tym podejściu różne komendy żółwia są metodami obiektów (głównie obiektów " +"``Turtle``). *Można* używać podejścia obiektowego w powłoce, ale byłoby to " +"bardziej typowe w pythonowym skrypcie." + +msgid "The example above then becomes::" +msgstr "Przykład powyżej staje się wtedy::" + +msgid "" +"Note the last line. ``t.screen`` is an instance of the :class:`Screen` that " +"a Turtle instance exists on; it's created automatically along with the " +"turtle." +msgstr "" +"Zwróć uwagę na ostatnią linię. ``t.screen`` to instancja :class:`Screen`, na " +"której istnieje instancja Turtle; jest ona tworzona automatycznie wraz z " +"żółwiem." + +msgid "The turtle's screen can be customised, for example::" +msgstr "Ekran żółwia można dostosować, na przykład::" + +msgid "Turtle graphics reference" +msgstr "Dokumentacja grafiki żółwia" + +msgid "" +"In the following documentation the argument list for functions is given. " +"Methods, of course, have the additional first argument *self* which is " +"omitted here." +msgstr "" +"W poniższej dokumentacji podano listę argumentów dla funkcji. Metody, " +"oczywiście, mają dodatkowy pierwszy argument *self*, który jest tutaj " +"pominięty." + +msgid "Turtle methods" +msgstr "Metody żółwia" + +msgid "Turtle motion" +msgstr "Ruch żółwia" + +msgid "Move and draw" +msgstr "Przesuwanie i rysowanie" + +msgid ":func:`forward` | :func:`fd`" +msgstr ":func:`forward` | :func:`fd`" + +msgid ":func:`backward` | :func:`bk` | :func:`back`" +msgstr ":func:`backward` | :func:`bk` | :func:`back`" + +msgid ":func:`right` | :func:`rt`" +msgstr ":func:`right` | :func:`rt`" + +msgid ":func:`left` | :func:`lt`" +msgstr ":func:`left` | :func:`lt`" + +msgid ":func:`goto` | :func:`setpos` | :func:`setposition`" +msgstr ":func:`goto` | :func:`setpos` | :func:`setposition`" + +msgid ":func:`setx`" +msgstr ":func:`setx`" + +msgid ":func:`sety`" +msgstr ":func:`sety`" + +msgid ":func:`setheading` | :func:`seth`" +msgstr ":func:`setheading` | :func:`seth`" + +msgid ":func:`home`" +msgstr ":func:`home`" + +msgid ":func:`circle`" +msgstr ":func:`circle`" + +msgid ":func:`dot`" +msgstr ":func:`dot`" + +msgid ":func:`stamp`" +msgstr ":func:`stamp`" + +msgid ":func:`clearstamp`" +msgstr ":func:`clearstamp`" + +msgid ":func:`clearstamps`" +msgstr ":func:`clearstamps`" + +msgid ":func:`undo`" +msgstr ":func:`undo`" + +msgid ":func:`speed`" +msgstr ":func:`speed`" + +msgid "Tell Turtle's state" +msgstr "Pobieranie stanu żółwia" + +msgid ":func:`position` | :func:`pos`" +msgstr ":func:`position` | :func:`pos`" + +msgid ":func:`towards`" +msgstr ":func:`towards`" + +msgid ":func:`xcor`" +msgstr ":func:`xcor`" + +msgid ":func:`ycor`" +msgstr ":func:`ycor`" + +msgid ":func:`heading`" +msgstr ":func:`heading`" + +msgid ":func:`distance`" +msgstr ":func:`distance`" + +msgid "Setting and measurement" +msgstr "Ustawienia i pomiary" + +msgid ":func:`degrees`" +msgstr ":func:`degrees`" + +msgid ":func:`radians`" +msgstr ":func:`radians`" + +msgid "Drawing state" +msgstr "Stan rysowania" + +msgid ":func:`pendown` | :func:`pd` | :func:`down`" +msgstr ":func:`pendown` | :func:`pd` | :func:`down`" + +msgid ":func:`penup` | :func:`pu` | :func:`up`" +msgstr ":func:`penup` | :func:`pu` | :func:`up`" + +msgid ":func:`pensize` | :func:`width`" +msgstr ":func:`pensize` | :func:`width`" + +msgid ":func:`pen`" +msgstr ":func:`pen`" + +msgid ":func:`isdown`" +msgstr ":func:`isdown`" + +msgid "Color control" +msgstr "Kontrola koloru" + +msgid ":func:`color`" +msgstr ":func:`color`" + +msgid ":func:`pencolor`" +msgstr ":func:`pencolor`" + +msgid ":func:`fillcolor`" +msgstr ":func:`fillcolor`" + +msgid "Filling" +msgstr "Wypełnienie" + +msgid ":func:`filling`" +msgstr ":func:`filling`" + +msgid ":func:`begin_fill`" +msgstr ":func:`begin_fill`" + +msgid ":func:`end_fill`" +msgstr ":func:`end_fill`" + +msgid "More drawing control" +msgstr "Więcej kontroli rysowania" + +msgid ":func:`reset`" +msgstr ":func:`reset`" + +msgid ":func:`clear`" +msgstr ":func:`clear`" + +msgid ":func:`write`" +msgstr ":func:`write`" + +msgid "Turtle state" +msgstr "Stan żółwia" + +msgid "Visibility" +msgstr "Widoczność" + +msgid ":func:`showturtle` | :func:`st`" +msgstr ":func:`showturtle` | :func:`st`" + +msgid ":func:`hideturtle` | :func:`ht`" +msgstr ":func:`hideturtle` | :func:`ht`" + +msgid ":func:`isvisible`" +msgstr ":func:`isvisible`" + +msgid "Appearance" +msgstr "Wygląd" + +msgid ":func:`shape`" +msgstr ":func:`shape`" + +msgid ":func:`resizemode`" +msgstr ":func:`resizemode`" + +msgid ":func:`shapesize` | :func:`turtlesize`" +msgstr ":func:`shapesize` | :func:`turtlesize`" + +msgid ":func:`shearfactor`" +msgstr ":func:`shearfactor`" + +msgid ":func:`settiltangle`" +msgstr ":func:`settiltangle`" + +msgid ":func:`tiltangle`" +msgstr ":func:`tiltangle`" + +msgid ":func:`tilt`" +msgstr ":func:`tilt`" + +msgid ":func:`shapetransform`" +msgstr ":func:`shapetransform`" + +msgid ":func:`get_shapepoly`" +msgstr ":func:`get_shapepoly`" + +msgid "Using events" +msgstr "Korzystanie ze zdarzeń" + +msgid ":func:`onclick`" +msgstr ":func:`onclick`" + +msgid ":func:`onrelease`" +msgstr ":func:`onrelease`" + +msgid ":func:`ondrag`" +msgstr ":func:`ondrag`" + +msgid "Special Turtle methods" +msgstr "Specjalne metody żółwi" + +msgid ":func:`begin_poly`" +msgstr ":func:`begin_poly`" + +msgid ":func:`end_poly`" +msgstr ":func:`end_poly`" + +msgid ":func:`get_poly`" +msgstr ":func:`get_poly`" + +msgid ":func:`clone`" +msgstr ":func:`clone`" + +msgid ":func:`getturtle` | :func:`getpen`" +msgstr ":func:`getturtle` | :func:`getpen`" + +msgid ":func:`getscreen`" +msgstr ":func:`getscreen`" + +msgid ":func:`setundobuffer`" +msgstr ":func:`setundobuffer`" + +msgid ":func:`undobufferentries`" +msgstr ":func:`undobufferentries`" + +msgid "Methods of TurtleScreen/Screen" +msgstr "Metody TurtleScreen/Screen" + +msgid "Window control" +msgstr "Kontrola okna" + +msgid ":func:`bgcolor`" +msgstr ":func:`bgcolor`" + +msgid ":func:`bgpic`" +msgstr ":func:`bgpic`" + +msgid ":func:`clearscreen`" +msgstr ":func:`clearscreen`" + +msgid ":func:`resetscreen`" +msgstr ":func:`resetscreen`" + +msgid ":func:`screensize`" +msgstr ":func:`screensize`" + +msgid ":func:`setworldcoordinates`" +msgstr ":func:`setworldcoordinates`" + +msgid "Animation control" +msgstr "Kontrola animacji" + +msgid ":func:`delay`" +msgstr ":func:`delay`" + +msgid ":func:`tracer`" +msgstr ":func:`tracer`" + +msgid ":func:`update`" +msgstr ":func:`update`" + +msgid "Using screen events" +msgstr "Korzystanie ze zdarzeń ekranowych" + +msgid ":func:`listen`" +msgstr ":func:`listen`" + +msgid ":func:`onkey` | :func:`onkeyrelease`" +msgstr ":func:`onkey` | :func:`onkeyrelease`" + +msgid ":func:`onkeypress`" +msgstr ":func:`onkeypress`" + +msgid ":func:`onclick` | :func:`onscreenclick`" +msgstr ":func:`onclick` | :func:`onscreenclick`" + +msgid ":func:`ontimer`" +msgstr ":func:`ontimer`" + +msgid ":func:`mainloop` | :func:`done`" +msgstr ":func:`mainloop` | :func:`done`" + +msgid "Settings and special methods" +msgstr "Ustawienia i metody specjalne" + +msgid ":func:`mode`" +msgstr ":func:`mode`" + +msgid ":func:`colormode`" +msgstr ":func:`colormode`" + +msgid ":func:`getcanvas`" +msgstr ":func:`getcanvas`" + +msgid ":func:`getshapes`" +msgstr ":func:`getshapes`" + +msgid ":func:`register_shape` | :func:`addshape`" +msgstr ":func:`register_shape` | :func:`addshape`" + +msgid ":func:`turtles`" +msgstr ":func:`turtles`" + +msgid ":func:`window_height`" +msgstr ":func:`window_height`" + +msgid ":func:`window_width`" +msgstr ":func:`window_width`" + +msgid "Input methods" +msgstr "Metody wprowadzania danych" + +msgid ":func:`textinput`" +msgstr ":func:`textinput`" + +msgid ":func:`numinput`" +msgstr ":func:`numinput`" + +msgid "Methods specific to Screen" +msgstr "Metody specyficzne dla klasy Screen" + +msgid ":func:`bye`" +msgstr ":func:`bye`" + +msgid ":func:`exitonclick`" +msgstr ":func:`exitonclick`" + +msgid ":func:`setup`" +msgstr ":func:`setup`" + +msgid ":func:`title`" +msgstr ":func:`title`" + +msgid "Methods of RawTurtle/Turtle and corresponding functions" +msgstr "Metody RawTurtle/Turtle i odpowiadające im funkcje" + +msgid "" +"Most of the examples in this section refer to a Turtle instance called " +"``turtle``." +msgstr "" +"Większość przykładów w tej sekcji odnosi się do instancji klasy Turtle o " +"nazwie ``turtle``." + +msgid "Parameters" +msgstr "parametry" + +msgid "a number (integer or float)" +msgstr "liczba (całkowita lub zmiennoprzecinkowa)" + +msgid "" +"Move the turtle forward by the specified *distance*, in the direction the " +"turtle is headed." +msgstr "" +"Przesuwa żółwia do przodu o określony *dystans*, w kierunku, w którym żółw " +"jest skierowany." + +msgid "a number" +msgstr "liczba" + +msgid "" +"Move the turtle backward by *distance*, opposite to the direction the turtle " +"is headed. Do not change the turtle's heading." +msgstr "" +"Przesuwa żółwia do tyłu o *dystans*, w kierunku przeciwnym do kierunku, w " +"którym żółw jest skierowany. Nie zmienia kierunku żółwia." + +msgid "" +"Turn turtle right by *angle* units. (Units are by default degrees, but can " +"be set via the :func:`degrees` and :func:`radians` functions.) Angle " +"orientation depends on the turtle mode, see :func:`mode`." +msgstr "" +"Obraca żółwia w prawo o jednostki *kąta*. (Jednostki to domyślnie stopnie, " +"ale można je ustawić za pomocą funkcji :func:`degrees` i :func:`radians`.) " +"Orientacja kąta zależy od trybu żółwia, patrz :func:`mode`." + +msgid "" +"Turn turtle left by *angle* units. (Units are by default degrees, but can " +"be set via the :func:`degrees` and :func:`radians` functions.) Angle " +"orientation depends on the turtle mode, see :func:`mode`." +msgstr "" +"Obraca żółwia w lewo o jednostki *kąta*. (Jednostki to domyślnie stopnie, " +"ale można je ustawić za pomocą funkcji :func:`degrees` i :func:`radians`.) " +"Orientacja kąta zależy od trybu żółwia, patrz :func:`mode`." + +msgid "a number or a pair/vector of numbers" +msgstr "liczba lub para/wektor liczb" + +msgid "a number or ``None``" +msgstr "liczba lub ``None``" + +msgid "" +"If *y* is ``None``, *x* must be a pair of coordinates or a :class:`Vec2D` (e." +"g. as returned by :func:`pos`)." +msgstr "" +"Jeśli *y* to ``None``, *x* musi być parą współrzędnych lub obiektem :class:" +"`Vec2D` (np. zwróconym przez :func:`pos`)." + +msgid "" +"Move turtle to an absolute position. If the pen is down, draw line. Do not " +"change the turtle's orientation." +msgstr "" +"Przesuwa żółwia do pozycji bezwzględnej. Jeśli pióro jest opuszczone, rysuje " +"linię. Nie zmienia orientacji żółwia." + +msgid "" +"Set the turtle's first coordinate to *x*, leave second coordinate unchanged." +msgstr "" +"Ustawia pierwszą współrzędną żółwia na *x*, drugą pozostawiając bez zmian." + +msgid "" +"Set the turtle's second coordinate to *y*, leave first coordinate unchanged." +msgstr "" +"Ustawia drugą współrzędną żółwia na *y*, pozostawiąc pierwszą współrzędną " +"bez zmian." + +msgid "" +"Set the orientation of the turtle to *to_angle*. Here are some common " +"directions in degrees:" +msgstr "" +"Ustawia orientację żółwia na *to_angle*. Oto kilka często używanych " +"kierunków w stopniach:" + +msgid "standard mode" +msgstr "tryb standardowy" + +msgid "logo mode" +msgstr "tryb logo" + +msgid "0 - east" +msgstr "0 – wschód" + +msgid "0 - north" +msgstr "0 – północ" + +msgid "90 - north" +msgstr "90 – północ" + +msgid "90 - east" +msgstr "90 – wschód" + +msgid "180 - west" +msgstr "180 – zachód" + +msgid "180 - south" +msgstr "180 – południe" + +msgid "270 - south" +msgstr "270 – południe" + +msgid "270 - west" +msgstr "270 – zachód" + +msgid "" +"Move turtle to the origin -- coordinates (0,0) -- and set its heading to its " +"start-orientation (which depends on the mode, see :func:`mode`)." +msgstr "" +"Przesuwa żółwia do punktu początkowego – współrzędne (0,0) – i ustawia jego " +"kurs na orientację początkową (która zależy od trybu, patrz :func:`mode`)." + +msgid "a number (or ``None``)" +msgstr "liczba (lub ``None``)" + +msgid "an integer (or ``None``)" +msgstr "liczba całkowita (lub ``None``)" + +msgid "" +"Draw a circle with given *radius*. The center is *radius* units left of the " +"turtle; *extent* -- an angle -- determines which part of the circle is " +"drawn. If *extent* is not given, draw the entire circle. If *extent* is " +"not a full circle, one endpoint of the arc is the current pen position. " +"Draw the arc in counterclockwise direction if *radius* is positive, " +"otherwise in clockwise direction. Finally the direction of the turtle is " +"changed by the amount of *extent*." +msgstr "" +"Rysuje okrąg o podanym *promieniu*. Środek znajduje się w odległości " +"*radius* na lewo od żółwia; *extent* – kąt – określa, która część okręgu " +"zostanie narysowana. Jeśli *extent* nie jest podany, rysowany jest cały " +"okrąg. Jeśli *extent* nie jest pełnym okręgiem, jednym z punktów końcowych " +"łuku jest bieżąca pozycja pióra. Rysuje łuk w kierunku przeciwnym do ruchu " +"wskazówek zegara, jeśli *radius* jest dodatni, w przeciwnym razie w kierunku " +"zgodnym z ruchem wskazówek zegara. Kierunek żółwia jest zmieniany o wartość " +"*extent*." + +msgid "" +"As the circle is approximated by an inscribed regular polygon, *steps* " +"determines the number of steps to use. If not given, it will be calculated " +"automatically. May be used to draw regular polygons." +msgstr "" +"Ponieważ okrąg jest przybliżany przez wpisany wielokąt foremny, *steps* " +"określa liczbę kroków do użycia. Jeśli nie zostanie podana, zostanie " +"obliczona automatycznie. Może być używana do rysowania wielokątów foremnych." + +msgid "an integer >= 1 (if given)" +msgstr "liczba całkowita >= 1 (jeśli podano)" + +msgid "a colorstring or a numeric color tuple" +msgstr "colorstring lub numeryczna krotka koloru" + +msgid "" +"Draw a circular dot with diameter *size*, using *color*. If *size* is not " +"given, the maximum of pensize+4 and 2*pensize is used." +msgstr "" +"Rysuje okrągłą kropkę o średnicy *size*, używając koloru *color*. Jeśli nie " +"podano *size*, używana jest maksymalna wartość z pensize+4 i 2*pensize." + +msgid "" +"Stamp a copy of the turtle shape onto the canvas at the current turtle " +"position. Return a stamp_id for that stamp, which can be used to delete it " +"by calling ``clearstamp(stamp_id)``." +msgstr "" +"Stempluje kopię kształtu żółwia na płótnie w bieżącej pozycji żółwia. Zwraca " +"stamp_id dla tego stempla, który może być użyty do usunięcia go przez " +"wywołanie ``clearstamp(stamp_id)``." + +msgid "an integer, must be return value of previous :func:`stamp` call" +msgstr "" +"liczba całkowita, musi być wartością zwróconą przez wywołanie poprzedniego :" +"func:`stamp`" + +msgid "Delete stamp with given *stampid*." +msgstr "Usunięcie stempla z podanym *stampid*." + +msgid "" +"Delete all or first/last *n* of turtle's stamps. If *n* is ``None``, delete " +"all stamps, if *n* > 0 delete first *n* stamps, else if *n* < 0 delete last " +"*n* stamps." +msgstr "" +"Usuwa wszystkie lub pierwsze/ostatnie *n* stempli żółwia. Jeśli *n* to " +"``None``, usuwa wszystkie stemple, jeśli *n* > 0 usuwa pierwsze *n* stempli, " +"inaczej jeśli *n* < 0 usuwa ostatnie *n* stempli." + +msgid "" +"Undo (repeatedly) the last turtle action(s). Number of available undo " +"actions is determined by the size of the undobuffer." +msgstr "" +"Cofa (wielokrotnie) ostatnią akcję (akcje) żółwia. Liczba dostępnych cofnięć " +"zależy od rozmiaru bufora cofania." + +msgid "an integer in the range 0..10 or a speedstring (see below)" +msgstr "liczba całkowita w zakresie 0..10 lub nazwa prędkości (patrz poniżej)" + +msgid "" +"Set the turtle's speed to an integer value in the range 0..10. If no " +"argument is given, return current speed." +msgstr "" +"Ustawia prędkość żółwia na wartość liczby całkowitej w zakresie 0..10. Jeśli " +"nie podano argumentu, zwraca aktualną prędkość." + +msgid "" +"If input is a number greater than 10 or smaller than 0.5, speed is set to " +"0. Speedstrings are mapped to speedvalues as follows:" +msgstr "" +"Jeśli wartość wejściowa jest większa niż 10 lub mniejsza niż 0,5, prędkość " +"jest ustawiana na 0. Nazwy prędkości są mapowane na wartości prędkości w " +"następujący sposób:" + +msgid "\"fastest\": 0" +msgstr "\"fastest\": 0" + +msgid "\"fast\": 10" +msgstr "\"fast\": 10" + +msgid "\"normal\": 6" +msgstr "\"normal\": 6" + +msgid "\"slow\": 3" +msgstr "\"slow\": 3" + +msgid "\"slowest\": 1" +msgstr "\"slowest\": 1" + +msgid "" +"Speeds from 1 to 10 enforce increasingly faster animation of line drawing " +"and turtle turning." +msgstr "" +"Prędkości od 1 do 10 wymuszają coraz szybszą animację rysowania linii i " +"obracania żółwia." + +msgid "" +"Attention: *speed* = 0 means that *no* animation takes place. forward/back " +"makes turtle jump and likewise left/right make the turtle turn instantly." +msgstr "" +"Uwaga: *speed* = 0 oznacza, że *żadna* animacja nie ma miejsca. forward/back " +"sprawia, że żółw skacze i podobnie left/right sprawia, że żółw natychmiast " +"się obraca." + +msgid "" +"Return the turtle's current location (x,y) (as a :class:`Vec2D` vector)." +msgstr "Zwraca bieżącą lokalizację żółwia (x,y) (jako wektor :class:`Vec2D`)." + +msgid "a number or a pair/vector of numbers or a turtle instance" +msgstr "liczba lub para/wektor liczb lub instancja żółwia" + +msgid "a number if *x* is a number, else ``None``" +msgstr "liczba, jeśli *x* jest liczbą, w przeciwnym razie ``None``" + +msgid "" +"Return the angle between the line from turtle position to position specified " +"by (x,y), the vector or the other turtle. This depends on the turtle's " +"start orientation which depends on the mode - \"standard\"/\"world\" or " +"\"logo\"." +msgstr "" +"Zwraca kąt między linią od pozycji żółwia do pozycji określonej przez (x,y), " +"wektor lub drugiego żółwia. Zależy to od orientacji początkowej żółwia, " +"która zależy od trybu – „standard”/„world” lub „logo”." + +msgid "Return the turtle's x coordinate." +msgstr "Zwraca współrzędną x żółwia." + +msgid "Return the turtle's y coordinate." +msgstr "Zwraca współrzędną y żółwia." + +msgid "" +"Return the turtle's current heading (value depends on the turtle mode, see :" +"func:`mode`)." +msgstr "" +"Zwraca aktualny kierunek żółwia (wartość zależy od trybu żółwia, patrz :func:" +"`mode`)." + +msgid "" +"Return the distance from the turtle to (x,y), the given vector, or the given " +"other turtle, in turtle step units." +msgstr "" +"Zwraca odległość od żółwia do (x,y), podanego wektora lub podanego innego " +"żółwia, w jednostkach kroku żółwia." + +msgid "Settings for measurement" +msgstr "Ustawienia pomiarowe" + +msgid "" +"Set angle measurement units, i.e. set number of \"degrees\" for a full " +"circle. Default value is 360 degrees." +msgstr "" +"Ustawia jednostki pomiaru kąta, tj. liczbę „stopni” dla pełnego okręgu. " +"Domyślna wartość to 360 stopni." + +msgid "" +"Set the angle measurement units to radians. Equivalent to ``degrees(2*math." +"pi)``." +msgstr "" +"Ustawia jednostki miary kąta na radiany. Odpowiednik ``degrees(2*math.pi)``." + +msgid "Pull the pen down -- drawing when moving." +msgstr "Opuszcza pióro w dół – rysowanie podczas ruchu." + +msgid "Pull the pen up -- no drawing when moving." +msgstr "Podnosi pióro do góry – nierysowanie podczas ruchu." + +msgid "a positive number" +msgstr "liczba dodatnia" + +msgid "" +"Set the line thickness to *width* or return it. If resizemode is set to " +"\"auto\" and turtleshape is a polygon, that polygon is drawn with the same " +"line thickness. If no argument is given, the current pensize is returned." +msgstr "" +"Ustawia grubość linii na *width* lub zwraca ją. Jeśli resizemode jest " +"ustawiony na „auto”, a turtleshape jest wielokątem, wielokąt ten jest " +"rysowany z taką samą grubością linii. Jeśli nie podano argumentu, zwracany " +"jest bieżący rozmiar pióra." + +msgid "a dictionary with some or all of the below listed keys" +msgstr "słownik z niektórymi lub wszystkimi z poniższych kluczy" + +msgid "one or more keyword-arguments with the below listed keys as keywords" +msgstr "" +"jedno lub więcej argumentów nazwanych z poniższymi kluczami jako nazwami" + +msgid "" +"Return or set the pen's attributes in a \"pen-dictionary\" with the " +"following key/value pairs:" +msgstr "" +"Zwraca lub ustawia atrybuty pióra w „pióro-słowniku” z następującymi parami " +"klucz/wartość:" + +msgid "\"shown\": True/False" +msgstr "„shown”: True/False" + +msgid "\"pendown\": True/False" +msgstr "„pendown”: True/False" + +msgid "\"pencolor\": color-string or color-tuple" +msgstr "„pencolor”: nazwa koloru (color-string) lub kolor-krotka" + +msgid "\"fillcolor\": color-string or color-tuple" +msgstr "„fillcolor”: nazwa koloru (color-string) lub kolor-krotka" + +msgid "\"pensize\": positive number" +msgstr "„pensize”: liczba dodatnia" + +msgid "\"speed\": number in range 0..10" +msgstr "„speed”: liczba z przedziału 0..10" + +msgid "\"resizemode\": \"auto\" or \"user\" or \"noresize\"" +msgstr "„resizemode”: „auto” lub „user” lub „noresize”" + +msgid "\"stretchfactor\": (positive number, positive number)" +msgstr "„stretchfactor”: (liczba dodatnia, liczba dodatnia)" + +msgid "\"outline\": positive number" +msgstr "„outline”: liczba dodatnia" + +msgid "\"tilt\": number" +msgstr "„tilt”: liczba" + +msgid "" +"This dictionary can be used as argument for a subsequent call to :func:`pen` " +"to restore the former pen-state. Moreover one or more of these attributes " +"can be provided as keyword-arguments. This can be used to set several pen " +"attributes in one statement." +msgstr "" +"Ten słownik może być użyty jako argument dla kolejnego wywołania :func:`pen` " +"w celu przywrócenia poprzedniego stanu pióra. Co więcej, jeden lub więcej z " +"tych atrybutów może być przekazany jako argument nazwany. Można to " +"wykorzystać do ustawienia kilku atrybutów pióra w jednej instrukcji." + +msgid "Return ``True`` if pen is down, ``False`` if it's up." +msgstr "" +"Zwraca ``True`` jeśli pióro jest opuszczone, ``False`` jeśli jest " +"podniesione." + +msgid "Return or set the pencolor." +msgstr "Zwraca lub ustawia kolor pióra." + +msgid "Four input formats are allowed:" +msgstr "Dozwolone są cztery formaty wejściowe:" + +msgid "``pencolor()``" +msgstr "``pencolor()``" + +msgid "" +"Return the current pencolor as color specification string or as a tuple (see " +"example). May be used as input to another color/pencolor/fillcolor call." +msgstr "" +"Zwraca bieżący kolor pióra jako ciąg specyfikacji koloru lub jako krotkę " +"(patrz przykład). Może być użyty jako dane wejściowe do innego wywołania " +"color/pencolor/fillcolor." + +msgid "``pencolor(colorstring)``" +msgstr "``pencolor(colorstring)``" + +msgid "" +"Set pencolor to *colorstring*, which is a Tk color specification string, " +"such as ``\"red\"``, ``\"yellow\"``, or ``\"#33cc8c\"``." +msgstr "" +"Ustawia kolor pióra na *colorstring*, który jest ciągiem specyfikacji koloru " +"Tk, takim jak ``\"red\"``, ``\"yellow\"``, lub ``\"#33cc8c\"``." + +msgid "``pencolor((r, g, b))``" +msgstr "``pencolor((r, g, b))``" + +msgid "" +"Set pencolor to the RGB color represented by the tuple of *r*, *g*, and " +"*b*. Each of *r*, *g*, and *b* must be in the range 0..colormode, where " +"colormode is either 1.0 or 255 (see :func:`colormode`)." +msgstr "" +"Ustawia kolor pióra na kolor RGB reprezentowany przez krotkę *r*, *g* i *b*. " +"Każda z *r*, *g* i *b* musi należeć do zakresu 0..colormode, gdzie colormode " +"to 1.0 lub 255 (patrz :func:`colormode`)." + +msgid "``pencolor(r, g, b)``" +msgstr "``pencolor(r, g, b)``" + +msgid "" +"Set pencolor to the RGB color represented by *r*, *g*, and *b*. Each of " +"*r*, *g*, and *b* must be in the range 0..colormode." +msgstr "" +"Ustawia kolor pióra na kolor RGB reprezentowany przez *r*, *g* i *b*. Każda " +"z *r*, *g* i *b* musi należeć do zakresu 0..colormode." + +msgid "" +"If turtleshape is a polygon, the outline of that polygon is drawn with the " +"newly set pencolor." +msgstr "" +"Jeśli turtleshape jest wielokątem, kontur tego wielokąta jest rysowany przy " +"użyciu nowo ustawionego koloru pióra." + +msgid "Return or set the fillcolor." +msgstr "Zwraca lub ustawia kolor wypełnienia." + +msgid "``fillcolor()``" +msgstr "``fillcolor()``" + +msgid "" +"Return the current fillcolor as color specification string, possibly in " +"tuple format (see example). May be used as input to another color/pencolor/" +"fillcolor call." +msgstr "" +"Zwraca bieżący kolor wypełnienia jako ciąg specyfikacji koloru, ewentualnie " +"w formacie krotki (patrz przykład). Może być użyty jako dane wejściowe do " +"innego wywołania color/pencolor/fillcolor." + +msgid "``fillcolor(colorstring)``" +msgstr "``fillcolor(colorstring)``" + +msgid "" +"Set fillcolor to *colorstring*, which is a Tk color specification string, " +"such as ``\"red\"``, ``\"yellow\"``, or ``\"#33cc8c\"``." +msgstr "" +"Ustawia kolor wypełnienia na *colorstring*, który jest ciągiem specyfikacji " +"koloru Tk, takim jak ``\"red\"``, ``\"yellow\"``, lub ``\"#33cc8c\"``." + +msgid "``fillcolor((r, g, b))``" +msgstr "``fillcolor((r, g, b))``" + +msgid "" +"Set fillcolor to the RGB color represented by the tuple of *r*, *g*, and " +"*b*. Each of *r*, *g*, and *b* must be in the range 0..colormode, where " +"colormode is either 1.0 or 255 (see :func:`colormode`)." +msgstr "" +"Ustawia kolor wypełnienia na kolor RGB reprezentowany przez krotkę *r*, *g* " +"i *b*. Każdy z *r*, *g* i *b* musi należeć do zakresu 0..colormode, gdzie " +"colormode to 1.0 lub 255 (patrz :func:`colormode`)." + +msgid "``fillcolor(r, g, b)``" +msgstr "``fillcolor(r, g, b)``" + +msgid "" +"Set fillcolor to the RGB color represented by *r*, *g*, and *b*. Each of " +"*r*, *g*, and *b* must be in the range 0..colormode." +msgstr "" +"Ustawia kolor wypełnienia na kolor RGB reprezentowany przez *r*, *g* i *b*. " +"Każde z *r*, *g* i *b* musi należeć do zakresu 0..colormode." + +msgid "" +"If turtleshape is a polygon, the interior of that polygon is drawn with the " +"newly set fillcolor." +msgstr "" +"Jeśli turtleshape jest wielokątem, wnętrze tego wielokąta jest rysowane z " +"nowo ustawionym kolorem wypełnienia." + +msgid "Return or set pencolor and fillcolor." +msgstr "Zwraca lub ustawia kolor pióra i wypełnienia." + +msgid "" +"Several input formats are allowed. They use 0 to 3 arguments as follows:" +msgstr "" +"Dozwolonych jest kilka formatów wejściowych. Używają one od 0 do 3 " +"argumentów w następujący sposób:" + +msgid "``color()``" +msgstr "``color()``" + +msgid "" +"Return the current pencolor and the current fillcolor as a pair of color " +"specification strings or tuples as returned by :func:`pencolor` and :func:" +"`fillcolor`." +msgstr "" +"Zwraca bieżący kolor pióra i bieżący kolor wypełnienia jako parę ciągów " +"specyfikacji kolorów lub krotek zwracanych przez :func:`pencolor` i :func:" +"`fillcolor`." + +msgid "``color(colorstring)``, ``color((r,g,b))``, ``color(r,g,b)``" +msgstr "``color(colorstring)``, ``color((r,g,b))``, ``color(r,g,b)``" + +msgid "" +"Inputs as in :func:`pencolor`, set both, fillcolor and pencolor, to the " +"given value." +msgstr "" +"Dane wejściowe jak w :func:`pencolor`, ustawiają zarówno kolor wypełnienia, " +"jak i kolor pióra na podaną wartość." + +msgid "" +"``color(colorstring1, colorstring2)``, ``color((r1,g1,b1), (r2,g2,b2))``" +msgstr "" +"``color(colorstring1, colorstring2)``, ``color((r1,g1,b1), (r2,g2,b2))``" + +msgid "" +"Equivalent to ``pencolor(colorstring1)`` and ``fillcolor(colorstring2)`` and " +"analogously if the other input format is used." +msgstr "" +"Odpowiednik dla ``pencolor(colorstring1)`` i ``fillcolor(colorstring2)`` " +"oraz analogicznie, jeśli używany jest inny format wejścia." + +msgid "" +"If turtleshape is a polygon, outline and interior of that polygon is drawn " +"with the newly set colors." +msgstr "" +"Jeśli turtleshape jest wielokątem, kontur i wnętrze tego wielokąta są " +"rysowane z nowo ustawionymi kolorami." + +msgid "See also: Screen method :func:`colormode`." +msgstr "Zobacz także: Metoda klasy Screen :func:`colormode`." + +msgid "Return fillstate (``True`` if filling, ``False`` else)." +msgstr "" +"Zwraca fillstate (``True`` jeśli wypełnienie, ``False`` w przeciwnym razie)." + +msgid "To be called just before drawing a shape to be filled." +msgstr "Do wywołania tuż przed rysowaniem kształtu do wypełnienia." + +msgid "Fill the shape drawn after the last call to :func:`begin_fill`." +msgstr "Wypełnia kształt narysowany po ostatnim wywołaniu :func:`begin_fill`." + +msgid "" +"Whether or not overlap regions for self-intersecting polygons or multiple " +"shapes are filled depends on the operating system graphics, type of overlap, " +"and number of overlaps. For example, the Turtle star above may be either " +"all yellow or have some white regions." +msgstr "" +"To, czy obszary nakładania się przecinających się wielokątów lub wielu " +"kształtów są wypełnione, zależy od grafiki systemu operacyjnego, typu " +"nakładania się i liczby nakładających się obszarów. Na przykład żółwiowa " +"gwiazda na górze rozdziału może być cała żółta lub mieć kilka białych " +"obszarów." + +msgid "" +"Delete the turtle's drawings from the screen, re-center the turtle and set " +"variables to the default values." +msgstr "" +"Usuń rysunki żółwia z ekranu, ponownie wyśrodkuj żółwia i ustaw zmienne na " +"wartości domyślne." + +msgid "" +"Delete the turtle's drawings from the screen. Do not move turtle. State " +"and position of the turtle as well as drawings of other turtles are not " +"affected." +msgstr "" +"Usuwa rysunki żółwia z ekranu. Nie rusza żółwia. Stan i pozycja żółwia, a " +"także rysunki innych żółwi, nie zostaną zmienione." + +msgid "object to be written to the TurtleScreen" +msgstr "obiekt, który ma zostać zapisany na TurtleScreen" + +msgid "True/False" +msgstr "True/False" + +msgid "one of the strings \"left\", \"center\" or right\"" +msgstr "jedna z wartości „left”, „center” lub „right”" + +msgid "a triple (fontname, fontsize, fonttype)" +msgstr "trójka wartości (fontname, fontsize, fonttype)" + +msgid "" +"Write text - the string representation of *arg* - at the current turtle " +"position according to *align* (\"left\", \"center\" or \"right\") and with " +"the given font. If *move* is true, the pen is moved to the bottom-right " +"corner of the text. By default, *move* is ``False``." +msgstr "" +"Pisze tekst – reprezentację obiektu *arg* – w bieżącej pozycji żółwia " +"zgodnie z *align* (\"left\", \"center\" lub \"right\") i z podaną czcionką. " +"Jeśli *move* to ``True``, pióro jest przesuwane do prawego dolnego rogu " +"tekstu. Domyślnie *move* ma wartość ``False``." + +msgid "" +"Make the turtle invisible. It's a good idea to do this while you're in the " +"middle of doing some complex drawing, because hiding the turtle speeds up " +"the drawing observably." +msgstr "" +"Czyni żółwia niewidocznym. Dobrym pomysłem jest zrobienie tego w trakcie " +"wykonywania złożonego rysunku, ponieważ ukrycie żółwia znacznie przyspiesza " +"rysowanie." + +msgid "Make the turtle visible." +msgstr "Sprawia, że żółw jest widoczny." + +msgid "Return ``True`` if the Turtle is shown, ``False`` if it's hidden." +msgstr "Zwraca ``True`` jeśli żółw jest widoczny, ``False`` jeśli jest ukryty." + +msgid "a string which is a valid shapename" +msgstr "ciąg znaków, który jest prawidłową nazwą kształtu" + +msgid "" +"Set turtle shape to shape with given *name* or, if name is not given, return " +"name of current shape. Shape with *name* must exist in the TurtleScreen's " +"shape dictionary. Initially there are the following polygon shapes: " +"\"arrow\", \"turtle\", \"circle\", \"square\", \"triangle\", \"classic\". " +"To learn about how to deal with shapes see Screen method :func:" +"`register_shape`." +msgstr "" +"Ustawia kształt żółwia na kształt o podanej nazwie *name* lub, jeśli nazwa " +"nie została podana, zwraca nazwę bieżącego kształtu. Kształt o nazwie *name* " +"musi istnieć w słowniku kształtów TurtleScreen. Początkowo dostępne są " +"następujące kształty wielokątów: \"arrow\", \"turtle\", \"circle\", " +"\"square\", \"triangle\", \"classic\". Aby dowiedzieć się, jak radzić sobie " +"z kształtami, zobacz metodę Screen :func:`register_shape`." + +msgid "one of the strings \"auto\", \"user\", \"noresize\"" +msgstr "jeden z ciągów znaków „auto”, „user”, „noresize”" + +msgid "" +"Set resizemode to one of the values: \"auto\", \"user\", \"noresize\". If " +"*rmode* is not given, return current resizemode. Different resizemodes have " +"the following effects:" +msgstr "" +"Ustawia tryb zmiany rozmiaru na jedną z wartości: „auto”, „user”, " +"„noresize”. Jeśli nie podano *rmode*, zwraca bieżący tryb zmiany rozmiaru. " +"Różne tryby zmiany rozmiaru mają następujące skutki:" + +msgid "" +"\"auto\": adapts the appearance of the turtle corresponding to the value of " +"pensize." +msgstr "\"auto\": dostosowuje wygląd żółwia do wartości rozmiaru pióra." + +msgid "" +"\"user\": adapts the appearance of the turtle according to the values of " +"stretchfactor and outlinewidth (outline), which are set by :func:`shapesize`." +msgstr "" + +msgid "\"noresize\": no adaption of the turtle's appearance takes place." +msgstr "" + +msgid "" +"``resizemode(\"user\")`` is called by :func:`shapesize` when used with " +"arguments." +msgstr "" + +msgid "positive number" +msgstr "" + +msgid "" +"Return or set the pen's attributes x/y-stretchfactors and/or outline. Set " +"resizemode to \"user\". If and only if resizemode is set to \"user\", the " +"turtle will be displayed stretched according to its stretchfactors: " +"*stretch_wid* is stretchfactor perpendicular to its orientation, " +"*stretch_len* is stretchfactor in direction of its orientation, *outline* " +"determines the width of the shape's outline." +msgstr "" + +msgid "number (optional)" +msgstr "" + +msgid "" +"Set or return the current shearfactor. Shear the turtleshape according to " +"the given shearfactor shear, which is the tangent of the shear angle. Do " +"*not* change the turtle's heading (direction of movement). If shear is not " +"given: return the current shearfactor, i. e. the tangent of the shear angle, " +"by which lines parallel to the heading of the turtle are sheared." +msgstr "" + +msgid "" +"Rotate the turtleshape by *angle* from its current tilt-angle, but do *not* " +"change the turtle's heading (direction of movement)." +msgstr "" + +msgid "" +"Rotate the turtleshape to point in the direction specified by *angle*, " +"regardless of its current tilt-angle. *Do not* change the turtle's heading " +"(direction of movement)." +msgstr "" + +msgid "a number (optional)" +msgstr "" + +msgid "" +"Set or return the current tilt-angle. If angle is given, rotate the " +"turtleshape to point in the direction specified by angle, regardless of its " +"current tilt-angle. Do *not* change the turtle's heading (direction of " +"movement). If angle is not given: return the current tilt-angle, i. e. the " +"angle between the orientation of the turtleshape and the heading of the " +"turtle (its direction of movement)." +msgstr "" + +msgid "Set or return the current transformation matrix of the turtle shape." +msgstr "" + +msgid "" +"If none of the matrix elements are given, return the transformation matrix " +"as a tuple of 4 elements. Otherwise set the given elements and transform the " +"turtleshape according to the matrix consisting of first row t11, t12 and " +"second row t21, t22. The determinant t11 * t22 - t12 * t21 must not be zero, " +"otherwise an error is raised. Modify stretchfactor, shearfactor and " +"tiltangle according to the given matrix." +msgstr "" + +msgid "" +"Return the current shape polygon as tuple of coordinate pairs. This can be " +"used to define a new shape or components of a compound shape." +msgstr "" + +msgid "" +"a function with two arguments which will be called with the coordinates of " +"the clicked point on the canvas" +msgstr "" + +msgid "number of the mouse-button, defaults to 1 (left mouse button)" +msgstr "" + +msgid "" +"``True`` or ``False`` -- if ``True``, a new binding will be added, otherwise " +"it will replace a former binding" +msgstr "" + +msgid "" +"Bind *fun* to mouse-click events on this turtle. If *fun* is ``None``, " +"existing bindings are removed. Example for the anonymous turtle, i.e. the " +"procedural way:" +msgstr "" + +msgid "" +"Bind *fun* to mouse-button-release events on this turtle. If *fun* is " +"``None``, existing bindings are removed." +msgstr "" + +msgid "" +"Bind *fun* to mouse-move events on this turtle. If *fun* is ``None``, " +"existing bindings are removed." +msgstr "" + +msgid "" +"Remark: Every sequence of mouse-move-events on a turtle is preceded by a " +"mouse-click event on that turtle." +msgstr "" + +msgid "" +"Subsequently, clicking and dragging the Turtle will move it across the " +"screen thereby producing handdrawings (if pen is down)." +msgstr "" + +msgid "" +"Start recording the vertices of a polygon. Current turtle position is first " +"vertex of polygon." +msgstr "" + +msgid "" +"Stop recording the vertices of a polygon. Current turtle position is last " +"vertex of polygon. This will be connected with the first vertex." +msgstr "" + +msgid "Return the last recorded polygon." +msgstr "" + +msgid "" +"Create and return a clone of the turtle with same position, heading and " +"turtle properties." +msgstr "" + +msgid "" +"Return the Turtle object itself. Only reasonable use: as a function to " +"return the \"anonymous turtle\":" +msgstr "" + +msgid "" +"Return the :class:`TurtleScreen` object the turtle is drawing on. " +"TurtleScreen methods can then be called for that object." +msgstr "" + +msgid "an integer or ``None``" +msgstr "" + +msgid "" +"Set or disable undobuffer. If *size* is an integer, an empty undobuffer of " +"given size is installed. *size* gives the maximum number of turtle actions " +"that can be undone by the :func:`undo` method/function. If *size* is " +"``None``, the undobuffer is disabled." +msgstr "" + +msgid "Return number of entries in the undobuffer." +msgstr "" + +msgid "Compound shapes" +msgstr "" + +msgid "" +"To use compound turtle shapes, which consist of several polygons of " +"different color, you must use the helper class :class:`Shape` explicitly as " +"described below:" +msgstr "" + +msgid "Create an empty Shape object of type \"compound\"." +msgstr "" + +msgid "" +"Add as many components to this object as desired, using the :meth:`~Shape." +"addcomponent` method." +msgstr "" + +msgid "For example:" +msgstr "Na przykład::" + +msgid "Now add the Shape to the Screen's shapelist and use it:" +msgstr "" + +msgid "" +"The :class:`Shape` class is used internally by the :func:`register_shape` " +"method in different ways. The application programmer has to deal with the " +"Shape class *only* when using compound shapes like shown above!" +msgstr "" + +msgid "Methods of TurtleScreen/Screen and corresponding functions" +msgstr "" + +msgid "" +"Most of the examples in this section refer to a TurtleScreen instance called " +"``screen``." +msgstr "" + +msgid "" +"a color string or three numbers in the range 0..colormode or a 3-tuple of " +"such numbers" +msgstr "" + +msgid "Set or return background color of the TurtleScreen." +msgstr "" + +msgid "a string, name of a gif-file or ``\"nopic\"``, or ``None``" +msgstr "" + +msgid "" +"Set background image or return name of current backgroundimage. If " +"*picname* is a filename, set the corresponding image as background. If " +"*picname* is ``\"nopic\"``, delete background image, if present. If " +"*picname* is ``None``, return the filename of the current backgroundimage. ::" +msgstr "" + +msgid "" +"This TurtleScreen method is available as a global function only under the " +"name ``clearscreen``. The global function ``clear`` is a different one " +"derived from the Turtle method ``clear``." +msgstr "" + +msgid "" +"Delete all drawings and all turtles from the TurtleScreen. Reset the now " +"empty TurtleScreen to its initial state: white background, no background " +"image, no event bindings and tracing on." +msgstr "" + +msgid "" +"This TurtleScreen method is available as a global function only under the " +"name ``resetscreen``. The global function ``reset`` is another one derived " +"from the Turtle method ``reset``." +msgstr "" + +msgid "Reset all Turtles on the Screen to their initial state." +msgstr "" + +msgid "positive integer, new width of canvas in pixels" +msgstr "" + +msgid "positive integer, new height of canvas in pixels" +msgstr "" + +msgid "colorstring or color-tuple, new background color" +msgstr "" + +msgid "" +"If no arguments are given, return current (canvaswidth, canvasheight). Else " +"resize the canvas the turtles are drawing on. Do not alter the drawing " +"window. To observe hidden parts of the canvas, use the scrollbars. With " +"this method, one can make visible those parts of a drawing which were " +"outside the canvas before." +msgstr "" + +msgid "e.g. to search for an erroneously escaped turtle ;-)" +msgstr "" + +msgid "a number, x-coordinate of lower left corner of canvas" +msgstr "" + +msgid "a number, y-coordinate of lower left corner of canvas" +msgstr "" + +msgid "a number, x-coordinate of upper right corner of canvas" +msgstr "" + +msgid "a number, y-coordinate of upper right corner of canvas" +msgstr "" + +msgid "" +"Set up user-defined coordinate system and switch to mode \"world\" if " +"necessary. This performs a ``screen.reset()``. If mode \"world\" is " +"already active, all drawings are redrawn according to the new coordinates." +msgstr "" + +msgid "" +"**ATTENTION**: in user-defined coordinate systems angles may appear " +"distorted." +msgstr "" + +msgid "positive integer" +msgstr "" + +msgid "" +"Set or return the drawing *delay* in milliseconds. (This is approximately " +"the time interval between two consecutive canvas updates.) The longer the " +"drawing delay, the slower the animation." +msgstr "" + +msgid "Optional argument:" +msgstr "" + +msgid "nonnegative integer" +msgstr "" + +msgid "" +"Turn turtle animation on/off and set delay for update drawings. If *n* is " +"given, only each n-th regular screen update is really performed. (Can be " +"used to accelerate the drawing of complex graphics.) When called without " +"arguments, returns the currently stored value of n. Second argument sets " +"delay value (see :func:`delay`)." +msgstr "" + +msgid "Perform a TurtleScreen update. To be used when tracer is turned off." +msgstr "" + +msgid "See also the RawTurtle/Turtle method :func:`speed`." +msgstr "" + +msgid "" +"Set focus on TurtleScreen (in order to collect key-events). Dummy arguments " +"are provided in order to be able to pass :func:`listen` to the onclick " +"method." +msgstr "" + +msgid "a function with no arguments or ``None``" +msgstr "" + +msgid "a string: key (e.g. \"a\") or key-symbol (e.g. \"space\")" +msgstr "" + +msgid "" +"Bind *fun* to key-release event of key. If *fun* is ``None``, event " +"bindings are removed. Remark: in order to be able to register key-events, " +"TurtleScreen must have the focus. (See method :func:`listen`.)" +msgstr "" + +msgid "" +"Bind *fun* to key-press event of key if key is given, or to any key-press-" +"event if no key is given. Remark: in order to be able to register key-" +"events, TurtleScreen must have focus. (See method :func:`listen`.)" +msgstr "" + +msgid "" +"Bind *fun* to mouse-click events on this screen. If *fun* is ``None``, " +"existing bindings are removed." +msgstr "" + +msgid "" +"Example for a TurtleScreen instance named ``screen`` and a Turtle instance " +"named ``turtle``:" +msgstr "" + +msgid "" +"This TurtleScreen method is available as a global function only under the " +"name ``onscreenclick``. The global function ``onclick`` is another one " +"derived from the Turtle method ``onclick``." +msgstr "" + +msgid "a function with no arguments" +msgstr "" + +msgid "a number >= 0" +msgstr "" + +msgid "Install a timer that calls *fun* after *t* milliseconds." +msgstr "" + +msgid "" +"Starts event loop - calling Tkinter's mainloop function. Must be the last " +"statement in a turtle graphics program. Must *not* be used if a script is " +"run from within IDLE in -n mode (No subprocess) - for interactive use of " +"turtle graphics. ::" +msgstr "" + +msgid "string" +msgstr "ciąg znaków" + +msgid "" +"Pop up a dialog window for input of a string. Parameter title is the title " +"of the dialog window, prompt is a text mostly describing what information to " +"input. Return the string input. If the dialog is canceled, return " +"``None``. ::" +msgstr "" + +msgid "" +"Pop up a dialog window for input of a number. title is the title of the " +"dialog window, prompt is a text mostly describing what numerical information " +"to input. default: default value, minval: minimum value for input, maxval: " +"maximum value for input. The number input must be in the range minval .. " +"maxval if these are given. If not, a hint is issued and the dialog remains " +"open for correction. Return the number input. If the dialog is canceled, " +"return ``None``. ::" +msgstr "" + +msgid "one of the strings \"standard\", \"logo\" or \"world\"" +msgstr "" + +msgid "" +"Set turtle mode (\"standard\", \"logo\" or \"world\") and perform reset. If " +"mode is not given, current mode is returned." +msgstr "" + +msgid "" +"Mode \"standard\" is compatible with old :mod:`turtle`. Mode \"logo\" is " +"compatible with most Logo turtle graphics. Mode \"world\" uses user-defined " +"\"world coordinates\". **Attention**: in this mode angles appear distorted " +"if ``x/y`` unit-ratio doesn't equal 1." +msgstr "" + +msgid "Mode" +msgstr "" + +msgid "Initial turtle heading" +msgstr "" + +msgid "positive angles" +msgstr "" + +msgid "\"standard\"" +msgstr "" + +msgid "to the right (east)" +msgstr "" + +msgid "counterclockwise" +msgstr "" + +msgid "\"logo\"" +msgstr "" + +msgid "upward (north)" +msgstr "" + +msgid "clockwise" +msgstr "" + +msgid "one of the values 1.0 or 255" +msgstr "" + +msgid "" +"Return the colormode or set it to 1.0 or 255. Subsequently *r*, *g*, *b* " +"values of color triples have to be in the range 0..*cmode*." +msgstr "" + +msgid "" +"Return the Canvas of this TurtleScreen. Useful for insiders who know what " +"to do with a Tkinter Canvas." +msgstr "" + +msgid "Return a list of names of all currently available turtle shapes." +msgstr "" + +msgid "There are three different ways to call this function:" +msgstr "" + +msgid "" +"*name* is the name of a gif-file and *shape* is ``None``: Install the " +"corresponding image shape. ::" +msgstr "" + +msgid "" +"Image shapes *do not* rotate when turning the turtle, so they do not display " +"the heading of the turtle!" +msgstr "" + +msgid "" +"*name* is an arbitrary string and *shape* is a tuple of pairs of " +"coordinates: Install the corresponding polygon shape." +msgstr "" + +msgid "" +"*name* is an arbitrary string and *shape* is a (compound) :class:`Shape` " +"object: Install the corresponding compound shape." +msgstr "" + +msgid "" +"Add a turtle shape to TurtleScreen's shapelist. Only thusly registered " +"shapes can be used by issuing the command ``shape(shapename)``." +msgstr "" + +msgid "Return the list of turtles on the screen." +msgstr "" + +msgid "Return the height of the turtle window. ::" +msgstr "" + +msgid "Return the width of the turtle window. ::" +msgstr "" + +msgid "Methods specific to Screen, not inherited from TurtleScreen" +msgstr "" + +msgid "Shut the turtlegraphics window." +msgstr "" + +msgid "Bind ``bye()`` method to mouse clicks on the Screen." +msgstr "" + +msgid "" +"If the value \"using_IDLE\" in the configuration dictionary is ``False`` " +"(default value), also enter mainloop. Remark: If IDLE with the ``-n`` " +"switch (no subprocess) is used, this value should be set to ``True`` in :" +"file:`turtle.cfg`. In this case IDLE's own mainloop is active also for the " +"client script." +msgstr "" + +msgid "" +"Set the size and position of the main window. Default values of arguments " +"are stored in the configuration dictionary and can be changed via a :file:" +"`turtle.cfg` file." +msgstr "" + +msgid "" +"if an integer, a size in pixels, if a float, a fraction of the screen; " +"default is 50% of screen" +msgstr "" + +msgid "" +"if an integer, the height in pixels, if a float, a fraction of the screen; " +"default is 75% of screen" +msgstr "" + +msgid "" +"if positive, starting position in pixels from the left edge of the screen, " +"if negative from the right edge, if ``None``, center window horizontally" +msgstr "" + +msgid "" +"if positive, starting position in pixels from the top edge of the screen, if " +"negative from the bottom edge, if ``None``, center window vertically" +msgstr "" + +msgid "a string that is shown in the titlebar of the turtle graphics window" +msgstr "" + +msgid "Set title of turtle window to *titlestring*." +msgstr "" + +msgid "Public classes" +msgstr "" + +msgid "" +"a :class:`!tkinter.Canvas`, a :class:`ScrolledCanvas` or a :class:" +"`TurtleScreen`" +msgstr "" + +msgid "" +"Create a turtle. The turtle has all methods described above as \"methods of " +"Turtle/RawTurtle\"." +msgstr "" + +msgid "" +"Subclass of RawTurtle, has the same interface but draws on a default :class:" +"`Screen` object created automatically when needed for the first time." +msgstr "" + +msgid "a :class:`!tkinter.Canvas`" +msgstr "" + +msgid "" +"Provides screen oriented methods like :func:`bgcolor` etc. that are " +"described above." +msgstr "" + +msgid "" +"Subclass of TurtleScreen, with :ref:`four methods added `." +msgstr "" + +msgid "" +"some Tkinter widget to contain the ScrolledCanvas, i.e. a Tkinter-canvas " +"with scrollbars added" +msgstr "" + +msgid "" +"Used by class Screen, which thus automatically provides a ScrolledCanvas as " +"playground for the turtles." +msgstr "" + +msgid "one of the strings \"polygon\", \"image\", \"compound\"" +msgstr "" + +msgid "" +"Data structure modeling shapes. The pair ``(type_, data)`` must follow this " +"specification:" +msgstr "" + +msgid "*type_*" +msgstr "" + +msgid "*data*" +msgstr "" + +msgid "\"polygon\"" +msgstr "" + +msgid "a polygon-tuple, i.e. a tuple of pairs of coordinates" +msgstr "" + +msgid "\"image\"" +msgstr "" + +msgid "an image (in this form only used internally!)" +msgstr "" + +msgid "\"compound\"" +msgstr "" + +msgid "" +"``None`` (a compound shape has to be constructed using the :meth:" +"`addcomponent` method)" +msgstr "" + +msgid "a polygon, i.e. a tuple of pairs of numbers" +msgstr "" + +msgid "a color the *poly* will be filled with" +msgstr "" + +msgid "a color for the poly's outline (if given)" +msgstr "" + +msgid "Example:" +msgstr "Przykład:" + +msgid "See :ref:`compoundshapes`." +msgstr "" + +msgid "" +"A two-dimensional vector class, used as a helper class for implementing " +"turtle graphics. May be useful for turtle graphics programs too. Derived " +"from tuple, so a vector is a tuple!" +msgstr "" + +msgid "Provides (for *a*, *b* vectors, *k* number):" +msgstr "" + +msgid "``a + b`` vector addition" +msgstr "" + +msgid "``a - b`` vector subtraction" +msgstr "" + +msgid "``a * b`` inner product" +msgstr "" + +msgid "``k * a`` and ``a * k`` multiplication with scalar" +msgstr "" + +msgid "``abs(a)`` absolute value of a" +msgstr "" + +msgid "``a.rotate(angle)`` rotation" +msgstr "``a.rotate(angle)`` rotation" + +msgid "Explanation" +msgstr "Wytłumaczenie" + +msgid "" +"A turtle object draws on a screen object, and there a number of key classes " +"in the turtle object-oriented interface that can be used to create them and " +"relate them to each other." +msgstr "" + +msgid "" +"A :class:`Turtle` instance will automatically create a :class:`Screen` " +"instance if one is not already present." +msgstr "" + +msgid "" +"``Turtle`` is a subclass of :class:`RawTurtle`, which *doesn't* " +"automatically create a drawing surface - a *canvas* will need to be provided " +"or created for it. The *canvas* can be a :class:`!tkinter.Canvas`, :class:" +"`ScrolledCanvas` or :class:`TurtleScreen`." +msgstr "" + +msgid "" +":class:`TurtleScreen` is the basic drawing surface for a turtle. :class:" +"`Screen` is a subclass of ``TurtleScreen``, and includes :ref:`some " +"additional methods ` for managing its appearance (including " +"size and title) and behaviour. ``TurtleScreen``'s constructor needs a :class:" +"`!tkinter.Canvas` or a :class:`ScrolledCanvas` as an argument." +msgstr "" + +msgid "" +"The functional interface for turtle graphics uses the various methods of " +"``Turtle`` and ``TurtleScreen``/``Screen``. Behind the scenes, a screen " +"object is automatically created whenever a function derived from a " +"``Screen`` method is called. Similarly, a turtle object is automatically " +"created whenever any of the functions derived from a Turtle method is called." +msgstr "" + +msgid "" +"To use multiple turtles on a screen, the object-oriented interface must be " +"used." +msgstr "" + +msgid "Help and configuration" +msgstr "" + +msgid "How to use help" +msgstr "" + +msgid "" +"The public methods of the Screen and Turtle classes are documented " +"extensively via docstrings. So these can be used as online-help via the " +"Python help facilities:" +msgstr "" + +msgid "" +"When using IDLE, tooltips show the signatures and first lines of the " +"docstrings of typed in function-/method calls." +msgstr "" + +msgid "Calling :func:`help` on methods or functions displays the docstrings::" +msgstr "" + +msgid "" +"The docstrings of the functions which are derived from methods have a " +"modified form::" +msgstr "" + +msgid "" +"These modified docstrings are created automatically together with the " +"function definitions that are derived from the methods at import time." +msgstr "" + +msgid "Translation of docstrings into different languages" +msgstr "" + +msgid "" +"There is a utility to create a dictionary the keys of which are the method " +"names and the values of which are the docstrings of the public methods of " +"the classes Screen and Turtle." +msgstr "" + +msgid "a string, used as filename" +msgstr "" + +msgid "" +"Create and write docstring-dictionary to a Python script with the given " +"filename. This function has to be called explicitly (it is not used by the " +"turtle graphics classes). The docstring dictionary will be written to the " +"Python script :file:`{filename}.py`. It is intended to serve as a template " +"for translation of the docstrings into different languages." +msgstr "" + +msgid "" +"If you (or your students) want to use :mod:`turtle` with online help in your " +"native language, you have to translate the docstrings and save the resulting " +"file as e.g. :file:`turtle_docstringdict_german.py`." +msgstr "" + +msgid "" +"If you have an appropriate entry in your :file:`turtle.cfg` file this " +"dictionary will be read in at import time and will replace the original " +"English docstrings." +msgstr "" + +msgid "" +"At the time of this writing there are docstring dictionaries in German and " +"in Italian. (Requests please to glingl@aon.at.)" +msgstr "" + +msgid "How to configure Screen and Turtles" +msgstr "" + +msgid "" +"The built-in default configuration mimics the appearance and behaviour of " +"the old turtle module in order to retain best possible compatibility with it." +msgstr "" + +msgid "" +"If you want to use a different configuration which better reflects the " +"features of this module or which better fits to your needs, e.g. for use in " +"a classroom, you can prepare a configuration file ``turtle.cfg`` which will " +"be read at import time and modify the configuration according to its " +"settings." +msgstr "" + +msgid "" +"The built in configuration would correspond to the following ``turtle.cfg``:" +msgstr "" + +msgid "Short explanation of selected entries:" +msgstr "" + +msgid "" +"The first four lines correspond to the arguments of the :func:`Screen.setup " +"` method." +msgstr "" + +msgid "" +"Line 5 and 6 correspond to the arguments of the method :func:`Screen." +"screensize `." +msgstr "" + +msgid "" +"*shape* can be any of the built-in shapes, e.g: arrow, turtle, etc. For " +"more info try ``help(shape)``." +msgstr "" + +msgid "" +"If you want to use no fill color (i.e. make the turtle transparent), you " +"have to write ``fillcolor = \"\"`` (but all nonempty strings must not have " +"quotes in the cfg file)." +msgstr "" + +msgid "" +"If you want to reflect the turtle its state, you have to use ``resizemode = " +"auto``." +msgstr "" + +msgid "" +"If you set e.g. ``language = italian`` the docstringdict :file:" +"`turtle_docstringdict_italian.py` will be loaded at import time (if present " +"on the import path, e.g. in the same directory as :mod:`turtle`)." +msgstr "" + +msgid "" +"The entries *exampleturtle* and *examplescreen* define the names of these " +"objects as they occur in the docstrings. The transformation of method-" +"docstrings to function-docstrings will delete these names from the " +"docstrings." +msgstr "" + +msgid "" +"*using_IDLE*: Set this to ``True`` if you regularly work with IDLE and its " +"``-n`` switch (\"no subprocess\"). This will prevent :func:`exitonclick` to " +"enter the mainloop." +msgstr "" + +msgid "" +"There can be a :file:`turtle.cfg` file in the directory where :mod:`turtle` " +"is stored and an additional one in the current working directory. The " +"latter will override the settings of the first one." +msgstr "" + +msgid "" +"The :file:`Lib/turtledemo` directory contains a :file:`turtle.cfg` file. " +"You can study it as an example and see its effects when running the demos " +"(preferably not from within the demo-viewer)." +msgstr "" + +msgid ":mod:`turtledemo` --- Demo scripts" +msgstr "" + +msgid "" +"The :mod:`turtledemo` package includes a set of demo scripts. These scripts " +"can be run and viewed using the supplied demo viewer as follows::" +msgstr "" + +msgid "" +"Alternatively, you can run the demo scripts individually. For example, ::" +msgstr "" + +msgid "The :mod:`turtledemo` package directory contains:" +msgstr "" + +msgid "" +"A demo viewer :file:`__main__.py` which can be used to view the sourcecode " +"of the scripts and run them at the same time." +msgstr "" + +msgid "" +"Multiple scripts demonstrating different features of the :mod:`turtle` " +"module. Examples can be accessed via the Examples menu. They can also be " +"run standalone." +msgstr "" + +msgid "" +"A :file:`turtle.cfg` file which serves as an example of how to write and use " +"such files." +msgstr "" + +msgid "The demo scripts are:" +msgstr "" + +msgid "Name" +msgstr "Nazwa" + +msgid "Description" +msgstr "Opis" + +msgid "Features" +msgstr "" + +msgid "bytedesign" +msgstr "" + +msgid "complex classical turtle graphics pattern" +msgstr "" + +msgid ":func:`tracer`, delay, :func:`update`" +msgstr "" + +msgid "chaos" +msgstr "" + +msgid "" +"graphs Verhulst dynamics, shows that computer's computations can generate " +"results sometimes against the common sense expectations" +msgstr "" + +msgid "world coordinates" +msgstr "" + +msgid "clock" +msgstr "" + +msgid "analog clock showing time of your computer" +msgstr "" + +msgid "turtles as clock's hands, ontimer" +msgstr "" + +msgid "colormixer" +msgstr "" + +msgid "experiment with r, g, b" +msgstr "" + +msgid "forest" +msgstr "" + +msgid "3 breadth-first trees" +msgstr "" + +msgid "randomization" +msgstr "" + +msgid "fractalcurves" +msgstr "" + +msgid "Hilbert & Koch curves" +msgstr "" + +msgid "recursion" +msgstr "" + +msgid "lindenmayer" +msgstr "" + +msgid "ethnomathematics (indian kolams)" +msgstr "" + +msgid "L-System" +msgstr "" + +msgid "minimal_hanoi" +msgstr "" + +msgid "Towers of Hanoi" +msgstr "" + +msgid "Rectangular Turtles as Hanoi discs (shape, shapesize)" +msgstr "" + +msgid "nim" +msgstr "" + +msgid "" +"play the classical nim game with three heaps of sticks against the computer." +msgstr "" + +msgid "turtles as nimsticks, event driven (mouse, keyboard)" +msgstr "" + +msgid "paint" +msgstr "" + +msgid "super minimalistic drawing program" +msgstr "" + +msgid "peace" +msgstr "" + +msgid "elementary" +msgstr "" + +msgid "turtle: appearance and animation" +msgstr "" + +msgid "penrose" +msgstr "" + +msgid "aperiodic tiling with kites and darts" +msgstr "" + +msgid "planet_and_moon" +msgstr "" + +msgid "simulation of gravitational system" +msgstr "" + +msgid "compound shapes, :class:`Vec2D`" +msgstr "" + +msgid "rosette" +msgstr "" + +msgid "a pattern from the wikipedia article on turtle graphics" +msgstr "" + +msgid ":func:`clone`, :func:`undo`" +msgstr "" + +msgid "round_dance" +msgstr "" + +msgid "dancing turtles rotating pairwise in opposite direction" +msgstr "" + +msgid "compound shapes, clone shapesize, tilt, get_shapepoly, update" +msgstr "" + +msgid "sorting_animate" +msgstr "" + +msgid "visual demonstration of different sorting methods" +msgstr "" + +msgid "simple alignment, randomization" +msgstr "" + +msgid "tree" +msgstr "" + +msgid "a (graphical) breadth first tree (using generators)" +msgstr "" + +msgid "two_canvases" +msgstr "" + +msgid "simple design" +msgstr "" + +msgid "turtles on two canvases" +msgstr "" + +msgid "yinyang" +msgstr "" + +msgid "another elementary example" +msgstr "" + +msgid "Have fun!" +msgstr "" + +msgid "Changes since Python 2.6" +msgstr "" + +msgid "" +"The methods :func:`Turtle.tracer `, :func:`Turtle.window_width " +"` and :func:`Turtle.window_height ` have been " +"eliminated. Methods with these names and functionality are now available " +"only as methods of :class:`Screen`. The functions derived from these remain " +"available. (In fact already in Python 2.6 these methods were merely " +"duplications of the corresponding :class:`TurtleScreen`/:class:`Screen` " +"methods.)" +msgstr "" + +msgid "" +"The method :func:`!Turtle.fill` has been eliminated. The behaviour of :func:" +"`begin_fill` and :func:`end_fill` have changed slightly: now every filling " +"process must be completed with an ``end_fill()`` call." +msgstr "" + +msgid "" +"A method :func:`Turtle.filling ` has been added. It returns a " +"boolean value: ``True`` if a filling process is under way, ``False`` " +"otherwise. This behaviour corresponds to a ``fill()`` call without arguments " +"in Python 2.6." +msgstr "" + +msgid "Changes since Python 3.0" +msgstr "" + +msgid "" +"The :class:`Turtle` methods :func:`shearfactor`, :func:`shapetransform` and :" +"func:`get_shapepoly` have been added. Thus the full range of regular linear " +"transforms is now available for transforming turtle shapes. :func:" +"`tiltangle` has been enhanced in functionality: it now can be used to get or " +"set the tilt angle. :func:`settiltangle` has been deprecated." +msgstr "" + +msgid "" +"The :class:`Screen` method :func:`onkeypress` has been added as a complement " +"to :func:`onkey`. As the latter binds actions to the key release event, an " +"alias: :func:`onkeyrelease` was also added for it." +msgstr "" + +msgid "" +"The method :func:`Screen.mainloop ` has been added, so there is no " +"longer a need to use the standalone :func:`mainloop` function when working " +"with :class:`Screen` and :class:`Turtle` objects." +msgstr "" + +msgid "" +"Two input methods have been added: :func:`Screen.textinput ` and :" +"func:`Screen.numinput `. These pop up input dialogs and return " +"strings and numbers respectively." +msgstr "" + +msgid "" +"Two example scripts :file:`tdemo_nim.py` and :file:`tdemo_round_dance.py` " +"have been added to the :file:`Lib/turtledemo` directory." +msgstr "" diff --git a/library/types.po b/library/types.po new file mode 100644 index 0000000000..afc4a0de39 --- /dev/null +++ b/library/types.po @@ -0,0 +1,485 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`types` --- Dynamic type creation and names for built-in types" +msgstr "" + +msgid "**Source code:** :source:`Lib/types.py`" +msgstr "" + +msgid "" +"This module defines utility functions to assist in dynamic creation of new " +"types." +msgstr "" + +msgid "" +"It also defines names for some object types that are used by the standard " +"Python interpreter, but not exposed as builtins like :class:`int` or :class:" +"`str` are." +msgstr "" + +msgid "" +"Finally, it provides some additional type-related utility classes and " +"functions that are not fundamental enough to be builtins." +msgstr "" + +msgid "Dynamic Type Creation" +msgstr "" + +msgid "Creates a class object dynamically using the appropriate metaclass." +msgstr "" + +msgid "" +"The first three arguments are the components that make up a class definition " +"header: the class name, the base classes (in order), the keyword arguments " +"(such as ``metaclass``)." +msgstr "" + +msgid "" +"The *exec_body* argument is a callback that is used to populate the freshly " +"created class namespace. It should accept the class namespace as its sole " +"argument and update the namespace directly with the class contents. If no " +"callback is provided, it has the same effect as passing in ``lambda ns: " +"None``." +msgstr "" + +msgid "Calculates the appropriate metaclass and creates the class namespace." +msgstr "" + +msgid "" +"The arguments are the components that make up a class definition header: the " +"class name, the base classes (in order) and the keyword arguments (such as " +"``metaclass``)." +msgstr "" + +msgid "The return value is a 3-tuple: ``metaclass, namespace, kwds``" +msgstr "" + +msgid "" +"*metaclass* is the appropriate metaclass, *namespace* is the prepared class " +"namespace and *kwds* is an updated copy of the passed in *kwds* argument " +"with any ``'metaclass'`` entry removed. If no *kwds* argument is passed in, " +"this will be an empty dict." +msgstr "" + +msgid "" +"The default value for the ``namespace`` element of the returned tuple has " +"changed. Now an insertion-order-preserving mapping is used when the " +"metaclass does not have a ``__prepare__`` method." +msgstr "" + +msgid ":ref:`metaclasses`" +msgstr ":ref:`metaclasses`" + +msgid "Full details of the class creation process supported by these functions" +msgstr "" + +msgid ":pep:`3115` - Metaclasses in Python 3000" +msgstr "" + +msgid "Introduced the ``__prepare__`` namespace hook" +msgstr "" + +msgid "Resolve MRO entries dynamically as specified by :pep:`560`." +msgstr "" + +msgid "" +"This function looks for items in *bases* that are not instances of :class:" +"`type`, and returns a tuple where each such object that has an :meth:" +"`~object.__mro_entries__` method is replaced with an unpacked result of " +"calling this method. If a *bases* item is an instance of :class:`type`, or " +"it doesn't have an :meth:`!__mro_entries__` method, then it is included in " +"the return tuple unchanged." +msgstr "" + +msgid ":pep:`560` - Core support for typing module and generic types" +msgstr "" + +msgid "Standard Interpreter Types" +msgstr "" + +msgid "" +"This module provides names for many of the types that are required to " +"implement a Python interpreter. It deliberately avoids including some of the " +"types that arise only incidentally during processing such as the " +"``listiterator`` type." +msgstr "" + +msgid "" +"Typical use of these names is for :func:`isinstance` or :func:`issubclass` " +"checks." +msgstr "" + +msgid "" +"If you instantiate any of these types, note that signatures may vary between " +"Python versions." +msgstr "" + +msgid "Standard names are defined for the following types:" +msgstr "" + +msgid "The type of :data:`None`." +msgstr "" + +msgid "" +"The type of user-defined functions and functions created by :keyword:" +"`lambda` expressions." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``function.__new__`` with " +"argument ``code``." +msgstr "" + +msgid "" +"The audit event only occurs for direct instantiation of function objects, " +"and is not raised for normal compilation." +msgstr "" + +msgid "" +"The type of :term:`generator`-iterator objects, created by generator " +"functions." +msgstr "" + +msgid "" +"The type of :term:`coroutine` objects, created by :keyword:`async def` " +"functions." +msgstr "" + +msgid "" +"The type of :term:`asynchronous generator`-iterator objects, created by " +"asynchronous generator functions." +msgstr "" + +msgid "" +"The type of :ref:`code objects ` such as returned by :func:" +"`compile`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``code.__new__`` with arguments " +"``code``, ``filename``, ``name``, ``argcount``, ``posonlyargcount``, " +"``kwonlyargcount``, ``nlocals``, ``stacksize``, ``flags``." +msgstr "" + +msgid "" +"Note that the audited arguments may not match the names or positions " +"required by the initializer. The audit event only occurs for direct " +"instantiation of code objects, and is not raised for normal compilation." +msgstr "" + +msgid "" +"The type for cell objects: such objects are used as containers for a " +"function's free variables." +msgstr "" + +msgid "The type of methods of user-defined class instances." +msgstr "" + +msgid "" +"The type of built-in functions like :func:`len` or :func:`sys.exit`, and " +"methods of built-in classes. (Here, the term \"built-in\" means \"written " +"in C\".)" +msgstr "" + +msgid "" +"The type of methods of some built-in data types and base classes such as :" +"meth:`object.__init__` or :meth:`object.__lt__`." +msgstr "" + +msgid "" +"The type of *bound* methods of some built-in data types and base classes. " +"For example it is the type of :code:`object().__str__`." +msgstr "" + +msgid "The type of :data:`NotImplemented`." +msgstr "" + +msgid "" +"The type of methods of some built-in data types such as :meth:`str.join`." +msgstr "" + +msgid "" +"The type of *unbound* class methods of some built-in data types such as " +"``dict.__dict__['fromkeys']``." +msgstr "" + +msgid "" +"The type of :term:`modules `. The constructor takes the name of the " +"module to be created and optionally its :term:`docstring`." +msgstr "" + +msgid "" +"Use :func:`importlib.util.module_from_spec` to create a new module if you " +"wish to set the various import-controlled attributes." +msgstr "" + +msgid "The :term:`docstring` of the module. Defaults to ``None``." +msgstr "" + +msgid "The :term:`loader` which loaded the module. Defaults to ``None``." +msgstr "" + +msgid "" +"This attribute is to match :attr:`importlib.machinery.ModuleSpec.loader` as " +"stored in the :attr:`__spec__` object." +msgstr "" + +msgid "" +"A future version of Python may stop setting this attribute by default. To " +"guard against this potential change, preferably read from the :attr:" +"`__spec__` attribute instead or use ``getattr(module, \"__loader__\", " +"None)`` if you explicitly need to use this attribute." +msgstr "" + +msgid "Defaults to ``None``. Previously the attribute was optional." +msgstr "" + +msgid "" +"The name of the module. Expected to match :attr:`importlib.machinery." +"ModuleSpec.name`." +msgstr "" + +msgid "" +"Which :term:`package` a module belongs to. If the module is top-level (i.e. " +"not a part of any specific package) then the attribute should be set to " +"``''``, else it should be set to the name of the package (which can be :attr:" +"`__name__` if the module is a package itself). Defaults to ``None``." +msgstr "" + +msgid "" +"This attribute is to match :attr:`importlib.machinery.ModuleSpec.parent` as " +"stored in the :attr:`__spec__` object." +msgstr "" + +msgid "" +"A future version of Python may stop setting this attribute by default. To " +"guard against this potential change, preferably read from the :attr:" +"`__spec__` attribute instead or use ``getattr(module, \"__package__\", " +"None)`` if you explicitly need to use this attribute." +msgstr "" + +msgid "" +"A record of the module's import-system-related state. Expected to be an " +"instance of :class:`importlib.machinery.ModuleSpec`." +msgstr "" + +msgid "The type of :data:`Ellipsis`." +msgstr "" + +msgid "" +"The type of :ref:`parameterized generics ` such as " +"``list[int]``." +msgstr "" + +msgid "" +"``t_origin`` should be a non-parameterized generic class, such as ``list``, " +"``tuple`` or ``dict``. ``t_args`` should be a :class:`tuple` (possibly of " +"length 1) of types which parameterize ``t_origin``::" +msgstr "" + +msgid "This type can now be subclassed." +msgstr "" + +msgid ":ref:`Generic Alias Types`" +msgstr "" + +msgid "In-depth documentation on instances of :class:`!types.GenericAlias`" +msgstr "" + +msgid ":pep:`585` - Type Hinting Generics In Standard Collections" +msgstr "" + +msgid "Introducing the :class:`!types.GenericAlias` class" +msgstr "" + +msgid "The type of :ref:`union type expressions`." +msgstr "" + +msgid "" +"The type of traceback objects such as found in ``sys.exception()." +"__traceback__``." +msgstr "" + +msgid "" +"See :ref:`the language reference ` for details of the " +"available attributes and operations, and guidance on creating tracebacks " +"dynamically." +msgstr "" + +msgid "" +"The type of :ref:`frame objects ` such as found in :attr:`tb." +"tb_frame ` if ``tb`` is a traceback object." +msgstr "" + +msgid "" +"The type of objects defined in extension modules with ``PyGetSetDef``, such " +"as :attr:`FrameType.f_locals ` or ``array.array.typecode``. " +"This type is used as descriptor for object attributes; it has the same " +"purpose as the :class:`property` type, but for classes defined in extension " +"modules." +msgstr "" + +msgid "" +"The type of objects defined in extension modules with ``PyMemberDef``, such " +"as ``datetime.timedelta.days``. This type is used as descriptor for simple " +"C data members which use standard conversion functions; it has the same " +"purpose as the :class:`property` type, but for classes defined in extension " +"modules." +msgstr "" + +msgid "" +"In addition, when a class is defined with a :attr:`~object.__slots__` " +"attribute, then for each slot, an instance of :class:`!MemberDescriptorType` " +"will be added as an attribute on the class. This allows the slot to appear " +"in the class's :attr:`~object.__dict__`." +msgstr "" + +msgid "" +"In other implementations of Python, this type may be identical to " +"``GetSetDescriptorType``." +msgstr "" + +msgid "" +"Read-only proxy of a mapping. It provides a dynamic view on the mapping's " +"entries, which means that when the mapping changes, the view reflects these " +"changes." +msgstr "" + +msgid "" +"Updated to support the new union (``|``) operator from :pep:`584`, which " +"simply delegates to the underlying mapping." +msgstr "" + +msgid "" +"Return ``True`` if the underlying mapping has a key *key*, else ``False``." +msgstr "" + +msgid "" +"Return the item of the underlying mapping with key *key*. Raises a :exc:" +"`KeyError` if *key* is not in the underlying mapping." +msgstr "" + +msgid "" +"Return an iterator over the keys of the underlying mapping. This is a " +"shortcut for ``iter(proxy.keys())``." +msgstr "" + +msgid "Return the number of items in the underlying mapping." +msgstr "" + +msgid "Return a shallow copy of the underlying mapping." +msgstr "" + +msgid "" +"Return the value for *key* if *key* is in the underlying mapping, 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 underlying mapping's items (``(key, value)`` pairs)." +msgstr "" + +msgid "Return a new view of the underlying mapping's keys." +msgstr "" + +msgid "Return a new view of the underlying mapping's values." +msgstr "" + +msgid "Return a reverse iterator over the keys of the underlying mapping." +msgstr "" + +msgid "Additional Utility Classes and Functions" +msgstr "" + +msgid "" +"A simple :class:`object` subclass that provides attribute access to its " +"namespace, as well as a meaningful repr." +msgstr "" + +msgid "" +"Unlike :class:`object`, with ``SimpleNamespace`` you can add and remove " +"attributes. If a ``SimpleNamespace`` object is initialized with keyword " +"arguments, those are directly added to the underlying namespace." +msgstr "" + +msgid "The type is roughly equivalent to the following code::" +msgstr "" + +msgid "" +"``SimpleNamespace`` may be useful as a replacement for ``class NS: pass``. " +"However, for a structured record type use :func:`~collections.namedtuple` " +"instead." +msgstr "" + +msgid "" +"Attribute order in the repr changed from alphabetical to insertion (like " +"``dict``)." +msgstr "" + +msgid "Route attribute access on a class to __getattr__." +msgstr "" + +msgid "" +"This is a descriptor, used to define attributes that act differently when " +"accessed through an instance and through a class. Instance access remains " +"normal, but access to an attribute through a class will be routed to the " +"class's __getattr__ method; this is done by raising AttributeError." +msgstr "" + +msgid "" +"This allows one to have properties active on an instance, and have virtual " +"attributes on the class with the same name (see :class:`enum.Enum` for an " +"example)." +msgstr "" + +msgid "Coroutine Utility Functions" +msgstr "" + +msgid "" +"This function transforms a :term:`generator` function into a :term:" +"`coroutine function` which returns a generator-based coroutine. The " +"generator-based coroutine is still a :term:`generator iterator`, but is also " +"considered to be a :term:`coroutine` object and is :term:`awaitable`. " +"However, it may not necessarily implement the :meth:`~object.__await__` " +"method." +msgstr "" + +msgid "If *gen_func* is a generator function, it will be modified in-place." +msgstr "" + +msgid "" +"If *gen_func* is not a generator function, it will be wrapped. If it returns " +"an instance of :class:`collections.abc.Generator`, the instance will be " +"wrapped in an *awaitable* proxy object. All other types of objects will be " +"returned as is." +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "compile" +msgstr "" diff --git a/library/typing.po b/library/typing.po new file mode 100644 index 0000000000..076fd76d62 --- /dev/null +++ b/library/typing.po @@ -0,0 +1,2610 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`typing` --- Support for type hints" +msgstr "" + +msgid "**Source code:** :source:`Lib/typing.py`" +msgstr "" + +msgid "" +"The Python runtime does not enforce function and variable type annotations. " +"They can be used by third party tools such as :term:`type checkers `, IDEs, linters, etc." +msgstr "" + +msgid "" +"This module provides runtime support for type hints. For the original " +"specification of the typing system, see :pep:`484`. For a simplified " +"introduction to type hints, see :pep:`483`." +msgstr "" + +msgid "" +"The function below takes and returns a string and is annotated as follows::" +msgstr "" + +msgid "" +"In the function ``greeting``, the argument ``name`` is expected to be of " +"type :class:`str` and the return type :class:`str`. Subtypes are accepted as " +"arguments." +msgstr "" + +msgid "" +"New features are frequently added to the ``typing`` module. The " +"`typing_extensions `_ package " +"provides backports of these new features to older versions of Python." +msgstr "" + +msgid "" +"For a summary of deprecated features and a deprecation timeline, please see " +"`Deprecation Timeline of Major Features`_." +msgstr "" + +msgid "" +"`\"Typing cheat sheet\" `_" +msgstr "" + +msgid "A quick overview of type hints (hosted at the mypy docs)" +msgstr "" + +msgid "" +"\"Type System Reference\" section of `the mypy docs `_" +msgstr "" + +msgid "" +"The Python typing system is standardised via PEPs, so this reference should " +"broadly apply to most Python type checkers. (Some parts may still be " +"specific to mypy.)" +msgstr "" + +msgid "" +"`\"Static Typing with Python\" `_" +msgstr "" + +msgid "" +"Type-checker-agnostic documentation written by the community detailing type " +"system features, useful typing related tools and typing best practices." +msgstr "" + +msgid "Relevant PEPs" +msgstr "" + +msgid "" +"Since the initial introduction of type hints in :pep:`484` and :pep:`483`, a " +"number of PEPs have modified and enhanced Python's framework for type " +"annotations:" +msgstr "" + +msgid ":pep:`526`: Syntax for Variable Annotations" +msgstr "" + +msgid "" +"*Introducing* syntax for annotating variables outside of function " +"definitions, and :data:`ClassVar`" +msgstr "" + +msgid ":pep:`544`: Protocols: Structural subtyping (static duck typing)" +msgstr "" + +msgid "" +"*Introducing* :class:`Protocol` and the :func:" +"`@runtime_checkable` decorator" +msgstr "" + +msgid ":pep:`585`: Type Hinting Generics In Standard Collections" +msgstr "" + +msgid "" +"*Introducing* :class:`types.GenericAlias` and the ability to use standard " +"library classes as :ref:`generic types`" +msgstr "" + +msgid ":pep:`586`: Literal Types" +msgstr "" + +msgid "*Introducing* :data:`Literal`" +msgstr "" + +msgid "" +":pep:`589`: TypedDict: Type Hints for Dictionaries with a Fixed Set of Keys" +msgstr "" + +msgid "*Introducing* :class:`TypedDict`" +msgstr "" + +msgid ":pep:`591`: Adding a final qualifier to typing" +msgstr "" + +msgid "*Introducing* :data:`Final` and the :func:`@final` decorator" +msgstr "" + +msgid ":pep:`593`: Flexible function and variable annotations" +msgstr "" + +msgid "*Introducing* :data:`Annotated`" +msgstr "" + +msgid ":pep:`604`: Allow writing union types as ``X | Y``" +msgstr "" + +msgid "" +"*Introducing* :data:`types.UnionType` and the ability to use the binary-or " +"operator ``|`` to signify a :ref:`union of types`" +msgstr "" + +msgid ":pep:`612`: Parameter Specification Variables" +msgstr "" + +msgid "*Introducing* :class:`ParamSpec` and :data:`Concatenate`" +msgstr "" + +msgid ":pep:`613`: Explicit Type Aliases" +msgstr "" + +msgid "*Introducing* :data:`TypeAlias`" +msgstr "" + +msgid ":pep:`646`: Variadic Generics" +msgstr "" + +msgid "*Introducing* :data:`TypeVarTuple`" +msgstr "" + +msgid ":pep:`647`: User-Defined Type Guards" +msgstr "" + +msgid "*Introducing* :data:`TypeGuard`" +msgstr "" + +msgid "" +":pep:`655`: Marking individual TypedDict items as required or potentially " +"missing" +msgstr "" + +msgid "*Introducing* :data:`Required` and :data:`NotRequired`" +msgstr "" + +msgid ":pep:`673`: Self type" +msgstr "" + +msgid "*Introducing* :data:`Self`" +msgstr "" + +msgid ":pep:`675`: Arbitrary Literal String Type" +msgstr "" + +msgid "*Introducing* :data:`LiteralString`" +msgstr "" + +msgid ":pep:`681`: Data Class Transforms" +msgstr "" + +msgid "" +"*Introducing* the :func:`@dataclass_transform` decorator" +msgstr "" + +msgid "Type aliases" +msgstr "" + +msgid "" +"A type alias is defined by assigning the type to the alias. In this example, " +"``Vector`` and ``list[float]`` will be treated as interchangeable synonyms::" +msgstr "" + +msgid "" +"Type aliases are useful for simplifying complex type signatures. For " +"example::" +msgstr "" + +msgid "" +"Type aliases may be marked with :data:`TypeAlias` to make it explicit that " +"the statement is a type alias declaration, not a normal variable assignment::" +msgstr "" + +msgid "NewType" +msgstr "" + +msgid "Use the :class:`NewType` helper to create distinct types::" +msgstr "" + +msgid "" +"The static type checker will treat the new type as if it were a subclass of " +"the original type. This is useful in helping catch logical errors::" +msgstr "" + +msgid "" +"You may still perform all ``int`` operations on a variable of type " +"``UserId``, but the result will always be of type ``int``. This lets you " +"pass in a ``UserId`` wherever an ``int`` might be expected, but will prevent " +"you from accidentally creating a ``UserId`` in an invalid way::" +msgstr "" + +msgid "" +"Note that these checks are enforced only by the static type checker. At " +"runtime, the statement ``Derived = NewType('Derived', Base)`` will make " +"``Derived`` a callable that immediately returns whatever parameter you pass " +"it. That means the expression ``Derived(some_value)`` does not create a new " +"class or introduce much overhead beyond that of a regular function call." +msgstr "" + +msgid "" +"More precisely, the expression ``some_value is Derived(some_value)`` is " +"always true at runtime." +msgstr "" + +msgid "It is invalid to create a subtype of ``Derived``::" +msgstr "" + +msgid "" +"However, it is possible to create a :class:`NewType` based on a 'derived' " +"``NewType``::" +msgstr "" + +msgid "and typechecking for ``ProUserId`` will work as expected." +msgstr "" + +msgid "See :pep:`484` for more details." +msgstr "" + +msgid "" +"Recall that the use of a type alias declares two types to be *equivalent* to " +"one another. Doing ``Alias = Original`` will make the static type checker " +"treat ``Alias`` as being *exactly equivalent* to ``Original`` in all cases. " +"This is useful when you want to simplify complex type signatures." +msgstr "" + +msgid "" +"In contrast, ``NewType`` declares one type to be a *subtype* of another. " +"Doing ``Derived = NewType('Derived', Original)`` will make the static type " +"checker treat ``Derived`` as a *subclass* of ``Original``, which means a " +"value of type ``Original`` cannot be used in places where a value of type " +"``Derived`` is expected. This is useful when you want to prevent logic " +"errors with minimal runtime cost." +msgstr "" + +msgid "" +"``NewType`` is now a class rather than a function. As a result, there is " +"some additional runtime cost when calling ``NewType`` over a regular " +"function." +msgstr "" + +msgid "" +"The performance of calling ``NewType`` has been restored to its level in " +"Python 3.9." +msgstr "" + +msgid "Annotating callable objects" +msgstr "" + +msgid "" +"Functions -- or other :term:`callable` objects -- can be annotated using :" +"class:`collections.abc.Callable` or :data:`typing.Callable`. " +"``Callable[[int], str]`` signifies a function that takes a single parameter " +"of type :class:`int` and returns a :class:`str`." +msgstr "" + +msgid "For example:" +msgstr "Na przykład::" + +msgid "" +"The subscription syntax must always be used with exactly two values: the " +"argument list and the return type. The argument list must be a list of " +"types, a :class:`ParamSpec`, :data:`Concatenate`, or an ellipsis. The return " +"type must be a single type." +msgstr "" + +msgid "" +"If a literal ellipsis ``...`` is given as the argument list, it indicates " +"that a callable with any arbitrary parameter list would be acceptable:" +msgstr "" + +msgid "" +"``Callable`` cannot express complex signatures such as functions that take a " +"variadic number of arguments, :ref:`overloaded functions `, or " +"functions that have keyword-only parameters. However, these signatures can " +"be expressed by defining a :class:`Protocol` class with a :meth:`~object." +"__call__` method:" +msgstr "" + +msgid "" +"Callables which take other callables as arguments may indicate that their " +"parameter types are dependent on each other using :class:`ParamSpec`. " +"Additionally, if that callable adds or removes arguments from other " +"callables, the :data:`Concatenate` operator may be used. They take the form " +"``Callable[ParamSpecVariable, ReturnType]`` and " +"``Callable[Concatenate[Arg1Type, Arg2Type, ..., ParamSpecVariable], " +"ReturnType]`` respectively." +msgstr "" + +msgid "" +"``Callable`` now supports :class:`ParamSpec` and :data:`Concatenate`. See :" +"pep:`612` for more details." +msgstr "" + +msgid "" +"The documentation for :class:`ParamSpec` and :class:`Concatenate` provides " +"examples of usage in ``Callable``." +msgstr "" + +msgid "Generics" +msgstr "" + +msgid "" +"Since type information about objects kept in containers cannot be statically " +"inferred in a generic way, many container classes in the standard library " +"support subscription to denote the expected types of container elements." +msgstr "" + +msgid "" +"Generics can be parameterized by using a factory available in typing called :" +"class:`TypeVar`." +msgstr "" + +msgid "Annotating tuples" +msgstr "" + +msgid "" +"For most containers in Python, the typing system assumes that all elements " +"in the container will be of the same type. For example::" +msgstr "" + +msgid "" +":class:`list` only accepts one type argument, so a type checker would emit " +"an error on the ``y`` assignment above. Similarly, :class:`~collections.abc." +"Mapping` only accepts two type arguments: the first indicates the type of " +"the keys, and the second indicates the type of the values." +msgstr "" + +msgid "" +"Unlike most other Python containers, however, it is common in idiomatic " +"Python code for tuples to have elements which are not all of the same type. " +"For this reason, tuples are special-cased in Python's typing system. :class:" +"`tuple` accepts *any number* of type arguments::" +msgstr "" + +msgid "" +"To denote a tuple which could be of *any* length, and in which all elements " +"are of the same type ``T``, use ``tuple[T, ...]``. To denote an empty tuple, " +"use ``tuple[()]``. Using plain ``tuple`` as an annotation is equivalent to " +"using ``tuple[Any, ...]``::" +msgstr "" + +msgid "The type of class objects" +msgstr "" + +msgid "" +"A variable annotated with ``C`` may accept a value of type ``C``. In " +"contrast, a variable annotated with ``type[C]`` (or :class:`typing.Type[C] " +"`) may accept values that are classes themselves -- specifically, it " +"will accept the *class object* of ``C``. For example::" +msgstr "" + +msgid "Note that ``type[C]`` is covariant::" +msgstr "" + +msgid "" +"The only legal parameters for :class:`type` are classes, :data:`Any`, :ref:" +"`type variables `, and unions of any of these types. For example::" +msgstr "" + +msgid "" +"``type[Any]`` is equivalent to :class:`type`, which is the root of Python's :" +"ref:`metaclass hierarchy `." +msgstr "" + +msgid "User-defined generic types" +msgstr "" + +msgid "A user-defined class can be defined as a generic class." +msgstr "" + +msgid "" +"``Generic[T]`` as a base class defines that the class ``LoggedVar`` takes a " +"single type parameter ``T`` . This also makes ``T`` valid as a type within " +"the class body." +msgstr "" + +msgid "" +"The :class:`Generic` base class defines :meth:`~object.__class_getitem__` so " +"that ``LoggedVar[T]`` is valid as a type::" +msgstr "" + +msgid "" +"A generic type can have any number of type variables. All varieties of :" +"class:`TypeVar` are permissible as parameters for a generic type::" +msgstr "" + +msgid "" +"Each type variable argument to :class:`Generic` must be distinct. This is " +"thus invalid::" +msgstr "" + +msgid "You can use multiple inheritance with :class:`Generic`::" +msgstr "" + +msgid "" +"When inheriting from generic classes, some type parameters could be fixed::" +msgstr "" + +msgid "In this case ``MyDict`` has a single parameter, ``T``." +msgstr "" + +msgid "" +"Using a generic class without specifying type parameters assumes :data:`Any` " +"for each position. In the following example, ``MyIterable`` is not generic " +"but implicitly inherits from ``Iterable[Any]``:" +msgstr "" + +msgid "User-defined generic type aliases are also supported. Examples::" +msgstr "" + +msgid ":class:`Generic` no longer has a custom metaclass." +msgstr "" + +msgid "" +"User-defined generics for parameter expressions are also supported via " +"parameter specification variables in the form ``Generic[P]``. The behavior " +"is consistent with type variables' described above as parameter " +"specification variables are treated by the typing module as a specialized " +"type variable. The one exception to this is that a list of types can be " +"used to substitute a :class:`ParamSpec`::" +msgstr "" + +msgid "" +"Furthermore, a generic with only one parameter specification variable will " +"accept parameter lists in the forms ``X[[Type1, Type2, ...]]`` and also " +"``X[Type1, Type2, ...]`` for aesthetic reasons. Internally, the latter is " +"converted to the former, so the following are equivalent::" +msgstr "" + +msgid "" +"Note that generics with :class:`ParamSpec` may not have correct " +"``__parameters__`` after substitution in some cases because they are " +"intended primarily for static type checking." +msgstr "" + +msgid "" +":class:`Generic` can now be parameterized over parameter expressions. See :" +"class:`ParamSpec` and :pep:`612` for more details." +msgstr "" + +msgid "" +"A user-defined generic class can have ABCs as base classes without a " +"metaclass conflict. Generic metaclasses are not supported. The outcome of " +"parameterizing generics is cached, and most types in the typing module are :" +"term:`hashable` and comparable for equality." +msgstr "" + +msgid "The :data:`Any` type" +msgstr "" + +msgid "" +"A special kind of type is :data:`Any`. A static type checker will treat " +"every type as being compatible with :data:`Any` and :data:`Any` as being " +"compatible with every type." +msgstr "" + +msgid "" +"This means that it is possible to perform any operation or method call on a " +"value of type :data:`Any` and assign it to any variable::" +msgstr "" + +msgid "" +"Notice that no type checking is performed when assigning a value of type :" +"data:`Any` to a more precise type. For example, the static type checker did " +"not report an error when assigning ``a`` to ``s`` even though ``s`` was " +"declared to be of type :class:`str` and receives an :class:`int` value at " +"runtime!" +msgstr "" + +msgid "" +"Furthermore, all functions without a return type or parameter types will " +"implicitly default to using :data:`Any`::" +msgstr "" + +msgid "" +"This behavior allows :data:`Any` to be used as an *escape hatch* when you " +"need to mix dynamically and statically typed code." +msgstr "" + +msgid "" +"Contrast the behavior of :data:`Any` with the behavior of :class:`object`. " +"Similar to :data:`Any`, every type is a subtype of :class:`object`. However, " +"unlike :data:`Any`, the reverse is not true: :class:`object` is *not* a " +"subtype of every other type." +msgstr "" + +msgid "" +"That means when the type of a value is :class:`object`, a type checker will " +"reject almost all operations on it, and assigning it to a variable (or using " +"it as a return value) of a more specialized type is a type error. For " +"example::" +msgstr "" + +msgid "" +"Use :class:`object` to indicate that a value could be any type in a typesafe " +"manner. Use :data:`Any` to indicate that a value is dynamically typed." +msgstr "" + +msgid "Nominal vs structural subtyping" +msgstr "" + +msgid "" +"Initially :pep:`484` defined the Python static type system as using *nominal " +"subtyping*. This means that a class ``A`` is allowed where a class ``B`` is " +"expected if and only if ``A`` is a subclass of ``B``." +msgstr "" + +msgid "" +"This requirement previously also applied to abstract base classes, such as :" +"class:`~collections.abc.Iterable`. The problem with this approach is that a " +"class had to be explicitly marked to support them, which is unpythonic and " +"unlike what one would normally do in idiomatic dynamically typed Python " +"code. For example, this conforms to :pep:`484`::" +msgstr "" + +msgid "" +":pep:`544` allows to solve this problem by allowing users to write the above " +"code without explicit base classes in the class definition, allowing " +"``Bucket`` to be implicitly considered a subtype of both ``Sized`` and " +"``Iterable[int]`` by static type checkers. This is known as *structural " +"subtyping* (or static duck-typing)::" +msgstr "" + +msgid "" +"Moreover, by subclassing a special class :class:`Protocol`, a user can " +"define new custom protocols to fully enjoy structural subtyping (see " +"examples below)." +msgstr "" + +msgid "Module contents" +msgstr "" + +msgid "" +"The ``typing`` module defines the following classes, functions and " +"decorators." +msgstr "" + +msgid "Special typing primitives" +msgstr "" + +msgid "Special types" +msgstr "" + +msgid "" +"These can be used as types in annotations. They do not support subscription " +"using ``[]``." +msgstr "" + +msgid "Special type indicating an unconstrained type." +msgstr "" + +msgid "Every type is compatible with :data:`Any`." +msgstr "" + +msgid ":data:`Any` is compatible with every type." +msgstr "" + +msgid "" +":data:`Any` can now be used as a base class. This can be useful for avoiding " +"type checker errors with classes that can duck type anywhere or are highly " +"dynamic." +msgstr "" + +msgid "A :ref:`constrained type variable `." +msgstr "" + +msgid "Definition::" +msgstr "" + +msgid "" +"``AnyStr`` is meant to be used for functions that may accept :class:`str` " +"or :class:`bytes` arguments but cannot allow the two to mix." +msgstr "" + +msgid "For example::" +msgstr "Dla przykładu::" + +msgid "" +"Note that, despite its name, ``AnyStr`` has nothing to do with the :class:" +"`Any` type, nor does it mean \"any string\". In particular, ``AnyStr`` and " +"``str | bytes`` are different from each other and have different use cases::" +msgstr "" + +msgid "Special type that includes only literal strings." +msgstr "" + +msgid "" +"Any string literal is compatible with ``LiteralString``, as is another " +"``LiteralString``. However, an object typed as just ``str`` is not. A string " +"created by composing ``LiteralString``-typed objects is also acceptable as a " +"``LiteralString``." +msgstr "" + +msgid "Example:" +msgstr "Przykład:" + +msgid "" +"``LiteralString`` is useful for sensitive APIs where arbitrary user-" +"generated strings could generate problems. For example, the two cases above " +"that generate type checker errors could be vulnerable to an SQL injection " +"attack." +msgstr "" + +msgid "See :pep:`675` for more details." +msgstr "" + +msgid "" +"The `bottom type `_, a type that " +"has no members." +msgstr "" + +msgid "" +"This can be used to define a function that should never be called, or a " +"function that never returns::" +msgstr "" + +msgid "" +"On older Python versions, :data:`NoReturn` may be used to express the same " +"concept. ``Never`` was added to make the intended meaning more explicit." +msgstr "" + +msgid "Special type indicating that a function never returns." +msgstr "" + +msgid "" +"``NoReturn`` can also be used as a `bottom type `_, a type that has no values. Starting in Python 3.11, " +"the :data:`Never` type should be used for this concept instead. Type " +"checkers should treat the two equivalently." +msgstr "" + +msgid "Special type to represent the current enclosed class." +msgstr "" + +msgid "" +"This annotation is semantically equivalent to the following, albeit in a " +"more succinct fashion::" +msgstr "" + +msgid "" +"In general, if something returns ``self``, as in the above examples, you " +"should use ``Self`` as the return annotation. If ``Foo.return_self`` was " +"annotated as returning ``\"Foo\"``, then the type checker would infer the " +"object returned from ``SubclassOfFoo.return_self`` as being of type ``Foo`` " +"rather than ``SubclassOfFoo``." +msgstr "" + +msgid "Other common use cases include:" +msgstr "" + +msgid "" +":class:`classmethod`\\s that are used as alternative constructors and return " +"instances of the ``cls`` parameter." +msgstr "" + +msgid "Annotating an :meth:`~object.__enter__` method which returns self." +msgstr "" + +msgid "" +"You should not use ``Self`` as the return annotation if the method is not " +"guaranteed to return an instance of a subclass when the class is subclassed::" +msgstr "" + +msgid "See :pep:`673` for more details." +msgstr "" + +msgid "" +"Special annotation for explicitly declaring a :ref:`type alias `." +msgstr "" + +msgid "" +"``TypeAlias`` is particularly useful for annotating aliases that make use of " +"forward references, as it can be hard for type checkers to distinguish these " +"from normal variable assignments:" +msgstr "" + +msgid "See :pep:`613` for more details." +msgstr "" + +msgid "Special forms" +msgstr "" + +msgid "" +"These can be used as types in annotations. They all support subscription " +"using ``[]``, but each has a unique syntax." +msgstr "" + +msgid "" +"Union type; ``Union[X, Y]`` is equivalent to ``X | Y`` and means either X or " +"Y." +msgstr "" + +msgid "" +"To define a union, use e.g. ``Union[int, str]`` or the shorthand ``int | " +"str``. Using that shorthand is recommended. Details:" +msgstr "" + +msgid "The arguments must be types and there must be at least one." +msgstr "" + +msgid "Unions of unions are flattened, e.g.::" +msgstr "" + +msgid "Unions of a single argument vanish, e.g.::" +msgstr "" + +msgid "Redundant arguments are skipped, e.g.::" +msgstr "" + +msgid "When comparing unions, the argument order is ignored, e.g.::" +msgstr "" + +msgid "You cannot subclass or instantiate a ``Union``." +msgstr "" + +msgid "You cannot write ``Union[X][Y]``." +msgstr "" + +msgid "Don't remove explicit subclasses from unions at runtime." +msgstr "" + +msgid "" +"Unions can now be written as ``X | Y``. See :ref:`union type " +"expressions`." +msgstr "" + +msgid "``Optional[X]`` is equivalent to ``X | None`` (or ``Union[X, None]``)." +msgstr "" + +msgid "" +"Note that this is not the same concept as an optional argument, which is one " +"that has a default. An optional argument with a default does not require " +"the ``Optional`` qualifier on its type annotation just because it is " +"optional. For example::" +msgstr "" + +msgid "" +"On the other hand, if an explicit value of ``None`` is allowed, the use of " +"``Optional`` is appropriate, whether the argument is optional or not. For " +"example::" +msgstr "" + +msgid "" +"Optional can now be written as ``X | None``. See :ref:`union type " +"expressions`." +msgstr "" + +msgid "Special form for annotating higher-order functions." +msgstr "" + +msgid "" +"``Concatenate`` can be used in conjunction with :ref:`Callable ` and :class:`ParamSpec` to annotate a higher-order callable which " +"adds, removes, or transforms parameters of another callable. Usage is in " +"the form ``Concatenate[Arg1Type, Arg2Type, ..., ParamSpecVariable]``. " +"``Concatenate`` is currently only valid when used as the first argument to " +"a :ref:`Callable `. The last parameter to " +"``Concatenate`` must be a :class:`ParamSpec` or ellipsis (``...``)." +msgstr "" + +msgid "" +"For example, to annotate a decorator ``with_lock`` which provides a :class:" +"`threading.Lock` to the decorated function, ``Concatenate`` can be used to " +"indicate that ``with_lock`` expects a callable which takes in a ``Lock`` as " +"the first argument, and returns a callable with a different type signature. " +"In this case, the :class:`ParamSpec` indicates that the returned callable's " +"parameter types are dependent on the parameter types of the callable being " +"passed in::" +msgstr "" + +msgid "" +":pep:`612` -- Parameter Specification Variables (the PEP which introduced " +"``ParamSpec`` and ``Concatenate``)" +msgstr "" + +msgid ":class:`ParamSpec`" +msgstr ":class:`ParamSpec`" + +msgid ":ref:`annotating-callables`" +msgstr ":ref:`annotating-callables`" + +msgid "Special typing form to define \"literal types\"." +msgstr "" + +msgid "" +"``Literal`` can be used to indicate to type checkers that the annotated " +"object has a value equivalent to one of the provided literals." +msgstr "" + +msgid "" +"``Literal[...]`` cannot be subclassed. At runtime, an arbitrary value is " +"allowed as type argument to ``Literal[...]``, but type checkers may impose " +"restrictions. See :pep:`586` for more details about literal types." +msgstr "" + +msgid "" +"``Literal`` now de-duplicates parameters. Equality comparisons of " +"``Literal`` objects are no longer order dependent. ``Literal`` objects will " +"now raise a :exc:`TypeError` exception during equality comparisons if one of " +"their parameters are not :term:`hashable`." +msgstr "" + +msgid "Special type construct to mark class variables." +msgstr "" + +msgid "" +"As introduced in :pep:`526`, a variable annotation wrapped in ClassVar " +"indicates that a given attribute is intended to be used as a class variable " +"and should not be set on instances of that class. Usage::" +msgstr "" + +msgid ":data:`ClassVar` accepts only types and cannot be further subscribed." +msgstr "" + +msgid "" +":data:`ClassVar` is not a class itself, and should not be used with :func:" +"`isinstance` or :func:`issubclass`. :data:`ClassVar` does not change Python " +"runtime behavior, but it can be used by third-party type checkers. For " +"example, a type checker might flag the following code as an error::" +msgstr "" + +msgid "Special typing construct to indicate final names to type checkers." +msgstr "" + +msgid "" +"Final names cannot be reassigned in any scope. Final names declared in class " +"scopes cannot be overridden in subclasses." +msgstr "" + +msgid "" +"There is no runtime checking of these properties. See :pep:`591` for more " +"details." +msgstr "" + +msgid "Special typing construct to mark a :class:`TypedDict` key as required." +msgstr "" + +msgid "" +"This is mainly useful for ``total=False`` TypedDicts. See :class:`TypedDict` " +"and :pep:`655` for more details." +msgstr "" + +msgid "" +"Special typing construct to mark a :class:`TypedDict` key as potentially " +"missing." +msgstr "" + +msgid "See :class:`TypedDict` and :pep:`655` for more details." +msgstr "" + +msgid "Special typing form to add context-specific metadata to an annotation." +msgstr "" + +msgid "" +"Add metadata ``x`` to a given type ``T`` by using the annotation " +"``Annotated[T, x]``. Metadata added using ``Annotated`` can be used by " +"static analysis tools or at runtime. At runtime, the metadata is stored in " +"a :attr:`!__metadata__` attribute." +msgstr "" + +msgid "" +"If a library or tool encounters an annotation ``Annotated[T, x]`` and has no " +"special logic for the metadata, it should ignore the metadata and simply " +"treat the annotation as ``T``. As such, ``Annotated`` can be useful for code " +"that wants to use annotations for purposes outside Python's static typing " +"system." +msgstr "" + +msgid "" +"Using ``Annotated[T, x]`` as an annotation still allows for static " +"typechecking of ``T``, as type checkers will simply ignore the metadata " +"``x``. In this way, ``Annotated`` differs from the :func:`@no_type_check " +"` decorator, which can also be used for adding annotations " +"outside the scope of the typing system, but completely disables typechecking " +"for a function or class." +msgstr "" + +msgid "" +"The responsibility of how to interpret the metadata lies with the tool or " +"library encountering an ``Annotated`` annotation. A tool or library " +"encountering an ``Annotated`` type can scan through the metadata elements to " +"determine if they are of interest (e.g., using :func:`isinstance`)." +msgstr "" + +msgid "" +"Here is an example of how you might use ``Annotated`` to add metadata to " +"type annotations if you were doing range analysis:" +msgstr "" + +msgid "Details of the syntax:" +msgstr "" + +msgid "The first argument to ``Annotated`` must be a valid type" +msgstr "" + +msgid "" +"Multiple metadata elements can be supplied (``Annotated`` supports variadic " +"arguments)::" +msgstr "" + +msgid "" +"It is up to the tool consuming the annotations to decide whether the client " +"is allowed to add multiple metadata elements to one annotation and how to " +"merge those annotations." +msgstr "" + +msgid "" +"``Annotated`` must be subscripted with at least two arguments " +"( ``Annotated[int]`` is not valid)" +msgstr "" + +msgid "" +"The order of the metadata elements is preserved and matters for equality " +"checks::" +msgstr "" + +msgid "" +"Nested ``Annotated`` types are flattened. The order of the metadata elements " +"starts with the innermost annotation::" +msgstr "" + +msgid "Duplicated metadata elements are not removed::" +msgstr "" + +msgid "``Annotated`` can be used with nested and generic aliases:" +msgstr "" + +msgid "``Annotated`` cannot be used with an unpacked :class:`TypeVarTuple`::" +msgstr "" + +msgid "This would be equivalent to::" +msgstr "" + +msgid "" +"where ``T1``, ``T2``, etc. are :class:`TypeVars `. This would be " +"invalid: only one type should be passed to Annotated." +msgstr "" + +msgid "" +"By default, :func:`get_type_hints` strips the metadata from annotations. " +"Pass ``include_extras=True`` to have the metadata preserved:" +msgstr "" + +msgid "" +"At runtime, the metadata associated with an ``Annotated`` type can be " +"retrieved via the :attr:`!__metadata__` attribute:" +msgstr "" + +msgid ":pep:`593` - Flexible function and variable annotations" +msgstr "" + +msgid "The PEP introducing ``Annotated`` to the standard library." +msgstr "" + +msgid "Special typing construct for marking user-defined type guard functions." +msgstr "" + +msgid "" +"``TypeGuard`` can be used to annotate the return type of a user-defined type " +"guard function. ``TypeGuard`` only accepts a single type argument. At " +"runtime, functions marked this way should return a boolean." +msgstr "" + +msgid "" +"``TypeGuard`` aims to benefit *type narrowing* -- a technique used by static " +"type checkers to determine a more precise type of an expression within a " +"program's code flow. Usually type narrowing is done by analyzing " +"conditional code flow and applying the narrowing to a block of code. The " +"conditional expression here is sometimes referred to as a \"type guard\"::" +msgstr "" + +msgid "" +"Sometimes it would be convenient to use a user-defined boolean function as a " +"type guard. Such a function should use ``TypeGuard[...]`` as its return " +"type to alert static type checkers to this intention." +msgstr "" + +msgid "" +"Using ``-> TypeGuard`` tells the static type checker that for a given " +"function:" +msgstr "" + +msgid "The return value is a boolean." +msgstr "" + +msgid "" +"If the return value is ``True``, the type of its argument is the type inside " +"``TypeGuard``." +msgstr "" + +msgid "" +"If ``is_str_list`` is a class or instance method, then the type in " +"``TypeGuard`` maps to the type of the second parameter after ``cls`` or " +"``self``." +msgstr "" + +msgid "" +"In short, the form ``def foo(arg: TypeA) -> TypeGuard[TypeB]: ...``, means " +"that if ``foo(arg)`` returns ``True``, then ``arg`` narrows from ``TypeA`` " +"to ``TypeB``." +msgstr "" + +msgid "" +"``TypeB`` need not be a narrower form of ``TypeA`` -- it can even be a wider " +"form. The main reason is to allow for things like narrowing ``list[object]`` " +"to ``list[str]`` even though the latter is not a subtype of the former, " +"since ``list`` is invariant. The responsibility of writing type-safe type " +"guards is left to the user." +msgstr "" + +msgid "" +"``TypeGuard`` also works with type variables. See :pep:`647` for more " +"details." +msgstr "" + +msgid "Typing operator to conceptually mark an object as having been unpacked." +msgstr "" + +msgid "" +"For example, using the unpack operator ``*`` on a :ref:`type variable tuple " +"` is equivalent to using ``Unpack`` to mark the type variable " +"tuple as having been unpacked::" +msgstr "" + +msgid "" +"In fact, ``Unpack`` can be used interchangeably with ``*`` in the context " +"of :class:`typing.TypeVarTuple ` and :class:`builtins.tuple " +"` types. You might see ``Unpack`` being used explicitly in older " +"versions of Python, where ``*`` couldn't be used in certain places::" +msgstr "" + +msgid "Building generic types" +msgstr "" + +msgid "" +"The following classes should not be used directly as annotations. Their " +"intended purpose is to be building blocks for creating generic types." +msgstr "" + +msgid "Abstract base class for generic types." +msgstr "" + +msgid "" +"A generic type is typically declared by inheriting from an instantiation of " +"this class with one or more type variables. For example, a generic mapping " +"type might be defined as::" +msgstr "" + +msgid "This class can then be used as follows::" +msgstr "" + +msgid "Type variable." +msgstr "" + +msgid "Usage::" +msgstr "" + +msgid "" +"Type variables exist primarily for the benefit of static type checkers. " +"They serve as the parameters for generic types as well as for generic " +"function and type alias definitions. See :class:`Generic` for more " +"information on generic types. Generic functions work as follows::" +msgstr "" + +msgid "" +"Note that type variables can be *bound*, *constrained*, or neither, but " +"cannot be both bound *and* constrained." +msgstr "" + +msgid "" +"Type variables may be marked covariant or contravariant by passing " +"``covariant=True`` or ``contravariant=True``. See :pep:`484` for more " +"details. By default, type variables are invariant." +msgstr "" + +msgid "" +"Bound type variables and constrained type variables have different semantics " +"in several important ways. Using a *bound* type variable means that the " +"``TypeVar`` will be solved using the most specific type possible::" +msgstr "" + +msgid "" +"Type variables can be bound to concrete types, abstract types (ABCs or " +"protocols), and even unions of types::" +msgstr "" + +msgid "" +"Using a *constrained* type variable, however, means that the ``TypeVar`` can " +"only ever be solved as being exactly one of the constraints given::" +msgstr "" + +msgid "At runtime, ``isinstance(x, T)`` will raise :exc:`TypeError`." +msgstr "" + +msgid "The name of the type variable." +msgstr "" + +msgid "Whether the type var has been marked as covariant." +msgstr "" + +msgid "Whether the type var has been marked as contravariant." +msgstr "" + +msgid "The bound of the type variable, if any." +msgstr "" + +msgid "A tuple containing the constraints of the type variable, if any." +msgstr "" + +msgid "" +"Type variable tuple. A specialized form of :ref:`type variable ` " +"that enables *variadic* generics." +msgstr "" + +msgid "" +"A normal type variable enables parameterization with a single type. A type " +"variable tuple, in contrast, allows parameterization with an *arbitrary* " +"number of types by acting like an *arbitrary* number of type variables " +"wrapped in a tuple. For example::" +msgstr "" + +msgid "" +"Note the use of the unpacking operator ``*`` in ``tuple[T, *Ts]``. " +"Conceptually, you can think of ``Ts`` as a tuple of type variables ``(T1, " +"T2, ...)``. ``tuple[T, *Ts]`` would then become ``tuple[T, *(T1, " +"T2, ...)]``, which is equivalent to ``tuple[T, T1, T2, ...]``. (Note that in " +"older versions of Python, you might see this written using :data:`Unpack " +"` instead, as ``Unpack[Ts]``.)" +msgstr "" + +msgid "" +"Type variable tuples must *always* be unpacked. This helps distinguish type " +"variable tuples from normal type variables::" +msgstr "" + +msgid "" +"Type variable tuples can be used in the same contexts as normal type " +"variables. For example, in class definitions, arguments, and return types::" +msgstr "" + +msgid "" +"Type variable tuples can be happily combined with normal type variables:" +msgstr "" + +msgid "" +"However, note that at most one type variable tuple may appear in a single " +"list of type arguments or type parameters::" +msgstr "" + +msgid "" +"Finally, an unpacked type variable tuple can be used as the type annotation " +"of ``*args``::" +msgstr "" + +msgid "" +"In contrast to non-unpacked annotations of ``*args`` - e.g. ``*args: int``, " +"which would specify that *all* arguments are ``int`` - ``*args: *Ts`` " +"enables reference to the types of the *individual* arguments in ``*args``. " +"Here, this allows us to ensure the types of the ``*args`` passed to " +"``call_soon`` match the types of the (positional) arguments of ``callback``." +msgstr "" + +msgid "See :pep:`646` for more details on type variable tuples." +msgstr "" + +msgid "The name of the type variable tuple." +msgstr "" + +msgid "" +"Parameter specification variable. A specialized version of :ref:`type " +"variables `." +msgstr "" + +msgid "" +"Parameter specification variables exist primarily for the benefit of static " +"type checkers. They are used to forward the parameter types of one callable " +"to another callable -- a pattern commonly found in higher order functions " +"and decorators. They are only valid when used in ``Concatenate``, or as the " +"first argument to ``Callable``, or as parameters for user-defined Generics. " +"See :class:`Generic` for more information on generic types." +msgstr "" + +msgid "" +"For example, to add basic logging to a function, one can create a decorator " +"``add_logging`` to log function calls. The parameter specification variable " +"tells the type checker that the callable passed into the decorator and the " +"new callable returned by it have inter-dependent type parameters::" +msgstr "" + +msgid "" +"Without ``ParamSpec``, the simplest way to annotate this previously was to " +"use a :class:`TypeVar` with bound ``Callable[..., Any]``. However this " +"causes two problems:" +msgstr "" + +msgid "" +"The type checker can't type check the ``inner`` function because ``*args`` " +"and ``**kwargs`` have to be typed :data:`Any`." +msgstr "" + +msgid "" +":func:`~cast` may be required in the body of the ``add_logging`` decorator " +"when returning the ``inner`` function, or the static type checker must be " +"told to ignore the ``return inner``." +msgstr "" + +msgid "" +"Since ``ParamSpec`` captures both positional and keyword parameters, ``P." +"args`` and ``P.kwargs`` can be used to split a ``ParamSpec`` into its " +"components. ``P.args`` represents the tuple of positional parameters in a " +"given call and should only be used to annotate ``*args``. ``P.kwargs`` " +"represents the mapping of keyword parameters to their values in a given " +"call, and should be only be used to annotate ``**kwargs``. Both attributes " +"require the annotated parameter to be in scope. At runtime, ``P.args`` and " +"``P.kwargs`` are instances respectively of :class:`ParamSpecArgs` and :class:" +"`ParamSpecKwargs`." +msgstr "" + +msgid "The name of the parameter specification." +msgstr "" + +msgid "" +"Parameter specification variables created with ``covariant=True`` or " +"``contravariant=True`` can be used to declare covariant or contravariant " +"generic types. The ``bound`` argument is also accepted, similar to :class:" +"`TypeVar`. However the actual semantics of these keywords are yet to be " +"decided." +msgstr "" + +msgid "" +"Only parameter specification variables defined in global scope can be " +"pickled." +msgstr "" + +msgid ":data:`Concatenate`" +msgstr ":data:`Concatenate`" + +msgid "" +"Arguments and keyword arguments attributes of a :class:`ParamSpec`. The ``P." +"args`` attribute of a ``ParamSpec`` is an instance of ``ParamSpecArgs``, and " +"``P.kwargs`` is an instance of ``ParamSpecKwargs``. They are intended for " +"runtime introspection and have no special meaning to static type checkers." +msgstr "" + +msgid "" +"Calling :func:`get_origin` on either of these objects will return the " +"original ``ParamSpec``:" +msgstr "" + +msgid "Other special directives" +msgstr "" + +msgid "" +"These functions and classes should not be used directly as annotations. " +"Their intended purpose is to be building blocks for creating and declaring " +"types." +msgstr "" + +msgid "Typed version of :func:`collections.namedtuple`." +msgstr "" + +msgid "This is equivalent to::" +msgstr "" + +msgid "" +"To give a field a default value, you can assign to it in the class body::" +msgstr "" + +msgid "" +"Fields with a default value must come after any fields without a default." +msgstr "" + +msgid "" +"The resulting class has an extra attribute ``__annotations__`` giving a dict " +"that maps the field names to the field types. (The field names are in the " +"``_fields`` attribute and the default values are in the ``_field_defaults`` " +"attribute, both of which are part of the :func:`~collections.namedtuple` " +"API.)" +msgstr "" + +msgid "``NamedTuple`` subclasses can also have docstrings and methods::" +msgstr "" + +msgid "``NamedTuple`` subclasses can be generic::" +msgstr "" + +msgid "Backward-compatible usage::" +msgstr "" + +msgid "Added support for :pep:`526` variable annotation syntax." +msgstr "" + +msgid "Added support for default values, methods, and docstrings." +msgstr "" + +msgid "" +"The ``_field_types`` and ``__annotations__`` attributes are now regular " +"dictionaries instead of instances of ``OrderedDict``." +msgstr "" + +msgid "" +"Removed the ``_field_types`` attribute in favor of the more standard " +"``__annotations__`` attribute which has the same information." +msgstr "" + +msgid "Added support for generic namedtuples." +msgstr "" + +msgid "Helper class to create low-overhead :ref:`distinct types `." +msgstr "" + +msgid "" +"A ``NewType`` is considered a distinct type by a typechecker. At runtime, " +"however, calling a ``NewType`` returns its argument unchanged." +msgstr "" + +msgid "The module in which the new type is defined." +msgstr "" + +msgid "The name of the new type." +msgstr "" + +msgid "The type that the new type is based on." +msgstr "" + +msgid "``NewType`` is now a class rather than a function." +msgstr "" + +msgid "Base class for protocol classes." +msgstr "" + +msgid "Protocol classes are defined like this::" +msgstr "" + +msgid "" +"Such classes are primarily used with static type checkers that recognize " +"structural subtyping (static duck-typing), for example::" +msgstr "" + +msgid "" +"See :pep:`544` for more details. Protocol classes decorated with :func:" +"`runtime_checkable` (described later) act as simple-minded runtime protocols " +"that check only the presence of given attributes, ignoring their type " +"signatures." +msgstr "" + +msgid "Protocol classes can be generic, for example::" +msgstr "" + +msgid "Mark a protocol class as a runtime protocol." +msgstr "" + +msgid "" +"Such a protocol can be used with :func:`isinstance` and :func:`issubclass`. " +"This raises :exc:`TypeError` when applied to a non-protocol class. This " +"allows a simple-minded structural check, very similar to \"one trick " +"ponies\" in :mod:`collections.abc` such as :class:`~collections.abc." +"Iterable`. For example::" +msgstr "" + +msgid "" +":func:`!runtime_checkable` will check only the presence of the required " +"methods or attributes, not their type signatures or types. For example, :" +"class:`ssl.SSLObject` is a class, therefore it passes an :func:`issubclass` " +"check against :ref:`Callable `. However, the ``ssl." +"SSLObject.__init__`` method exists only to raise a :exc:`TypeError` with a " +"more informative message, therefore making it impossible to call " +"(instantiate) :class:`ssl.SSLObject`." +msgstr "" + +msgid "" +"An :func:`isinstance` check against a runtime-checkable protocol can be " +"surprisingly slow compared to an ``isinstance()`` check against a non-" +"protocol class. Consider using alternative idioms such as :func:`hasattr` " +"calls for structural checks in performance-sensitive code." +msgstr "" + +msgid "" +"Special construct to add type hints to a dictionary. At runtime it is a " +"plain :class:`dict`." +msgstr "" + +msgid "" +"``TypedDict`` declares a dictionary type that expects all of its instances " +"to have a certain set of keys, where each key is associated with a value of " +"a consistent type. This expectation is not checked at runtime but is only " +"enforced by type checkers. Usage::" +msgstr "" + +msgid "" +"To allow using this feature with older versions of Python that do not " +"support :pep:`526`, ``TypedDict`` supports two additional equivalent " +"syntactic forms:" +msgstr "" + +msgid "Using a literal :class:`dict` as the second argument::" +msgstr "" + +msgid "Using keyword arguments::" +msgstr "" + +msgid "" +"The keyword-argument syntax is deprecated in 3.11 and will be removed in " +"3.13. It may also be unsupported by static type checkers." +msgstr "" + +msgid "" +"The functional syntax should also be used when any of the keys are not " +"valid :ref:`identifiers `, for example because they are " +"keywords or contain hyphens. Example::" +msgstr "" + +msgid "" +"By default, all keys must be present in a ``TypedDict``. It is possible to " +"mark individual keys as non-required using :data:`NotRequired`::" +msgstr "" + +msgid "" +"This means that a ``Point2D`` ``TypedDict`` can have the ``label`` key " +"omitted." +msgstr "" + +msgid "" +"It is also possible to mark all keys as non-required by default by " +"specifying a totality of ``False``::" +msgstr "" + +msgid "" +"This means that a ``Point2D`` ``TypedDict`` can have any of the keys " +"omitted. A type checker is only expected to support a literal ``False`` or " +"``True`` as the value of the ``total`` argument. ``True`` is the default, " +"and makes all items defined in the class body required." +msgstr "" + +msgid "" +"Individual keys of a ``total=False`` ``TypedDict`` can be marked as required " +"using :data:`Required`::" +msgstr "" + +msgid "" +"It is possible for a ``TypedDict`` type to inherit from one or more other " +"``TypedDict`` types using the class-based syntax. Usage::" +msgstr "" + +msgid "" +"``Point3D`` has three items: ``x``, ``y`` and ``z``. It is equivalent to " +"this definition::" +msgstr "" + +msgid "" +"A ``TypedDict`` cannot inherit from a non-\\ ``TypedDict`` class, except " +"for :class:`Generic`. For example::" +msgstr "" + +msgid "A ``TypedDict`` can be generic:" +msgstr "" + +msgid "" +"A ``TypedDict`` can be introspected via annotations dicts (see :ref:" +"`annotations-howto` for more information on annotations best practices), :" +"attr:`__total__`, :attr:`__required_keys__`, and :attr:`__optional_keys__`." +msgstr "" + +msgid "" +"``Point2D.__total__`` gives the value of the ``total`` argument. Example:" +msgstr "" + +msgid "" +"This attribute reflects *only* the value of the ``total`` argument to the " +"current ``TypedDict`` class, not whether the class is semantically total. " +"For example, a ``TypedDict`` with ``__total__`` set to True may have keys " +"marked with :data:`NotRequired`, or it may inherit from another " +"``TypedDict`` with ``total=False``. Therefore, it is generally better to " +"use :attr:`__required_keys__` and :attr:`__optional_keys__` for " +"introspection." +msgstr "" + +msgid "" +"``Point2D.__required_keys__`` and ``Point2D.__optional_keys__`` return :" +"class:`frozenset` objects containing required and non-required keys, " +"respectively." +msgstr "" + +msgid "" +"Keys marked with :data:`Required` will always appear in " +"``__required_keys__`` and keys marked with :data:`NotRequired` will always " +"appear in ``__optional_keys__``." +msgstr "" + +msgid "" +"For backwards compatibility with Python 3.10 and below, it is also possible " +"to use inheritance to declare both required and non-required keys in the " +"same ``TypedDict`` . This is done by declaring a ``TypedDict`` with one " +"value for the ``total`` argument and then inheriting from it in another " +"``TypedDict`` with a different value for ``total``:" +msgstr "" + +msgid "" +"If ``from __future__ import annotations`` is used or if annotations are " +"given as strings, annotations are not evaluated when the ``TypedDict`` is " +"defined. Therefore, the runtime introspection that ``__required_keys__`` and " +"``__optional_keys__`` rely on may not work properly, and the values of the " +"attributes may be incorrect." +msgstr "" + +msgid "" +"See :pep:`589` for more examples and detailed rules of using ``TypedDict``." +msgstr "" + +msgid "" +"Added support for marking individual keys as :data:`Required` or :data:" +"`NotRequired`. See :pep:`655`." +msgstr "" + +msgid "Added support for generic ``TypedDict``\\ s." +msgstr "" + +msgid "Protocols" +msgstr "" + +msgid "" +"The following protocols are provided by the typing module. All are decorated " +"with :func:`@runtime_checkable `." +msgstr "" + +msgid "" +"An ABC with one abstract method ``__abs__`` that is covariant in its return " +"type." +msgstr "" + +msgid "An ABC with one abstract method ``__bytes__``." +msgstr "" + +msgid "An ABC with one abstract method ``__complex__``." +msgstr "" + +msgid "An ABC with one abstract method ``__float__``." +msgstr "" + +msgid "An ABC with one abstract method ``__index__``." +msgstr "" + +msgid "An ABC with one abstract method ``__int__``." +msgstr "" + +msgid "" +"An ABC with one abstract method ``__round__`` that is covariant in its " +"return type." +msgstr "" + +msgid "ABCs for working with IO" +msgstr "" + +msgid "" +"Generic type ``IO[AnyStr]`` and its subclasses ``TextIO(IO[str])`` and " +"``BinaryIO(IO[bytes])`` represent the types of I/O streams such as returned " +"by :func:`open`." +msgstr "" + +msgid "Functions and decorators" +msgstr "" + +msgid "Cast a value to a type." +msgstr "" + +msgid "" +"This returns the value unchanged. To the type checker this signals that the " +"return value has the designated type, but at runtime we intentionally don't " +"check anything (we want this to be as fast as possible)." +msgstr "" + +msgid "" +"Ask a static type checker to confirm that *val* has an inferred type of " +"*typ*." +msgstr "" + +msgid "" +"At runtime this does nothing: it returns the first argument unchanged with " +"no checks or side effects, no matter the actual type of the argument." +msgstr "" + +msgid "" +"When a static type checker encounters a call to ``assert_type()``, it emits " +"an error if the value is not of the specified type::" +msgstr "" + +msgid "" +"This function is useful for ensuring the type checker's understanding of a " +"script is in line with the developer's intentions::" +msgstr "" + +msgid "" +"Ask a static type checker to confirm that a line of code is unreachable." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +"Here, the annotations allow the type checker to infer that the last case can " +"never execute, because ``arg`` is either an :class:`int` or a :class:`str`, " +"and both options are covered by earlier cases." +msgstr "" + +msgid "" +"If a type checker finds that a call to ``assert_never()`` is reachable, it " +"will emit an error. For example, if the type annotation for ``arg`` was " +"instead ``int | str | float``, the type checker would emit an error pointing " +"out that ``unreachable`` is of type :class:`float`. For a call to " +"``assert_never`` to pass type checking, the inferred type of the argument " +"passed in must be the bottom type, :data:`Never`, and nothing else." +msgstr "" + +msgid "At runtime, this throws an exception when called." +msgstr "" + +msgid "" +"`Unreachable Code and Exhaustiveness Checking `__ has more information about " +"exhaustiveness checking with static typing." +msgstr "" + +msgid "Ask a static type checker to reveal the inferred type of an expression." +msgstr "" + +msgid "" +"When a static type checker encounters a call to this function, it emits a " +"diagnostic with the inferred type of the argument. For example::" +msgstr "" + +msgid "" +"This can be useful when you want to debug how your type checker handles a " +"particular piece of code." +msgstr "" + +msgid "" +"At runtime, this function prints the runtime type of its argument to :data:" +"`sys.stderr` and returns the argument unchanged (allowing the call to be " +"used within an expression)::" +msgstr "" + +msgid "" +"Note that the runtime type may be different from (more or less specific " +"than) the type statically inferred by a type checker." +msgstr "" + +msgid "" +"Most type checkers support ``reveal_type()`` anywhere, even if the name is " +"not imported from ``typing``. Importing the name from ``typing``, however, " +"allows your code to run without runtime errors and communicates intent more " +"clearly." +msgstr "" + +msgid "" +"Decorator to mark an object as providing :func:`dataclass `-like behavior." +msgstr "" + +msgid "" +"``dataclass_transform`` may be used to decorate a class, metaclass, or a " +"function that is itself a decorator. The presence of " +"``@dataclass_transform()`` tells a static type checker that the decorated " +"object performs runtime \"magic\" that transforms a class in a similar way " +"to :func:`@dataclasses.dataclass `." +msgstr "" + +msgid "Example usage with a decorator function:" +msgstr "" + +msgid "On a base class::" +msgstr "" + +msgid "On a metaclass::" +msgstr "" + +msgid "" +"The ``CustomerModel`` classes defined above will be treated by type checkers " +"similarly to classes created with :func:`@dataclasses.dataclass `. For example, type checkers will assume these classes have " +"``__init__`` methods that accept ``id`` and ``name``." +msgstr "" + +msgid "" +"The decorated class, metaclass, or function may accept the following bool " +"arguments which type checkers will assume have the same effect as they would " +"have on the :func:`@dataclasses.dataclass` decorator: " +"``init``, ``eq``, ``order``, ``unsafe_hash``, ``frozen``, ``match_args``, " +"``kw_only``, and ``slots``. It must be possible for the value of these " +"arguments (``True`` or ``False``) to be statically evaluated." +msgstr "" + +msgid "" +"The arguments to the ``dataclass_transform`` decorator can be used to " +"customize the default behaviors of the decorated class, metaclass, or " +"function:" +msgstr "" + +msgid "Parameters" +msgstr "parametry" + +msgid "" +"Indicates whether the ``eq`` parameter is assumed to be ``True`` or " +"``False`` if it is omitted by the caller. Defaults to ``True``." +msgstr "" + +msgid "" +"Indicates whether the ``order`` parameter is assumed to be ``True`` or " +"``False`` if it is omitted by the caller. Defaults to ``False``." +msgstr "" + +msgid "" +"Indicates whether the ``kw_only`` parameter is assumed to be ``True`` or " +"``False`` if it is omitted by the caller. Defaults to ``False``." +msgstr "" + +msgid "" +"Specifies a static list of supported classes or functions that describe " +"fields, similar to :func:`dataclasses.field`. Defaults to ``()``." +msgstr "" + +msgid "" +"Arbitrary other keyword arguments are accepted in order to allow for " +"possible future extensions." +msgstr "" + +msgid "" +"Type checkers recognize the following optional parameters on field " +"specifiers:" +msgstr "" + +msgid "**Recognised parameters for field specifiers**" +msgstr "" + +msgid "Parameter name" +msgstr "" + +msgid "Description" +msgstr "Opis" + +msgid "``init``" +msgstr "" + +msgid "" +"Indicates whether the field should be included in the synthesized " +"``__init__`` method. If unspecified, ``init`` defaults to ``True``." +msgstr "" + +msgid "``default``" +msgstr "" + +msgid "Provides the default value for the field." +msgstr "" + +msgid "``default_factory``" +msgstr "" + +msgid "" +"Provides a runtime callback that returns the default value for the field. If " +"neither ``default`` nor ``default_factory`` are specified, the field is " +"assumed to have no default value and must be provided a value when the class " +"is instantiated." +msgstr "" + +msgid "``factory``" +msgstr "" + +msgid "An alias for the ``default_factory`` parameter on field specifiers." +msgstr "" + +msgid "``kw_only``" +msgstr "" + +msgid "" +"Indicates whether the field should be marked as keyword-only. If ``True``, " +"the field will be keyword-only. If ``False``, it will not be keyword-only. " +"If unspecified, the value of the ``kw_only`` parameter on the object " +"decorated with ``dataclass_transform`` will be used, or if that is " +"unspecified, the value of ``kw_only_default`` on ``dataclass_transform`` " +"will be used." +msgstr "" + +msgid "``alias``" +msgstr "" + +msgid "" +"Provides an alternative name for the field. This alternative name is used in " +"the synthesized ``__init__`` method." +msgstr "" + +msgid "" +"At runtime, this decorator records its arguments in the " +"``__dataclass_transform__`` attribute on the decorated object. It has no " +"other runtime effect." +msgstr "" + +msgid "See :pep:`681` for more details." +msgstr "" + +msgid "Decorator for creating overloaded functions and methods." +msgstr "" + +msgid "" +"The ``@overload`` decorator allows describing functions and methods that " +"support multiple different combinations of argument types. A series of " +"``@overload``-decorated definitions must be followed by exactly one non-" +"``@overload``-decorated definition (for the same function/method)." +msgstr "" + +msgid "" +"``@overload``-decorated definitions are for the benefit of the type checker " +"only, since they will be overwritten by the non-``@overload``-decorated " +"definition. The non-``@overload``-decorated definition, meanwhile, will be " +"used at runtime but should be ignored by a type checker. At runtime, " +"calling an ``@overload``-decorated function directly will raise :exc:" +"`NotImplementedError`." +msgstr "" + +msgid "" +"An example of overload that gives a more precise type than can be expressed " +"using a union or a type variable:" +msgstr "" + +msgid "" +"See :pep:`484` for more details and comparison with other typing semantics." +msgstr "" + +msgid "" +"Overloaded functions can now be introspected at runtime using :func:" +"`get_overloads`." +msgstr "" + +msgid "" +"Return a sequence of :func:`@overload `-decorated definitions for " +"*func*." +msgstr "" + +msgid "" +"*func* is the function object for the implementation of the overloaded " +"function. For example, given the definition of ``process`` in the " +"documentation for :func:`@overload `, ``get_overloads(process)`` " +"will return a sequence of three function objects for the three defined " +"overloads. If called on a function with no overloads, ``get_overloads()`` " +"returns an empty sequence." +msgstr "" + +msgid "" +"``get_overloads()`` can be used for introspecting an overloaded function at " +"runtime." +msgstr "" + +msgid "Clear all registered overloads in the internal registry." +msgstr "" + +msgid "This can be used to reclaim the memory used by the registry." +msgstr "" + +msgid "Decorator to indicate final methods and final classes." +msgstr "" + +msgid "" +"Decorating a method with ``@final`` indicates to a type checker that the " +"method cannot be overridden in a subclass. Decorating a class with " +"``@final`` indicates that it cannot be subclassed." +msgstr "" + +msgid "" +"The decorator will now attempt to set a ``__final__`` attribute to ``True`` " +"on the decorated object. Thus, a check like ``if getattr(obj, \"__final__\", " +"False)`` can be used at runtime to determine whether an object ``obj`` has " +"been marked as final. If the decorated object does not support setting " +"attributes, the decorator returns the object unchanged without raising an " +"exception." +msgstr "" + +msgid "Decorator to indicate that annotations are not type hints." +msgstr "" + +msgid "" +"This works as a class or function :term:`decorator`. With a class, it " +"applies recursively to all methods and classes defined in that class (but " +"not to methods defined in its superclasses or subclasses). Type checkers " +"will ignore all annotations in a function or class with this decorator." +msgstr "" + +msgid "``@no_type_check`` mutates the decorated object in place." +msgstr "" + +msgid "Decorator to give another decorator the :func:`no_type_check` effect." +msgstr "" + +msgid "" +"This wraps the decorator with something that wraps the decorated function " +"in :func:`no_type_check`." +msgstr "" + +msgid "Decorator to mark a class or function as unavailable at runtime." +msgstr "" + +msgid "" +"This decorator is itself not available at runtime. It is mainly intended to " +"mark classes that are defined in type stub files if an implementation " +"returns an instance of a private class::" +msgstr "" + +msgid "" +"Note that returning instances of private classes is not recommended. It is " +"usually preferable to make such classes public." +msgstr "" + +msgid "Introspection helpers" +msgstr "" + +msgid "" +"Return a dictionary containing type hints for a function, method, module or " +"class object." +msgstr "" + +msgid "" +"This is often the same as ``obj.__annotations__``. In addition, forward " +"references encoded as string literals are handled by evaluating them in " +"``globals`` and ``locals`` namespaces. For a class ``C``, return a " +"dictionary constructed by merging all the ``__annotations__`` along ``C." +"__mro__`` in reverse order." +msgstr "" + +msgid "" +"The function recursively replaces all ``Annotated[T, ...]`` with ``T``, " +"unless ``include_extras`` is set to ``True`` (see :class:`Annotated` for " +"more information). For example:" +msgstr "" + +msgid "" +":func:`get_type_hints` does not work with imported :ref:`type aliases ` that include forward references. Enabling postponed evaluation of " +"annotations (:pep:`563`) may remove the need for most forward references." +msgstr "" + +msgid "" +"Added ``include_extras`` parameter as part of :pep:`593`. See the " +"documentation on :data:`Annotated` for more information." +msgstr "" + +msgid "" +"Previously, ``Optional[t]`` was added for function and method annotations if " +"a default value equal to ``None`` was set. Now the annotation is returned " +"unchanged." +msgstr "" + +msgid "" +"Get the unsubscripted version of a type: for a typing object of the form " +"``X[Y, Z, ...]`` return ``X``." +msgstr "" + +msgid "" +"If ``X`` is a typing-module alias for a builtin or :mod:`collections` class, " +"it will be normalized to the original class. If ``X`` is an instance of :" +"class:`ParamSpecArgs` or :class:`ParamSpecKwargs`, return the underlying :" +"class:`ParamSpec`. Return ``None`` for unsupported objects." +msgstr "" + +msgid "Examples:" +msgstr "Przykłady:" + +msgid "" +"Get type arguments with all substitutions performed: for a typing object of " +"the form ``X[Y, Z, ...]`` return ``(Y, Z, ...)``." +msgstr "" + +msgid "" +"If ``X`` is a union or :class:`Literal` contained in another generic type, " +"the order of ``(Y, Z, ...)`` may be different from the order of the original " +"arguments ``[Y, Z, ...]`` due to type caching. Return ``()`` for unsupported " +"objects." +msgstr "" + +msgid "Check if a type is a :class:`TypedDict`." +msgstr "" + +msgid "" +"Class used for internal typing representation of string forward references." +msgstr "" + +msgid "" +"For example, ``List[\"SomeClass\"]`` is implicitly transformed into " +"``List[ForwardRef(\"SomeClass\")]``. ``ForwardRef`` should not be " +"instantiated by a user, but may be used by introspection tools." +msgstr "" + +msgid "" +":pep:`585` generic types such as ``list[\"SomeClass\"]`` will not be " +"implicitly transformed into ``list[ForwardRef(\"SomeClass\")]`` and thus " +"will not automatically resolve to ``list[SomeClass]``." +msgstr "" + +msgid "Constant" +msgstr "Stała" + +msgid "" +"A special constant that is assumed to be ``True`` by 3rd party static type " +"checkers. It is ``False`` at runtime." +msgstr "" + +msgid "" +"The first type annotation must be enclosed in quotes, making it a \"forward " +"reference\", to hide the ``expensive_mod`` reference from the interpreter " +"runtime. Type annotations for local variables are not evaluated, so the " +"second annotation does not need to be enclosed in quotes." +msgstr "" + +msgid "" +"If ``from __future__ import annotations`` is used, annotations are not " +"evaluated at function definition time. Instead, they are stored as strings " +"in ``__annotations__``. This makes it unnecessary to use quotes around the " +"annotation (see :pep:`563`)." +msgstr "" + +msgid "Deprecated aliases" +msgstr "" + +msgid "" +"This module defines several deprecated aliases to pre-existing standard " +"library classes. These were originally included in the typing module in " +"order to support parameterizing these generic classes using ``[]``. However, " +"the aliases became redundant in Python 3.9 when the corresponding pre-" +"existing classes were enhanced to support ``[]`` (see :pep:`585`)." +msgstr "" + +msgid "" +"The redundant types are deprecated as of Python 3.9. However, while the " +"aliases may be removed at some point, removal of these aliases is not " +"currently planned. As such, no deprecation warnings are currently issued by " +"the interpreter for these aliases." +msgstr "" + +msgid "" +"If at some point it is decided to remove these deprecated aliases, a " +"deprecation warning will be issued by the interpreter for at least two " +"releases prior to removal. The aliases are guaranteed to remain in the " +"typing module without deprecation warnings until at least Python 3.14." +msgstr "" + +msgid "" +"Type checkers are encouraged to flag uses of the deprecated types if the " +"program they are checking targets a minimum Python version of 3.9 or newer." +msgstr "" + +msgid "Aliases to built-in types" +msgstr "" + +msgid "Deprecated alias to :class:`dict`." +msgstr "" + +msgid "" +"Note that to annotate arguments, it is preferred to use an abstract " +"collection type such as :class:`Mapping` rather than to use :class:`dict` " +"or :class:`!typing.Dict`." +msgstr "" + +msgid "This type can be used as follows::" +msgstr "" + +msgid "" +":class:`builtins.dict ` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`list`." +msgstr "" + +msgid "" +"Note that to annotate arguments, it is preferred to use an abstract " +"collection type such as :class:`Sequence` or :class:`Iterable` rather than " +"to use :class:`list` or :class:`!typing.List`." +msgstr "" + +msgid "This type may be used as follows::" +msgstr "" + +msgid "" +":class:`builtins.list ` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`builtins.set `." +msgstr "" + +msgid "" +"Note that to annotate arguments, it is preferred to use an abstract " +"collection type such as :class:`AbstractSet` rather than to use :class:`set` " +"or :class:`!typing.Set`." +msgstr "" + +msgid "" +":class:`builtins.set ` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`builtins.frozenset `." +msgstr "" + +msgid "" +":class:`builtins.frozenset ` now supports subscripting (``[]``). " +"See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias for :class:`tuple`." +msgstr "" + +msgid "" +":class:`tuple` and ``Tuple`` are special-cased in the type system; see :ref:" +"`annotating-tuples` for more details." +msgstr "" + +msgid "" +":class:`builtins.tuple ` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`type`." +msgstr "" + +msgid "" +"See :ref:`type-of-class-objects` for details on using :class:`type` or " +"``typing.Type`` in type annotations." +msgstr "" + +msgid "" +":class:`builtins.type ` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Aliases to types in :mod:`collections`" +msgstr "" + +msgid "Deprecated alias to :class:`collections.defaultdict`." +msgstr "" + +msgid "" +":class:`collections.defaultdict` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.OrderedDict`." +msgstr "" + +msgid "" +":class:`collections.OrderedDict` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.ChainMap`." +msgstr "" + +msgid "" +":class:`collections.ChainMap` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.Counter`." +msgstr "" + +msgid "" +":class:`collections.Counter` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.deque`." +msgstr "" + +msgid "" +":class:`collections.deque` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Aliases to other concrete types" +msgstr "" + +msgid "" +"Deprecated aliases corresponding to the return types from :func:`re.compile` " +"and :func:`re.match`." +msgstr "" + +msgid "" +"These types (and the corresponding functions) are generic over :data:" +"`AnyStr`. ``Pattern`` can be specialised as ``Pattern[str]`` or " +"``Pattern[bytes]``; ``Match`` can be specialised as ``Match[str]`` or " +"``Match[bytes]``." +msgstr "" + +msgid "" +"The ``typing.re`` namespace is deprecated and will be removed. These types " +"should be directly imported from ``typing`` instead." +msgstr "" + +msgid "" +"Classes ``Pattern`` and ``Match`` from :mod:`re` now support ``[]``. See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias for :class:`str`." +msgstr "" + +msgid "" +"``Text`` is provided to supply a forward compatible path for Python 2 code: " +"in Python 2, ``Text`` is an alias for ``unicode``." +msgstr "" + +msgid "" +"Use ``Text`` to indicate that a value must contain a unicode string in a " +"manner that is compatible with both Python 2 and Python 3::" +msgstr "" + +msgid "" +"Python 2 is no longer supported, and most type checkers also no longer " +"support type checking Python 2 code. Removal of the alias is not currently " +"planned, but users are encouraged to use :class:`str` instead of ``Text``." +msgstr "" + +msgid "Aliases to container ABCs in :mod:`collections.abc`" +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Set`." +msgstr "" + +msgid "" +":class:`collections.abc.Set` now supports subscripting (``[]``). See :pep:" +"`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "" +"This type represents the types :class:`bytes`, :class:`bytearray`, and :" +"class:`memoryview` of byte sequences." +msgstr "" + +msgid "" +"Prefer ``typing_extensions.Buffer``, or a union like ``bytes | bytearray | " +"memoryview``." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Collection`." +msgstr "" + +msgid "" +":class:`collections.abc.Collection` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Container`." +msgstr "" + +msgid "" +":class:`collections.abc.Container` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.ItemsView`." +msgstr "" + +msgid "" +":class:`collections.abc.ItemsView` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.KeysView`." +msgstr "" + +msgid "" +":class:`collections.abc.KeysView` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Mapping`." +msgstr "" + +msgid "" +":class:`collections.abc.Mapping` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.MappingView`." +msgstr "" + +msgid "" +":class:`collections.abc.MappingView` now supports subscripting (``[]``). " +"See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.MutableMapping`." +msgstr "" + +msgid "" +":class:`collections.abc.MutableMapping` now supports subscripting (``[]``). " +"See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.MutableSequence`." +msgstr "" + +msgid "" +":class:`collections.abc.MutableSequence` now supports subscripting (``[]``). " +"See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.MutableSet`." +msgstr "" + +msgid "" +":class:`collections.abc.MutableSet` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Sequence`." +msgstr "" + +msgid "" +":class:`collections.abc.Sequence` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.ValuesView`." +msgstr "" + +msgid "" +":class:`collections.abc.ValuesView` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Aliases to asynchronous ABCs in :mod:`collections.abc`" +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Coroutine`." +msgstr "" + +msgid "" +"The variance and order of type variables correspond to those of :class:" +"`Generator`, for example::" +msgstr "" + +msgid "" +":class:`collections.abc.Coroutine` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.AsyncGenerator`." +msgstr "" + +msgid "" +"An async generator can be annotated by the generic type " +"``AsyncGenerator[YieldType, SendType]``. For example::" +msgstr "" + +msgid "" +"Unlike normal generators, async generators cannot return a value, so there " +"is no ``ReturnType`` type parameter. As with :class:`Generator`, the " +"``SendType`` behaves contravariantly." +msgstr "" + +msgid "" +"If your generator will only yield values, set the ``SendType`` to ``None``::" +msgstr "" + +msgid "" +"Alternatively, annotate your generator as having a return type of either " +"``AsyncIterable[YieldType]`` or ``AsyncIterator[YieldType]``::" +msgstr "" + +msgid "" +":class:`collections.abc.AsyncGenerator` now supports subscripting (``[]``). " +"See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.AsyncIterable`." +msgstr "" + +msgid "" +":class:`collections.abc.AsyncIterable` now supports subscripting (``[]``). " +"See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.AsyncIterator`." +msgstr "" + +msgid "" +":class:`collections.abc.AsyncIterator` now supports subscripting (``[]``). " +"See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Awaitable`." +msgstr "" + +msgid "" +":class:`collections.abc.Awaitable` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Aliases to other ABCs in :mod:`collections.abc`" +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Iterable`." +msgstr "" + +msgid "" +":class:`collections.abc.Iterable` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Iterator`." +msgstr "" + +msgid "" +":class:`collections.abc.Iterator` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Callable`." +msgstr "" + +msgid "" +"See :ref:`annotating-callables` for details on how to use :class:" +"`collections.abc.Callable` and ``typing.Callable`` in type annotations." +msgstr "" + +msgid "" +":class:`collections.abc.Callable` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Generator`." +msgstr "" + +msgid "" +"A generator can be annotated by the generic type ``Generator[YieldType, " +"SendType, ReturnType]``. For example::" +msgstr "" + +msgid "" +"Note that unlike many other generics in the typing module, the ``SendType`` " +"of :class:`Generator` behaves contravariantly, not covariantly or " +"invariantly." +msgstr "" + +msgid "" +"If your generator will only yield values, set the ``SendType`` and " +"``ReturnType`` to ``None``::" +msgstr "" + +msgid "" +"Alternatively, annotate your generator as having a return type of either " +"``Iterable[YieldType]`` or ``Iterator[YieldType]``::" +msgstr "" + +msgid "" +":class:`collections.abc.Generator` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Alias to :class:`collections.abc.Hashable`." +msgstr "" + +msgid "Deprecated alias to :class:`collections.abc.Reversible`." +msgstr "" + +msgid "" +":class:`collections.abc.Reversible` now supports subscripting (``[]``). See :" +"pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Alias to :class:`collections.abc.Sized`." +msgstr "" + +msgid "Aliases to :mod:`contextlib` ABCs" +msgstr "" + +msgid "Deprecated alias to :class:`contextlib.AbstractContextManager`." +msgstr "" + +msgid "" +":class:`contextlib.AbstractContextManager` now supports subscripting " +"(``[]``). See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecated alias to :class:`contextlib.AbstractAsyncContextManager`." +msgstr "" + +msgid "" +":class:`contextlib.AbstractAsyncContextManager` now supports subscripting " +"(``[]``). See :pep:`585` and :ref:`types-genericalias`." +msgstr "" + +msgid "Deprecation Timeline of Major Features" +msgstr "" + +msgid "" +"Certain features in ``typing`` are deprecated and may be removed in a future " +"version of Python. The following table summarizes major deprecations for " +"your convenience. This is subject to change, and not all deprecations are " +"listed." +msgstr "" + +msgid "Feature" +msgstr "" + +msgid "Deprecated in" +msgstr "" + +msgid "Projected removal" +msgstr "" + +msgid "PEP/issue" +msgstr "PEP/issue" + +msgid "``typing.io`` and ``typing.re`` submodules" +msgstr "" + +msgid "3.8" +msgstr "" + +msgid "3.13" +msgstr "" + +msgid ":issue:`38291`" +msgstr "" + +msgid "``typing`` versions of standard collections" +msgstr "" + +msgid "3.9" +msgstr "" + +msgid "Undecided (see :ref:`deprecated-typing-aliases` for more information)" +msgstr "" + +msgid ":pep:`585`" +msgstr ":pep:`585`" + +msgid ":class:`typing.ByteString`" +msgstr ":class:`typing.ByteString`" + +msgid "3.14" +msgstr "" + +msgid ":gh:`91896`" +msgstr ":gh:`91896`" + +msgid ":data:`typing.Text`" +msgstr ":data:`typing.Text`" + +msgid "3.11" +msgstr "3.11" + +msgid "Undecided" +msgstr "" + +msgid ":gh:`92332`" +msgstr ":gh:`92332`" diff --git a/library/unicodedata.po b/library/unicodedata.po index a3374e1d66..0066f56da3 100644 --- a/library/unicodedata.po +++ b/library/unicodedata.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:16+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +160,7 @@ msgid "" msgstr "" msgid "Examples:" -msgstr "" +msgstr "Przykłady:" msgid "Footnotes" msgstr "Przypisy" diff --git a/library/unittest.mock-examples.po b/library/unittest.mock-examples.po new file mode 100644 index 0000000000..25440dcdab --- /dev/null +++ b/library/unittest.mock-examples.po @@ -0,0 +1,900 @@ +# 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:16+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:`unittest.mock` --- getting started" +msgstr "" + +msgid "Using Mock" +msgstr "" + +msgid "Mock Patching Methods" +msgstr "" + +msgid "Common uses for :class:`Mock` objects include:" +msgstr "" + +msgid "Patching methods" +msgstr "" + +msgid "Recording method calls on objects" +msgstr "" + +msgid "" +"You might want to replace a method on an object to check that it is called " +"with the correct arguments by another part of the system:" +msgstr "" + +msgid "" +"Once our mock has been used (``real.method`` in this example) it has methods " +"and attributes that allow you to make assertions about how it has been used." +msgstr "" + +msgid "" +"In most of these examples the :class:`Mock` and :class:`MagicMock` classes " +"are interchangeable. As the ``MagicMock`` is the more capable class it makes " +"a sensible one to use by default." +msgstr "" + +msgid "" +"Once the mock has been called its :attr:`~Mock.called` attribute is set to " +"``True``. More importantly we can use the :meth:`~Mock.assert_called_with` " +"or :meth:`~Mock.assert_called_once_with` method to check that it was called " +"with the correct arguments." +msgstr "" + +msgid "" +"This example tests that calling ``ProductionClass().method`` results in a " +"call to the ``something`` method:" +msgstr "" + +msgid "Mock for Method Calls on an Object" +msgstr "" + +msgid "" +"In the last example we patched a method directly on an object to check that " +"it was called correctly. Another common use case is to pass an object into a " +"method (or some part of the system under test) and then check that it is " +"used in the correct way." +msgstr "" + +msgid "" +"The simple ``ProductionClass`` below has a ``closer`` method. If it is " +"called with an object then it calls ``close`` on it." +msgstr "" + +msgid "" +"So to test it we need to pass in an object with a ``close`` method and check " +"that it was called correctly." +msgstr "" + +msgid "" +"We don't have to do any work to provide the 'close' method on our mock. " +"Accessing close creates it. So, if 'close' hasn't already been called then " +"accessing it in the test will create it, but :meth:`~Mock." +"assert_called_with` will raise a failure exception." +msgstr "" + +msgid "Mocking Classes" +msgstr "" + +msgid "" +"A common use case is to mock out classes instantiated by your code under " +"test. When you patch a class, then that class is replaced with a mock. " +"Instances are created by *calling the class*. This means you access the " +"\"mock instance\" by looking at the return value of the mocked class." +msgstr "" + +msgid "" +"In the example below we have a function ``some_function`` that instantiates " +"``Foo`` and calls a method on it. The call to :func:`patch` replaces the " +"class ``Foo`` with a mock. The ``Foo`` instance is the result of calling the " +"mock, so it is configured by modifying the mock :attr:`~Mock." +"return_value`. ::" +msgstr "" + +msgid "Naming your mocks" +msgstr "" + +msgid "" +"It can be useful to give your mocks a name. The name is shown in the repr of " +"the mock and can be helpful when the mock appears in test failure messages. " +"The name is also propagated to attributes or methods of the mock:" +msgstr "" + +msgid "Tracking all Calls" +msgstr "" + +msgid "" +"Often you want to track more than a single call to a method. The :attr:" +"`~Mock.mock_calls` attribute records all calls to child attributes of the " +"mock - and also to their children." +msgstr "" + +msgid "" +"If you make an assertion about ``mock_calls`` and any unexpected methods " +"have been called, then the assertion will fail. This is useful because as " +"well as asserting that the calls you expected have been made, you are also " +"checking that they were made in the right order and with no additional calls:" +msgstr "" + +msgid "" +"You use the :data:`call` object to construct lists for comparing with " +"``mock_calls``:" +msgstr "" + +msgid "" +"However, parameters to calls that return mocks are not recorded, which means " +"it is not possible to track nested calls where the parameters used to create " +"ancestors are important:" +msgstr "" + +msgid "Setting Return Values and Attributes" +msgstr "" + +msgid "Setting the return values on a mock object is trivially easy:" +msgstr "" + +msgid "Of course you can do the same for methods on the mock:" +msgstr "" + +msgid "The return value can also be set in the constructor:" +msgstr "" + +msgid "If you need an attribute setting on your mock, just do it:" +msgstr "" + +msgid "" +"Sometimes you want to mock up a more complex situation, like for example " +"``mock.connection.cursor().execute(\"SELECT 1\")``. If we wanted this call " +"to return a list, then we have to configure the result of the nested call." +msgstr "" + +msgid "" +"We can use :data:`call` to construct the set of calls in a \"chained call\" " +"like this for easy assertion afterwards:" +msgstr "" + +msgid "" +"It is the call to ``.call_list()`` that turns our call object into a list of " +"calls representing the chained calls." +msgstr "" + +msgid "Raising exceptions with mocks" +msgstr "" + +msgid "" +"A useful attribute is :attr:`~Mock.side_effect`. If you set this to an " +"exception class or instance then the exception will be raised when the mock " +"is called." +msgstr "" + +msgid "Side effect functions and iterables" +msgstr "" + +msgid "" +"``side_effect`` can also be set to a function or an iterable. The use case " +"for ``side_effect`` as an iterable is where your mock is going to be called " +"several times, and you want each call to return a different value. When you " +"set ``side_effect`` to an iterable every call to the mock returns the next " +"value from the iterable:" +msgstr "" + +msgid "" +"For more advanced use cases, like dynamically varying the return values " +"depending on what the mock is called with, ``side_effect`` can be a " +"function. The function will be called with the same arguments as the mock. " +"Whatever the function returns is what the call returns:" +msgstr "" + +msgid "Mocking asynchronous iterators" +msgstr "" + +msgid "" +"Since Python 3.8, ``AsyncMock`` and ``MagicMock`` have support to mock :ref:" +"`async-iterators` through ``__aiter__``. The :attr:`~Mock.return_value` " +"attribute of ``__aiter__`` can be used to set the return values to be used " +"for iteration." +msgstr "" + +msgid "Mocking asynchronous context manager" +msgstr "" + +msgid "" +"Since Python 3.8, ``AsyncMock`` and ``MagicMock`` have support to mock :ref:" +"`async-context-managers` through ``__aenter__`` and ``__aexit__``. By " +"default, ``__aenter__`` and ``__aexit__`` are ``AsyncMock`` instances that " +"return an async function." +msgstr "" + +msgid "Creating a Mock from an Existing Object" +msgstr "" + +msgid "" +"One problem with over use of mocking is that it couples your tests to the " +"implementation of your mocks rather than your real code. Suppose you have a " +"class that implements ``some_method``. In a test for another class, you " +"provide a mock of this object that *also* provides ``some_method``. If later " +"you refactor the first class, so that it no longer has ``some_method`` - " +"then your tests will continue to pass even though your code is now broken!" +msgstr "" + +msgid "" +":class:`Mock` allows you to provide an object as a specification for the " +"mock, using the *spec* keyword argument. Accessing methods / attributes on " +"the mock that don't exist on your specification object will immediately " +"raise an attribute error. If you change the implementation of your " +"specification, then tests that use that class will start failing immediately " +"without you having to instantiate the class in those tests." +msgstr "" + +msgid "" +"Using a specification also enables a smarter matching of calls made to the " +"mock, regardless of whether some parameters were passed as positional or " +"named arguments::" +msgstr "" + +msgid "" +"If you want this smarter matching to also work with method calls on the " +"mock, you can use :ref:`auto-speccing `." +msgstr "" + +msgid "" +"If you want a stronger form of specification that prevents the setting of " +"arbitrary attributes as well as the getting of them then you can use " +"*spec_set* instead of *spec*." +msgstr "" + +msgid "Patch Decorators" +msgstr "" + +msgid "" +"With :func:`patch` it matters that you patch objects in the namespace where " +"they are looked up. This is normally straightforward, but for a quick guide " +"read :ref:`where to patch `." +msgstr "" + +msgid "" +"A common need in tests is to patch a class attribute or a module attribute, " +"for example patching a builtin or patching a class in a module to test that " +"it is instantiated. Modules and classes are effectively global, so patching " +"on them has to be undone after the test or the patch will persist into other " +"tests and cause hard to diagnose problems." +msgstr "" + +msgid "" +"mock provides three convenient decorators for this: :func:`patch`, :func:" +"`patch.object` and :func:`patch.dict`. ``patch`` takes a single string, of " +"the form ``package.module.Class.attribute`` to specify the attribute you are " +"patching. It also optionally takes a value that you want the attribute (or " +"class or whatever) to be replaced with. 'patch.object' takes an object and " +"the name of the attribute you would like patched, plus optionally the value " +"to patch it with." +msgstr "" + +msgid "``patch.object``::" +msgstr "" + +msgid "" +"If you are patching a module (including :mod:`builtins`) then use :func:" +"`patch` instead of :func:`patch.object`:" +msgstr "" + +msgid "" +"The module name can be 'dotted', in the form ``package.module`` if needed::" +msgstr "" + +msgid "A nice pattern is to actually decorate test methods themselves:" +msgstr "" + +msgid "" +"If you want to patch with a Mock, you can use :func:`patch` with only one " +"argument (or :func:`patch.object` with two arguments). The mock will be " +"created for you and passed into the test function / method:" +msgstr "" + +msgid "You can stack up multiple patch decorators using this pattern::" +msgstr "" + +msgid "" +"When you nest patch decorators the mocks are passed in to the decorated " +"function in the same order they applied (the normal *Python* order that " +"decorators are applied). This means from the bottom up, so in the example " +"above the mock for ``test_module.ClassName2`` is passed in first." +msgstr "" + +msgid "" +"There is also :func:`patch.dict` for setting values in a dictionary just " +"during a scope and restoring the dictionary to its original state when the " +"test ends:" +msgstr "" + +msgid "" +"``patch``, ``patch.object`` and ``patch.dict`` can all be used as context " +"managers." +msgstr "" + +msgid "" +"Where you use :func:`patch` to create a mock for you, you can get a " +"reference to the mock using the \"as\" form of the with statement:" +msgstr "" + +msgid "" +"As an alternative ``patch``, ``patch.object`` and ``patch.dict`` can be used " +"as class decorators. When used in this way it is the same as applying the " +"decorator individually to every method whose name starts with \"test\"." +msgstr "" + +msgid "Further Examples" +msgstr "" + +msgid "Here are some more examples for some slightly more advanced scenarios." +msgstr "" + +msgid "Mocking chained calls" +msgstr "" + +msgid "" +"Mocking chained calls is actually straightforward with mock once you " +"understand the :attr:`~Mock.return_value` attribute. When a mock is called " +"for the first time, or you fetch its ``return_value`` before it has been " +"called, a new :class:`Mock` is created." +msgstr "" + +msgid "" +"This means that you can see how the object returned from a call to a mocked " +"object has been used by interrogating the ``return_value`` mock:" +msgstr "" + +msgid "" +"From here it is a simple step to configure and then make assertions about " +"chained calls. Of course another alternative is writing your code in a more " +"testable way in the first place..." +msgstr "" + +msgid "So, suppose we have some code that looks a little bit like this:" +msgstr "" + +msgid "" +"Assuming that ``BackendProvider`` is already well tested, how do we test " +"``method()``? Specifically, we want to test that the code section ``# more " +"code`` uses the response object in the correct way." +msgstr "" + +msgid "" +"As this chain of calls is made from an instance attribute we can monkey " +"patch the ``backend`` attribute on a ``Something`` instance. In this " +"particular case we are only interested in the return value from the final " +"call to ``start_call`` so we don't have much configuration to do. Let's " +"assume the object it returns is 'file-like', so we'll ensure that our " +"response object uses the builtin :func:`open` as its ``spec``." +msgstr "" + +msgid "" +"To do this we create a mock instance as our mock backend and create a mock " +"response object for it. To set the response as the return value for that " +"final ``start_call`` we could do this::" +msgstr "" + +msgid "" +"We can do that in a slightly nicer way using the :meth:`~Mock." +"configure_mock` method to directly set the return value for us::" +msgstr "" + +msgid "" +"With these we monkey patch the \"mock backend\" in place and can make the " +"real call::" +msgstr "" + +msgid "" +"Using :attr:`~Mock.mock_calls` we can check the chained call with a single " +"assert. A chained call is several calls in one line of code, so there will " +"be several entries in ``mock_calls``. We can use :meth:`call.call_list` to " +"create this list of calls for us::" +msgstr "" + +msgid "Partial mocking" +msgstr "" + +msgid "" +"In some tests I wanted to mock out a call to :meth:`datetime.date.today` to " +"return a known date, but I didn't want to prevent the code under test from " +"creating new date objects. Unfortunately :class:`datetime.date` is written " +"in C, and so I couldn't just monkey-patch out the static :meth:`date.today` " +"method." +msgstr "" + +msgid "" +"I found a simple way of doing this that involved effectively wrapping the " +"date class with a mock, but passing through calls to the constructor to the " +"real class (and returning real instances)." +msgstr "" + +msgid "" +"The :func:`patch decorator ` is used here to mock out the ``date`` " +"class in the module under test. The :attr:`side_effect` attribute on the " +"mock date class is then set to a lambda function that returns a real date. " +"When the mock date class is called a real date will be constructed and " +"returned by ``side_effect``. ::" +msgstr "" + +msgid "" +"Note that we don't patch :class:`datetime.date` globally, we patch ``date`` " +"in the module that *uses* it. See :ref:`where to patch `." +msgstr "" + +msgid "" +"When ``date.today()`` is called a known date is returned, but calls to the " +"``date(...)`` constructor still return normal dates. Without this you can " +"find yourself having to calculate an expected result using exactly the same " +"algorithm as the code under test, which is a classic testing anti-pattern." +msgstr "" + +msgid "" +"Calls to the date constructor are recorded in the ``mock_date`` attributes " +"(``call_count`` and friends) which may also be useful for your tests." +msgstr "" + +msgid "" +"An alternative way of dealing with mocking dates, or other builtin classes, " +"is discussed in `this blog entry `_." +msgstr "" + +msgid "Mocking a Generator Method" +msgstr "" + +msgid "" +"A Python generator is a function or method that uses the :keyword:`yield` " +"statement to return a series of values when iterated over [#]_." +msgstr "" + +msgid "" +"A generator method / function is called to return the generator object. It " +"is the generator object that is then iterated over. The protocol method for " +"iteration is :meth:`~container.__iter__`, so we can mock this using a :class:" +"`MagicMock`." +msgstr "" + +msgid "" +"Here's an example class with an \"iter\" method implemented as a generator:" +msgstr "" + +msgid "How would we mock this class, and in particular its \"iter\" method?" +msgstr "" + +msgid "" +"To configure the values returned from the iteration (implicit in the call " +"to :class:`list`), we need to configure the object returned by the call to " +"``foo.iter()``." +msgstr "" + +msgid "" +"There are also generator expressions and more `advanced uses `_ of generators, but we aren't concerned " +"about them here. A very good introduction to generators and how powerful " +"they are is: `Generator Tricks for Systems Programmers `_." +msgstr "" + +msgid "Applying the same patch to every test method" +msgstr "" + +msgid "" +"If you want several patches in place for multiple test methods the obvious " +"way is to apply the patch decorators to every method. This can feel like " +"unnecessary repetition. Instead, you can use :func:`patch` (in all its " +"various forms) as a class decorator. This applies the patches to all test " +"methods on the class. A test method is identified by methods whose names " +"start with ``test``::" +msgstr "" + +msgid "" +"An alternative way of managing patches is to use the :ref:`start-and-stop`. " +"These allow you to move the patching into your ``setUp`` and ``tearDown`` " +"methods. ::" +msgstr "" + +msgid "" +"If you use this technique you must ensure that the patching is \"undone\" by " +"calling ``stop``. This can be fiddlier than you might think, because if an " +"exception is raised in the setUp then tearDown is not called. :meth:" +"`unittest.TestCase.addCleanup` makes this easier::" +msgstr "" + +msgid "Mocking Unbound Methods" +msgstr "" + +msgid "" +"Whilst writing tests today I needed to patch an *unbound method* (patching " +"the method on the class rather than on the instance). I needed self to be " +"passed in as the first argument because I want to make asserts about which " +"objects were calling this particular method. The issue is that you can't " +"patch with a mock for this, because if you replace an unbound method with a " +"mock it doesn't become a bound method when fetched from the instance, and so " +"it doesn't get self passed in. The workaround is to patch the unbound method " +"with a real function instead. The :func:`patch` decorator makes it so simple " +"to patch out methods with a mock that having to create a real function " +"becomes a nuisance." +msgstr "" + +msgid "" +"If you pass ``autospec=True`` to patch then it does the patching with a " +"*real* function object. This function object has the same signature as the " +"one it is replacing, but delegates to a mock under the hood. You still get " +"your mock auto-created in exactly the same way as before. What it means " +"though, is that if you use it to patch out an unbound method on a class the " +"mocked function will be turned into a bound method if it is fetched from an " +"instance. It will have ``self`` passed in as the first argument, which is " +"exactly what I wanted:" +msgstr "" + +msgid "" +"If we don't use ``autospec=True`` then the unbound method is patched out " +"with a Mock instance instead, and isn't called with ``self``." +msgstr "" + +msgid "Checking multiple calls with mock" +msgstr "" + +msgid "" +"mock has a nice API for making assertions about how your mock objects are " +"used." +msgstr "" + +msgid "" +"If your mock is only being called once you can use the :meth:" +"`assert_called_once_with` method that also asserts that the :attr:" +"`call_count` is one." +msgstr "" + +msgid "" +"Both ``assert_called_with`` and ``assert_called_once_with`` make assertions " +"about the *most recent* call. If your mock is going to be called several " +"times, and you want to make assertions about *all* those calls you can use :" +"attr:`~Mock.call_args_list`:" +msgstr "" + +msgid "" +"The :data:`call` helper makes it easy to make assertions about these calls. " +"You can build up a list of expected calls and compare it to " +"``call_args_list``. This looks remarkably similar to the repr of the " +"``call_args_list``:" +msgstr "" + +msgid "Coping with mutable arguments" +msgstr "" + +msgid "" +"Another situation is rare, but can bite you, is when your mock is called " +"with mutable arguments. ``call_args`` and ``call_args_list`` store " +"*references* to the arguments. If the arguments are mutated by the code " +"under test then you can no longer make assertions about what the values were " +"when the mock was called." +msgstr "" + +msgid "" +"Here's some example code that shows the problem. Imagine the following " +"functions defined in 'mymodule'::" +msgstr "" + +msgid "" +"When we try to test that ``grob`` calls ``frob`` with the correct argument " +"look what happens::" +msgstr "" + +msgid "" +"One possibility would be for mock to copy the arguments you pass in. This " +"could then cause problems if you do assertions that rely on object identity " +"for equality." +msgstr "" + +msgid "" +"Here's one solution that uses the :attr:`side_effect` functionality. If you " +"provide a ``side_effect`` function for a mock then ``side_effect`` will be " +"called with the same args as the mock. This gives us an opportunity to copy " +"the arguments and store them for later assertions. In this example I'm using " +"*another* mock to store the arguments so that I can use the mock methods for " +"doing the assertion. Again a helper function sets this up for me. ::" +msgstr "" + +msgid "" +"``copy_call_args`` is called with the mock that will be called. It returns a " +"new mock that we do the assertion on. The ``side_effect`` function makes a " +"copy of the args and calls our ``new_mock`` with the copy." +msgstr "" + +msgid "" +"If your mock is only going to be used once there is an easier way of " +"checking arguments at the point they are called. You can simply do the " +"checking inside a ``side_effect`` function." +msgstr "" + +msgid "" +"An alternative approach is to create a subclass of :class:`Mock` or :class:" +"`MagicMock` that copies (using :func:`copy.deepcopy`) the arguments. Here's " +"an example implementation:" +msgstr "" + +msgid "" +"When you subclass ``Mock`` or ``MagicMock`` all dynamically created " +"attributes, and the ``return_value`` will use your subclass automatically. " +"That means all children of a ``CopyingMock`` will also have the type " +"``CopyingMock``." +msgstr "" + +msgid "Nesting Patches" +msgstr "" + +msgid "" +"Using patch as a context manager is nice, but if you do multiple patches you " +"can end up with nested with statements indenting further and further to the " +"right::" +msgstr "" + +msgid "" +"With unittest ``cleanup`` functions and the :ref:`start-and-stop` we can " +"achieve the same effect without the nested indentation. A simple helper " +"method, ``create_patch``, puts the patch in place and returns the created " +"mock for us::" +msgstr "" + +msgid "Mocking a dictionary with MagicMock" +msgstr "" + +msgid "" +"You may want to mock a dictionary, or other container object, recording all " +"access to it whilst having it still behave like a dictionary." +msgstr "" + +msgid "" +"We can do this with :class:`MagicMock`, which will behave like a dictionary, " +"and using :data:`~Mock.side_effect` to delegate dictionary access to a real " +"underlying dictionary that is under our control." +msgstr "" + +msgid "" +"When the :meth:`__getitem__` and :meth:`__setitem__` methods of our " +"``MagicMock`` are called (normal dictionary access) then ``side_effect`` is " +"called with the key (and in the case of ``__setitem__`` the value too). We " +"can also control what is returned." +msgstr "" + +msgid "" +"After the ``MagicMock`` has been used we can use attributes like :data:" +"`~Mock.call_args_list` to assert about how the dictionary was used:" +msgstr "" + +msgid "" +"An alternative to using ``MagicMock`` is to use ``Mock`` and *only* provide " +"the magic methods you specifically want:" +msgstr "" + +msgid "" +"A *third* option is to use ``MagicMock`` but passing in ``dict`` as the " +"*spec* (or *spec_set*) argument so that the ``MagicMock`` created only has " +"dictionary magic methods available:" +msgstr "" + +msgid "" +"With these side effect functions in place, the ``mock`` will behave like a " +"normal dictionary but recording the access. It even raises a :exc:`KeyError` " +"if you try to access a key that doesn't exist." +msgstr "" + +msgid "" +"After it has been used you can make assertions about the access using the " +"normal mock methods and attributes:" +msgstr "" + +msgid "Mock subclasses and their attributes" +msgstr "" + +msgid "" +"There are various reasons why you might want to subclass :class:`Mock`. One " +"reason might be to add helper methods. Here's a silly example:" +msgstr "" + +msgid "" +"The standard behaviour for ``Mock`` instances is that attributes and the " +"return value mocks are of the same type as the mock they are accessed on. " +"This ensures that ``Mock`` attributes are ``Mocks`` and ``MagicMock`` " +"attributes are ``MagicMocks`` [#]_. So if you're subclassing to add helper " +"methods then they'll also be available on the attributes and return value " +"mock of instances of your subclass." +msgstr "" + +msgid "" +"Sometimes this is inconvenient. For example, `one user `_ is subclassing mock to created a `Twisted " +"adaptor `_. Having this applied to attributes too actually causes errors." +msgstr "" + +msgid "" +"``Mock`` (in all its flavours) uses a method called ``_get_child_mock`` to " +"create these \"sub-mocks\" for attributes and return values. You can prevent " +"your subclass being used for attributes by overriding this method. The " +"signature is that it takes arbitrary keyword arguments (``**kwargs``) which " +"are then passed onto the mock constructor:" +msgstr "" + +msgid "" +"An exception to this rule are the non-callable mocks. Attributes use the " +"callable variant because otherwise non-callable mocks couldn't have callable " +"methods." +msgstr "" + +msgid "Mocking imports with patch.dict" +msgstr "" + +msgid "" +"One situation where mocking can be hard is where you have a local import " +"inside a function. These are harder to mock because they aren't using an " +"object from the module namespace that we can patch out." +msgstr "" + +msgid "" +"Generally local imports are to be avoided. They are sometimes done to " +"prevent circular dependencies, for which there is *usually* a much better " +"way to solve the problem (refactor the code) or to prevent \"up front " +"costs\" by delaying the import. This can also be solved in better ways than " +"an unconditional local import (store the module as a class or module " +"attribute and only do the import on first use)." +msgstr "" + +msgid "" +"That aside there is a way to use ``mock`` to affect the results of an " +"import. Importing fetches an *object* from the :data:`sys.modules` " +"dictionary. Note that it fetches an *object*, which need not be a module. " +"Importing a module for the first time results in a module object being put " +"in ``sys.modules``, so usually when you import something you get a module " +"back. This need not be the case however." +msgstr "" + +msgid "" +"This means you can use :func:`patch.dict` to *temporarily* put a mock in " +"place in :data:`sys.modules`. Any imports whilst this patch is active will " +"fetch the mock. When the patch is complete (the decorated function exits, " +"the with statement body is complete or ``patcher.stop()`` is called) then " +"whatever was there previously will be restored safely." +msgstr "" + +msgid "Here's an example that mocks out the 'fooble' module." +msgstr "" + +msgid "" +"As you can see the ``import fooble`` succeeds, but on exit there is no " +"'fooble' left in :data:`sys.modules`." +msgstr "" + +msgid "This also works for the ``from module import name`` form:" +msgstr "" + +msgid "With slightly more work you can also mock package imports:" +msgstr "" + +msgid "Tracking order of calls and less verbose call assertions" +msgstr "" + +msgid "" +"The :class:`Mock` class allows you to track the *order* of method calls on " +"your mock objects through the :attr:`~Mock.method_calls` attribute. This " +"doesn't allow you to track the order of calls between separate mock objects, " +"however we can use :attr:`~Mock.mock_calls` to achieve the same effect." +msgstr "" + +msgid "" +"Because mocks track calls to child mocks in ``mock_calls``, and accessing an " +"arbitrary attribute of a mock creates a child mock, we can create our " +"separate mocks from a parent one. Calls to those child mock will then all be " +"recorded, in order, in the ``mock_calls`` of the parent:" +msgstr "" + +msgid "" +"We can then assert about the calls, including the order, by comparing with " +"the ``mock_calls`` attribute on the manager mock:" +msgstr "" + +msgid "" +"If ``patch`` is creating, and putting in place, your mocks then you can " +"attach them to a manager mock using the :meth:`~Mock.attach_mock` method. " +"After attaching calls will be recorded in ``mock_calls`` of the manager. ::" +msgstr "" + +msgid "" +"If many calls have been made, but you're only interested in a particular " +"sequence of them then an alternative is to use the :meth:`~Mock." +"assert_has_calls` method. This takes a list of calls (constructed with the :" +"data:`call` object). If that sequence of calls are in :attr:`~Mock." +"mock_calls` then the assert succeeds." +msgstr "" + +msgid "" +"Even though the chained call ``m.one().two().three()`` aren't the only calls " +"that have been made to the mock, the assert still succeeds." +msgstr "" + +msgid "" +"Sometimes a mock may have several calls made to it, and you are only " +"interested in asserting about *some* of those calls. You may not even care " +"about the order. In this case you can pass ``any_order=True`` to " +"``assert_has_calls``:" +msgstr "" + +msgid "More complex argument matching" +msgstr "" + +msgid "" +"Using the same basic concept as :data:`ANY` we can implement matchers to do " +"more complex assertions on objects used as arguments to mocks." +msgstr "" + +msgid "" +"Suppose we expect some object to be passed to a mock that by default " +"compares equal based on object identity (which is the Python default for " +"user defined classes). To use :meth:`~Mock.assert_called_with` we would need " +"to pass in the exact same object. If we are only interested in some of the " +"attributes of this object then we can create a matcher that will check these " +"attributes for us." +msgstr "" + +msgid "" +"You can see in this example how a 'standard' call to ``assert_called_with`` " +"isn't sufficient:" +msgstr "" + +msgid "" +"A comparison function for our ``Foo`` class might look something like this:" +msgstr "" + +msgid "" +"And a matcher object that can use comparison functions like this for its " +"equality operation would look something like this:" +msgstr "" + +msgid "Putting all this together:" +msgstr "" + +msgid "" +"The ``Matcher`` is instantiated with our compare function and the ``Foo`` " +"object we want to compare against. In ``assert_called_with`` the ``Matcher`` " +"equality method will be called, which compares the object the mock was " +"called with against the one we created our matcher with. If they match then " +"``assert_called_with`` passes, and if they don't an :exc:`AssertionError` is " +"raised:" +msgstr "" + +msgid "" +"With a bit of tweaking you could have the comparison function raise the :exc:" +"`AssertionError` directly and provide a more useful failure message." +msgstr "" + +msgid "" +"As of version 1.5, the Python testing library `PyHamcrest `_ provides similar functionality, that may be " +"useful here, in the form of its equality matcher (`hamcrest.library." +"integration.match_equality `_)." +msgstr "" diff --git a/library/unittest.mock.po b/library/unittest.mock.po new file mode 100644 index 0000000000..eef805c1fb --- /dev/null +++ b/library/unittest.mock.po @@ -0,0 +1,2091 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`unittest.mock` --- mock object library" +msgstr "" + +msgid "**Source code:** :source:`Lib/unittest/mock.py`" +msgstr "" + +msgid "" +":mod:`unittest.mock` is a library for testing in Python. It allows you to " +"replace parts of your system under test with mock objects and make " +"assertions about how they have been used." +msgstr "" + +msgid "" +":mod:`unittest.mock` provides a core :class:`Mock` class removing the need " +"to create a host of stubs throughout your test suite. After performing an " +"action, you can make assertions about which methods / attributes were used " +"and arguments they were called with. You can also specify return values and " +"set needed attributes in the normal way." +msgstr "" + +msgid "" +"Additionally, mock provides a :func:`patch` decorator that handles patching " +"module and class level attributes within the scope of a test, along with :" +"const:`sentinel` for creating unique objects. See the `quick guide`_ for " +"some examples of how to use :class:`Mock`, :class:`MagicMock` and :func:" +"`patch`." +msgstr "" + +msgid "" +"Mock is designed for use with :mod:`unittest` and is based on the 'action -> " +"assertion' pattern instead of 'record -> replay' used by many mocking " +"frameworks." +msgstr "" + +msgid "" +"There is a backport of :mod:`unittest.mock` for earlier versions of Python, " +"available as `mock on PyPI `_." +msgstr "" + +msgid "Quick Guide" +msgstr "" + +msgid "" +":class:`Mock` and :class:`MagicMock` objects create all attributes and " +"methods as you access them and store details of how they have been used. You " +"can configure them, to specify return values or limit what attributes are " +"available, and then make assertions about how they have been used:" +msgstr "" + +msgid "" +":attr:`side_effect` allows you to perform side effects, including raising an " +"exception when a mock is called:" +msgstr "" + +msgid "" +"Mock has many other ways you can configure it and control its behaviour. For " +"example the *spec* argument configures the mock to take its specification " +"from another object. Attempting to access attributes or methods on the mock " +"that don't exist on the spec will fail with an :exc:`AttributeError`." +msgstr "" + +msgid "" +"The :func:`patch` decorator / context manager makes it easy to mock classes " +"or objects in a module under test. The object you specify will be replaced " +"with a mock (or other object) during the test and restored when the test " +"ends::" +msgstr "" + +msgid "" +"When you nest patch decorators the mocks are passed in to the decorated " +"function in the same order they applied (the normal *Python* order that " +"decorators are applied). This means from the bottom up, so in the example " +"above the mock for ``module.ClassName1`` is passed in first." +msgstr "" + +msgid "" +"With :func:`patch` it matters that you patch objects in the namespace where " +"they are looked up. This is normally straightforward, but for a quick guide " +"read :ref:`where to patch `." +msgstr "" + +msgid "" +"As well as a decorator :func:`patch` can be used as a context manager in a " +"with statement:" +msgstr "" + +msgid "" +"There is also :func:`patch.dict` for setting values in a dictionary just " +"during a scope and restoring the dictionary to its original state when the " +"test ends:" +msgstr "" + +msgid "" +"Mock supports the mocking of Python :ref:`magic methods `. " +"The easiest way of using magic methods is with the :class:`MagicMock` class. " +"It allows you to do things like:" +msgstr "" + +msgid "" +"Mock allows you to assign functions (or other Mock instances) to magic " +"methods and they will be called appropriately. The :class:`MagicMock` class " +"is just a Mock variant that has all of the magic methods pre-created for you " +"(well, all the useful ones anyway)." +msgstr "" + +msgid "" +"The following is an example of using magic methods with the ordinary Mock " +"class:" +msgstr "" + +msgid "" +"For ensuring that the mock objects in your tests have the same api as the " +"objects they are replacing, you can use :ref:`auto-speccing `. Auto-speccing can be done through the *autospec* argument to " +"patch, or the :func:`create_autospec` function. Auto-speccing creates mock " +"objects that have the same attributes and methods as the objects they are " +"replacing, and any functions and methods (including constructors) have the " +"same call signature as the real object." +msgstr "" + +msgid "" +"This ensures that your mocks will fail in the same way as your production " +"code if they are used incorrectly:" +msgstr "" + +msgid "" +":func:`create_autospec` can also be used on classes, where it copies the " +"signature of the ``__init__`` method, and on callable objects where it " +"copies the signature of the ``__call__`` method." +msgstr "" + +msgid "The Mock Class" +msgstr "" + +msgid "" +":class:`Mock` is a flexible mock object intended to replace the use of stubs " +"and test doubles throughout your code. Mocks are callable and create " +"attributes as new mocks when you access them [#]_. Accessing the same " +"attribute will always return the same mock. Mocks record how you use them, " +"allowing you to make assertions about what your code has done to them." +msgstr "" + +msgid "" +":class:`MagicMock` is a subclass of :class:`Mock` with all the magic methods " +"pre-created and ready to use. There are also non-callable variants, useful " +"when you are mocking out objects that aren't callable: :class:" +"`NonCallableMock` and :class:`NonCallableMagicMock`" +msgstr "" + +msgid "" +"The :func:`patch` decorators makes it easy to temporarily replace classes in " +"a particular module with a :class:`Mock` object. By default :func:`patch` " +"will create a :class:`MagicMock` for you. You can specify an alternative " +"class of :class:`Mock` using the *new_callable* argument to :func:`patch`." +msgstr "" + +msgid "" +"Create a new :class:`Mock` object. :class:`Mock` takes several optional " +"arguments that specify the behaviour of the Mock object:" +msgstr "" + +msgid "" +"*spec*: This can be either a list of strings or an existing object (a class " +"or instance) that acts as the specification for the mock object. If you pass " +"in an object then a list of strings is formed by calling dir on the object " +"(excluding unsupported magic attributes and methods). Accessing any " +"attribute not in this list will raise an :exc:`AttributeError`." +msgstr "" + +msgid "" +"If *spec* is an object (rather than a list of strings) then :attr:`~instance." +"__class__` returns the class of the spec object. This allows mocks to pass :" +"func:`isinstance` tests." +msgstr "" + +msgid "" +"*spec_set*: A stricter variant of *spec*. If used, attempting to *set* or " +"get an attribute on the mock that isn't on the object passed as *spec_set* " +"will raise an :exc:`AttributeError`." +msgstr "" + +msgid "" +"*side_effect*: A function to be called whenever the Mock is called. See the :" +"attr:`~Mock.side_effect` attribute. Useful for raising exceptions or " +"dynamically changing return values. The function is called with the same " +"arguments as the mock, and unless it returns :data:`DEFAULT`, the return " +"value of this function is used as the return value." +msgstr "" + +msgid "" +"Alternatively *side_effect* can be an exception class or instance. In this " +"case the exception will be raised when the mock is called." +msgstr "" + +msgid "" +"If *side_effect* is an iterable then each call to the mock will return the " +"next value from the iterable." +msgstr "" + +msgid "A *side_effect* can be cleared by setting it to ``None``." +msgstr "" + +msgid "" +"*return_value*: The value returned when the mock is called. By default this " +"is a new Mock (created on first access). See the :attr:`return_value` " +"attribute." +msgstr "" + +msgid "" +"*unsafe*: By default, accessing any attribute whose name starts with " +"*assert*, *assret*, *asert*, *aseert* or *assrt* will raise an :exc:" +"`AttributeError`. Passing ``unsafe=True`` will allow access to these " +"attributes." +msgstr "" + +msgid "" +"*wraps*: Item for the mock object to wrap. If *wraps* is not ``None`` then " +"calling the Mock will pass the call through to the wrapped object (returning " +"the real result). Attribute access on the mock will return a Mock object " +"that wraps the corresponding attribute of the wrapped object (so attempting " +"to access an attribute that doesn't exist will raise an :exc:" +"`AttributeError`)." +msgstr "" + +msgid "" +"If the mock has an explicit *return_value* set then calls are not passed to " +"the wrapped object and the *return_value* is returned instead." +msgstr "" + +msgid "" +"*name*: If the mock has a name then it will be used in the repr of the mock. " +"This can be useful for debugging. The name is propagated to child mocks." +msgstr "" + +msgid "" +"Mocks can also be called with arbitrary keyword arguments. These will be " +"used to set attributes on the mock after it is created. See the :meth:" +"`configure_mock` method for details." +msgstr "" + +msgid "Assert that the mock was called at least once." +msgstr "" + +msgid "Assert that the mock was called exactly once." +msgstr "" + +msgid "" +"This method is a convenient way of asserting that the last call has been " +"made in a particular way:" +msgstr "" + +msgid "" +"Assert that the mock was called exactly once and that call was with the " +"specified arguments." +msgstr "" + +msgid "assert the mock has been called with the specified arguments." +msgstr "" + +msgid "" +"The assert passes if the mock has *ever* been called, unlike :meth:" +"`assert_called_with` and :meth:`assert_called_once_with` that only pass if " +"the call is the most recent one, and in the case of :meth:" +"`assert_called_once_with` it must also be the only call." +msgstr "" + +msgid "" +"assert the mock has been called with the specified calls. The :attr:" +"`mock_calls` list is checked for the calls." +msgstr "" + +msgid "" +"If *any_order* is false then the calls must be sequential. There can be " +"extra calls before or after the specified calls." +msgstr "" + +msgid "" +"If *any_order* is true then the calls can be in any order, but they must all " +"appear in :attr:`mock_calls`." +msgstr "" + +msgid "Assert the mock was never called." +msgstr "" + +msgid "The reset_mock method resets all the call attributes on a mock object:" +msgstr "" + +msgid "Added two keyword-only arguments to the reset_mock function." +msgstr "" + +msgid "" +"This can be useful where you want to make a series of assertions that reuse " +"the same object. Note that :meth:`reset_mock` *doesn't* clear the return " +"value, :attr:`side_effect` or any child attributes you have set using normal " +"assignment by default. In case you want to reset *return_value* or :attr:" +"`side_effect`, then pass the corresponding parameter as ``True``. Child " +"mocks and the return value mock (if any) are reset as well." +msgstr "" + +msgid "*return_value*, and :attr:`side_effect` are keyword-only arguments." +msgstr "" + +msgid "" +"Add a spec to a mock. *spec* can either be an object or a list of strings. " +"Only attributes on the *spec* can be fetched as attributes from the mock." +msgstr "" + +msgid "If *spec_set* is true then only attributes on the spec can be set." +msgstr "" + +msgid "" +"Attach a mock as an attribute of this one, replacing its name and parent. " +"Calls to the attached mock will be recorded in the :attr:`method_calls` and :" +"attr:`mock_calls` attributes of this one." +msgstr "" + +msgid "Set attributes on the mock through keyword arguments." +msgstr "" + +msgid "" +"Attributes plus return values and side effects can be set on child mocks " +"using standard dot notation and unpacking a dictionary in the method call:" +msgstr "" + +msgid "The same thing can be achieved in the constructor call to mocks:" +msgstr "" + +msgid "" +":meth:`configure_mock` exists to make it easier to do configuration after " +"the mock has been created." +msgstr "" + +msgid "" +":class:`Mock` objects limit the results of ``dir(some_mock)`` to useful " +"results. For mocks with a *spec* this includes all the permitted attributes " +"for the mock." +msgstr "" + +msgid "" +"See :data:`FILTER_DIR` for what this filtering does, and how to switch it " +"off." +msgstr "" + +msgid "" +"Create the child mocks for attributes and return value. By default child " +"mocks will be the same type as the parent. Subclasses of Mock may want to " +"override this to customize the way child mocks are made." +msgstr "" + +msgid "" +"For non-callable mocks the callable variant will be used (rather than any " +"custom subclass)." +msgstr "" + +msgid "A boolean representing whether or not the mock object has been called:" +msgstr "" + +msgid "An integer telling you how many times the mock object has been called:" +msgstr "" + +msgid "Set this to configure the value returned by calling the mock:" +msgstr "" + +msgid "" +"The default return value is a mock object and you can configure it in the " +"normal way:" +msgstr "" + +msgid ":attr:`return_value` can also be set in the constructor:" +msgstr "" + +msgid "" +"This can either be a function to be called when the mock is called, an " +"iterable or an exception (class or instance) to be raised." +msgstr "" +"Może to być albo funkcja do wywołania, gdy wywoływany jest mock, iterable " +"lub wyjątek (klasa lub instancja) do rzucenia." + +msgid "" +"If you pass in a function it will be called with same arguments as the mock " +"and unless the function returns the :data:`DEFAULT` singleton the call to " +"the mock will then return whatever the function returns. If the function " +"returns :data:`DEFAULT` then the mock will return its normal value (from " +"the :attr:`return_value`)." +msgstr "" +"Jeśli przekażesz funkcję, zostanie ona wywołana z tymi samymi argumentami co " +"mock i dopóki funkcja nie zwróci singletona :data:`DEFAULT`, wywołanie mocka " +"będzie zwracać cokolwiek zwraca funkcja. Jeśli funkcja zwróci :data:" +"`DEFAULT`, to mock zwróci swoją normalną wartość (z :attr:`return_value`)." + +msgid "" +"If you pass in an iterable, it is used to retrieve an iterator which must " +"yield a value on every call. This value can either be an exception instance " +"to be raised, or a value to be returned from the call to the mock (:data:" +"`DEFAULT` handling is identical to the function case)." +msgstr "" +"Jeśli przekażesz iterable, zostanie on użyty do pobrania iteratora, który " +"musi zwrócić wartość przy każdym wywołaniu. Wartość ta może być albo " +"instancją wyjątku, która ma być rzucony, albo wartością, która ma być " +"zwrócona z wywołania mocka (obsługa :data:`DEFAULT` jest identyczna do " +"przypadku funkcji)." + +msgid "" +"An example of a mock that raises an exception (to test exception handling of " +"an API):" +msgstr "" + +msgid "Using :attr:`side_effect` to return a sequence of values:" +msgstr "" + +msgid "Using a callable:" +msgstr "" + +msgid "" +":attr:`side_effect` can be set in the constructor. Here's an example that " +"adds one to the value the mock is called with and returns it:" +msgstr "" + +msgid "Setting :attr:`side_effect` to ``None`` clears it:" +msgstr "" + +msgid "" +"This is either ``None`` (if the mock hasn't been called), or the arguments " +"that the mock was last called with. This will be in the form of a tuple: the " +"first member, which can also be accessed through the ``args`` property, is " +"any ordered arguments the mock was called with (or an empty tuple) and the " +"second member, which can also be accessed through the ``kwargs`` property, " +"is any keyword arguments (or an empty dictionary)." +msgstr "" + +msgid "" +":attr:`call_args`, along with members of the lists :attr:`call_args_list`, :" +"attr:`method_calls` and :attr:`mock_calls` are :data:`call` objects. These " +"are tuples, so they can be unpacked to get at the individual arguments and " +"make more complex assertions. See :ref:`calls as tuples `." +msgstr "" + +msgid "Added ``args`` and ``kwargs`` properties." +msgstr "" + +msgid "" +"This is a list of all the calls made to the mock object in sequence (so the " +"length of the list is the number of times it has been called). Before any " +"calls have been made it is an empty list. The :data:`call` object can be " +"used for conveniently constructing lists of calls to compare with :attr:" +"`call_args_list`." +msgstr "" + +msgid "" +"Members of :attr:`call_args_list` are :data:`call` objects. These can be " +"unpacked as tuples to get at the individual arguments. See :ref:`calls as " +"tuples `." +msgstr "" + +msgid "" +"As well as tracking calls to themselves, mocks also track calls to methods " +"and attributes, and *their* methods and attributes:" +msgstr "" + +msgid "" +"Members of :attr:`method_calls` are :data:`call` objects. These can be " +"unpacked as tuples to get at the individual arguments. See :ref:`calls as " +"tuples `." +msgstr "" + +msgid "" +":attr:`mock_calls` records *all* calls to the mock object, its methods, " +"magic methods *and* return value mocks." +msgstr "" + +msgid "" +"Members of :attr:`mock_calls` are :data:`call` objects. These can be " +"unpacked as tuples to get at the individual arguments. See :ref:`calls as " +"tuples `." +msgstr "" + +msgid "" +"The way :attr:`mock_calls` are recorded means that where nested calls are " +"made, the parameters of ancestor calls are not recorded and so will always " +"compare equal:" +msgstr "" + +msgid "" +"Normally the :attr:`__class__` attribute of an object will return its type. " +"For a mock object with a :attr:`spec`, ``__class__`` returns the spec class " +"instead. This allows mock objects to pass :func:`isinstance` tests for the " +"object they are replacing / masquerading as:" +msgstr "" + +msgid "" +":attr:`__class__` is assignable to, this allows a mock to pass an :func:" +"`isinstance` check without forcing you to use a spec:" +msgstr "" + +msgid "" +"A non-callable version of :class:`Mock`. The constructor parameters have the " +"same meaning of :class:`Mock`, with the exception of *return_value* and " +"*side_effect* which have no meaning on a non-callable mock." +msgstr "" + +msgid "" +"Mock objects that use a class or an instance as a :attr:`spec` or :attr:" +"`spec_set` are able to pass :func:`isinstance` tests:" +msgstr "" + +msgid "" +"The :class:`Mock` classes have support for mocking magic methods. See :ref:" +"`magic methods ` for the full details." +msgstr "" + +msgid "" +"The mock classes and the :func:`patch` decorators all take arbitrary keyword " +"arguments for configuration. For the :func:`patch` decorators the keywords " +"are passed to the constructor of the mock being created. The keyword " +"arguments are for configuring attributes of the mock:" +msgstr "" + +msgid "" +"The return value and side effect of child mocks can be set in the same way, " +"using dotted notation. As you can't use dotted names directly in a call you " +"have to create a dictionary and unpack it using ``**``:" +msgstr "" + +msgid "" +"A callable mock which was created with a *spec* (or a *spec_set*) will " +"introspect the specification object's signature when matching calls to the " +"mock. Therefore, it can match the actual call's arguments regardless of " +"whether they were passed positionally or by name::" +msgstr "" + +msgid "" +"This applies to :meth:`~Mock.assert_called_with`, :meth:`~Mock." +"assert_called_once_with`, :meth:`~Mock.assert_has_calls` and :meth:`~Mock." +"assert_any_call`. When :ref:`auto-speccing`, it will also apply to method " +"calls on the mock object." +msgstr "" + +msgid "Added signature introspection on specced and autospecced mock objects." +msgstr "" + +msgid "" +"A mock intended to be used as a :class:`property`, or other :term:" +"`descriptor`, on a class. :class:`PropertyMock` provides :meth:`~object." +"__get__` and :meth:`~object.__set__` methods so you can specify a return " +"value when it is fetched." +msgstr "" + +msgid "" +"Fetching a :class:`PropertyMock` instance from an object calls the mock, " +"with no args. Setting it calls the mock with the value being set. ::" +msgstr "" + +msgid "" +"Because of the way mock attributes are stored you can't directly attach a :" +"class:`PropertyMock` to a mock object. Instead you can attach it to the mock " +"type object::" +msgstr "" + +msgid "" +"An asynchronous version of :class:`MagicMock`. The :class:`AsyncMock` object " +"will behave so the object is recognized as an async function, and the result " +"of a call is an awaitable." +msgstr "" + +msgid "" +"The result of ``mock()`` is an async function which will have the outcome of " +"``side_effect`` or ``return_value`` after it has been awaited:" +msgstr "" + +msgid "" +"if ``side_effect`` is a function, the async function will return the result " +"of that function," +msgstr "" + +msgid "" +"if ``side_effect`` is an exception, the async function will raise the " +"exception," +msgstr "" + +msgid "" +"if ``side_effect`` is an iterable, the async function will return the next " +"value of the iterable, however, if the sequence of result is exhausted, " +"``StopAsyncIteration`` is raised immediately," +msgstr "" + +msgid "" +"if ``side_effect`` is not defined, the async function will return the value " +"defined by ``return_value``, hence, by default, the async function returns a " +"new :class:`AsyncMock` object." +msgstr "" + +msgid "" +"Setting the *spec* of a :class:`Mock` or :class:`MagicMock` to an async " +"function will result in a coroutine object being returned after calling." +msgstr "" + +msgid "" +"Setting the *spec* of a :class:`Mock`, :class:`MagicMock`, or :class:" +"`AsyncMock` to a class with asynchronous and synchronous functions will " +"automatically detect the synchronous functions and set them as :class:" +"`MagicMock` (if the parent mock is :class:`AsyncMock` or :class:`MagicMock`) " +"or :class:`Mock` (if the parent mock is :class:`Mock`). All asynchronous " +"functions will be :class:`AsyncMock`." +msgstr "" + +msgid "" +"Assert that the mock was awaited at least once. Note that this is separate " +"from the object having been called, the ``await`` keyword must be used:" +msgstr "" + +msgid "Assert that the mock was awaited exactly once." +msgstr "" + +msgid "Assert that the last await was with the specified arguments." +msgstr "" + +msgid "" +"Assert that the mock was awaited exactly once and with the specified " +"arguments." +msgstr "" + +msgid "Assert the mock has ever been awaited with the specified arguments." +msgstr "" + +msgid "" +"Assert the mock has been awaited with the specified calls. The :attr:" +"`await_args_list` list is checked for the awaits." +msgstr "" + +msgid "" +"If *any_order* is false then the awaits must be sequential. There can be " +"extra calls before or after the specified awaits." +msgstr "" + +msgid "" +"If *any_order* is true then the awaits can be in any order, but they must " +"all appear in :attr:`await_args_list`." +msgstr "" + +msgid "Assert that the mock was never awaited." +msgstr "" + +msgid "" +"See :func:`Mock.reset_mock`. Also sets :attr:`await_count` to 0, :attr:" +"`await_args` to None, and clears the :attr:`await_args_list`." +msgstr "" + +msgid "" +"An integer keeping track of how many times the mock object has been awaited." +msgstr "" + +msgid "" +"This is either ``None`` (if the mock hasn’t been awaited), or the arguments " +"that the mock was last awaited with. Functions the same as :attr:`Mock." +"call_args`." +msgstr "" + +msgid "" +"This is a list of all the awaits made to the mock object in sequence (so the " +"length of the list is the number of times it has been awaited). Before any " +"awaits have been made it is an empty list." +msgstr "" + +msgid "Calling" +msgstr "" + +msgid "" +"Mock objects are callable. The call will return the value set as the :attr:" +"`~Mock.return_value` attribute. The default return value is a new Mock " +"object; it is created the first time the return value is accessed (either " +"explicitly or by calling the Mock) - but it is stored and the same one " +"returned each time." +msgstr "" + +msgid "" +"Calls made to the object will be recorded in the attributes like :attr:" +"`~Mock.call_args` and :attr:`~Mock.call_args_list`." +msgstr "" + +msgid "" +"If :attr:`~Mock.side_effect` is set then it will be called after the call " +"has been recorded, so if :attr:`side_effect` raises an exception the call is " +"still recorded." +msgstr "" + +msgid "" +"The simplest way to make a mock raise an exception when called is to make :" +"attr:`~Mock.side_effect` an exception class or instance:" +msgstr "" + +msgid "" +"If :attr:`side_effect` is a function then whatever that function returns is " +"what calls to the mock return. The :attr:`side_effect` function is called " +"with the same arguments as the mock. This allows you to vary the return " +"value of the call dynamically, based on the input:" +msgstr "" + +msgid "" +"If you want the mock to still return the default return value (a new mock), " +"or any set return value, then there are two ways of doing this. Either " +"return :attr:`mock.return_value` from inside :attr:`side_effect`, or return :" +"data:`DEFAULT`:" +msgstr "" + +msgid "" +"To remove a :attr:`side_effect`, and return to the default behaviour, set " +"the :attr:`side_effect` to ``None``:" +msgstr "" + +msgid "" +"The :attr:`side_effect` can also be any iterable object. Repeated calls to " +"the mock will return values from the iterable (until the iterable is " +"exhausted and a :exc:`StopIteration` is raised):" +msgstr "" + +msgid "" +"If any members of the iterable are exceptions they will be raised instead of " +"returned::" +msgstr "" + +msgid "Deleting Attributes" +msgstr "" + +msgid "" +"Mock objects create attributes on demand. This allows them to pretend to be " +"objects of any type." +msgstr "" + +msgid "" +"You may want a mock object to return ``False`` to a :func:`hasattr` call, or " +"raise an :exc:`AttributeError` when an attribute is fetched. You can do this " +"by providing an object as a :attr:`spec` for a mock, but that isn't always " +"convenient." +msgstr "" + +msgid "" +"You \"block\" attributes by deleting them. Once deleted, accessing an " +"attribute will raise an :exc:`AttributeError`." +msgstr "" + +msgid "Mock names and the name attribute" +msgstr "" + +msgid "" +"Since \"name\" is an argument to the :class:`Mock` constructor, if you want " +"your mock object to have a \"name\" attribute you can't just pass it in at " +"creation time. There are two alternatives. One option is to use :meth:`~Mock." +"configure_mock`::" +msgstr "" + +msgid "" +"A simpler option is to simply set the \"name\" attribute after mock " +"creation::" +msgstr "" + +msgid "Attaching Mocks as Attributes" +msgstr "" + +msgid "" +"When you attach a mock as an attribute of another mock (or as the return " +"value) it becomes a \"child\" of that mock. Calls to the child are recorded " +"in the :attr:`~Mock.method_calls` and :attr:`~Mock.mock_calls` attributes of " +"the parent. This is useful for configuring child mocks and then attaching " +"them to the parent, or for attaching mocks to a parent that records all " +"calls to the children and allows you to make assertions about the order of " +"calls between mocks:" +msgstr "" + +msgid "" +"The exception to this is if the mock has a name. This allows you to prevent " +"the \"parenting\" if for some reason you don't want it to happen." +msgstr "" + +msgid "" +"Mocks created for you by :func:`patch` are automatically given names. To " +"attach mocks that have names to a parent you use the :meth:`~Mock." +"attach_mock` method::" +msgstr "" + +msgid "" +"The only exceptions are magic methods and attributes (those that have " +"leading and trailing double underscores). Mock doesn't create these but " +"instead raises an :exc:`AttributeError`. This is because the interpreter " +"will often implicitly request these methods, and gets *very* confused to get " +"a new Mock object when it expects a magic method. If you need magic method " +"support see :ref:`magic methods `." +msgstr "" + +msgid "The patchers" +msgstr "" + +msgid "" +"The patch decorators are used for patching objects only within the scope of " +"the function they decorate. They automatically handle the unpatching for " +"you, even if exceptions are raised. All of these functions can also be used " +"in with statements or as class decorators." +msgstr "" + +msgid "patch" +msgstr "" + +msgid "" +"The key is to do the patching in the right namespace. See the section `where " +"to patch`_." +msgstr "" + +msgid "" +":func:`patch` acts as a function decorator, class decorator or a context " +"manager. Inside the body of the function or with statement, the *target* is " +"patched with a *new* object. When the function/with statement exits the " +"patch is undone." +msgstr "" + +msgid "" +"If *new* is omitted, then the target is replaced with an :class:`AsyncMock` " +"if the patched object is an async function or a :class:`MagicMock` " +"otherwise. If :func:`patch` is used as a decorator and *new* is omitted, the " +"created mock is passed in as an extra argument to the decorated function. " +"If :func:`patch` is used as a context manager the created mock is returned " +"by the context manager." +msgstr "" + +msgid "" +"*target* should be a string in the form ``'package.module.ClassName'``. The " +"*target* is imported and the specified object replaced with the *new* " +"object, so the *target* must be importable from the environment you are " +"calling :func:`patch` from. The target is imported when the decorated " +"function is executed, not at decoration time." +msgstr "" + +msgid "" +"The *spec* and *spec_set* keyword arguments are passed to the :class:" +"`MagicMock` if patch is creating one for you." +msgstr "" + +msgid "" +"In addition you can pass ``spec=True`` or ``spec_set=True``, which causes " +"patch to pass in the object being mocked as the spec/spec_set object." +msgstr "" + +msgid "" +"*new_callable* allows you to specify a different class, or callable object, " +"that will be called to create the *new* object. By default :class:" +"`AsyncMock` is used for async functions and :class:`MagicMock` for the rest." +msgstr "" + +msgid "" +"A more powerful form of *spec* is *autospec*. If you set ``autospec=True`` " +"then the mock will be created with a spec from the object being replaced. " +"All attributes of the mock will also have the spec of the corresponding " +"attribute of the object being replaced. Methods and functions being mocked " +"will have their arguments checked and will raise a :exc:`TypeError` if they " +"are called with the wrong signature. For mocks replacing a class, their " +"return value (the 'instance') will have the same spec as the class. See the :" +"func:`create_autospec` function and :ref:`auto-speccing`." +msgstr "" + +msgid "" +"Instead of ``autospec=True`` you can pass ``autospec=some_object`` to use an " +"arbitrary object as the spec instead of the one being replaced." +msgstr "" + +msgid "" +"By default :func:`patch` will fail to replace attributes that don't exist. " +"If you pass in ``create=True``, and the attribute doesn't exist, patch will " +"create the attribute for you when the patched function is called, and delete " +"it again after the patched function has exited. This is useful for writing " +"tests against attributes that your production code creates at runtime. It is " +"off by default because it can be dangerous. With it switched on you can " +"write passing tests against APIs that don't actually exist!" +msgstr "" + +msgid "" +"If you are patching builtins in a module then you don't need to pass " +"``create=True``, it will be added by default." +msgstr "" + +msgid "" +"Patch can be used as a :class:`TestCase` class decorator. It works by " +"decorating each test method in the class. This reduces the boilerplate code " +"when your test methods share a common patchings set. :func:`patch` finds " +"tests by looking for method names that start with ``patch.TEST_PREFIX``. By " +"default this is ``'test'``, which matches the way :mod:`unittest` finds " +"tests. You can specify an alternative prefix by setting ``patch." +"TEST_PREFIX``." +msgstr "" + +msgid "" +"Patch can be used as a context manager, with the with statement. Here the " +"patching applies to the indented block after the with statement. If you use " +"\"as\" then the patched object will be bound to the name after the \"as\"; " +"very useful if :func:`patch` is creating a mock object for you." +msgstr "" + +msgid "" +":func:`patch` takes arbitrary keyword arguments. These will be passed to :" +"class:`AsyncMock` if the patched object is asynchronous, to :class:" +"`MagicMock` otherwise or to *new_callable* if specified." +msgstr "" + +msgid "" +"``patch.dict(...)``, ``patch.multiple(...)`` and ``patch.object(...)`` are " +"available for alternate use-cases." +msgstr "" + +msgid "" +":func:`patch` as function decorator, creating the mock for you and passing " +"it into the decorated function::" +msgstr "" + +msgid "" +"Patching a class replaces the class with a :class:`MagicMock` *instance*. If " +"the class is instantiated in the code under test then it will be the :attr:" +"`~Mock.return_value` of the mock that will be used." +msgstr "" + +msgid "" +"If the class is instantiated multiple times you could use :attr:`~Mock." +"side_effect` to return a new mock each time. Alternatively you can set the " +"*return_value* to be anything you want." +msgstr "" + +msgid "" +"To configure return values on methods of *instances* on the patched class " +"you must do this on the :attr:`return_value`. For example::" +msgstr "" + +msgid "" +"If you use *spec* or *spec_set* and :func:`patch` is replacing a *class*, " +"then the return value of the created mock will have the same spec. ::" +msgstr "" + +msgid "" +"The *new_callable* argument is useful where you want to use an alternative " +"class to the default :class:`MagicMock` for the created mock. For example, " +"if you wanted a :class:`NonCallableMock` to be used::" +msgstr "" + +msgid "" +"Another use case might be to replace an object with an :class:`io.StringIO` " +"instance::" +msgstr "" + +msgid "" +"When :func:`patch` is creating a mock for you, it is common that the first " +"thing you need to do is to configure the mock. Some of that configuration " +"can be done in the call to patch. Any arbitrary keywords you pass into the " +"call will be used to set attributes on the created mock::" +msgstr "" + +msgid "" +"As well as attributes on the created mock attributes, like the :attr:`~Mock." +"return_value` and :attr:`~Mock.side_effect`, of child mocks can also be " +"configured. These aren't syntactically valid to pass in directly as keyword " +"arguments, but a dictionary with these as keys can still be expanded into a :" +"func:`patch` call using ``**``::" +msgstr "" + +msgid "" +"By default, attempting to patch a function in a module (or a method or an " +"attribute in a class) that does not exist will fail with :exc:" +"`AttributeError`::" +msgstr "" + +msgid "" +"but adding ``create=True`` in the call to :func:`patch` will make the " +"previous example work as expected::" +msgstr "" + +msgid "" +":func:`patch` now returns an :class:`AsyncMock` if the target is an async " +"function." +msgstr "" + +msgid "patch.object" +msgstr "" + +msgid "" +"patch the named member (*attribute*) on an object (*target*) with a mock " +"object." +msgstr "" + +msgid "" +":func:`patch.object` can be used as a decorator, class decorator or a " +"context manager. Arguments *new*, *spec*, *create*, *spec_set*, *autospec* " +"and *new_callable* have the same meaning as for :func:`patch`. Like :func:" +"`patch`, :func:`patch.object` takes arbitrary keyword arguments for " +"configuring the mock object it creates." +msgstr "" + +msgid "" +"When used as a class decorator :func:`patch.object` honours ``patch." +"TEST_PREFIX`` for choosing which methods to wrap." +msgstr "" + +msgid "" +"You can either call :func:`patch.object` with three arguments or two " +"arguments. The three argument form takes the object to be patched, the " +"attribute name and the object to replace the attribute with." +msgstr "" + +msgid "" +"When calling with the two argument form you omit the replacement object, and " +"a mock is created for you and passed in as an extra argument to the " +"decorated function:" +msgstr "" + +msgid "" +"*spec*, *create* and the other arguments to :func:`patch.object` have the " +"same meaning as they do for :func:`patch`." +msgstr "" + +msgid "patch.dict" +msgstr "" + +msgid "" +"Patch a dictionary, or dictionary like object, and restore the dictionary to " +"its original state after the test." +msgstr "" + +msgid "" +"*in_dict* can be a dictionary or a mapping like container. If it is a " +"mapping then it must at least support getting, setting and deleting items " +"plus iterating over keys." +msgstr "" + +msgid "" +"*in_dict* can also be a string specifying the name of the dictionary, which " +"will then be fetched by importing it." +msgstr "" + +msgid "" +"*values* can be a dictionary of values to set in the dictionary. *values* " +"can also be an iterable of ``(key, value)`` pairs." +msgstr "" + +msgid "" +"If *clear* is true then the dictionary will be cleared before the new values " +"are set." +msgstr "" + +msgid "" +":func:`patch.dict` can also be called with arbitrary keyword arguments to " +"set values in the dictionary." +msgstr "" + +msgid "" +":func:`patch.dict` now returns the patched dictionary when used as a context " +"manager." +msgstr "" + +msgid "" +":func:`patch.dict` can be used as a context manager, decorator or class " +"decorator:" +msgstr "" + +msgid "" +"When used as a class decorator :func:`patch.dict` honours ``patch." +"TEST_PREFIX`` (default to ``'test'``) for choosing which methods to wrap:" +msgstr "" + +msgid "" +"If you want to use a different prefix for your test, you can inform the " +"patchers of the different prefix by setting ``patch.TEST_PREFIX``. For more " +"details about how to change the value of see :ref:`test-prefix`." +msgstr "" + +msgid "" +":func:`patch.dict` can be used to add members to a dictionary, or simply let " +"a test change a dictionary, and ensure the dictionary is restored when the " +"test ends." +msgstr "" + +msgid "" +"Keywords can be used in the :func:`patch.dict` call to set values in the " +"dictionary:" +msgstr "" + +msgid "" +":func:`patch.dict` can be used with dictionary like objects that aren't " +"actually dictionaries. At the very minimum they must support item getting, " +"setting, deleting and either iteration or membership test. This corresponds " +"to the magic methods :meth:`~object.__getitem__`, :meth:`~object." +"__setitem__`, :meth:`~object.__delitem__` and either :meth:`~container." +"__iter__` or :meth:`~object.__contains__`." +msgstr "" + +msgid "patch.multiple" +msgstr "" + +msgid "" +"Perform multiple patches in a single call. It takes the object to be patched " +"(either as an object or a string to fetch the object by importing) and " +"keyword arguments for the patches::" +msgstr "" + +msgid "" +"Use :data:`DEFAULT` as the value if you want :func:`patch.multiple` to " +"create mocks for you. In this case the created mocks are passed into a " +"decorated function by keyword, and a dictionary is returned when :func:" +"`patch.multiple` is used as a context manager." +msgstr "" + +msgid "" +":func:`patch.multiple` can be used as a decorator, class decorator or a " +"context manager. The arguments *spec*, *spec_set*, *create*, *autospec* and " +"*new_callable* have the same meaning as for :func:`patch`. These arguments " +"will be applied to *all* patches done by :func:`patch.multiple`." +msgstr "" + +msgid "" +"When used as a class decorator :func:`patch.multiple` honours ``patch." +"TEST_PREFIX`` for choosing which methods to wrap." +msgstr "" + +msgid "" +"If you want :func:`patch.multiple` to create mocks for you, then you can " +"use :data:`DEFAULT` as the value. If you use :func:`patch.multiple` as a " +"decorator then the created mocks are passed into the decorated function by " +"keyword. ::" +msgstr "" + +msgid "" +":func:`patch.multiple` can be nested with other ``patch`` decorators, but " +"put arguments passed by keyword *after* any of the standard arguments " +"created by :func:`patch`::" +msgstr "" + +msgid "" +"If :func:`patch.multiple` is used as a context manager, the value returned " +"by the context manager is a dictionary where created mocks are keyed by " +"name::" +msgstr "" + +msgid "patch methods: start and stop" +msgstr "" + +msgid "" +"All the patchers have :meth:`start` and :meth:`stop` methods. These make it " +"simpler to do patching in ``setUp`` methods or where you want to do multiple " +"patches without nesting decorators or with statements." +msgstr "" + +msgid "" +"To use them call :func:`patch`, :func:`patch.object` or :func:`patch.dict` " +"as normal and keep a reference to the returned ``patcher`` object. You can " +"then call :meth:`start` to put the patch in place and :meth:`stop` to undo " +"it." +msgstr "" + +msgid "" +"If you are using :func:`patch` to create a mock for you then it will be " +"returned by the call to ``patcher.start``. ::" +msgstr "" + +msgid "" +"A typical use case for this might be for doing multiple patches in the " +"``setUp`` method of a :class:`TestCase`::" +msgstr "" + +msgid "" +"If you use this technique you must ensure that the patching is \"undone\" by " +"calling ``stop``. This can be fiddlier than you might think, because if an " +"exception is raised in the ``setUp`` then ``tearDown`` is not called. :meth:" +"`unittest.TestCase.addCleanup` makes this easier::" +msgstr "" + +msgid "" +"As an added bonus you no longer need to keep a reference to the ``patcher`` " +"object." +msgstr "" + +msgid "" +"It is also possible to stop all patches which have been started by using :" +"func:`patch.stopall`." +msgstr "" + +msgid "Stop all active patches. Only stops patches started with ``start``." +msgstr "" + +msgid "patch builtins" +msgstr "" + +msgid "" +"You can patch any builtins within a module. The following example patches " +"builtin :func:`ord`::" +msgstr "" + +msgid "TEST_PREFIX" +msgstr "" + +msgid "" +"All of the patchers can be used as class decorators. When used in this way " +"they wrap every test method on the class. The patchers recognise methods " +"that start with ``'test'`` as being test methods. This is the same way that " +"the :class:`unittest.TestLoader` finds test methods by default." +msgstr "" + +msgid "" +"It is possible that you want to use a different prefix for your tests. You " +"can inform the patchers of the different prefix by setting ``patch." +"TEST_PREFIX``::" +msgstr "" + +msgid "Nesting Patch Decorators" +msgstr "" + +msgid "" +"If you want to perform multiple patches then you can simply stack up the " +"decorators." +msgstr "" + +msgid "You can stack up multiple patch decorators using this pattern:" +msgstr "" + +msgid "" +"Note that the decorators are applied from the bottom upwards. This is the " +"standard way that Python applies decorators. The order of the created mocks " +"passed into your test function matches this order." +msgstr "" + +msgid "Where to patch" +msgstr "" + +msgid "" +":func:`patch` works by (temporarily) changing the object that a *name* " +"points to with another one. There can be many names pointing to any " +"individual object, so for patching to work you must ensure that you patch " +"the name used by the system under test." +msgstr "" + +msgid "" +"The basic principle is that you patch where an object is *looked up*, which " +"is not necessarily the same place as where it is defined. A couple of " +"examples will help to clarify this." +msgstr "" + +msgid "" +"Imagine we have a project that we want to test with the following structure::" +msgstr "" + +msgid "" +"Now we want to test ``some_function`` but we want to mock out ``SomeClass`` " +"using :func:`patch`. The problem is that when we import module b, which we " +"will have to do then it imports ``SomeClass`` from module a. If we use :func:" +"`patch` to mock out ``a.SomeClass`` then it will have no effect on our test; " +"module b already has a reference to the *real* ``SomeClass`` and it looks " +"like our patching had no effect." +msgstr "" + +msgid "" +"The key is to patch out ``SomeClass`` where it is used (or where it is " +"looked up). In this case ``some_function`` will actually look up " +"``SomeClass`` in module b, where we have imported it. The patching should " +"look like::" +msgstr "" + +msgid "" +"However, consider the alternative scenario where instead of ``from a import " +"SomeClass`` module b does ``import a`` and ``some_function`` uses ``a." +"SomeClass``. Both of these import forms are common. In this case the class " +"we want to patch is being looked up in the module and so we have to patch " +"``a.SomeClass`` instead::" +msgstr "" + +msgid "Patching Descriptors and Proxy Objects" +msgstr "" + +msgid "" +"Both patch_ and patch.object_ correctly patch and restore descriptors: class " +"methods, static methods and properties. You should patch these on the " +"*class* rather than an instance. They also work with *some* objects that " +"proxy attribute access, like the `django settings object `_." +msgstr "" + +msgid "MagicMock and magic method support" +msgstr "" + +msgid "Mocking Magic Methods" +msgstr "" + +msgid "" +":class:`Mock` supports mocking the Python protocol methods, also known as :" +"term:`\"magic methods\" `. This allows mock objects to replace " +"containers or other objects that implement Python protocols." +msgstr "" + +msgid "" +"Because magic methods are looked up differently from normal methods [#]_, " +"this support has been specially implemented. This means that only specific " +"magic methods are supported. The supported list includes *almost* all of " +"them. If there are any missing that you need please let us know." +msgstr "" + +msgid "" +"You mock magic methods by setting the method you are interested in to a " +"function or a mock instance. If you are using a function then it *must* take " +"``self`` as the first argument [#]_." +msgstr "" + +msgid "" +"One use case for this is for mocking objects used as context managers in a :" +"keyword:`with` statement:" +msgstr "" + +msgid "" +"Calls to magic methods do not appear in :attr:`~Mock.method_calls`, but they " +"are recorded in :attr:`~Mock.mock_calls`." +msgstr "" + +msgid "" +"If you use the *spec* keyword argument to create a mock then attempting to " +"set a magic method that isn't in the spec will raise an :exc:" +"`AttributeError`." +msgstr "" + +msgid "The full list of supported magic methods is:" +msgstr "" + +msgid "``__hash__``, ``__sizeof__``, ``__repr__`` and ``__str__``" +msgstr "" + +msgid "``__dir__``, ``__format__`` and ``__subclasses__``" +msgstr "" + +msgid "``__round__``, ``__floor__``, ``__trunc__`` and ``__ceil__``" +msgstr "" + +msgid "" +"Comparisons: ``__lt__``, ``__gt__``, ``__le__``, ``__ge__``, ``__eq__`` and " +"``__ne__``" +msgstr "" + +msgid "" +"Container methods: ``__getitem__``, ``__setitem__``, ``__delitem__``, " +"``__contains__``, ``__len__``, ``__iter__``, ``__reversed__`` and " +"``__missing__``" +msgstr "" + +msgid "" +"Context manager: ``__enter__``, ``__exit__``, ``__aenter__`` and " +"``__aexit__``" +msgstr "" + +msgid "Unary numeric methods: ``__neg__``, ``__pos__`` and ``__invert__``" +msgstr "" + +msgid "" +"The numeric methods (including right hand and in-place variants): " +"``__add__``, ``__sub__``, ``__mul__``, ``__matmul__``, ``__truediv__``, " +"``__floordiv__``, ``__mod__``, ``__divmod__``, ``__lshift__``, " +"``__rshift__``, ``__and__``, ``__xor__``, ``__or__``, and ``__pow__``" +msgstr "" + +msgid "" +"Numeric conversion methods: ``__complex__``, ``__int__``, ``__float__`` and " +"``__index__``" +msgstr "" + +msgid "Descriptor methods: ``__get__``, ``__set__`` and ``__delete__``" +msgstr "" + +msgid "" +"Pickling: ``__reduce__``, ``__reduce_ex__``, ``__getinitargs__``, " +"``__getnewargs__``, ``__getstate__`` and ``__setstate__``" +msgstr "" + +msgid "File system path representation: ``__fspath__``" +msgstr "" + +msgid "Asynchronous iteration methods: ``__aiter__`` and ``__anext__``" +msgstr "" + +msgid "Added support for :func:`os.PathLike.__fspath__`." +msgstr "" + +msgid "" +"Added support for ``__aenter__``, ``__aexit__``, ``__aiter__`` and " +"``__anext__``." +msgstr "" + +msgid "" +"The following methods exist but are *not* supported as they are either in " +"use by mock, can't be set dynamically, or can cause problems:" +msgstr "" + +msgid "``__getattr__``, ``__setattr__``, ``__init__`` and ``__new__``" +msgstr "" + +msgid "" +"``__prepare__``, ``__instancecheck__``, ``__subclasscheck__``, ``__del__``" +msgstr "" + +msgid "Magic Mock" +msgstr "" + +msgid "" +"There are two ``MagicMock`` variants: :class:`MagicMock` and :class:" +"`NonCallableMagicMock`." +msgstr "" + +msgid "" +"``MagicMock`` is a subclass of :class:`Mock` with default implementations of " +"most of the :term:`magic methods `. You can use ``MagicMock`` " +"without having to configure the magic methods yourself." +msgstr "" + +msgid "The constructor parameters have the same meaning as for :class:`Mock`." +msgstr "" + +msgid "" +"If you use the *spec* or *spec_set* arguments then *only* magic methods that " +"exist in the spec will be created." +msgstr "" + +msgid "A non-callable version of :class:`MagicMock`." +msgstr "" + +msgid "" +"The constructor parameters have the same meaning as for :class:`MagicMock`, " +"with the exception of *return_value* and *side_effect* which have no meaning " +"on a non-callable mock." +msgstr "" + +msgid "" +"The magic methods are setup with :class:`MagicMock` objects, so you can " +"configure them and use them in the usual way:" +msgstr "" + +msgid "" +"By default many of the protocol methods are required to return objects of a " +"specific type. These methods are preconfigured with a default return value, " +"so that they can be used without you having to do anything if you aren't " +"interested in the return value. You can still *set* the return value " +"manually if you want to change the default." +msgstr "" + +msgid "Methods and their defaults:" +msgstr "" + +msgid "``__lt__``: :data:`NotImplemented`" +msgstr "``__lt__``: :data:`NotImplemented`" + +msgid "``__gt__``: :data:`!NotImplemented`" +msgstr "``__gt__``: :data:`!NotImplemented`" + +msgid "``__le__``: :data:`!NotImplemented`" +msgstr "``__le__``: :data:`!NotImplemented`" + +msgid "``__ge__``: :data:`!NotImplemented`" +msgstr "``__ge__``: :data:`!NotImplemented`" + +msgid "``__int__``: ``1``" +msgstr "``__int__``: ``1``" + +msgid "``__contains__``: ``False``" +msgstr "``__contains__``: ``False``" + +msgid "``__len__``: ``0``" +msgstr "``__len__``: ``0``" + +msgid "``__iter__``: ``iter([])``" +msgstr "``__iter__``: ``iter([])``" + +msgid "``__exit__``: ``False``" +msgstr "``__exit__``: ``False``" + +msgid "``__aexit__``: ``False``" +msgstr "``__aexit__``: ``False``" + +msgid "``__complex__``: ``1j``" +msgstr "``__complex__``: ``1j``" + +msgid "``__float__``: ``1.0``" +msgstr "``__float__``: ``1.0``" + +msgid "``__bool__``: ``True``" +msgstr "``__bool__``: ``True``" + +msgid "``__index__``: ``1``" +msgstr "``__index__``: ``1``" + +msgid "``__hash__``: default hash for the mock" +msgstr "" + +msgid "``__str__``: default str for the mock" +msgstr "" + +msgid "``__sizeof__``: default sizeof for the mock" +msgstr "" + +msgid "For example:" +msgstr "Na przykład::" + +msgid "" +"The two equality methods, :meth:`!__eq__` and :meth:`!__ne__`, are special. " +"They do the default equality comparison on identity, using the :attr:`~Mock." +"side_effect` attribute, unless you change their return value to return " +"something else::" +msgstr "" + +msgid "" +"The return value of :meth:`MagicMock.__iter__` can be any iterable object " +"and isn't required to be an iterator:" +msgstr "" + +msgid "" +"If the return value *is* an iterator, then iterating over it once will " +"consume it and subsequent iterations will result in an empty list:" +msgstr "" + +msgid "" +"``MagicMock`` has all of the supported magic methods configured except for " +"some of the obscure and obsolete ones. You can still set these up if you " +"want." +msgstr "" + +msgid "" +"Magic methods that are supported but not setup by default in ``MagicMock`` " +"are:" +msgstr "" + +msgid "``__subclasses__``" +msgstr "``__subclasses__``" + +msgid "``__dir__``" +msgstr "``__dir__``" + +msgid "``__format__``" +msgstr "``__format__``" + +msgid "``__get__``, ``__set__`` and ``__delete__``" +msgstr "" + +msgid "``__reversed__`` and ``__missing__``" +msgstr "" + +msgid "" +"``__reduce__``, ``__reduce_ex__``, ``__getinitargs__``, ``__getnewargs__``, " +"``__getstate__`` and ``__setstate__``" +msgstr "" + +msgid "``__getformat__``" +msgstr "``__getformat__``" + +msgid "" +"Magic methods *should* be looked up on the class rather than the instance. " +"Different versions of Python are inconsistent about applying this rule. The " +"supported protocol methods should work with all supported versions of Python." +msgstr "" + +msgid "" +"The function is basically hooked up to the class, but each ``Mock`` instance " +"is kept isolated from the others." +msgstr "" + +msgid "Helpers" +msgstr "" + +msgid "sentinel" +msgstr "" + +msgid "" +"The ``sentinel`` object provides a convenient way of providing unique " +"objects for your tests." +msgstr "" + +msgid "" +"Attributes are created on demand when you access them by name. Accessing the " +"same attribute will always return the same object. The objects returned have " +"a sensible repr so that test failure messages are readable." +msgstr "" + +msgid "" +"The ``sentinel`` attributes now preserve their identity when they are :mod:" +"`copied ` or :mod:`pickled `." +msgstr "" + +msgid "" +"Sometimes when testing you need to test that a specific object is passed as " +"an argument to another method, or returned. It can be common to create named " +"sentinel objects to test this. :data:`sentinel` provides a convenient way of " +"creating and testing the identity of objects like this." +msgstr "" + +msgid "" +"In this example we monkey patch ``method`` to return ``sentinel." +"some_object``:" +msgstr "" + +msgid "DEFAULT" +msgstr "" + +msgid "" +"The :data:`DEFAULT` object is a pre-created sentinel (actually ``sentinel." +"DEFAULT``). It can be used by :attr:`~Mock.side_effect` functions to " +"indicate that the normal return value should be used." +msgstr "" + +msgid "call" +msgstr "" + +msgid "" +":func:`call` is a helper object for making simpler assertions, for comparing " +"with :attr:`~Mock.call_args`, :attr:`~Mock.call_args_list`, :attr:`~Mock." +"mock_calls` and :attr:`~Mock.method_calls`. :func:`call` can also be used " +"with :meth:`~Mock.assert_has_calls`." +msgstr "" + +msgid "" +"For a call object that represents multiple calls, :meth:`call_list` returns " +"a list of all the intermediate calls as well as the final call." +msgstr "" + +msgid "" +"``call_list`` is particularly useful for making assertions on \"chained " +"calls\". A chained call is multiple calls on a single line of code. This " +"results in multiple entries in :attr:`~Mock.mock_calls` on a mock. Manually " +"constructing the sequence of calls can be tedious." +msgstr "" + +msgid "" +":meth:`~call.call_list` can construct the sequence of calls from the same " +"chained call:" +msgstr "" + +msgid "" +"A ``call`` object is either a tuple of (positional args, keyword args) or " +"(name, positional args, keyword args) depending on how it was constructed. " +"When you construct them yourself this isn't particularly interesting, but " +"the ``call`` objects that are in the :attr:`Mock.call_args`, :attr:`Mock." +"call_args_list` and :attr:`Mock.mock_calls` attributes can be introspected " +"to get at the individual arguments they contain." +msgstr "" + +msgid "" +"The ``call`` objects in :attr:`Mock.call_args` and :attr:`Mock." +"call_args_list` are two-tuples of (positional args, keyword args) whereas " +"the ``call`` objects in :attr:`Mock.mock_calls`, along with ones you " +"construct yourself, are three-tuples of (name, positional args, keyword " +"args)." +msgstr "" + +msgid "" +"You can use their \"tupleness\" to pull out the individual arguments for " +"more complex introspection and assertions. The positional arguments are a " +"tuple (an empty tuple if there are no positional arguments) and the keyword " +"arguments are a dictionary:" +msgstr "" + +msgid "create_autospec" +msgstr "" + +msgid "" +"Create a mock object using another object as a spec. Attributes on the mock " +"will use the corresponding attribute on the *spec* object as their spec." +msgstr "" + +msgid "" +"Functions or methods being mocked will have their arguments checked to " +"ensure that they are called with the correct signature." +msgstr "" + +msgid "" +"If *spec_set* is ``True`` then attempting to set attributes that don't exist " +"on the spec object will raise an :exc:`AttributeError`." +msgstr "" + +msgid "" +"If a class is used as a spec then the return value of the mock (the instance " +"of the class) will have the same spec. You can use a class as the spec for " +"an instance object by passing ``instance=True``. The returned mock will only " +"be callable if instances of the mock are callable." +msgstr "" + +msgid "" +":func:`create_autospec` also takes arbitrary keyword arguments that are " +"passed to the constructor of the created mock." +msgstr "" + +msgid "" +"See :ref:`auto-speccing` for examples of how to use auto-speccing with :func:" +"`create_autospec` and the *autospec* argument to :func:`patch`." +msgstr "" + +msgid "" +":func:`create_autospec` now returns an :class:`AsyncMock` if the target is " +"an async function." +msgstr "" + +msgid "ANY" +msgstr "" + +msgid "" +"Sometimes you may need to make assertions about *some* of the arguments in a " +"call to mock, but either not care about some of the arguments or want to " +"pull them individually out of :attr:`~Mock.call_args` and make more complex " +"assertions on them." +msgstr "" + +msgid "" +"To ignore certain arguments you can pass in objects that compare equal to " +"*everything*. Calls to :meth:`~Mock.assert_called_with` and :meth:`~Mock." +"assert_called_once_with` will then succeed no matter what was passed in." +msgstr "" + +msgid "" +":data:`ANY` can also be used in comparisons with call lists like :attr:" +"`~Mock.mock_calls`:" +msgstr "" + +msgid "" +":data:`ANY` is not limited to comparisons with call objects and so can also " +"be used in test assertions::" +msgstr "" + +msgid "FILTER_DIR" +msgstr "" + +msgid "" +":data:`FILTER_DIR` is a module level variable that controls the way mock " +"objects respond to :func:`dir`. The default is ``True``, which uses the " +"filtering described below, to only show useful members. If you dislike this " +"filtering, or need to switch it off for diagnostic purposes, then set ``mock." +"FILTER_DIR = False``." +msgstr "" + +msgid "" +"With filtering on, ``dir(some_mock)`` shows only useful attributes and will " +"include any dynamically created attributes that wouldn't normally be shown. " +"If the mock was created with a *spec* (or *autospec* of course) then all the " +"attributes from the original are shown, even if they haven't been accessed " +"yet:" +msgstr "" + +msgid "" +"Many of the not-very-useful (private to :class:`Mock` rather than the thing " +"being mocked) underscore and double underscore prefixed attributes have been " +"filtered from the result of calling :func:`dir` on a :class:`Mock`. If you " +"dislike this behaviour you can switch it off by setting the module level " +"switch :data:`FILTER_DIR`:" +msgstr "" + +msgid "" +"Alternatively you can just use ``vars(my_mock)`` (instance members) and " +"``dir(type(my_mock))`` (type members) to bypass the filtering irrespective " +"of :const:`mock.FILTER_DIR`." +msgstr "" + +msgid "mock_open" +msgstr "" + +msgid "" +"A helper function to create a mock to replace the use of :func:`open`. It " +"works for :func:`open` called directly or used as a context manager." +msgstr "" + +msgid "" +"The *mock* argument is the mock object to configure. If ``None`` (the " +"default) then a :class:`MagicMock` will be created for you, with the API " +"limited to methods or attributes available on standard file handles." +msgstr "" + +msgid "" +"*read_data* is a string for the :meth:`~io.IOBase.read`, :meth:`~io.IOBase." +"readline`, and :meth:`~io.IOBase.readlines` methods of the file handle to " +"return. Calls to those methods will take data from *read_data* until it is " +"depleted. The mock of these methods is pretty simplistic: every time the " +"*mock* is called, the *read_data* is rewound to the start. If you need more " +"control over the data that you are feeding to the tested code you will need " +"to customize this mock for yourself. When that is insufficient, one of the " +"in-memory filesystem packages on `PyPI `_ can offer a " +"realistic filesystem for testing." +msgstr "" + +msgid "" +"Added :meth:`~io.IOBase.readline` and :meth:`~io.IOBase.readlines` support. " +"The mock of :meth:`~io.IOBase.read` changed to consume *read_data* rather " +"than returning it on each call." +msgstr "" + +msgid "*read_data* is now reset on each call to the *mock*." +msgstr "" + +msgid "" +"Added :meth:`~container.__iter__` to implementation so that iteration (such " +"as in for loops) correctly consumes *read_data*." +msgstr "" + +msgid "" +"Using :func:`open` as a context manager is a great way to ensure your file " +"handles are closed properly and is becoming common::" +msgstr "" + +msgid "" +"The issue is that even if you mock out the call to :func:`open` it is the " +"*returned object* that is used as a context manager (and has :meth:`~object." +"__enter__` and :meth:`~object.__exit__` called)." +msgstr "" + +msgid "" +"Mocking context managers with a :class:`MagicMock` is common enough and " +"fiddly enough that a helper function is useful. ::" +msgstr "" + +msgid "And for reading files::" +msgstr "" + +msgid "Autospeccing" +msgstr "" + +msgid "" +"Autospeccing is based on the existing :attr:`spec` feature of mock. It " +"limits the api of mocks to the api of an original object (the spec), but it " +"is recursive (implemented lazily) so that attributes of mocks only have the " +"same api as the attributes of the spec. In addition mocked functions / " +"methods have the same call signature as the original so they raise a :exc:" +"`TypeError` if they are called incorrectly." +msgstr "" + +msgid "Before I explain how auto-speccing works, here's why it is needed." +msgstr "" + +msgid "" +":class:`Mock` is a very powerful and flexible object, but it suffers from " +"two flaws when used to mock out objects from a system under test. One of " +"these flaws is specific to the :class:`Mock` api and the other is a more " +"general problem with using mock objects." +msgstr "" + +msgid "" +"First the problem specific to :class:`Mock`. :class:`Mock` has two assert " +"methods that are extremely handy: :meth:`~Mock.assert_called_with` and :meth:" +"`~Mock.assert_called_once_with`." +msgstr "" + +msgid "" +"Because mocks auto-create attributes on demand, and allow you to call them " +"with arbitrary arguments, if you misspell one of these assert methods then " +"your assertion is gone:" +msgstr "" + +msgid "Your tests can pass silently and incorrectly because of the typo." +msgstr "" + +msgid "" +"The second issue is more general to mocking. If you refactor some of your " +"code, rename members and so on, any tests for code that is still using the " +"*old api* but uses mocks instead of the real objects will still pass. This " +"means your tests can all pass even though your code is broken." +msgstr "" + +msgid "" +"Note that this is another reason why you need integration tests as well as " +"unit tests. Testing everything in isolation is all fine and dandy, but if " +"you don't test how your units are \"wired together\" there is still lots of " +"room for bugs that tests might have caught." +msgstr "" + +msgid "" +":mod:`mock` already provides a feature to help with this, called speccing. " +"If you use a class or instance as the :attr:`spec` for a mock then you can " +"only access attributes on the mock that exist on the real class:" +msgstr "" + +msgid "" +"The spec only applies to the mock itself, so we still have the same issue " +"with any methods on the mock:" +msgstr "" + +msgid "" +"Auto-speccing solves this problem. You can either pass ``autospec=True`` to :" +"func:`patch` / :func:`patch.object` or use the :func:`create_autospec` " +"function to create a mock with a spec. If you use the ``autospec=True`` " +"argument to :func:`patch` then the object that is being replaced will be " +"used as the spec object. Because the speccing is done \"lazily\" (the spec " +"is created as attributes on the mock are accessed) you can use it with very " +"complex or deeply nested objects (like modules that import modules that " +"import modules) without a big performance hit." +msgstr "" + +msgid "Here's an example of it in use::" +msgstr "" + +msgid "" +"You can see that :class:`request.Request` has a spec. :class:`request." +"Request` takes two arguments in the constructor (one of which is *self*). " +"Here's what happens if we try to call it incorrectly::" +msgstr "" + +msgid "" +"The spec also applies to instantiated classes (i.e. the return value of " +"specced mocks)::" +msgstr "" + +msgid "" +":class:`Request` objects are not callable, so the return value of " +"instantiating our mocked out :class:`request.Request` is a non-callable " +"mock. With the spec in place any typos in our asserts will raise the correct " +"error::" +msgstr "" + +msgid "" +"In many cases you will just be able to add ``autospec=True`` to your " +"existing :func:`patch` calls and then be protected against bugs due to typos " +"and api changes." +msgstr "" + +msgid "" +"As well as using *autospec* through :func:`patch` there is a :func:" +"`create_autospec` for creating autospecced mocks directly:" +msgstr "" + +msgid "" +"This isn't without caveats and limitations however, which is why it is not " +"the default behaviour. In order to know what attributes are available on the " +"spec object, autospec has to introspect (access attributes) the spec. As you " +"traverse attributes on the mock a corresponding traversal of the original " +"object is happening under the hood. If any of your specced objects have " +"properties or descriptors that can trigger code execution then you may not " +"be able to use autospec. On the other hand it is much better to design your " +"objects so that introspection is safe [#]_." +msgstr "" + +msgid "" +"A more serious problem is that it is common for instance attributes to be " +"created in the :meth:`~object.__init__` method and not to exist on the class " +"at all. *autospec* can't know about any dynamically created attributes and " +"restricts the api to visible attributes. ::" +msgstr "" + +msgid "" +"There are a few different ways of resolving this problem. The easiest, but " +"not necessarily the least annoying, way is to simply set the required " +"attributes on the mock after creation. Just because *autospec* doesn't allow " +"you to fetch attributes that don't exist on the spec it doesn't prevent you " +"setting them::" +msgstr "" + +msgid "" +"There is a more aggressive version of both *spec* and *autospec* that *does* " +"prevent you setting non-existent attributes. This is useful if you want to " +"ensure your code only *sets* valid attributes too, but obviously it prevents " +"this particular scenario:" +msgstr "" + +msgid "" +"Probably the best way of solving the problem is to add class attributes as " +"default values for instance members initialised in :meth:`~object.__init__`. " +"Note that if you are only setting default attributes in :meth:`!__init__` " +"then providing them via class attributes (shared between instances of " +"course) is faster too. e.g." +msgstr "" + +msgid "" +"This brings up another issue. It is relatively common to provide a default " +"value of ``None`` for members that will later be an object of a different " +"type. ``None`` would be useless as a spec because it wouldn't let you access " +"*any* attributes or methods on it. As ``None`` is *never* going to be useful " +"as a spec, and probably indicates a member that will normally of some other " +"type, autospec doesn't use a spec for members that are set to ``None``. " +"These will just be ordinary mocks (well - MagicMocks):" +msgstr "" + +msgid "" +"If modifying your production classes to add defaults isn't to your liking " +"then there are more options. One of these is simply to use an instance as " +"the spec rather than the class. The other is to create a subclass of the " +"production class and add the defaults to the subclass without affecting the " +"production class. Both of these require you to use an alternative object as " +"the spec. Thankfully :func:`patch` supports this - you can simply pass the " +"alternative object as the *autospec* argument::" +msgstr "" + +msgid "" +"This only applies to classes or already instantiated objects. Calling a " +"mocked class to create a mock instance *does not* create a real instance. It " +"is only attribute lookups - along with calls to :func:`dir` - that are done." +msgstr "" + +msgid "Sealing mocks" +msgstr "" + +msgid "" +"Seal will disable the automatic creation of mocks when accessing an " +"attribute of the mock being sealed or any of its attributes that are already " +"mocks recursively." +msgstr "" + +msgid "" +"If a mock instance with a name or a spec is assigned to an attribute it " +"won't be considered in the sealing chain. This allows one to prevent seal " +"from fixing part of the mock object. ::" +msgstr "" + +msgid "" +"Order of precedence of :attr:`side_effect`, :attr:`return_value` and *wraps*" +msgstr "" + +msgid "The order of their precedence is:" +msgstr "" + +msgid ":attr:`~Mock.side_effect`" +msgstr ":attr:`~Mock.side_effect`" + +msgid ":attr:`~Mock.return_value`" +msgstr ":attr:`~Mock.return_value`" + +msgid "*wraps*" +msgstr "" + +msgid "" +"If all three are set, mock will return the value from :attr:`~Mock." +"side_effect`, ignoring :attr:`~Mock.return_value` and the wrapped object " +"altogether. If any two are set, the one with the higher precedence will " +"return the value. Regardless of the order of which was set first, the order " +"of precedence remains unchanged." +msgstr "" + +msgid "" +"As ``None`` is the default value of :attr:`~Mock.side_effect`, if you " +"reassign its value back to ``None``, the order of precedence will be checked " +"between :attr:`~Mock.return_value` and the wrapped object, ignoring :attr:" +"`~Mock.side_effect`." +msgstr "" + +msgid "" +"If the value being returned by :attr:`~Mock.side_effect` is :data:`DEFAULT`, " +"it is ignored and the order of precedence moves to the successor to obtain " +"the value to return." +msgstr "" + +msgid "" +"When :class:`Mock` wraps an object, the default value of :attr:`~Mock." +"return_value` will be :data:`DEFAULT`." +msgstr "" + +msgid "" +"The order of precedence will ignore this value and it will move to the last " +"successor which is the wrapped object." +msgstr "" + +msgid "" +"As the real call is being made to the wrapped object, creating an instance " +"of this mock will return the real instance of the class. The positional " +"arguments, if any, required by the wrapped object must be passed." +msgstr "" + +msgid "" +"But if you assign ``None`` to it, this will not be ignored as it is an " +"explicit assignment. So, the order of precedence will not move to the " +"wrapped object." +msgstr "" + +msgid "" +"Even if you set all three at once when initializing the mock, the order of " +"precedence remains the same:" +msgstr "" + +msgid "" +"If :attr:`~Mock.side_effect` is exhausted, the order of precedence will not " +"cause a value to be obtained from the successors. Instead, ``StopIteration`` " +"exception is raised." +msgstr "" diff --git a/library/unittest.po b/library/unittest.po new file mode 100644 index 0000000000..7ec1de6432 --- /dev/null +++ b/library/unittest.po @@ -0,0 +1,2571 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`unittest` --- Unit testing framework" +msgstr "" + +msgid "**Source code:** :source:`Lib/unittest/__init__.py`" +msgstr "" + +msgid "" +"(If you are already familiar with the basic concepts of testing, you might " +"want to skip to :ref:`the list of assert methods `.)" +msgstr "" + +msgid "" +"The :mod:`unittest` unit testing framework was originally inspired by JUnit " +"and has a similar flavor as major unit testing frameworks in other " +"languages. It supports test automation, sharing of setup and shutdown code " +"for tests, aggregation of tests into collections, and independence of the " +"tests from the reporting framework." +msgstr "" + +msgid "" +"To achieve this, :mod:`unittest` supports some important concepts in an " +"object-oriented way:" +msgstr "" + +msgid "test fixture" +msgstr "" + +msgid "" +"A :dfn:`test fixture` represents the preparation needed to perform one or " +"more tests, and any associated cleanup actions. This may involve, for " +"example, creating temporary or proxy databases, directories, or starting a " +"server process." +msgstr "" + +msgid "test case" +msgstr "" + +msgid "" +"A :dfn:`test case` is the individual unit of testing. It checks for a " +"specific response to a particular set of inputs. :mod:`unittest` provides a " +"base class, :class:`TestCase`, which may be used to create new test cases." +msgstr "" + +msgid "test suite" +msgstr "" + +msgid "" +"A :dfn:`test suite` is a collection of test cases, test suites, or both. It " +"is used to aggregate tests that should be executed together." +msgstr "" + +msgid "test runner" +msgstr "" + +msgid "" +"A :dfn:`test runner` is a component which orchestrates the execution of " +"tests and provides the outcome to the user. The runner may use a graphical " +"interface, a textual interface, or return a special value to indicate the " +"results of executing the tests." +msgstr "" + +msgid "Module :mod:`doctest`" +msgstr "" + +msgid "Another test-support module with a very different flavor." +msgstr "" + +msgid "" +"`Simple Smalltalk Testing: With Patterns `_" +msgstr "" + +msgid "" +"Kent Beck's original paper on testing frameworks using the pattern shared " +"by :mod:`unittest`." +msgstr "" + +msgid "`pytest `_" +msgstr "" + +msgid "" +"Third-party unittest framework with a lighter-weight syntax for writing " +"tests. For example, ``assert func(10) == 42``." +msgstr "" + +msgid "" +"`The Python Testing Tools Taxonomy `_" +msgstr "" + +msgid "" +"An extensive list of Python testing tools including functional testing " +"frameworks and mock object libraries." +msgstr "" + +msgid "" +"`Testing in Python Mailing List `_" +msgstr "" + +msgid "" +"A special-interest-group for discussion of testing, and testing tools, in " +"Python." +msgstr "" + +msgid "" +"The script :file:`Tools/unittestgui/unittestgui.py` in the Python source " +"distribution is a GUI tool for test discovery and execution. This is " +"intended largely for ease of use for those new to unit testing. For " +"production environments it is recommended that tests be driven by a " +"continuous integration system such as `Buildbot `_, " +"`Jenkins `_, `GitHub Actions `_, or `AppVeyor `_." +msgstr "" + +msgid "Basic example" +msgstr "" + +msgid "" +"The :mod:`unittest` module provides a rich set of tools for constructing and " +"running tests. This section demonstrates that a small subset of the tools " +"suffice to meet the needs of most users." +msgstr "" + +msgid "Here is a short script to test three string methods::" +msgstr "" + +msgid "" +"A testcase is created by subclassing :class:`unittest.TestCase`. The three " +"individual tests are defined with methods whose names start with the letters " +"``test``. This naming convention informs the test runner about which " +"methods represent tests." +msgstr "" + +msgid "" +"The crux of each test is a call to :meth:`~TestCase.assertEqual` to check " +"for an expected result; :meth:`~TestCase.assertTrue` or :meth:`~TestCase." +"assertFalse` to verify a condition; or :meth:`~TestCase.assertRaises` to " +"verify that a specific exception gets raised. These methods are used " +"instead of the :keyword:`assert` statement so the test runner can accumulate " +"all test results and produce a report." +msgstr "" + +msgid "" +"The :meth:`~TestCase.setUp` and :meth:`~TestCase.tearDown` methods allow you " +"to define instructions that will be executed before and after each test " +"method. They are covered in more detail in the section :ref:`organizing-" +"tests`." +msgstr "" + +msgid "" +"The final block shows a simple way to run the tests. :func:`unittest.main` " +"provides a command-line interface to the test script. When run from the " +"command line, the above script produces an output that looks like this::" +msgstr "" + +msgid "" +"Passing the ``-v`` option to your test script will instruct :func:`unittest." +"main` to enable a higher level of verbosity, and produce the following " +"output::" +msgstr "" + +msgid "" +"The above examples show the most commonly used :mod:`unittest` features " +"which are sufficient to meet many everyday testing needs. The remainder of " +"the documentation explores the full feature set from first principles." +msgstr "" + +msgid "" +"The behavior of returning a value from a test method (other than the default " +"``None`` value), is now deprecated." +msgstr "" + +msgid "Command-Line Interface" +msgstr "" + +msgid "" +"The unittest module can be used from the command line to run tests from " +"modules, classes or even individual test methods::" +msgstr "" + +msgid "" +"You can pass in a list with any combination of module names, and fully " +"qualified class or method names." +msgstr "" + +msgid "Test modules can be specified by file path as well::" +msgstr "" + +msgid "" +"This allows you to use the shell filename completion to specify the test " +"module. The file specified must still be importable as a module. The path is " +"converted to a module name by removing the '.py' and converting path " +"separators into '.'. If you want to execute a test file that isn't " +"importable as a module you should execute the file directly instead." +msgstr "" + +msgid "" +"You can run tests with more detail (higher verbosity) by passing in the -v " +"flag::" +msgstr "" + +msgid "" +"When executed without arguments :ref:`unittest-test-discovery` is started::" +msgstr "" + +msgid "For a list of all the command-line options::" +msgstr "" + +msgid "" +"In earlier versions it was only possible to run individual test methods and " +"not modules or classes." +msgstr "" + +msgid "Command-line options" +msgstr "" + +msgid ":program:`unittest` supports these command-line options:" +msgstr "" + +msgid "" +"The standard output and standard error streams are buffered during the test " +"run. Output during a passing test is discarded. Output is echoed normally on " +"test fail or error and is added to the failure messages." +msgstr "" + +msgid "" +":kbd:`Control-C` during the test run waits for the current test to end and " +"then reports all the results so far. A second :kbd:`Control-C` raises the " +"normal :exc:`KeyboardInterrupt` exception." +msgstr "" + +msgid "" +"See `Signal Handling`_ for the functions that provide this functionality." +msgstr "" + +msgid "Stop the test run on the first error or failure." +msgstr "" + +msgid "" +"Only run test methods and classes that match the pattern or substring. This " +"option may be used multiple times, in which case all test cases that match " +"any of the given patterns are included." +msgstr "" + +msgid "" +"Patterns that contain a wildcard character (``*``) are matched against the " +"test name using :meth:`fnmatch.fnmatchcase`; otherwise simple case-sensitive " +"substring matching is used." +msgstr "" + +msgid "" +"Patterns are matched against the fully qualified test method name as " +"imported by the test loader." +msgstr "" + +msgid "" +"For example, ``-k foo`` matches ``foo_tests.SomeTest.test_something``, " +"``bar_tests.SomeTest.test_foo``, but not ``bar_tests.FooTest." +"test_something``." +msgstr "" + +msgid "Show local variables in tracebacks." +msgstr "" + +msgid "The command-line options ``-b``, ``-c`` and ``-f`` were added." +msgstr "" + +msgid "The command-line option ``--locals``." +msgstr "" + +msgid "The command-line option ``-k``." +msgstr "" + +msgid "" +"The command line can also be used for test discovery, for running all of the " +"tests in a project or just a subset." +msgstr "" + +msgid "Test Discovery" +msgstr "" + +msgid "" +"Unittest supports simple test discovery. In order to be compatible with test " +"discovery, all of the test files must be :ref:`modules ` or :" +"ref:`packages ` importable from the top-level directory of the " +"project (this means that their filenames must be valid :ref:`identifiers " +"`)." +msgstr "" + +msgid "" +"Test discovery is implemented in :meth:`TestLoader.discover`, but can also " +"be used from the command line. The basic command-line usage is::" +msgstr "" + +msgid "" +"As a shortcut, ``python -m unittest`` is the equivalent of ``python -m " +"unittest discover``. If you want to pass arguments to test discovery the " +"``discover`` sub-command must be used explicitly." +msgstr "" + +msgid "The ``discover`` sub-command has the following options:" +msgstr "" + +msgid "Verbose output" +msgstr "" + +msgid "Directory to start discovery (``.`` default)" +msgstr "" + +msgid "Pattern to match test files (``test*.py`` default)" +msgstr "" + +msgid "Top level directory of project (defaults to start directory)" +msgstr "" + +msgid "" +"The :option:`-s`, :option:`-p`, and :option:`-t` options can be passed in as " +"positional arguments in that order. The following two command lines are " +"equivalent::" +msgstr "" + +msgid "" +"As well as being a path it is possible to pass a package name, for example " +"``myproject.subpackage.test``, as the start directory. The package name you " +"supply will then be imported and its location on the filesystem will be used " +"as the start directory." +msgstr "" + +msgid "" +"Test discovery loads tests by importing them. Once test discovery has found " +"all the test files from the start directory you specify it turns the paths " +"into package names to import. For example :file:`foo/bar/baz.py` will be " +"imported as ``foo.bar.baz``." +msgstr "" + +msgid "" +"If you have a package installed globally and attempt test discovery on a " +"different copy of the package then the import *could* happen from the wrong " +"place. If this happens test discovery will warn you and exit." +msgstr "" + +msgid "" +"If you supply the start directory as a package name rather than a path to a " +"directory then discover assumes that whichever location it imports from is " +"the location you intended, so you will not get the warning." +msgstr "" + +msgid "" +"Test modules and packages can customize test loading and discovery by " +"through the `load_tests protocol`_." +msgstr "" + +msgid "" +"Test discovery supports :term:`namespace packages ` for " +"the start directory. Note that you need to specify the top level directory " +"too (e.g. ``python -m unittest discover -s root/namespace -t root``)." +msgstr "" + +msgid "" +":mod:`unittest` dropped the :term:`namespace packages ` " +"support in Python 3.11. It has been broken since Python 3.7. Start directory " +"and subdirectories containing tests must be regular package that have " +"``__init__.py`` file." +msgstr "" + +msgid "" +"Directories containing start directory still can be a namespace package. In " +"this case, you need to specify start directory as dotted package name, and " +"target directory explicitly. For example::" +msgstr "" + +msgid "Organizing test code" +msgstr "" + +msgid "" +"The basic building blocks of unit testing are :dfn:`test cases` --- single " +"scenarios that must be set up and checked for correctness. In :mod:" +"`unittest`, test cases are represented by :class:`unittest.TestCase` " +"instances. To make your own test cases you must write subclasses of :class:" +"`TestCase` or use :class:`FunctionTestCase`." +msgstr "" + +msgid "" +"The testing code of a :class:`TestCase` instance should be entirely self " +"contained, such that it can be run either in isolation or in arbitrary " +"combination with any number of other test cases." +msgstr "" + +msgid "" +"The simplest :class:`TestCase` subclass will simply implement a test method " +"(i.e. a method whose name starts with ``test``) in order to perform specific " +"testing code::" +msgstr "" + +msgid "" +"Note that in order to test something, we use one of the :ref:`assert\\* " +"methods ` provided by the :class:`TestCase` base class. If " +"the test fails, an exception will be raised with an explanatory message, " +"and :mod:`unittest` will identify the test case as a :dfn:`failure`. Any " +"other exceptions will be treated as :dfn:`errors`." +msgstr "" + +msgid "" +"Tests can be numerous, and their set-up can be repetitive. Luckily, we can " +"factor out set-up code by implementing a method called :meth:`~TestCase." +"setUp`, which the testing framework will automatically call for every single " +"test we run::" +msgstr "" + +msgid "" +"The order in which the various tests will be run is determined by sorting " +"the test method names with respect to the built-in ordering for strings." +msgstr "" + +msgid "" +"If the :meth:`~TestCase.setUp` method raises an exception while the test is " +"running, the framework will consider the test to have suffered an error, and " +"the test method will not be executed." +msgstr "" + +msgid "" +"Similarly, we can provide a :meth:`~TestCase.tearDown` method that tidies up " +"after the test method has been run::" +msgstr "" + +msgid "" +"If :meth:`~TestCase.setUp` succeeded, :meth:`~TestCase.tearDown` will be run " +"whether the test method succeeded or not." +msgstr "" + +msgid "" +"Such a working environment for the testing code is called a :dfn:`test " +"fixture`. A new TestCase instance is created as a unique test fixture used " +"to execute each individual test method. Thus :meth:`~TestCase.setUp`, :meth:" +"`~TestCase.tearDown`, and :meth:`~TestCase.__init__` will be called once per " +"test." +msgstr "" + +msgid "" +"It is recommended that you use TestCase implementations to group tests " +"together according to the features they test. :mod:`unittest` provides a " +"mechanism for this: the :dfn:`test suite`, represented by :mod:`unittest`'s :" +"class:`TestSuite` class. In most cases, calling :func:`unittest.main` will " +"do the right thing and collect all the module's test cases for you and " +"execute them." +msgstr "" + +msgid "" +"However, should you want to customize the building of your test suite, you " +"can do it yourself::" +msgstr "" + +msgid "" +"You can place the definitions of test cases and test suites in the same " +"modules as the code they are to test (such as :file:`widget.py`), but there " +"are several advantages to placing the test code in a separate module, such " +"as :file:`test_widget.py`:" +msgstr "" + +msgid "The test module can be run standalone from the command line." +msgstr "" + +msgid "The test code can more easily be separated from shipped code." +msgstr "" + +msgid "" +"There is less temptation to change test code to fit the code it tests " +"without a good reason." +msgstr "" + +msgid "" +"Test code should be modified much less frequently than the code it tests." +msgstr "" + +msgid "Tested code can be refactored more easily." +msgstr "" + +msgid "" +"Tests for modules written in C must be in separate modules anyway, so why " +"not be consistent?" +msgstr "" + +msgid "" +"If the testing strategy changes, there is no need to change the source code." +msgstr "" + +msgid "Re-using old test code" +msgstr "" + +msgid "" +"Some users will find that they have existing test code that they would like " +"to run from :mod:`unittest`, without converting every old test function to " +"a :class:`TestCase` subclass." +msgstr "" + +msgid "" +"For this reason, :mod:`unittest` provides a :class:`FunctionTestCase` class. " +"This subclass of :class:`TestCase` can be used to wrap an existing test " +"function. Set-up and tear-down functions can also be provided." +msgstr "" + +msgid "Given the following test function::" +msgstr "" + +msgid "" +"one can create an equivalent test case instance as follows, with optional " +"set-up and tear-down methods::" +msgstr "" + +msgid "" +"Even though :class:`FunctionTestCase` can be used to quickly convert an " +"existing test base over to a :mod:`unittest`\\ -based system, this approach " +"is not recommended. Taking the time to set up proper :class:`TestCase` " +"subclasses will make future test refactorings infinitely easier." +msgstr "" + +msgid "" +"In some cases, the existing tests may have been written using the :mod:" +"`doctest` module. If so, :mod:`doctest` provides a :class:`DocTestSuite` " +"class that can automatically build :class:`unittest.TestSuite` instances " +"from the existing :mod:`doctest`\\ -based tests." +msgstr "" + +msgid "Skipping tests and expected failures" +msgstr "" + +msgid "" +"Unittest supports skipping individual test methods and even whole classes of " +"tests. In addition, it supports marking a test as an \"expected failure,\" " +"a test that is broken and will fail, but shouldn't be counted as a failure " +"on a :class:`TestResult`." +msgstr "" + +msgid "" +"Skipping a test is simply a matter of using the :func:`skip` :term:" +"`decorator` or one of its conditional variants, calling :meth:`TestCase." +"skipTest` within a :meth:`~TestCase.setUp` or test method, or raising :exc:" +"`SkipTest` directly." +msgstr "" + +msgid "Basic skipping looks like this::" +msgstr "" + +msgid "This is the output of running the example above in verbose mode::" +msgstr "" + +msgid "Classes can be skipped just like methods::" +msgstr "" + +msgid "" +":meth:`TestCase.setUp` can also skip the test. This is useful when a " +"resource that needs to be set up is not available." +msgstr "" + +msgid "Expected failures use the :func:`expectedFailure` decorator. ::" +msgstr "" + +msgid "" +"It's easy to roll your own skipping decorators by making a decorator that " +"calls :func:`skip` on the test when it wants it to be skipped. This " +"decorator skips the test unless the passed object has a certain attribute::" +msgstr "" + +msgid "" +"The following decorators and exception implement test skipping and expected " +"failures:" +msgstr "" + +msgid "" +"Unconditionally skip the decorated test. *reason* should describe why the " +"test is being skipped." +msgstr "" + +msgid "Skip the decorated test if *condition* is true." +msgstr "" + +msgid "Skip the decorated test unless *condition* is true." +msgstr "" + +msgid "" +"Mark the test as an expected failure or error. If the test fails or errors " +"in the test function itself (rather than in one of the :dfn:`test fixture` " +"methods) then it will be considered a success. If the test passes, it will " +"be considered a failure." +msgstr "" + +msgid "This exception is raised to skip a test." +msgstr "" + +msgid "" +"Usually you can use :meth:`TestCase.skipTest` or one of the skipping " +"decorators instead of raising this directly." +msgstr "" + +msgid "" +"Skipped tests will not have :meth:`~TestCase.setUp` or :meth:`~TestCase." +"tearDown` run around them. Skipped classes will not have :meth:`~TestCase." +"setUpClass` or :meth:`~TestCase.tearDownClass` run. Skipped modules will not " +"have :func:`setUpModule` or :func:`tearDownModule` run." +msgstr "" + +msgid "Distinguishing test iterations using subtests" +msgstr "" + +msgid "" +"When there are very small differences among your tests, for instance some " +"parameters, unittest allows you to distinguish them inside the body of a " +"test method using the :meth:`~TestCase.subTest` context manager." +msgstr "" + +msgid "For example, the following test::" +msgstr "" + +msgid "will produce the following output::" +msgstr "" + +msgid "" +"Without using a subtest, execution would stop after the first failure, and " +"the error would be less easy to diagnose because the value of ``i`` wouldn't " +"be displayed::" +msgstr "" + +msgid "Classes and functions" +msgstr "" + +msgid "This section describes in depth the API of :mod:`unittest`." +msgstr "" + +msgid "Test cases" +msgstr "" + +msgid "" +"Instances of the :class:`TestCase` class represent the logical test units in " +"the :mod:`unittest` universe. This class is intended to be used as a base " +"class, with specific tests being implemented by concrete subclasses. This " +"class implements the interface needed by the test runner to allow it to " +"drive the tests, and methods that the test code can use to check for and " +"report various kinds of failure." +msgstr "" + +msgid "" +"Each instance of :class:`TestCase` will run a single base method: the method " +"named *methodName*. In most uses of :class:`TestCase`, you will neither " +"change the *methodName* nor reimplement the default ``runTest()`` method." +msgstr "" + +msgid "" +":class:`TestCase` can be instantiated successfully without providing a " +"*methodName*. This makes it easier to experiment with :class:`TestCase` from " +"the interactive interpreter." +msgstr "" + +msgid "" +":class:`TestCase` instances provide three groups of methods: one group used " +"to run the test, another used by the test implementation to check conditions " +"and report failures, and some inquiry methods allowing information about the " +"test itself to be gathered." +msgstr "" + +msgid "Methods in the first group (running the test) are:" +msgstr "" + +msgid "" +"Method called to prepare the test fixture. This is called immediately " +"before calling the test method; other than :exc:`AssertionError` or :exc:" +"`SkipTest`, any exception raised by this method will be considered an error " +"rather than a test failure. The default implementation does nothing." +msgstr "" + +msgid "" +"Method called immediately after the test method has been called and the " +"result recorded. This is called even if the test method raised an " +"exception, so the implementation in subclasses may need to be particularly " +"careful about checking internal state. Any exception, other than :exc:" +"`AssertionError` or :exc:`SkipTest`, raised by this method will be " +"considered an additional error rather than a test failure (thus increasing " +"the total number of reported errors). This method will only be called if " +"the :meth:`setUp` succeeds, regardless of the outcome of the test method. " +"The default implementation does nothing." +msgstr "" + +msgid "" +"A class method called before tests in an individual class are run. " +"``setUpClass`` is called with the class as the only argument and must be " +"decorated as a :func:`classmethod`::" +msgstr "" + +msgid "See `Class and Module Fixtures`_ for more details." +msgstr "" + +msgid "" +"A class method called after tests in an individual class have run. " +"``tearDownClass`` is called with the class as the only argument and must be " +"decorated as a :meth:`classmethod`::" +msgstr "" + +msgid "" +"Run the test, collecting the result into the :class:`TestResult` object " +"passed as *result*. If *result* is omitted or ``None``, a temporary result " +"object is created (by calling the :meth:`defaultTestResult` method) and " +"used. The result object is returned to :meth:`run`'s caller." +msgstr "" + +msgid "" +"The same effect may be had by simply calling the :class:`TestCase` instance." +msgstr "" + +msgid "" +"Previous versions of ``run`` did not return the result. Neither did calling " +"an instance." +msgstr "" + +msgid "" +"Calling this during a test method or :meth:`setUp` skips the current test. " +"See :ref:`unittest-skipping` for more information." +msgstr "" + +msgid "" +"Return a context manager which executes the enclosed code block as a " +"subtest. *msg* and *params* are optional, arbitrary values which are " +"displayed whenever a subtest fails, allowing you to identify them clearly." +msgstr "" + +msgid "" +"A test case can contain any number of subtest declarations, and they can be " +"arbitrarily nested." +msgstr "" + +msgid "See :ref:`subtests` for more information." +msgstr "" + +msgid "" +"Run the test without collecting the result. This allows exceptions raised " +"by the test to be propagated to the caller, and can be used to support " +"running tests under a debugger." +msgstr "" + +msgid "" +"The :class:`TestCase` class provides several assert methods to check for and " +"report failures. The following table lists the most commonly used methods " +"(see the tables below for more assert methods):" +msgstr "" + +msgid "Method" +msgstr "" + +msgid "Checks that" +msgstr "" + +msgid "New in" +msgstr "" + +msgid ":meth:`assertEqual(a, b) `" +msgstr "" + +msgid "``a == b``" +msgstr "``a == b``" + +msgid ":meth:`assertNotEqual(a, b) `" +msgstr "" + +msgid "``a != b``" +msgstr "``a != b``" + +msgid ":meth:`assertTrue(x) `" +msgstr "" + +msgid "``bool(x) is True``" +msgstr "``bool(x) is True``" + +msgid ":meth:`assertFalse(x) `" +msgstr "" + +msgid "``bool(x) is False``" +msgstr "" + +msgid ":meth:`assertIs(a, b) `" +msgstr "" + +msgid "``a is b``" +msgstr "``a is b``" + +msgid "3.1" +msgstr "" + +msgid ":meth:`assertIsNot(a, b) `" +msgstr "" + +msgid "``a is not b``" +msgstr "" + +msgid ":meth:`assertIsNone(x) `" +msgstr "" + +msgid "``x is None``" +msgstr "``x is None``" + +msgid ":meth:`assertIsNotNone(x) `" +msgstr "" + +msgid "``x is not None``" +msgstr "" + +msgid ":meth:`assertIn(a, b) `" +msgstr "" + +msgid "``a in b``" +msgstr "``a in b``" + +msgid ":meth:`assertNotIn(a, b) `" +msgstr "" + +msgid "``a not in b``" +msgstr "" + +msgid ":meth:`assertIsInstance(a, b) `" +msgstr "" + +msgid "``isinstance(a, b)``" +msgstr "``isinstance(a, b)``" + +msgid "3.2" +msgstr "" + +msgid ":meth:`assertNotIsInstance(a, b) `" +msgstr "" + +msgid "``not isinstance(a, b)``" +msgstr "" + +msgid "" +"All the assert methods accept a *msg* argument that, if specified, is used " +"as the error message on failure (see also :data:`longMessage`). Note that " +"the *msg* keyword argument can be passed to :meth:`assertRaises`, :meth:" +"`assertRaisesRegex`, :meth:`assertWarns`, :meth:`assertWarnsRegex` only when " +"they are used as a context manager." +msgstr "" + +msgid "" +"Test that *first* and *second* are equal. If the values do not compare " +"equal, the test will fail." +msgstr "" + +msgid "" +"In addition, if *first* and *second* are the exact same type and one of " +"list, tuple, dict, set, frozenset or str or any type that a subclass " +"registers with :meth:`addTypeEqualityFunc` the type-specific equality " +"function will be called in order to generate a more useful default error " +"message (see also the :ref:`list of type-specific methods `)." +msgstr "" + +msgid "Added the automatic calling of type-specific equality function." +msgstr "" + +msgid "" +":meth:`assertMultiLineEqual` added as the default type equality function for " +"comparing strings." +msgstr "" + +msgid "" +"Test that *first* and *second* are not equal. If the values do compare " +"equal, the test will fail." +msgstr "" + +msgid "Test that *expr* is true (or false)." +msgstr "" + +msgid "" +"Note that this is equivalent to ``bool(expr) is True`` and not to ``expr is " +"True`` (use ``assertIs(expr, True)`` for the latter). This method should " +"also be avoided when more specific methods are available (e.g. " +"``assertEqual(a, b)`` instead of ``assertTrue(a == b)``), because they " +"provide a better error message in case of failure." +msgstr "" + +msgid "Test that *first* and *second* are (or are not) the same object." +msgstr "" + +msgid "Test that *expr* is (or is not) ``None``." +msgstr "" + +msgid "Test that *member* is (or is not) in *container*." +msgstr "" + +msgid "" +"Test that *obj* is (or is not) an instance of *cls* (which can be a class or " +"a tuple of classes, as supported by :func:`isinstance`). To check for the " +"exact type, use :func:`assertIs(type(obj), cls) `." +msgstr "" + +msgid "" +"It is also possible to check the production of exceptions, warnings, and log " +"messages using the following methods:" +msgstr "" + +msgid ":meth:`assertRaises(exc, fun, *args, **kwds) `" +msgstr "" + +msgid "``fun(*args, **kwds)`` raises *exc*" +msgstr "" + +msgid "" +":meth:`assertRaisesRegex(exc, r, fun, *args, **kwds) `" +msgstr "" + +msgid "``fun(*args, **kwds)`` raises *exc* and the message matches regex *r*" +msgstr "" + +msgid ":meth:`assertWarns(warn, fun, *args, **kwds) `" +msgstr "" + +msgid "``fun(*args, **kwds)`` raises *warn*" +msgstr "" + +msgid "" +":meth:`assertWarnsRegex(warn, r, fun, *args, **kwds) `" +msgstr "" + +msgid "``fun(*args, **kwds)`` raises *warn* and the message matches regex *r*" +msgstr "" + +msgid ":meth:`assertLogs(logger, level) `" +msgstr "" + +msgid "The ``with`` block logs on *logger* with minimum *level*" +msgstr "" + +msgid "3.4" +msgstr "" + +msgid ":meth:`assertNoLogs(logger, level) `" +msgstr "" + +msgid "The ``with`` block does not log on" +msgstr "" + +msgid "*logger* with minimum *level*" +msgstr "" + +msgid "3.10" +msgstr "" + +msgid "" +"Test that an exception is raised when *callable* is called with any " +"positional or keyword arguments that are also passed to :meth:" +"`assertRaises`. The test passes if *exception* is raised, is an error if " +"another exception is raised, or fails if no exception is raised. To catch " +"any of a group of exceptions, a tuple containing the exception classes may " +"be passed as *exception*." +msgstr "" +"Sprawdza czy rzucany jest wyjątek przy wywołaniu *callable* z dowolnymi " +"pozycyjnymi lub nazwanymi argumentami, które są też przekazane do :meth:" +"`assertRaises`. Test przechodzi pomyślnie, jeśli rzucony jest wyjątek " +"*exception*, kończy się błędem, jeśli rzucony jest inny wyjątek, lub kończy " +"się niepowodzeniem, jeśli żaden wyjątek nie jest rzucony. Aby przechwycić " +"dowolny z grupy wyjątków, jako *exception* można przekazać krotkę " +"zawierającą klasy wyjątków." + +msgid "" +"If only the *exception* and possibly the *msg* arguments are given, return a " +"context manager so that the code under test can be written inline rather " +"than as a function::" +msgstr "" + +msgid "" +"When used as a context manager, :meth:`assertRaises` accepts the additional " +"keyword argument *msg*." +msgstr "" + +msgid "" +"The context manager will store the caught exception object in its :attr:" +"`exception` attribute. This can be useful if the intention is to perform " +"additional checks on the exception raised::" +msgstr "" + +msgid "Added the ability to use :meth:`assertRaises` as a context manager." +msgstr "" + +msgid "Added the :attr:`exception` attribute." +msgstr "" + +msgid "Added the *msg* keyword argument when used as a context manager." +msgstr "" + +msgid "" +"Like :meth:`assertRaises` but also tests that *regex* matches on the string " +"representation of the raised exception. *regex* may be a regular expression " +"object or a string containing a regular expression suitable for use by :func:" +"`re.search`. Examples::" +msgstr "" + +msgid "or::" +msgstr "lub::" + +msgid "Added under the name ``assertRaisesRegexp``." +msgstr "" + +msgid "Renamed to :meth:`assertRaisesRegex`." +msgstr "" + +msgid "" +"Test that a warning is triggered when *callable* is called with any " +"positional or keyword arguments that are also passed to :meth:" +"`assertWarns`. The test passes if *warning* is triggered and fails if it " +"isn't. Any exception is an error. To catch any of a group of warnings, a " +"tuple containing the warning classes may be passed as *warnings*." +msgstr "" + +msgid "" +"If only the *warning* and possibly the *msg* arguments are given, return a " +"context manager so that the code under test can be written inline rather " +"than as a function::" +msgstr "" + +msgid "" +"When used as a context manager, :meth:`assertWarns` accepts the additional " +"keyword argument *msg*." +msgstr "" + +msgid "" +"The context manager will store the caught warning object in its :attr:" +"`warning` attribute, and the source line which triggered the warnings in " +"the :attr:`filename` and :attr:`lineno` attributes. This can be useful if " +"the intention is to perform additional checks on the warning caught::" +msgstr "" + +msgid "" +"This method works regardless of the warning filters in place when it is " +"called." +msgstr "" + +msgid "" +"Like :meth:`assertWarns` but also tests that *regex* matches on the message " +"of the triggered warning. *regex* may be a regular expression object or a " +"string containing a regular expression suitable for use by :func:`re." +"search`. Example::" +msgstr "" + +msgid "" +"A context manager to test that at least one message is logged on the " +"*logger* or one of its children, with at least the given *level*." +msgstr "" + +msgid "" +"If given, *logger* should be a :class:`logging.Logger` object or a :class:" +"`str` giving the name of a logger. The default is the root logger, which " +"will catch all messages that were not blocked by a non-propagating " +"descendent logger." +msgstr "" + +msgid "" +"If given, *level* should be either a numeric logging level or its string " +"equivalent (for example either ``\"ERROR\"`` or :const:`logging.ERROR`). " +"The default is :const:`logging.INFO`." +msgstr "" + +msgid "" +"The test passes if at least one message emitted inside the ``with`` block " +"matches the *logger* and *level* conditions, otherwise it fails." +msgstr "" + +msgid "" +"The object returned by the context manager is a recording helper which keeps " +"tracks of the matching log messages. It has two attributes:" +msgstr "" + +msgid "" +"A list of :class:`logging.LogRecord` objects of the matching log messages." +msgstr "" + +msgid "" +"A list of :class:`str` objects with the formatted output of matching " +"messages." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +"A context manager to test that no messages are logged on the *logger* or one " +"of its children, with at least the given *level*." +msgstr "" + +msgid "" +"If given, *logger* should be a :class:`logging.Logger` object or a :class:" +"`str` giving the name of a logger. The default is the root logger, which " +"will catch all messages." +msgstr "" + +msgid "" +"Unlike :meth:`assertLogs`, nothing will be returned by the context manager." +msgstr "" + +msgid "" +"There are also other methods used to perform more specific checks, such as:" +msgstr "" + +msgid ":meth:`assertAlmostEqual(a, b) `" +msgstr "" + +msgid "``round(a-b, 7) == 0``" +msgstr "``round(a-b, 7) == 0``" + +msgid ":meth:`assertNotAlmostEqual(a, b) `" +msgstr "" + +msgid "``round(a-b, 7) != 0``" +msgstr "" + +msgid ":meth:`assertGreater(a, b) `" +msgstr "" + +msgid "``a > b``" +msgstr "``a > b``" + +msgid ":meth:`assertGreaterEqual(a, b) `" +msgstr "" + +msgid "``a >= b``" +msgstr "``a >= b``" + +msgid ":meth:`assertLess(a, b) `" +msgstr "" + +msgid "``a < b``" +msgstr "``a < b``" + +msgid ":meth:`assertLessEqual(a, b) `" +msgstr "" + +msgid "``a <= b``" +msgstr "``a <= b``" + +msgid ":meth:`assertRegex(s, r) `" +msgstr "" + +msgid "``r.search(s)``" +msgstr "" + +msgid ":meth:`assertNotRegex(s, r) `" +msgstr "" + +msgid "``not r.search(s)``" +msgstr "``not r.search(s)``" + +msgid ":meth:`assertCountEqual(a, b) `" +msgstr "" + +msgid "" +"*a* and *b* have the same elements in the same number, regardless of their " +"order." +msgstr "" + +msgid "" +"Test that *first* and *second* are approximately (or not approximately) " +"equal by computing the difference, rounding to the given number of decimal " +"*places* (default 7), and comparing to zero. Note that these methods round " +"the values to the given number of *decimal places* (i.e. like the :func:" +"`round` function) and not *significant digits*." +msgstr "" + +msgid "" +"If *delta* is supplied instead of *places* then the difference between " +"*first* and *second* must be less or equal to (or greater than) *delta*." +msgstr "" + +msgid "Supplying both *delta* and *places* raises a :exc:`TypeError`." +msgstr "" + +msgid "" +":meth:`assertAlmostEqual` automatically considers almost equal objects that " +"compare equal. :meth:`assertNotAlmostEqual` automatically fails if the " +"objects compare equal. Added the *delta* keyword argument." +msgstr "" + +msgid "" +"Test that *first* is respectively >, >=, < or <= than *second* depending on " +"the method name. If not, the test will fail::" +msgstr "" + +msgid "" +"Test that a *regex* search matches (or does not match) *text*. In case of " +"failure, the error message will include the pattern and the *text* (or the " +"pattern and the part of *text* that unexpectedly matched). *regex* may be a " +"regular expression object or a string containing a regular expression " +"suitable for use by :func:`re.search`." +msgstr "" + +msgid "Added under the name ``assertRegexpMatches``." +msgstr "" + +msgid "" +"The method ``assertRegexpMatches()`` has been renamed to :meth:`." +"assertRegex`." +msgstr "" + +msgid ":meth:`.assertNotRegex`." +msgstr ":meth:`.assertNotRegex`." + +msgid "" +"The name ``assertNotRegexpMatches`` is a deprecated alias for :meth:`." +"assertNotRegex`." +msgstr "" + +msgid "" +"Test that sequence *first* contains the same elements as *second*, " +"regardless of their order. When they don't, an error message listing the " +"differences between the sequences will be generated." +msgstr "" + +msgid "" +"Duplicate elements are *not* ignored when comparing *first* and *second*. It " +"verifies whether each element has the same count in both sequences. " +"Equivalent to: ``assertEqual(Counter(list(first)), Counter(list(second)))`` " +"but works with sequences of unhashable objects as well." +msgstr "" + +msgid "" +"The :meth:`assertEqual` method dispatches the equality check for objects of " +"the same type to different type-specific methods. These methods are already " +"implemented for most of the built-in types, but it's also possible to " +"register new methods using :meth:`addTypeEqualityFunc`:" +msgstr "" + +msgid "" +"Registers a type-specific method called by :meth:`assertEqual` to check if " +"two objects of exactly the same *typeobj* (not subclasses) compare equal. " +"*function* must take two positional arguments and a third msg=None keyword " +"argument just as :meth:`assertEqual` does. It must raise :data:`self." +"failureException(msg) ` when inequality between the first " +"two parameters is detected -- possibly providing useful information and " +"explaining the inequalities in details in the error message." +msgstr "" + +msgid "" +"The list of type-specific methods automatically used by :meth:`~TestCase." +"assertEqual` are summarized in the following table. Note that it's usually " +"not necessary to invoke these methods directly." +msgstr "" + +msgid "Used to compare" +msgstr "" + +msgid ":meth:`assertMultiLineEqual(a, b) `" +msgstr "" + +msgid "strings" +msgstr "" + +msgid ":meth:`assertSequenceEqual(a, b) `" +msgstr "" + +msgid "sequences" +msgstr "" + +msgid ":meth:`assertListEqual(a, b) `" +msgstr "" + +msgid "lists" +msgstr "" + +msgid ":meth:`assertTupleEqual(a, b) `" +msgstr "" + +msgid "tuples" +msgstr "" + +msgid ":meth:`assertSetEqual(a, b) `" +msgstr "" + +msgid "sets or frozensets" +msgstr "" + +msgid ":meth:`assertDictEqual(a, b) `" +msgstr "" + +msgid "dicts" +msgstr "" + +msgid "" +"Test that the multiline string *first* is equal to the string *second*. When " +"not equal a diff of the two strings highlighting the differences will be " +"included in the error message. This method is used by default when comparing " +"strings with :meth:`assertEqual`." +msgstr "" + +msgid "" +"Tests that two sequences are equal. If a *seq_type* is supplied, both " +"*first* and *second* must be instances of *seq_type* or a failure will be " +"raised. If the sequences are different an error message is constructed that " +"shows the difference between the two." +msgstr "" + +msgid "" +"This method is not called directly by :meth:`assertEqual`, but it's used to " +"implement :meth:`assertListEqual` and :meth:`assertTupleEqual`." +msgstr "" + +msgid "" +"Tests that two lists or tuples are equal. If not, an error message is " +"constructed that shows only the differences between the two. An error is " +"also raised if either of the parameters are of the wrong type. These methods " +"are used by default when comparing lists or tuples with :meth:`assertEqual`." +msgstr "" +"Sprawdza, czy dwie listy lub krotki są równe. Jeśli nie, tworzony jest " +"komunikat o błędzie, który pokazuje tylko różnice między nimi. Błąd jest " +"również rzucany jeśli którykolwiek z parametrów jest niewłaściwego typu. " +"Metody te są używane domyślnie podczas porównywania list lub krotek przy " +"użyciu :meth:`assertEqual`." + +msgid "" +"Tests that two sets are equal. If not, an error message is constructed that " +"lists the differences between the sets. This method is used by default when " +"comparing sets or frozensets with :meth:`assertEqual`." +msgstr "" + +msgid "" +"Fails if either of *first* or *second* does not have a :meth:`set." +"difference` method." +msgstr "" + +msgid "" +"Test that two dictionaries are equal. If not, an error message is " +"constructed that shows the differences in the dictionaries. This method will " +"be used by default to compare dictionaries in calls to :meth:`assertEqual`." +msgstr "" + +msgid "" +"Finally the :class:`TestCase` provides the following methods and attributes:" +msgstr "" + +msgid "" +"Signals a test failure unconditionally, with *msg* or ``None`` for the error " +"message." +msgstr "" + +msgid "" +"This class attribute gives the exception raised by the test method. If a " +"test framework needs to use a specialized exception, possibly to carry " +"additional information, it must subclass this exception in order to \"play " +"fair\" with the framework. The initial value of this attribute is :exc:" +"`AssertionError`." +msgstr "" + +msgid "" +"This class attribute determines what happens when a custom failure message " +"is passed as the msg argument to an assertXYY call that fails. ``True`` is " +"the default value. In this case, the custom message is appended to the end " +"of the standard failure message. When set to ``False``, the custom message " +"replaces the standard message." +msgstr "" + +msgid "" +"The class setting can be overridden in individual test methods by assigning " +"an instance attribute, self.longMessage, to ``True`` or ``False`` before " +"calling the assert methods." +msgstr "" + +msgid "The class setting gets reset before each test call." +msgstr "" + +msgid "" +"This attribute controls the maximum length of diffs output by assert methods " +"that report diffs on failure. It defaults to 80*8 characters. Assert methods " +"affected by this attribute are :meth:`assertSequenceEqual` (including all " +"the sequence comparison methods that delegate to it), :meth:" +"`assertDictEqual` and :meth:`assertMultiLineEqual`." +msgstr "" + +msgid "" +"Setting ``maxDiff`` to ``None`` means that there is no maximum length of " +"diffs." +msgstr "" + +msgid "" +"Testing frameworks can use the following methods to collect information on " +"the test:" +msgstr "" + +msgid "" +"Return the number of tests represented by this test object. For :class:" +"`TestCase` instances, this will always be ``1``." +msgstr "" + +msgid "" +"Return an instance of the test result class that should be used for this " +"test case class (if no other result instance is provided to the :meth:`run` " +"method)." +msgstr "" + +msgid "" +"For :class:`TestCase` instances, this will always be an instance of :class:" +"`TestResult`; subclasses of :class:`TestCase` should override this as " +"necessary." +msgstr "" + +msgid "" +"Return a string identifying the specific test case. This is usually the " +"full name of the test method, including the module and class name." +msgstr "" + +msgid "" +"Returns a description of the test, or ``None`` if no description has been " +"provided. The default implementation of this method returns the first line " +"of the test method's docstring, if available, or ``None``." +msgstr "" + +msgid "" +"In 3.1 this was changed to add the test name to the short description even " +"in the presence of a docstring. This caused compatibility issues with " +"unittest extensions and adding the test name was moved to the :class:" +"`TextTestResult` in Python 3.2." +msgstr "" + +msgid "" +"Add a function to be called after :meth:`tearDown` to cleanup resources used " +"during the test. Functions will be called in reverse order to the order they " +"are added (:abbr:`LIFO (last-in, first-out)`). They are called with any " +"arguments and keyword arguments passed into :meth:`addCleanup` when they are " +"added." +msgstr "" + +msgid "" +"If :meth:`setUp` fails, meaning that :meth:`tearDown` is not called, then " +"any cleanup functions added will still be called." +msgstr "" + +msgid "" +"Enter the supplied :term:`context manager`. If successful, also add its :" +"meth:`~object.__exit__` method as a cleanup function by :meth:`addCleanup` " +"and return the result of the :meth:`~object.__enter__` method." +msgstr "" + +msgid "" +"This method is called unconditionally after :meth:`tearDown`, or after :meth:" +"`setUp` if :meth:`setUp` raises an exception." +msgstr "" + +msgid "" +"It is responsible for calling all the cleanup functions added by :meth:" +"`addCleanup`. If you need cleanup functions to be called *prior* to :meth:" +"`tearDown` then you can call :meth:`doCleanups` yourself." +msgstr "" + +msgid "" +":meth:`doCleanups` pops methods off the stack of cleanup functions one at a " +"time, so it can be called at any time." +msgstr "" + +msgid "" +"Add a function to be called after :meth:`tearDownClass` to cleanup resources " +"used during the test class. Functions will be called in reverse order to the " +"order they are added (:abbr:`LIFO (last-in, first-out)`). They are called " +"with any arguments and keyword arguments passed into :meth:`addClassCleanup` " +"when they are added." +msgstr "" + +msgid "" +"If :meth:`setUpClass` fails, meaning that :meth:`tearDownClass` is not " +"called, then any cleanup functions added will still be called." +msgstr "" + +msgid "" +"Enter the supplied :term:`context manager`. If successful, also add its :" +"meth:`~object.__exit__` method as a cleanup function by :meth:" +"`addClassCleanup` and return the result of the :meth:`~object.__enter__` " +"method." +msgstr "" + +msgid "" +"This method is called unconditionally after :meth:`tearDownClass`, or after :" +"meth:`setUpClass` if :meth:`setUpClass` raises an exception." +msgstr "" + +msgid "" +"It is responsible for calling all the cleanup functions added by :meth:" +"`addClassCleanup`. If you need cleanup functions to be called *prior* to :" +"meth:`tearDownClass` then you can call :meth:`doClassCleanups` yourself." +msgstr "" + +msgid "" +":meth:`doClassCleanups` pops methods off the stack of cleanup functions one " +"at a time, so it can be called at any time." +msgstr "" + +msgid "" +"This class provides an API similar to :class:`TestCase` and also accepts " +"coroutines as test functions." +msgstr "" + +msgid "" +"Method called to prepare the test fixture. This is called after :meth:" +"`setUp`. This is called immediately before calling the test method; other " +"than :exc:`AssertionError` or :exc:`SkipTest`, any exception raised by this " +"method will be considered an error rather than a test failure. The default " +"implementation does nothing." +msgstr "" + +msgid "" +"Method called immediately after the test method has been called and the " +"result recorded. This is called before :meth:`tearDown`. This is called " +"even if the test method raised an exception, so the implementation in " +"subclasses may need to be particularly careful about checking internal " +"state. Any exception, other than :exc:`AssertionError` or :exc:`SkipTest`, " +"raised by this method will be considered an additional error rather than a " +"test failure (thus increasing the total number of reported errors). This " +"method will only be called if the :meth:`asyncSetUp` succeeds, regardless of " +"the outcome of the test method. The default implementation does nothing." +msgstr "" + +msgid "This method accepts a coroutine that can be used as a cleanup function." +msgstr "" + +msgid "" +"Enter the supplied :term:`asynchronous context manager`. If successful, " +"also add its :meth:`~object.__aexit__` method as a cleanup function by :meth:" +"`addAsyncCleanup` and return the result of the :meth:`~object.__aenter__` " +"method." +msgstr "" + +msgid "" +"Sets up a new event loop to run the test, collecting the result into the :" +"class:`TestResult` object passed as *result*. If *result* is omitted or " +"``None``, a temporary result object is created (by calling the :meth:" +"`defaultTestResult` method) and used. The result object is returned to :meth:" +"`run`'s caller. At the end of the test all the tasks in the event loop are " +"cancelled." +msgstr "" + +msgid "An example illustrating the order::" +msgstr "" + +msgid "" +"After running the test, ``events`` would contain ``[\"setUp\", " +"\"asyncSetUp\", \"test_response\", \"asyncTearDown\", \"tearDown\", " +"\"cleanup\"]``." +msgstr "" + +msgid "" +"This class implements the portion of the :class:`TestCase` interface which " +"allows the test runner to drive the test, but does not provide the methods " +"which test code can use to check and report errors. This is used to create " +"test cases using legacy test code, allowing it to be integrated into a :mod:" +"`unittest`-based test framework." +msgstr "" + +msgid "Deprecated aliases" +msgstr "" + +msgid "" +"For historical reasons, some of the :class:`TestCase` methods had one or " +"more aliases that are now deprecated. The following table lists the correct " +"names along with their deprecated aliases:" +msgstr "" + +msgid "Method Name" +msgstr "" + +msgid "Deprecated alias" +msgstr "" + +msgid ":meth:`.assertEqual`" +msgstr ":meth:`.assertEqual`" + +msgid "failUnlessEqual" +msgstr "" + +msgid "assertEquals" +msgstr "" + +msgid ":meth:`.assertNotEqual`" +msgstr ":meth:`.assertNotEqual`" + +msgid "failIfEqual" +msgstr "" + +msgid "assertNotEquals" +msgstr "" + +msgid ":meth:`.assertTrue`" +msgstr ":meth:`.assertTrue`" + +msgid "failUnless" +msgstr "" + +msgid "assert\\_" +msgstr "" + +msgid ":meth:`.assertFalse`" +msgstr ":meth:`.assertFalse`" + +msgid "failIf" +msgstr "" + +msgid ":meth:`.assertRaises`" +msgstr ":meth:`.assertRaises`" + +msgid "failUnlessRaises" +msgstr "" + +msgid ":meth:`.assertAlmostEqual`" +msgstr ":meth:`.assertAlmostEqual`" + +msgid "failUnlessAlmostEqual" +msgstr "" + +msgid "assertAlmostEquals" +msgstr "" + +msgid ":meth:`.assertNotAlmostEqual`" +msgstr ":meth:`.assertNotAlmostEqual`" + +msgid "failIfAlmostEqual" +msgstr "" + +msgid "assertNotAlmostEquals" +msgstr "" + +msgid ":meth:`.assertRegex`" +msgstr ":meth:`.assertRegex`" + +msgid "assertRegexpMatches" +msgstr "" + +msgid ":meth:`.assertNotRegex`" +msgstr ":meth:`.assertNotRegex`" + +msgid "assertNotRegexpMatches" +msgstr "" + +msgid ":meth:`.assertRaisesRegex`" +msgstr ":meth:`.assertRaisesRegex`" + +msgid "assertRaisesRegexp" +msgstr "" + +msgid "The fail* aliases listed in the second column have been deprecated." +msgstr "" + +msgid "The assert* aliases listed in the third column have been deprecated." +msgstr "" + +msgid "" +"``assertRegexpMatches`` and ``assertRaisesRegexp`` have been renamed to :" +"meth:`.assertRegex` and :meth:`.assertRaisesRegex`." +msgstr "" + +msgid "" +"The ``assertNotRegexpMatches`` name is deprecated in favor of :meth:`." +"assertNotRegex`." +msgstr "" + +msgid "Grouping tests" +msgstr "" + +msgid "" +"This class represents an aggregation of individual test cases and test " +"suites. The class presents the interface needed by the test runner to allow " +"it to be run as any other test case. Running a :class:`TestSuite` instance " +"is the same as iterating over the suite, running each test individually." +msgstr "" + +msgid "" +"If *tests* is given, it must be an iterable of individual test cases or " +"other test suites that will be used to build the suite initially. Additional " +"methods are provided to add test cases and suites to the collection later on." +msgstr "" + +msgid "" +":class:`TestSuite` objects behave much like :class:`TestCase` objects, " +"except they do not actually implement a test. Instead, they are used to " +"aggregate tests into groups of tests that should be run together. Some " +"additional methods are available to add tests to :class:`TestSuite` " +"instances:" +msgstr "" + +msgid "Add a :class:`TestCase` or :class:`TestSuite` to the suite." +msgstr "" + +msgid "" +"Add all the tests from an iterable of :class:`TestCase` and :class:" +"`TestSuite` instances to this test suite." +msgstr "" + +msgid "" +"This is equivalent to iterating over *tests*, calling :meth:`addTest` for " +"each element." +msgstr "" + +msgid ":class:`TestSuite` shares the following methods with :class:`TestCase`:" +msgstr "" + +msgid "" +"Run the tests associated with this suite, collecting the result into the " +"test result object passed as *result*. Note that unlike :meth:`TestCase." +"run`, :meth:`TestSuite.run` requires the result object to be passed in." +msgstr "" + +msgid "" +"Run the tests associated with this suite without collecting the result. This " +"allows exceptions raised by the test to be propagated to the caller and can " +"be used to support running tests under a debugger." +msgstr "" + +msgid "" +"Return the number of tests represented by this test object, including all " +"individual tests and sub-suites." +msgstr "" + +msgid "" +"Tests grouped by a :class:`TestSuite` are always accessed by iteration. " +"Subclasses can lazily provide tests by overriding :meth:`!__iter__`. Note " +"that this method may be called several times on a single suite (for example " +"when counting tests or comparing for equality) so the tests returned by " +"repeated iterations before :meth:`TestSuite.run` must be the same for each " +"call iteration. After :meth:`TestSuite.run`, callers should not rely on the " +"tests returned by this method unless the caller uses a subclass that " +"overrides :meth:`TestSuite._removeTestAtIndex` to preserve test references." +msgstr "" + +msgid "" +"In earlier versions the :class:`TestSuite` accessed tests directly rather " +"than through iteration, so overriding :meth:`!__iter__` wasn't sufficient " +"for providing tests." +msgstr "" + +msgid "" +"In earlier versions the :class:`TestSuite` held references to each :class:" +"`TestCase` after :meth:`TestSuite.run`. Subclasses can restore that behavior " +"by overriding :meth:`TestSuite._removeTestAtIndex`." +msgstr "" + +msgid "" +"In the typical usage of a :class:`TestSuite` object, the :meth:`run` method " +"is invoked by a :class:`TestRunner` rather than by the end-user test harness." +msgstr "" + +msgid "Loading and running tests" +msgstr "" + +msgid "" +"The :class:`TestLoader` class is used to create test suites from classes and " +"modules. Normally, there is no need to create an instance of this class; " +"the :mod:`unittest` module provides an instance that can be shared as :data:" +"`unittest.defaultTestLoader`. Using a subclass or instance, however, allows " +"customization of some configurable properties." +msgstr "" + +msgid ":class:`TestLoader` objects have the following attributes:" +msgstr "" + +msgid "" +"A list of the non-fatal errors encountered while loading tests. Not reset by " +"the loader at any point. Fatal errors are signalled by the relevant method " +"raising an exception to the caller. Non-fatal errors are also indicated by a " +"synthetic test that will raise the original error when run." +msgstr "" + +msgid ":class:`TestLoader` objects have the following methods:" +msgstr "" + +msgid "" +"Return a suite of all test cases contained in the :class:`TestCase`\\ -" +"derived :class:`testCaseClass`." +msgstr "" + +msgid "" +"A test case instance is created for each method named by :meth:" +"`getTestCaseNames`. By default these are the method names beginning with " +"``test``. If :meth:`getTestCaseNames` returns no methods, but the :meth:" +"`runTest` method is implemented, a single test case is created for that " +"method instead." +msgstr "" + +msgid "" +"Return a suite of all test cases contained in the given module. This method " +"searches *module* for classes derived from :class:`TestCase` and creates an " +"instance of the class for each test method defined for the class." +msgstr "" + +msgid "" +"While using a hierarchy of :class:`TestCase`\\ -derived classes can be " +"convenient in sharing fixtures and helper functions, defining test methods " +"on base classes that are not intended to be instantiated directly does not " +"play well with this method. Doing so, however, can be useful when the " +"fixtures are different and defined in subclasses." +msgstr "" + +msgid "" +"If a module provides a ``load_tests`` function it will be called to load the " +"tests. This allows modules to customize test loading. This is the " +"`load_tests protocol`_. The *pattern* argument is passed as the third " +"argument to ``load_tests``." +msgstr "" + +msgid "Support for ``load_tests`` added." +msgstr "" + +msgid "" +"The undocumented and unofficial *use_load_tests* default argument is " +"deprecated and ignored, although it is still accepted for backward " +"compatibility. The method also now accepts a keyword-only argument " +"*pattern* which is passed to ``load_tests`` as the third argument." +msgstr "" + +msgid "Return a suite of all test cases given a string specifier." +msgstr "" + +msgid "" +"The specifier *name* is a \"dotted name\" that may resolve either to a " +"module, a test case class, a test method within a test case class, a :class:" +"`TestSuite` instance, or a callable object which returns a :class:`TestCase` " +"or :class:`TestSuite` instance. These checks are applied in the order " +"listed here; that is, a method on a possible test case class will be picked " +"up as \"a test method within a test case class\", rather than \"a callable " +"object\"." +msgstr "" + +msgid "" +"For example, if you have a module :mod:`SampleTests` containing a :class:" +"`TestCase`\\ -derived class :class:`SampleTestCase` with three test methods " +"(:meth:`test_one`, :meth:`test_two`, and :meth:`test_three`), the specifier " +"``'SampleTests.SampleTestCase'`` would cause this method to return a suite " +"which will run all three test methods. Using the specifier ``'SampleTests." +"SampleTestCase.test_two'`` would cause it to return a test suite which will " +"run only the :meth:`test_two` test method. The specifier can refer to " +"modules and packages which have not been imported; they will be imported as " +"a side-effect." +msgstr "" + +msgid "The method optionally resolves *name* relative to the given *module*." +msgstr "" + +msgid "" +"If an :exc:`ImportError` or :exc:`AttributeError` occurs while traversing " +"*name* then a synthetic test that raises that error when run will be " +"returned. These errors are included in the errors accumulated by self.errors." +msgstr "" + +msgid "" +"Similar to :meth:`loadTestsFromName`, but takes a sequence of names rather " +"than a single name. The return value is a test suite which supports all the " +"tests defined for each name." +msgstr "" + +msgid "" +"Return a sorted sequence of method names found within *testCaseClass*; this " +"should be a subclass of :class:`TestCase`." +msgstr "" + +msgid "" +"Find all the test modules by recursing into subdirectories from the " +"specified start directory, and return a TestSuite object containing them. " +"Only test files that match *pattern* will be loaded. (Using shell style " +"pattern matching.) Only module names that are importable (i.e. are valid " +"Python identifiers) will be loaded." +msgstr "" + +msgid "" +"All test modules must be importable from the top level of the project. If " +"the start directory is not the top level directory then the top level " +"directory must be specified separately." +msgstr "" + +msgid "" +"If importing a module fails, for example due to a syntax error, then this " +"will be recorded as a single error and discovery will continue. If the " +"import failure is due to :exc:`SkipTest` being raised, it will be recorded " +"as a skip instead of an error." +msgstr "" + +msgid "" +"If a package (a directory containing a file named :file:`__init__.py`) is " +"found, the package will be checked for a ``load_tests`` function. If this " +"exists then it will be called ``package.load_tests(loader, tests, " +"pattern)``. Test discovery takes care to ensure that a package is only " +"checked for tests once during an invocation, even if the load_tests function " +"itself calls ``loader.discover``." +msgstr "" + +msgid "" +"If ``load_tests`` exists then discovery does *not* recurse into the package, " +"``load_tests`` is responsible for loading all tests in the package." +msgstr "" + +msgid "" +"The pattern is deliberately not stored as a loader attribute so that " +"packages can continue discovery themselves. *top_level_dir* is stored so " +"``load_tests`` does not need to pass this argument in to ``loader." +"discover()``." +msgstr "" + +msgid "*start_dir* can be a dotted module name as well as a directory." +msgstr "" + +msgid "" +"Modules that raise :exc:`SkipTest` on import are recorded as skips, not " +"errors." +msgstr "" + +msgid "*start_dir* can be a :term:`namespace packages `." +msgstr "" + +msgid "" +"Paths are sorted before being imported so that execution order is the same " +"even if the underlying file system's ordering is not dependent on file name." +msgstr "" + +msgid "" +"Found packages are now checked for ``load_tests`` regardless of whether " +"their path matches *pattern*, because it is impossible for a package name to " +"match the default pattern." +msgstr "" + +msgid "" +"*start_dir* can not be a :term:`namespace packages `. It " +"has been broken since Python 3.7 and Python 3.11 officially remove it." +msgstr "" + +msgid "" +"The following attributes of a :class:`TestLoader` can be configured either " +"by subclassing or assignment on an instance:" +msgstr "" + +msgid "" +"String giving the prefix of method names which will be interpreted as test " +"methods. The default value is ``'test'``." +msgstr "" + +msgid "" +"This affects :meth:`getTestCaseNames` and all the ``loadTestsFrom*`` methods." +msgstr "" + +msgid "" +"Function to be used to compare method names when sorting them in :meth:" +"`getTestCaseNames` and all the ``loadTestsFrom*`` methods." +msgstr "" + +msgid "" +"Callable object that constructs a test suite from a list of tests. No " +"methods on the resulting object are needed. The default value is the :class:" +"`TestSuite` class." +msgstr "" + +msgid "This affects all the ``loadTestsFrom*`` methods." +msgstr "" + +msgid "" +"List of Unix shell-style wildcard test name patterns that test methods have " +"to match to be included in test suites (see ``-k`` option)." +msgstr "" + +msgid "" +"If this attribute is not ``None`` (the default), all test methods to be " +"included in test suites must match one of the patterns in this list. Note " +"that matches are always performed using :meth:`fnmatch.fnmatchcase`, so " +"unlike patterns passed to the ``-k`` option, simple substring patterns will " +"have to be converted using ``*`` wildcards." +msgstr "" + +msgid "" +"This class is used to compile information about which tests have succeeded " +"and which have failed." +msgstr "" + +msgid "" +"A :class:`TestResult` object stores the results of a set of tests. The :" +"class:`TestCase` and :class:`TestSuite` classes ensure that results are " +"properly recorded; test authors do not need to worry about recording the " +"outcome of tests." +msgstr "" + +msgid "" +"Testing frameworks built on top of :mod:`unittest` may want access to the :" +"class:`TestResult` object generated by running a set of tests for reporting " +"purposes; a :class:`TestResult` instance is returned by the :meth:" +"`TestRunner.run` method for this purpose." +msgstr "" + +msgid "" +":class:`TestResult` instances have the following attributes that will be of " +"interest when inspecting the results of running a set of tests:" +msgstr "" + +msgid "" +"A list containing 2-tuples of :class:`TestCase` instances and strings " +"holding formatted tracebacks. Each tuple represents a test which raised an " +"unexpected exception." +msgstr "" + +msgid "" +"A list containing 2-tuples of :class:`TestCase` instances and strings " +"holding formatted tracebacks. Each tuple represents a test where a failure " +"was explicitly signalled using the :ref:`assert\\* methods `." +msgstr "" + +msgid "" +"A list containing 2-tuples of :class:`TestCase` instances and strings " +"holding the reason for skipping the test." +msgstr "" + +msgid "" +"A list containing 2-tuples of :class:`TestCase` instances and strings " +"holding formatted tracebacks. Each tuple represents an expected failure or " +"error of the test case." +msgstr "" + +msgid "" +"A list containing :class:`TestCase` instances that were marked as expected " +"failures, but succeeded." +msgstr "" + +msgid "" +"Set to ``True`` when the execution of tests should stop by :meth:`stop`." +msgstr "" + +msgid "The total number of tests run so far." +msgstr "" + +msgid "" +"If set to true, ``sys.stdout`` and ``sys.stderr`` will be buffered in " +"between :meth:`startTest` and :meth:`stopTest` being called. Collected " +"output will only be echoed onto the real ``sys.stdout`` and ``sys.stderr`` " +"if the test fails or errors. Any output is also attached to the failure / " +"error message." +msgstr "" + +msgid "" +"If set to true :meth:`stop` will be called on the first failure or error, " +"halting the test run." +msgstr "" + +msgid "If set to true then local variables will be shown in tracebacks." +msgstr "" + +msgid "" +"Return ``True`` if all tests run so far have passed, otherwise returns " +"``False``." +msgstr "" + +msgid "" +"Returns ``False`` if there were any :attr:`unexpectedSuccesses` from tests " +"marked with the :func:`expectedFailure` decorator." +msgstr "" + +msgid "" +"This method can be called to signal that the set of tests being run should " +"be aborted by setting the :attr:`shouldStop` attribute to ``True``. :class:" +"`TestRunner` objects should respect this flag and return without running any " +"additional tests." +msgstr "" + +msgid "" +"For example, this feature is used by the :class:`TextTestRunner` class to " +"stop the test framework when the user signals an interrupt from the " +"keyboard. Interactive tools which provide :class:`TestRunner` " +"implementations can use this in a similar manner." +msgstr "" + +msgid "" +"The following methods of the :class:`TestResult` class are used to maintain " +"the internal data structures, and may be extended in subclasses to support " +"additional reporting requirements. This is particularly useful in building " +"tools which support interactive reporting while tests are being run." +msgstr "" + +msgid "Called when the test case *test* is about to be run." +msgstr "" + +msgid "" +"Called after the test case *test* has been executed, regardless of the " +"outcome." +msgstr "" + +msgid "Called once before any tests are executed." +msgstr "" + +msgid "Called once after all tests are executed." +msgstr "" + +msgid "" +"Called when the test case *test* raises an unexpected exception. *err* is a " +"tuple of the form returned by :func:`sys.exc_info`: ``(type, value, " +"traceback)``." +msgstr "" + +msgid "" +"The default implementation appends a tuple ``(test, formatted_err)`` to the " +"instance's :attr:`errors` attribute, where *formatted_err* is a formatted " +"traceback derived from *err*." +msgstr "" + +msgid "" +"Called when the test case *test* signals a failure. *err* is a tuple of the " +"form returned by :func:`sys.exc_info`: ``(type, value, traceback)``." +msgstr "" + +msgid "" +"The default implementation appends a tuple ``(test, formatted_err)`` to the " +"instance's :attr:`failures` attribute, where *formatted_err* is a formatted " +"traceback derived from *err*." +msgstr "" + +msgid "Called when the test case *test* succeeds." +msgstr "" + +msgid "The default implementation does nothing." +msgstr "" + +msgid "" +"Called when the test case *test* is skipped. *reason* is the reason the " +"test gave for skipping." +msgstr "" + +msgid "" +"The default implementation appends a tuple ``(test, reason)`` to the " +"instance's :attr:`skipped` attribute." +msgstr "" + +msgid "" +"Called when the test case *test* fails or errors, but was marked with the :" +"func:`expectedFailure` decorator." +msgstr "" + +msgid "" +"The default implementation appends a tuple ``(test, formatted_err)`` to the " +"instance's :attr:`expectedFailures` attribute, where *formatted_err* is a " +"formatted traceback derived from *err*." +msgstr "" + +msgid "" +"Called when the test case *test* was marked with the :func:`expectedFailure` " +"decorator, but succeeded." +msgstr "" + +msgid "" +"The default implementation appends the test to the instance's :attr:" +"`unexpectedSuccesses` attribute." +msgstr "" + +msgid "" +"Called when a subtest finishes. *test* is the test case corresponding to " +"the test method. *subtest* is a custom :class:`TestCase` instance " +"describing the subtest." +msgstr "" + +msgid "" +"If *outcome* is :const:`None`, the subtest succeeded. Otherwise, it failed " +"with an exception where *outcome* is a tuple of the form returned by :func:" +"`sys.exc_info`: ``(type, value, traceback)``." +msgstr "" + +msgid "" +"The default implementation does nothing when the outcome is a success, and " +"records subtest failures as normal failures." +msgstr "" + +msgid "" +"A concrete implementation of :class:`TestResult` used by the :class:" +"`TextTestRunner`." +msgstr "" + +msgid "" +"This class was previously named ``_TextTestResult``. The old name still " +"exists as an alias but is deprecated." +msgstr "" + +msgid "" +"Instance of the :class:`TestLoader` class intended to be shared. If no " +"customization of the :class:`TestLoader` is needed, this instance can be " +"used instead of repeatedly creating new instances." +msgstr "" + +msgid "" +"A basic test runner implementation that outputs results to a stream. If " +"*stream* is ``None``, the default, :data:`sys.stderr` is used as the output " +"stream. This class has a few configurable parameters, but is essentially " +"very simple. Graphical applications which run test suites should provide " +"alternate implementations. Such implementations should accept ``**kwargs`` " +"as the interface to construct runners changes when features are added to " +"unittest." +msgstr "" + +msgid "" +"By default this runner shows :exc:`DeprecationWarning`, :exc:" +"`PendingDeprecationWarning`, :exc:`ResourceWarning` and :exc:`ImportWarning` " +"even if they are :ref:`ignored by default `. Deprecation " +"warnings caused by :ref:`deprecated unittest methods ` " +"are also special-cased and, when the warning filters are ``'default'`` or " +"``'always'``, they will appear only once per-module, in order to avoid too " +"many warning messages. This behavior can be overridden using Python's :" +"option:`!-Wd` or :option:`!-Wa` options (see :ref:`Warning control `) and leaving *warnings* to ``None``." +msgstr "" + +msgid "Added the ``warnings`` argument." +msgstr "" + +msgid "" +"The default stream is set to :data:`sys.stderr` at instantiation time rather " +"than import time." +msgstr "" + +msgid "Added the tb_locals parameter." +msgstr "" + +msgid "" +"This method returns the instance of ``TestResult`` used by :meth:`run`. It " +"is not intended to be called directly, but can be overridden in subclasses " +"to provide a custom ``TestResult``." +msgstr "" + +msgid "" +"``_makeResult()`` instantiates the class or callable passed in the " +"``TextTestRunner`` constructor as the ``resultclass`` argument. It defaults " +"to :class:`TextTestResult` if no ``resultclass`` is provided. The result " +"class is instantiated with the following arguments::" +msgstr "" + +msgid "" +"This method is the main public interface to the ``TextTestRunner``. This " +"method takes a :class:`TestSuite` or :class:`TestCase` instance. A :class:" +"`TestResult` is created by calling :func:`_makeResult` and the test(s) are " +"run and the results printed to stdout." +msgstr "" + +msgid "" +"A command-line program that loads a set of tests from *module* and runs " +"them; this is primarily for making test modules conveniently executable. The " +"simplest use for this function is to include the following line at the end " +"of a test script::" +msgstr "" + +msgid "" +"You can run tests with more detailed information by passing in the verbosity " +"argument::" +msgstr "" + +msgid "" +"The *defaultTest* argument is either the name of a single test or an " +"iterable of test names to run if no test names are specified via *argv*. If " +"not specified or ``None`` and no test names are provided via *argv*, all " +"tests found in *module* are run." +msgstr "" + +msgid "" +"The *argv* argument can be a list of options passed to the program, with the " +"first element being the program name. If not specified or ``None``, the " +"values of :data:`sys.argv` are used." +msgstr "" + +msgid "" +"The *testRunner* argument can either be a test runner class or an already " +"created instance of it. By default ``main`` calls :func:`sys.exit` with an " +"exit code indicating success or failure of the tests run." +msgstr "" + +msgid "" +"The *testLoader* argument has to be a :class:`TestLoader` instance, and " +"defaults to :data:`defaultTestLoader`." +msgstr "" + +msgid "" +"``main`` supports being used from the interactive interpreter by passing in " +"the argument ``exit=False``. This displays the result on standard output " +"without calling :func:`sys.exit`::" +msgstr "" + +msgid "" +"The *failfast*, *catchbreak* and *buffer* parameters have the same effect as " +"the same-name `command-line options`_." +msgstr "" + +msgid "" +"The *warnings* argument specifies the :ref:`warning filter ` " +"that should be used while running the tests. If it's not specified, it will " +"remain ``None`` if a :option:`!-W` option is passed to :program:`python` " +"(see :ref:`Warning control `), otherwise it will be set " +"to ``'default'``." +msgstr "" + +msgid "" +"Calling ``main`` actually returns an instance of the ``TestProgram`` class. " +"This stores the result of the tests run as the ``result`` attribute." +msgstr "" + +msgid "The *exit* parameter was added." +msgstr "" + +msgid "" +"The *verbosity*, *failfast*, *catchbreak*, *buffer* and *warnings* " +"parameters were added." +msgstr "" + +msgid "" +"The *defaultTest* parameter was changed to also accept an iterable of test " +"names." +msgstr "" + +msgid "load_tests Protocol" +msgstr "" + +msgid "" +"Modules or packages can customize how tests are loaded from them during " +"normal test runs or test discovery by implementing a function called " +"``load_tests``." +msgstr "" + +msgid "" +"If a test module defines ``load_tests`` it will be called by :meth:" +"`TestLoader.loadTestsFromModule` with the following arguments::" +msgstr "" + +msgid "" +"where *pattern* is passed straight through from ``loadTestsFromModule``. It " +"defaults to ``None``." +msgstr "" + +msgid "It should return a :class:`TestSuite`." +msgstr "" + +msgid "" +"*loader* is the instance of :class:`TestLoader` doing the loading. " +"*standard_tests* are the tests that would be loaded by default from the " +"module. It is common for test modules to only want to add or remove tests " +"from the standard set of tests. The third argument is used when loading " +"packages as part of test discovery." +msgstr "" + +msgid "" +"A typical ``load_tests`` function that loads tests from a specific set of :" +"class:`TestCase` classes may look like::" +msgstr "" + +msgid "" +"If discovery is started in a directory containing a package, either from the " +"command line or by calling :meth:`TestLoader.discover`, then the package :" +"file:`__init__.py` will be checked for ``load_tests``. If that function " +"does not exist, discovery will recurse into the package as though it were " +"just another directory. Otherwise, discovery of the package's tests will be " +"left up to ``load_tests`` which is called with the following arguments::" +msgstr "" + +msgid "" +"This should return a :class:`TestSuite` representing all the tests from the " +"package. (``standard_tests`` will only contain tests collected from :file:" +"`__init__.py`.)" +msgstr "" + +msgid "" +"Because the pattern is passed into ``load_tests`` the package is free to " +"continue (and potentially modify) test discovery. A 'do nothing' " +"``load_tests`` function for a test package would look like::" +msgstr "" + +msgid "" +"Discovery no longer checks package names for matching *pattern* due to the " +"impossibility of package names matching the default pattern." +msgstr "" + +msgid "Class and Module Fixtures" +msgstr "" + +msgid "" +"Class and module level fixtures are implemented in :class:`TestSuite`. When " +"the test suite encounters a test from a new class then :meth:`tearDownClass` " +"from the previous class (if there is one) is called, followed by :meth:" +"`setUpClass` from the new class." +msgstr "" + +msgid "" +"Similarly if a test is from a different module from the previous test then " +"``tearDownModule`` from the previous module is run, followed by " +"``setUpModule`` from the new module." +msgstr "" + +msgid "" +"After all the tests have run the final ``tearDownClass`` and " +"``tearDownModule`` are run." +msgstr "" + +msgid "" +"Note that shared fixtures do not play well with [potential] features like " +"test parallelization and they break test isolation. They should be used with " +"care." +msgstr "" + +msgid "" +"The default ordering of tests created by the unittest test loaders is to " +"group all tests from the same modules and classes together. This will lead " +"to ``setUpClass`` / ``setUpModule`` (etc) being called exactly once per " +"class and module. If you randomize the order, so that tests from different " +"modules and classes are adjacent to each other, then these shared fixture " +"functions may be called multiple times in a single test run." +msgstr "" + +msgid "" +"Shared fixtures are not intended to work with suites with non-standard " +"ordering. A ``BaseTestSuite`` still exists for frameworks that don't want to " +"support shared fixtures." +msgstr "" + +msgid "" +"If there are any exceptions raised during one of the shared fixture " +"functions the test is reported as an error. Because there is no " +"corresponding test instance an ``_ErrorHolder`` object (that has the same " +"interface as a :class:`TestCase`) is created to represent the error. If you " +"are just using the standard unittest test runner then this detail doesn't " +"matter, but if you are a framework author it may be relevant." +msgstr "" + +msgid "setUpClass and tearDownClass" +msgstr "" + +msgid "These must be implemented as class methods::" +msgstr "" + +msgid "" +"If you want the ``setUpClass`` and ``tearDownClass`` on base classes called " +"then you must call up to them yourself. The implementations in :class:" +"`TestCase` are empty." +msgstr "" + +msgid "" +"If an exception is raised during a ``setUpClass`` then the tests in the " +"class are not run and the ``tearDownClass`` is not run. Skipped classes will " +"not have ``setUpClass`` or ``tearDownClass`` run. If the exception is a :exc:" +"`SkipTest` exception then the class will be reported as having been skipped " +"instead of as an error." +msgstr "" + +msgid "setUpModule and tearDownModule" +msgstr "" + +msgid "These should be implemented as functions::" +msgstr "" + +msgid "" +"If an exception is raised in a ``setUpModule`` then none of the tests in the " +"module will be run and the ``tearDownModule`` will not be run. If the " +"exception is a :exc:`SkipTest` exception then the module will be reported as " +"having been skipped instead of as an error." +msgstr "" + +msgid "" +"To add cleanup code that must be run even in the case of an exception, use " +"``addModuleCleanup``:" +msgstr "" + +msgid "" +"Add a function to be called after :func:`tearDownModule` to cleanup " +"resources used during the test class. Functions will be called in reverse " +"order to the order they are added (:abbr:`LIFO (last-in, first-out)`). They " +"are called with any arguments and keyword arguments passed into :meth:" +"`addModuleCleanup` when they are added." +msgstr "" + +msgid "" +"If :meth:`setUpModule` fails, meaning that :func:`tearDownModule` is not " +"called, then any cleanup functions added will still be called." +msgstr "" + +msgid "" +"Enter the supplied :term:`context manager`. If successful, also add its :" +"meth:`~object.__exit__` method as a cleanup function by :func:" +"`addModuleCleanup` and return the result of the :meth:`~object.__enter__` " +"method." +msgstr "" + +msgid "" +"This function is called unconditionally after :func:`tearDownModule`, or " +"after :func:`setUpModule` if :func:`setUpModule` raises an exception." +msgstr "" + +msgid "" +"It is responsible for calling all the cleanup functions added by :func:" +"`addModuleCleanup`. If you need cleanup functions to be called *prior* to :" +"func:`tearDownModule` then you can call :func:`doModuleCleanups` yourself." +msgstr "" + +msgid "" +":func:`doModuleCleanups` pops methods off the stack of cleanup functions one " +"at a time, so it can be called at any time." +msgstr "" + +msgid "Signal Handling" +msgstr "" + +msgid "" +"The :option:`-c/--catch ` command-line option to unittest, " +"along with the ``catchbreak`` parameter to :func:`unittest.main()`, provide " +"more friendly handling of control-C during a test run. With catch break " +"behavior enabled control-C will allow the currently running test to " +"complete, and the test run will then end and report all the results so far. " +"A second control-c will raise a :exc:`KeyboardInterrupt` in the usual way." +msgstr "" + +msgid "" +"The control-c handling signal handler attempts to remain compatible with " +"code or tests that install their own :const:`signal.SIGINT` handler. If the " +"``unittest`` handler is called but *isn't* the installed :const:`signal." +"SIGINT` handler, i.e. it has been replaced by the system under test and " +"delegated to, then it calls the default handler. This will normally be the " +"expected behavior by code that replaces an installed handler and delegates " +"to it. For individual tests that need ``unittest`` control-c handling " +"disabled the :func:`removeHandler` decorator can be used." +msgstr "" + +msgid "" +"There are a few utility functions for framework authors to enable control-c " +"handling functionality within test frameworks." +msgstr "" + +msgid "" +"Install the control-c handler. When a :const:`signal.SIGINT` is received " +"(usually in response to the user pressing control-c) all registered results " +"have :meth:`~TestResult.stop` called." +msgstr "" + +msgid "" +"Register a :class:`TestResult` object for control-c handling. Registering a " +"result stores a weak reference to it, so it doesn't prevent the result from " +"being garbage collected." +msgstr "" + +msgid "" +"Registering a :class:`TestResult` object has no side-effects if control-c " +"handling is not enabled, so test frameworks can unconditionally register all " +"results they create independently of whether or not handling is enabled." +msgstr "" + +msgid "" +"Remove a registered result. Once a result has been removed then :meth:" +"`~TestResult.stop` will no longer be called on that result object in " +"response to a control-c." +msgstr "" + +msgid "" +"When called without arguments this function removes the control-c handler if " +"it has been installed. This function can also be used as a test decorator to " +"temporarily remove the handler while the test is being executed::" +msgstr "" diff --git a/library/urllib.error.po b/library/urllib.error.po new file mode 100644 index 0000000000..b596c40138 --- /dev/null +++ b/library/urllib.error.po @@ -0,0 +1,83 @@ +# 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:16+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:`urllib.error` --- Exception classes raised by urllib.request" +msgstr "" + +msgid "**Source code:** :source:`Lib/urllib/error.py`" +msgstr "" + +msgid "" +"The :mod:`urllib.error` module defines the exception classes for exceptions " +"raised by :mod:`urllib.request`. The base exception class is :exc:" +"`URLError`." +msgstr "" + +msgid "" +"The following exceptions are raised by :mod:`urllib.error` as appropriate:" +msgstr "" + +msgid "" +"The handlers raise this exception (or derived exceptions) when they run into " +"a problem. It is a subclass of :exc:`OSError`." +msgstr "" + +msgid "" +"The reason for this error. It can be a message string or another exception " +"instance." +msgstr "" + +msgid "" +":exc:`URLError` has been made a subclass of :exc:`OSError` instead of :exc:" +"`IOError`." +msgstr "" + +msgid "" +"Though being an exception (a subclass of :exc:`URLError`), an :exc:" +"`HTTPError` can also function as a non-exceptional file-like return value " +"(the same thing that :func:`~urllib.request.urlopen` returns). This is " +"useful when handling exotic HTTP errors, such as requests for authentication." +msgstr "" + +msgid "" +"An HTTP status code as defined in :rfc:`2616`. This numeric value " +"corresponds to a value found in the dictionary of codes as found in :attr:" +"`http.server.BaseHTTPRequestHandler.responses`." +msgstr "" + +msgid "This is usually a string explaining the reason for this error." +msgstr "" + +msgid "" +"The HTTP response headers for the HTTP request that caused the :exc:" +"`HTTPError`." +msgstr "" + +msgid "" +"This exception is raised when the :func:`~urllib.request.urlretrieve` " +"function detects that the amount of the downloaded data is less than the " +"expected amount (given by the *Content-Length* header). The :attr:`content` " +"attribute stores the downloaded (and supposedly truncated) data." +msgstr "" diff --git a/library/urllib_parse.po b/library/urllib.parse.po similarity index 93% rename from library/urllib_parse.po rename to library/urllib.parse.po index 97c14a6dbf..d7b5821369 100644 --- a/library/urllib_parse.po +++ b/library/urllib.parse.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-18 02:02+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +41,9 @@ msgid "" "The module has been designed to match the internet RFC on Relative Uniform " "Resource Locators. It supports the following URL schemes: ``file``, ``ftp``, " "``gopher``, ``hdl``, ``http``, ``https``, ``imap``, ``mailto``, ``mms``, " -"``news``, ``nntp``, ``prospero``, ``rsync``, ``rtsp``, ``rtspu``, ``sftp``, " -"``shttp``, ``sip``, ``sips``, ``snews``, ``svn``, ``svn+ssh``, ``telnet``, " -"``wais``, ``ws``, ``wss``." +"``news``, ``nntp``, ``prospero``, ``rsync``, ``rtsp``, ``rtsps``, ``rtspu``, " +"``sftp``, ``shttp``, ``sip``, ``sips``, ``snews``, ``svn``, ``svn+ssh``, " +"``telnet``, ``wais``, ``ws``, ``wss``." msgstr "" msgid "" @@ -95,7 +96,7 @@ msgid "" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Index" msgstr "" @@ -107,7 +108,7 @@ msgid "Value if not present" msgstr "" msgid ":attr:`scheme`" -msgstr "" +msgstr ":attr:`scheme`" msgid "0" msgstr "0" @@ -119,7 +120,7 @@ msgid "*scheme* parameter" msgstr "" msgid ":attr:`netloc`" -msgstr "" +msgstr ":attr:`netloc`" msgid "1" msgstr "1" @@ -131,7 +132,7 @@ msgid "empty string" msgstr "" msgid ":attr:`path`" -msgstr "" +msgstr ":attr:`path`" msgid "2" msgstr "2" @@ -140,16 +141,16 @@ msgid "Hierarchical path" msgstr "" msgid ":attr:`params`" -msgstr "" +msgstr ":attr:`params`" msgid "3" -msgstr "" +msgstr "3" msgid "Parameters for last path element" msgstr "" msgid ":attr:`query`" -msgstr "" +msgstr ":attr:`query`" msgid "4" msgstr "4" @@ -158,37 +159,37 @@ msgid "Query component" msgstr "" msgid ":attr:`fragment`" -msgstr "" +msgstr ":attr:`fragment`" msgid "5" -msgstr "" +msgstr "5" msgid "Fragment identifier" msgstr "" msgid ":attr:`username`" -msgstr "" +msgstr ":attr:`username`" msgid "User name" msgstr "" msgid ":const:`None`" -msgstr "" +msgstr ":const:`None`" msgid ":attr:`password`" -msgstr "" +msgstr ":attr:`password`" msgid "Password" msgstr "" msgid ":attr:`hostname`" -msgstr "" +msgstr ":attr:`hostname`" msgid "Host name (lower case)" msgstr "" msgid ":attr:`port`" -msgstr "" +msgstr ":attr:`port`" msgid "Port number as integer, if present" msgstr "" @@ -391,7 +392,7 @@ msgid "" msgstr "" msgid ":attr:`url`" -msgstr "" +msgstr ":attr:`url`" msgid "URL with no fragment" msgstr "" @@ -580,11 +581,11 @@ msgid "" msgstr "" msgid "" -"Replace special characters in *string* using the ``%xx`` escape. Letters, " -"digits, and the characters ``'_.-~'`` are never quoted. By default, this " -"function is intended for quoting the path section of a URL. The optional " -"*safe* parameter specifies additional ASCII characters that should not be " -"quoted --- its default value is ``'/'``." +"Replace special characters in *string* using the :samp:`%{xx}` escape. " +"Letters, digits, and the characters ``'_.-~'`` are never quoted. By default, " +"this function is intended for quoting the path section of a URL. The " +"optional *safe* parameter specifies additional ASCII characters that should " +"not be quoted --- its default value is ``'/'``." msgstr "" msgid "*string* may be either a :class:`str` or a :class:`bytes` object." @@ -631,10 +632,10 @@ msgid "Example: ``quote_from_bytes(b'a&\\xef')`` yields ``'a%26%EF'``." msgstr "" msgid "" -"Replace ``%xx`` escapes with their single-character equivalent. The optional " -"*encoding* and *errors* parameters specify how to decode percent-encoded " -"sequences into Unicode characters, as accepted by the :meth:`bytes.decode` " -"method." +"Replace :samp:`%{xx}` escapes with their single-character equivalent. The " +"optional *encoding* and *errors* parameters specify how to decode percent-" +"encoded sequences into Unicode characters, as accepted by the :meth:`bytes." +"decode` method." msgstr "" msgid "" @@ -661,8 +662,8 @@ msgid "Example: ``unquote_plus('/El+Ni%C3%B1o/')`` yields ``'/El Niño/'``." msgstr "" msgid "" -"Replace ``%xx`` escapes with their single-octet equivalent, and return a :" -"class:`bytes` object." +"Replace :samp:`%{xx}` escapes with their single-octet equivalent, and return " +"a :class:`bytes` object." msgstr "" msgid "" @@ -723,7 +724,7 @@ msgstr "" msgid "*query* supports bytes and string objects." msgstr "" -msgid "*quote_via* parameter." +msgid "Added the *quote_via* parameter." msgstr "" msgid "`WHATWG`_ - URL Living standard" @@ -780,7 +781,7 @@ msgid "This specifies the formal syntax and semantics of absolute URLs." msgstr "" msgid "WWW" -msgstr "" +msgstr "WWW" msgid "World Wide Web" msgstr "" diff --git a/library/urllib.request.po b/library/urllib.request.po new file mode 100644 index 0000000000..09452035b4 --- /dev/null +++ b/library/urllib.request.po @@ -0,0 +1,1532 @@ +# 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: +# Maciej Olko , 2021 +# 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:17+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:`urllib.request` --- Extensible library for opening URLs" +msgstr "" + +msgid "**Source code:** :source:`Lib/urllib/request.py`" +msgstr "" + +msgid "" +"The :mod:`urllib.request` module defines functions and classes which help in " +"opening URLs (mostly HTTP) in a complex world --- basic and digest " +"authentication, redirections, cookies and more." +msgstr "" + +msgid "" +"The `Requests package `_ is " +"recommended for a higher-level HTTP client interface." +msgstr "" + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + +msgid "The :mod:`urllib.request` module defines the following functions:" +msgstr "" + +msgid "" +"Open *url*, which can be either a string containing a valid, properly " +"encoded URL, or a :class:`Request` object." +msgstr "" + +msgid "" +"*data* must be an object specifying additional data to be sent to the " +"server, or ``None`` if no such data is needed. See :class:`Request` for " +"details." +msgstr "" + +msgid "" +"urllib.request module uses HTTP/1.1 and includes ``Connection:close`` header " +"in its HTTP requests." +msgstr "" + +msgid "" +"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). This actually only works for HTTP, HTTPS and " +"FTP connections." +msgstr "" + +msgid "" +"If *context* is specified, it must be a :class:`ssl.SSLContext` instance " +"describing the various SSL options. See :class:`~http.client." +"HTTPSConnection` for more details." +msgstr "" + +msgid "" +"The optional *cafile* and *capath* parameters specify a set of trusted CA " +"certificates for HTTPS requests. *cafile* should point to a single file " +"containing a bundle of CA certificates, whereas *capath* should point to a " +"directory of hashed certificate files. More information can be found in :" +"meth:`ssl.SSLContext.load_verify_locations`." +msgstr "" + +msgid "The *cadefault* parameter is ignored." +msgstr "" + +msgid "" +"This function always returns an object which can work as a :term:`context " +"manager` and has the properties *url*, *headers*, and *status*. See :class:" +"`urllib.response.addinfourl` for more detail on these properties." +msgstr "" + +msgid "" +"For HTTP and HTTPS URLs, this function returns a :class:`http.client." +"HTTPResponse` object slightly modified. In addition to the three new methods " +"above, the msg attribute contains the same information as the :attr:`~http." +"client.HTTPResponse.reason` attribute --- the reason phrase returned by " +"server --- instead of the response headers as it is specified in the " +"documentation for :class:`~http.client.HTTPResponse`." +msgstr "" + +msgid "" +"For FTP, file, and data URLs and requests explicitly handled by legacy :" +"class:`URLopener` and :class:`FancyURLopener` classes, this function returns " +"a :class:`urllib.response.addinfourl` object." +msgstr "" + +msgid "Raises :exc:`~urllib.error.URLError` on protocol errors." +msgstr "" + +msgid "" +"Note that ``None`` may be returned if no handler handles the request (though " +"the default installed global :class:`OpenerDirector` uses :class:" +"`UnknownHandler` to ensure this never happens)." +msgstr "" + +msgid "" +"In addition, if proxy settings are detected (for example, when a ``*_proxy`` " +"environment variable like :envvar:`http_proxy` is set), :class:" +"`ProxyHandler` is default installed and makes sure the requests are handled " +"through the proxy." +msgstr "" + +msgid "" +"The legacy ``urllib.urlopen`` function from Python 2.6 and earlier has been " +"discontinued; :func:`urllib.request.urlopen` corresponds to the old " +"``urllib2.urlopen``. Proxy handling, which was done by passing a dictionary " +"parameter to ``urllib.urlopen``, can be obtained by using :class:" +"`ProxyHandler` objects." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``urllib.Request`` with arguments " +"``fullurl``, ``data``, ``headers``, ``method``." +msgstr "" + +msgid "" +"The default opener raises an :ref:`auditing event ` ``urllib." +"Request`` with arguments ``fullurl``, ``data``, ``headers``, ``method`` " +"taken from the request object." +msgstr "" + +msgid "*cafile* and *capath* were added." +msgstr "" + +msgid "" +"HTTPS virtual hosts are now supported if possible (that is, if :data:`ssl." +"HAS_SNI` is true)." +msgstr "" + +msgid "*data* can be an iterable object." +msgstr "" + +msgid "*cadefault* was added." +msgstr "" + +msgid "*context* was added." +msgstr "" + +msgid "" +"HTTPS connection now send 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_protocol`." +msgstr "" + +msgid "" +"*cafile*, *capath* and *cadefault* are deprecated in favor of *context*. " +"Please use :meth:`ssl.SSLContext.load_cert_chain` instead, or let :func:`ssl." +"create_default_context` select the system's trusted CA certificates for you." +msgstr "" + +msgid "" +"Install an :class:`OpenerDirector` instance as the default global opener. " +"Installing an opener is only necessary if you want urlopen to use that " +"opener; otherwise, simply call :meth:`OpenerDirector.open` instead of :func:" +"`~urllib.request.urlopen`. The code does not check for a real :class:" +"`OpenerDirector`, and any class with the appropriate interface will work." +msgstr "" + +msgid "" +"Return an :class:`OpenerDirector` instance, which chains the handlers in the " +"order given. *handler*\\s can be either instances of :class:`BaseHandler`, " +"or subclasses of :class:`BaseHandler` (in which case it must be possible to " +"call the constructor without any parameters). Instances of the following " +"classes will be in front of the *handler*\\s, unless the *handler*\\s " +"contain them, instances of them or subclasses of them: :class:`ProxyHandler` " +"(if proxy settings are detected), :class:`UnknownHandler`, :class:" +"`HTTPHandler`, :class:`HTTPDefaultErrorHandler`, :class:" +"`HTTPRedirectHandler`, :class:`FTPHandler`, :class:`FileHandler`, :class:" +"`HTTPErrorProcessor`." +msgstr "" + +msgid "" +"If the Python installation has SSL support (i.e., if the :mod:`ssl` module " +"can be imported), :class:`HTTPSHandler` will also be added." +msgstr "" + +msgid "" +"A :class:`BaseHandler` subclass may also change its :attr:`handler_order` " +"attribute to modify its position in the handlers list." +msgstr "" + +msgid "" +"Convert the pathname *path* from the local syntax for a path to the form " +"used in the path component of a URL. This does not produce a complete URL. " +"The return value will already be quoted using the :func:`~urllib.parse." +"quote` function." +msgstr "" + +msgid "" +"Convert the path component *path* from a percent-encoded URL to the local " +"syntax for a path. This does not accept a complete URL. This function " +"uses :func:`~urllib.parse.unquote` to decode *path*." +msgstr "" + +msgid "" +"This helper function returns a dictionary of scheme to proxy server URL " +"mappings. It scans the environment for variables named ``_proxy``, " +"in a case insensitive approach, for all operating systems first, and when it " +"cannot find it, looks for proxy information from System Configuration for " +"macOS and Windows Systems Registry for Windows. If both lowercase and " +"uppercase environment variables exist (and disagree), lowercase is preferred." +msgstr "" + +msgid "" +"If the environment variable ``REQUEST_METHOD`` is set, which usually " +"indicates your script is running in a CGI environment, the environment " +"variable ``HTTP_PROXY`` (uppercase ``_PROXY``) will be ignored. This is " +"because that variable can be injected by a client using the \"Proxy:\" HTTP " +"header. If you need to use an HTTP proxy in a CGI environment, either use " +"``ProxyHandler`` explicitly, or make sure the variable name is in lowercase " +"(or at least the ``_proxy`` suffix)." +msgstr "" + +msgid "The following classes are provided:" +msgstr "" + +msgid "This class is an abstraction of a URL request." +msgstr "" + +msgid "*url* should be a string containing a valid, properly encoded URL." +msgstr "" + +msgid "" +"*data* must be an object specifying additional data to send to the server, " +"or ``None`` if no such data is needed. Currently HTTP requests are the only " +"ones that use *data*. The supported object types include bytes, file-like " +"objects, and iterables of bytes-like objects. If no ``Content-Length`` nor " +"``Transfer-Encoding`` header field has been provided, :class:`HTTPHandler` " +"will set these headers according to the type of *data*. ``Content-Length`` " +"will be used to send bytes objects, while ``Transfer-Encoding: chunked`` as " +"specified in :rfc:`7230`, Section 3.3.1 will be used to send files and other " +"iterables." +msgstr "" + +msgid "" +"For an HTTP POST request method, *data* should be a buffer in the standard :" +"mimetype:`application/x-www-form-urlencoded` format. The :func:`urllib." +"parse.urlencode` function takes a mapping or sequence of 2-tuples and " +"returns an ASCII string in this format. It should be encoded to bytes before " +"being used as the *data* parameter." +msgstr "" + +msgid "" +"*headers* should be a dictionary, and will be treated as if :meth:" +"`add_header` was called with each key and value as arguments. This is often " +"used to \"spoof\" the ``User-Agent`` header value, which is used by a " +"browser to identify itself -- some HTTP servers only allow requests coming " +"from common browsers as opposed to scripts. For example, Mozilla Firefox may " +"identify itself as ``\"Mozilla/5.0 (X11; U; Linux i686) Gecko/20071127 " +"Firefox/2.0.0.11\"``, while :mod:`urllib`'s default user agent string is " +"``\"Python-urllib/2.6\"`` (on Python 2.6). All header keys are sent in camel " +"case." +msgstr "" + +msgid "" +"An appropriate ``Content-Type`` header should be included if the *data* " +"argument is present. If this header has not been provided and *data* is not " +"None, ``Content-Type: application/x-www-form-urlencoded`` will be added as a " +"default." +msgstr "" + +msgid "" +"The next two arguments are only of interest for correct handling of third-" +"party HTTP cookies:" +msgstr "" + +msgid "" +"*origin_req_host* should be the request-host of the origin transaction, as " +"defined by :rfc:`2965`. It defaults to ``http.cookiejar." +"request_host(self)``. This is the host name or IP address of the original " +"request that was initiated by the user. For example, if the request is for " +"an image in an HTML document, this should be the request-host of the request " +"for the page containing the image." +msgstr "" + +msgid "" +"*unverifiable* should indicate whether the request is unverifiable, as " +"defined by :rfc:`2965`. It defaults to ``False``. An unverifiable request " +"is one whose URL the user did not have the option to approve. For example, " +"if the request is for an image in an HTML document, and the user had no " +"option to approve the automatic fetching of the image, this should be true." +msgstr "" + +msgid "" +"*method* should be a string that indicates the HTTP request method that will " +"be used (e.g. ``'HEAD'``). If provided, its value is stored in the :attr:" +"`~Request.method` attribute and is used by :meth:`get_method()`. The default " +"is ``'GET'`` if *data* is ``None`` or ``'POST'`` otherwise. Subclasses may " +"indicate a different default method by setting the :attr:`~Request.method` " +"attribute in the class itself." +msgstr "" + +msgid "" +"The request will not work as expected if the data object is unable to " +"deliver its content more than once (e.g. a file or an iterable that can " +"produce the content only once) and the request is retried for HTTP redirects " +"or authentication. The *data* is sent to the HTTP server right away after " +"the headers. There is no support for a 100-continue expectation in the " +"library." +msgstr "" + +msgid ":attr:`Request.method` argument is added to the Request class." +msgstr "" + +msgid "Default :attr:`Request.method` may be indicated at the class level." +msgstr "" + +msgid "" +"Do not raise an error if the ``Content-Length`` has not been provided and " +"*data* is neither ``None`` nor a bytes object. Fall back to use chunked " +"transfer encoding instead." +msgstr "" + +msgid "" +"The :class:`OpenerDirector` class opens URLs via :class:`BaseHandler`\\ s " +"chained together. It manages the chaining of handlers, and recovery from " +"errors." +msgstr "" + +msgid "" +"This is the base class for all registered handlers --- and handles only the " +"simple mechanics of registration." +msgstr "" + +msgid "" +"A class which defines a default handler for HTTP error responses; all " +"responses are turned into :exc:`~urllib.error.HTTPError` exceptions." +msgstr "" + +msgid "A class to handle redirections." +msgstr "" + +msgid "A class to handle HTTP Cookies." +msgstr "" + +msgid "" +"Cause requests to go through a proxy. If *proxies* is given, it must be a " +"dictionary mapping protocol names to URLs of proxies. The default is to read " +"the list of proxies from the environment variables ``_proxy``. If " +"no proxy environment variables are set, then in a Windows environment proxy " +"settings are obtained from the registry's Internet Settings section, and in " +"a macOS environment proxy information is retrieved from the System " +"Configuration Framework." +msgstr "" + +msgid "To disable autodetected proxy pass an empty dictionary." +msgstr "" + +msgid "" +"The :envvar:`no_proxy` environment variable can be used to specify hosts " +"which shouldn't be reached via proxy; if set, it should be a comma-separated " +"list of hostname suffixes, optionally with ``:port`` appended, for example " +"``cern.ch,ncsa.uiuc.edu,some.host:8080``." +msgstr "" + +msgid "" +"``HTTP_PROXY`` will be ignored if a variable ``REQUEST_METHOD`` is set; see " +"the documentation on :func:`~urllib.request.getproxies`." +msgstr "" + +msgid "Keep a database of ``(realm, uri) -> (user, password)`` mappings." +msgstr "" + +msgid "" +"Keep a database of ``(realm, uri) -> (user, password)`` mappings. A realm " +"of ``None`` is considered a catch-all realm, which is searched if no other " +"realm fits." +msgstr "" + +msgid "" +"A variant of :class:`HTTPPasswordMgrWithDefaultRealm` that also has a " +"database of ``uri -> is_authenticated`` mappings. Can be used by a " +"BasicAuth handler to determine when to send authentication credentials " +"immediately instead of waiting for a ``401`` response first." +msgstr "" + +msgid "" +"This is a mixin class that helps with HTTP authentication, both to the " +"remote host and to a proxy. *password_mgr*, if given, should be something " +"that is compatible with :class:`HTTPPasswordMgr`; refer to section :ref:" +"`http-password-mgr` for information on the interface that must be " +"supported. If *passwd_mgr* also provides ``is_authenticated`` and " +"``update_authenticated`` methods (see :ref:`http-password-mgr-with-prior-" +"auth`), then the handler will use the ``is_authenticated`` result for a " +"given URI to determine whether or not to send authentication credentials " +"with the request. If ``is_authenticated`` returns ``True`` for the URI, " +"credentials are sent. If ``is_authenticated`` is ``False``, credentials are " +"not sent, and then if a ``401`` response is received the request is re-sent " +"with the authentication credentials. If authentication succeeds, " +"``update_authenticated`` is called to set ``is_authenticated`` ``True`` for " +"the URI, so that subsequent requests to the URI or any of its super-URIs " +"will automatically include the authentication credentials." +msgstr "" + +msgid "Added ``is_authenticated`` support." +msgstr "" + +msgid "" +"Handle authentication with the remote host. *password_mgr*, if given, should " +"be something that is compatible with :class:`HTTPPasswordMgr`; refer to " +"section :ref:`http-password-mgr` for information on the interface that must " +"be supported. HTTPBasicAuthHandler will raise a :exc:`ValueError` when " +"presented with a wrong Authentication scheme." +msgstr "" + +msgid "" +"Handle authentication with the proxy. *password_mgr*, if given, should be " +"something that is compatible with :class:`HTTPPasswordMgr`; refer to " +"section :ref:`http-password-mgr` for information on the interface that must " +"be supported." +msgstr "" + +msgid "" +"This is a mixin class that helps with HTTP authentication, both to the " +"remote host and to a proxy. *password_mgr*, if given, should be something " +"that is compatible with :class:`HTTPPasswordMgr`; refer to section :ref:" +"`http-password-mgr` for information on the interface that must be supported." +msgstr "" + +msgid "" +"Handle authentication with the remote host. *password_mgr*, if given, should " +"be something that is compatible with :class:`HTTPPasswordMgr`; refer to " +"section :ref:`http-password-mgr` for information on the interface that must " +"be supported. When both Digest Authentication Handler and Basic " +"Authentication Handler are both added, Digest Authentication is always tried " +"first. If the Digest Authentication returns a 40x response again, it is sent " +"to Basic Authentication handler to Handle. This Handler method will raise " +"a :exc:`ValueError` when presented with an authentication scheme other than " +"Digest or Basic." +msgstr "" + +msgid "Raise :exc:`ValueError` on unsupported Authentication Scheme." +msgstr "" + +msgid "A class to handle opening of HTTP URLs." +msgstr "" + +msgid "" +"A class to handle opening of HTTPS URLs. *context* and *check_hostname* " +"have the same meaning as in :class:`http.client.HTTPSConnection`." +msgstr "" + +msgid "*context* and *check_hostname* were added." +msgstr "" + +msgid "Open local files." +msgstr "" + +msgid "Open data URLs." +msgstr "" + +msgid "Open FTP URLs." +msgstr "" + +msgid "" +"Open FTP URLs, keeping a cache of open FTP connections to minimize delays." +msgstr "" + +msgid "A catch-all class to handle unknown URLs." +msgstr "" + +msgid "Process HTTP error responses." +msgstr "" + +msgid "Request Objects" +msgstr "" + +msgid "" +"The following methods describe :class:`Request`'s public interface, and so " +"all may be overridden in subclasses. It also defines several public " +"attributes that can be used by clients to inspect the parsed request." +msgstr "" + +msgid "The original URL passed to the constructor." +msgstr "" + +msgid "" +"Request.full_url is a property with setter, getter and a deleter. Getting :" +"attr:`~Request.full_url` returns the original request URL with the fragment, " +"if it was present." +msgstr "" + +msgid "The URI scheme." +msgstr "" + +msgid "" +"The URI authority, typically a host, but may also contain a port separated " +"by a colon." +msgstr "" + +msgid "The original host for the request, without port." +msgstr "" + +msgid "" +"The URI path. If the :class:`Request` uses a proxy, then selector will be " +"the full URL that is passed to the proxy." +msgstr "" + +msgid "The entity body for the request, or ``None`` if not specified." +msgstr "" + +msgid "" +"Changing value of :attr:`Request.data` now deletes \"Content-Length\" header " +"if it was previously set or calculated." +msgstr "" + +msgid "" +"boolean, indicates whether the request is unverifiable as defined by :rfc:" +"`2965`." +msgstr "" + +msgid "" +"The HTTP request method to use. By default its value is :const:`None`, " +"which means that :meth:`~Request.get_method` will do its normal computation " +"of the method to be used. Its value can be set (thus overriding the default " +"computation in :meth:`~Request.get_method`) either by providing a default " +"value by setting it at the class level in a :class:`Request` subclass, or by " +"passing a value in to the :class:`Request` constructor via the *method* " +"argument." +msgstr "" + +msgid "" +"A default value can now be set in subclasses; previously it could only be " +"set via the constructor argument." +msgstr "" + +msgid "" +"Return a string indicating the HTTP request method. If :attr:`Request." +"method` is not ``None``, return its value, otherwise return ``'GET'`` if :" +"attr:`Request.data` is ``None``, or ``'POST'`` if it's not. This is only " +"meaningful for HTTP requests." +msgstr "" + +msgid "get_method now looks at the value of :attr:`Request.method`." +msgstr "" + +msgid "" +"Add another header to the request. Headers are currently ignored by all " +"handlers except HTTP handlers, where they are added to the list of headers " +"sent to the server. Note that there cannot be more than one header with the " +"same name, and later calls will overwrite previous calls in case the *key* " +"collides. Currently, this is no loss of HTTP functionality, since all " +"headers which have meaning when used more than once have a (header-specific) " +"way of gaining the same functionality using only one header. Note that " +"headers added using this method are also added to redirected requests." +msgstr "" + +msgid "Add a header that will not be added to a redirected request." +msgstr "" + +msgid "" +"Return whether the instance has the named header (checks both regular and " +"unredirected)." +msgstr "" + +msgid "" +"Remove named header from the request instance (both from regular and " +"unredirected headers)." +msgstr "" + +msgid "Return the URL given in the constructor." +msgstr "" + +msgid "Returns :attr:`Request.full_url`" +msgstr "" + +msgid "" +"Prepare the request by connecting to a proxy server. The *host* and *type* " +"will replace those of the instance, and the instance's selector will be the " +"original URL given in the constructor." +msgstr "" + +msgid "" +"Return the value of the given header. If the header is not present, return " +"the default value." +msgstr "" + +msgid "" +"Return a list of tuples (header_name, header_value) of the Request headers." +msgstr "" + +msgid "" +"The request methods add_data, has_data, get_data, get_type, get_host, " +"get_selector, get_origin_req_host and is_unverifiable that were deprecated " +"since 3.3 have been removed." +msgstr "" + +msgid "OpenerDirector Objects" +msgstr "" + +msgid ":class:`OpenerDirector` instances have the following methods:" +msgstr "" + +msgid "" +"*handler* should be an instance of :class:`BaseHandler`. The following " +"methods are searched, and added to the possible chains (note that HTTP " +"errors are a special case). Note that, in the following, *protocol* should " +"be replaced with the actual protocol to handle, for example :meth:" +"`http_response` would be the HTTP protocol response handler. Also *type* " +"should be replaced with the actual HTTP code, for example :meth:" +"`http_error_404` would handle HTTP 404 errors." +msgstr "" + +msgid "" +":meth:`_open` --- signal that the handler knows how to open " +"*protocol* URLs." +msgstr "" + +msgid "See |protocol_open|_ for more information." +msgstr "" + +msgid "" +":meth:`http_error_\\` --- signal that the handler knows how to " +"handle HTTP errors with HTTP error code *type*." +msgstr "" + +msgid "See |http_error_nnn|_ for more information." +msgstr "" + +msgid "" +":meth:`_error` --- signal that the handler knows how to handle " +"errors from (non-\\ ``http``) *protocol*." +msgstr "" + +msgid "" +":meth:`_request` --- signal that the handler knows how to pre-" +"process *protocol* requests." +msgstr "" + +msgid "See |protocol_request|_ for more information." +msgstr "" + +msgid "" +":meth:`_response` --- signal that the handler knows how to post-" +"process *protocol* responses." +msgstr "" + +msgid "See |protocol_response|_ for more information." +msgstr "" + +msgid "" +"Open the given *url* (which can be a request object or a string), optionally " +"passing the given *data*. Arguments, return values and exceptions raised are " +"the same as those of :func:`urlopen` (which simply calls the :meth:`open` " +"method on the currently installed global :class:`OpenerDirector`). 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). The timeout feature actually works only for " +"HTTP, HTTPS and FTP connections." +msgstr "" + +msgid "" +"Handle an error of the given protocol. This will call the registered error " +"handlers for the given protocol with the given arguments (which are protocol " +"specific). The HTTP protocol is a special case which uses the HTTP response " +"code to determine the specific error handler; refer to the :meth:" +"`http_error_\\` methods of the handler classes." +msgstr "" + +msgid "" +"Return values and exceptions raised are the same as those of :func:`urlopen`." +msgstr "" + +msgid "OpenerDirector objects open URLs in three stages:" +msgstr "" + +msgid "" +"The order in which these methods are called within each stage is determined " +"by sorting the handler instances." +msgstr "" + +msgid "" +"Every handler with a method named like :meth:`_request` has that " +"method called to pre-process the request." +msgstr "" + +msgid "" +"Handlers with a method named like :meth:`_open` are called to " +"handle the request. This stage ends when a handler either returns a non-\\ :" +"const:`None` value (ie. a response), or raises an exception (usually :exc:" +"`~urllib.error.URLError`). Exceptions are allowed to propagate." +msgstr "" + +msgid "" +"In fact, the above algorithm is first tried for methods named :meth:" +"`default_open`. If all such methods return :const:`None`, the algorithm is " +"repeated for methods named like :meth:`_open`. If all such " +"methods return :const:`None`, the algorithm is repeated for methods named :" +"meth:`unknown_open`." +msgstr "" + +msgid "" +"Note that the implementation of these methods may involve calls of the " +"parent :class:`OpenerDirector` instance's :meth:`~OpenerDirector.open` and :" +"meth:`~OpenerDirector.error` methods." +msgstr "" + +msgid "" +"Every handler with a method named like :meth:`_response` has that " +"method called to post-process the response." +msgstr "" + +msgid "BaseHandler Objects" +msgstr "" + +msgid "" +":class:`BaseHandler` objects provide a couple of methods that are directly " +"useful, and others that are meant to be used by derived classes. These are " +"intended for direct use:" +msgstr "" + +msgid "Add a director as parent." +msgstr "" + +msgid "Remove any parents." +msgstr "" + +msgid "" +"The following attribute and methods should only be used by classes derived " +"from :class:`BaseHandler`." +msgstr "" + +msgid "" +"The convention has been adopted that subclasses defining :meth:" +"`_request` or :meth:`_response` methods are named :class:" +"`\\*Processor`; all others are named :class:`\\*Handler`." +msgstr "" + +msgid "" +"A valid :class:`OpenerDirector`, which can be used to open using a different " +"protocol, or handle errors." +msgstr "" + +msgid "" +"This method is *not* defined in :class:`BaseHandler`, but subclasses should " +"define it if they want to catch all URLs." +msgstr "" + +msgid "" +"This method, if implemented, will be called by the parent :class:" +"`OpenerDirector`. It should return a file-like object as described in the " +"return value of the :meth:`~OpenerDirector.open` method of :class:" +"`OpenerDirector`, or ``None``. It should raise :exc:`~urllib.error." +"URLError`, unless a truly exceptional thing happens (for example, :exc:" +"`MemoryError` should not be mapped to :exc:`URLError`)." +msgstr "" + +msgid "This method will be called before any protocol-specific open method." +msgstr "" + +msgid "" +"This method is *not* defined in :class:`BaseHandler`, but subclasses should " +"define it if they want to handle URLs with the given protocol." +msgstr "" + +msgid "" +"This method, if defined, will be called by the parent :class:" +"`OpenerDirector`. Return values should be the same as for :meth:" +"`default_open`." +msgstr "" + +msgid "" +"This method is *not* defined in :class:`BaseHandler`, but subclasses should " +"define it if they want to catch all URLs with no specific registered handler " +"to open it." +msgstr "" + +msgid "" +"This method, if implemented, will be called by the :attr:`parent` :class:" +"`OpenerDirector`. Return values should be the same as for :meth:" +"`default_open`." +msgstr "" + +msgid "" +"This method is *not* defined in :class:`BaseHandler`, but subclasses should " +"override it if they intend to provide a catch-all for otherwise unhandled " +"HTTP errors. It will be called automatically by the :class:" +"`OpenerDirector` getting the error, and should not normally be called in " +"other circumstances." +msgstr "" + +msgid "" +"*req* will be a :class:`Request` object, *fp* will be a file-like object " +"with the HTTP error body, *code* will be the three-digit code of the error, " +"*msg* will be the user-visible explanation of the code and *hdrs* will be a " +"mapping object with the headers of the error." +msgstr "" + +msgid "" +"Return values and exceptions raised should be the same as those of :func:" +"`urlopen`." +msgstr "" + +msgid "" +"*nnn* should be a three-digit HTTP error code. This method is also not " +"defined in :class:`BaseHandler`, but will be called, if it exists, on an " +"instance of a subclass, when an HTTP error with code *nnn* occurs." +msgstr "" + +msgid "Subclasses should override this method to handle specific HTTP errors." +msgstr "" + +msgid "" +"Arguments, return values and exceptions raised should be the same as for :" +"meth:`http_error_default`." +msgstr "" + +msgid "" +"This method is *not* defined in :class:`BaseHandler`, but subclasses should " +"define it if they want to pre-process requests of the given protocol." +msgstr "" + +msgid "" +"This method, if defined, will be called by the parent :class:" +"`OpenerDirector`. *req* will be a :class:`Request` object. The return value " +"should be a :class:`Request` object." +msgstr "" + +msgid "" +"This method is *not* defined in :class:`BaseHandler`, but subclasses should " +"define it if they want to post-process responses of the given protocol." +msgstr "" + +msgid "" +"This method, if defined, will be called by the parent :class:" +"`OpenerDirector`. *req* will be a :class:`Request` object. *response* will " +"be an object implementing the same interface as the return value of :func:" +"`urlopen`. The return value should implement the same interface as the " +"return value of :func:`urlopen`." +msgstr "" + +msgid "HTTPRedirectHandler Objects" +msgstr "" + +msgid "" +"Some HTTP redirections require action from this module's client code. If " +"this is the case, :exc:`~urllib.error.HTTPError` is raised. See :rfc:`2616` " +"for details of the precise meanings of the various redirection codes." +msgstr "" + +msgid "" +"An :class:`HTTPError` exception raised as a security consideration if the " +"HTTPRedirectHandler is presented with a redirected URL which is not an HTTP, " +"HTTPS or FTP URL." +msgstr "" + +msgid "" +"Return a :class:`Request` or ``None`` in response to a redirect. This is " +"called by the default implementations of the :meth:`http_error_30\\*` " +"methods when a redirection is received from the server. If a redirection " +"should take place, return a new :class:`Request` to allow :meth:" +"`http_error_30\\*` to perform the redirect to *newurl*. Otherwise, raise :" +"exc:`~urllib.error.HTTPError` if no other handler should try to handle this " +"URL, or return ``None`` if you can't but another handler might." +msgstr "" + +msgid "" +"The default implementation of this method does not strictly follow :rfc:" +"`2616`, which says that 301 and 302 responses to ``POST`` requests must not " +"be automatically redirected without confirmation by the user. In reality, " +"browsers do allow automatic redirection of these responses, changing the " +"POST to a ``GET``, and the default implementation reproduces this behavior." +msgstr "" + +msgid "" +"Redirect to the ``Location:`` or ``URI:`` URL. This method is called by the " +"parent :class:`OpenerDirector` when getting an HTTP 'moved permanently' " +"response." +msgstr "" + +msgid "" +"The same as :meth:`http_error_301`, but called for the 'found' response." +msgstr "" + +msgid "" +"The same as :meth:`http_error_301`, but called for the 'see other' response." +msgstr "" + +msgid "" +"The same as :meth:`http_error_301`, but called for the 'temporary redirect' " +"response. It does not allow changing the request method from ``POST`` to " +"``GET``." +msgstr "" + +msgid "" +"The same as :meth:`http_error_301`, but called for the 'permanent redirect' " +"response. It does not allow changing the request method from ``POST`` to " +"``GET``." +msgstr "" + +msgid "HTTPCookieProcessor Objects" +msgstr "" + +msgid ":class:`HTTPCookieProcessor` instances have one attribute:" +msgstr "" + +msgid "The :class:`http.cookiejar.CookieJar` in which cookies are stored." +msgstr "" + +msgid "ProxyHandler Objects" +msgstr "" + +msgid "" +"The :class:`ProxyHandler` will have a method :meth:`_open` for " +"every *protocol* which has a proxy in the *proxies* dictionary given in the " +"constructor. The method will modify requests to go through the proxy, by " +"calling ``request.set_proxy()``, and call the next handler in the chain to " +"actually execute the protocol." +msgstr "" + +msgid "HTTPPasswordMgr Objects" +msgstr "" + +msgid "" +"These methods are available on :class:`HTTPPasswordMgr` and :class:" +"`HTTPPasswordMgrWithDefaultRealm` objects." +msgstr "" + +msgid "" +"*uri* can be either a single URI, or a sequence of URIs. *realm*, *user* and " +"*passwd* must be strings. This causes ``(user, passwd)`` to be used as " +"authentication tokens when authentication for *realm* and a super-URI of any " +"of the given URIs is given." +msgstr "" + +msgid "" +"Get user/password for given realm and URI, if any. This method will return " +"``(None, None)`` if there is no matching user/password." +msgstr "" + +msgid "" +"For :class:`HTTPPasswordMgrWithDefaultRealm` objects, the realm ``None`` " +"will be searched if the given *realm* has no matching user/password." +msgstr "" + +msgid "HTTPPasswordMgrWithPriorAuth Objects" +msgstr "" + +msgid "" +"This password manager extends :class:`HTTPPasswordMgrWithDefaultRealm` to " +"support tracking URIs for which authentication credentials should always be " +"sent." +msgstr "" + +msgid "" +"*realm*, *uri*, *user*, *passwd* are as for :meth:`HTTPPasswordMgr." +"add_password`. *is_authenticated* sets the initial value of the " +"``is_authenticated`` flag for the given URI or list of URIs. If " +"*is_authenticated* is specified as ``True``, *realm* is ignored." +msgstr "" + +msgid "Same as for :class:`HTTPPasswordMgrWithDefaultRealm` objects" +msgstr "" + +msgid "" +"Update the ``is_authenticated`` flag for the given *uri* or list of URIs." +msgstr "" + +msgid "" +"Returns the current state of the ``is_authenticated`` flag for the given URI." +msgstr "" + +msgid "AbstractBasicAuthHandler Objects" +msgstr "" + +msgid "" +"Handle an authentication request by getting a user/password pair, and re-" +"trying the request. *authreq* should be the name of the header where the " +"information about the realm is included in the request, *host* specifies the " +"URL and path to authenticate for, *req* should be the (failed) :class:" +"`Request` object, and *headers* should be the error headers." +msgstr "" + +msgid "" +"*host* is either an authority (e.g. ``\"python.org\"``) or a URL containing " +"an authority component (e.g. ``\"http://python.org/\"``). In either case, " +"the authority must not contain a userinfo component (so, ``\"python.org\"`` " +"and ``\"python.org:80\"`` are fine, ``\"joe:password@python.org\"`` is not)." +msgstr "" + +msgid "HTTPBasicAuthHandler Objects" +msgstr "" + +msgid "Retry the request with authentication information, if available." +msgstr "" + +msgid "ProxyBasicAuthHandler Objects" +msgstr "" + +msgid "AbstractDigestAuthHandler Objects" +msgstr "" + +msgid "" +"*authreq* should be the name of the header where the information about the " +"realm is included in the request, *host* should be the host to authenticate " +"to, *req* should be the (failed) :class:`Request` object, and *headers* " +"should be the error headers." +msgstr "" + +msgid "HTTPDigestAuthHandler Objects" +msgstr "" + +msgid "ProxyDigestAuthHandler Objects" +msgstr "" + +msgid "HTTPHandler Objects" +msgstr "" + +msgid "" +"Send an HTTP request, which can be either GET or POST, depending on ``req." +"has_data()``." +msgstr "" + +msgid "HTTPSHandler Objects" +msgstr "" + +msgid "" +"Send an HTTPS request, which can be either GET or POST, depending on ``req." +"has_data()``." +msgstr "" + +msgid "FileHandler Objects" +msgstr "" + +msgid "" +"Open the file locally, if there is no host name, or the host name is " +"``'localhost'``." +msgstr "" + +msgid "" +"This method is applicable only for local hostnames. When a remote hostname " +"is given, an :exc:`~urllib.error.URLError` is raised." +msgstr "" + +msgid "DataHandler Objects" +msgstr "" + +msgid "" +"Read a data URL. This kind of URL contains the content encoded in the URL " +"itself. The data URL syntax is specified in :rfc:`2397`. This implementation " +"ignores white spaces in base64 encoded data URLs so the URL may be wrapped " +"in whatever source file it comes from. But even though some browsers don't " +"mind about a missing padding at the end of a base64 encoded data URL, this " +"implementation will raise an :exc:`ValueError` in that case." +msgstr "" + +msgid "FTPHandler Objects" +msgstr "" + +msgid "" +"Open the FTP file indicated by *req*. The login is always done with empty " +"username and password." +msgstr "" + +msgid "CacheFTPHandler Objects" +msgstr "" + +msgid "" +":class:`CacheFTPHandler` objects are :class:`FTPHandler` objects with the " +"following additional methods:" +msgstr "" + +msgid "Set timeout of connections to *t* seconds." +msgstr "" + +msgid "Set maximum number of cached connections to *m*." +msgstr "" + +msgid "UnknownHandler Objects" +msgstr "" + +msgid "Raise a :exc:`~urllib.error.URLError` exception." +msgstr "" + +msgid "HTTPErrorProcessor Objects" +msgstr "" + +msgid "For 200 error codes, the response object is returned immediately." +msgstr "" + +msgid "" +"For non-200 error codes, this simply passes the job on to the :meth:" +"`http_error_\\` handler methods, via :meth:`OpenerDirector.error`. " +"Eventually, :class:`HTTPDefaultErrorHandler` will raise an :exc:`~urllib." +"error.HTTPError` if no other handler handles the error." +msgstr "" + +msgid "Process HTTPS error responses." +msgstr "" + +msgid "The behavior is same as :meth:`http_response`." +msgstr "" + +msgid "Examples" +msgstr "Przykłady" + +msgid "" +"In addition to the examples below, more examples are given in :ref:`urllib-" +"howto`." +msgstr "" + +msgid "" +"This example gets the python.org main page and displays the first 300 bytes " +"of it. ::" +msgstr "" + +msgid "" +"Note that urlopen returns a bytes object. This is because there is no way " +"for urlopen to automatically determine the encoding of the byte stream it " +"receives from the HTTP server. In general, a program will decode the " +"returned bytes object to string once it determines or guesses the " +"appropriate encoding." +msgstr "" + +msgid "" +"The following W3C document, https://www.w3.org/International/O-charset\\ , " +"lists the various ways in which an (X)HTML or an XML document could have " +"specified its encoding information." +msgstr "" + +msgid "" +"As the python.org website uses *utf-8* encoding as specified in its meta " +"tag, we will use the same for decoding the bytes object. ::" +msgstr "" + +msgid "" +"It is also possible to achieve the same result without using the :term:" +"`context manager` approach. ::" +msgstr "" + +msgid "" +"In the following example, we are sending a data-stream to the stdin of a CGI " +"and reading the data it returns to us. Note that this example will only work " +"when the Python installation supports SSL. ::" +msgstr "" + +msgid "The code for the sample CGI used in the above example is::" +msgstr "" + +msgid "Here is an example of doing a ``PUT`` request using :class:`Request`::" +msgstr "" + +msgid "Use of Basic HTTP Authentication::" +msgstr "" + +msgid "" +":func:`build_opener` provides many handlers by default, including a :class:" +"`ProxyHandler`. By default, :class:`ProxyHandler` uses the environment " +"variables named ``_proxy``, where ```` is the URL scheme " +"involved. For example, the :envvar:`http_proxy` environment variable is " +"read to obtain the HTTP proxy's URL." +msgstr "" + +msgid "" +"This example replaces the default :class:`ProxyHandler` with one that uses " +"programmatically supplied proxy URLs, and adds proxy authorization support " +"with :class:`ProxyBasicAuthHandler`. ::" +msgstr "" + +msgid "Adding HTTP headers:" +msgstr "" + +msgid "Use the *headers* argument to the :class:`Request` constructor, or::" +msgstr "" + +msgid "" +":class:`OpenerDirector` automatically adds a :mailheader:`User-Agent` header " +"to every :class:`Request`. To change this::" +msgstr "" + +msgid "" +"Also, remember that a few standard headers (:mailheader:`Content-Length`, :" +"mailheader:`Content-Type` and :mailheader:`Host`) are added when the :class:" +"`Request` is passed to :func:`urlopen` (or :meth:`OpenerDirector.open`)." +msgstr "" + +msgid "" +"Here is an example session that uses the ``GET`` method to retrieve a URL " +"containing parameters::" +msgstr "" + +msgid "" +"The following example uses the ``POST`` method instead. Note that params " +"output from urlencode is encoded to bytes before it is sent to urlopen as " +"data::" +msgstr "" + +msgid "" +"The following example uses an explicitly specified HTTP proxy, overriding " +"environment settings::" +msgstr "" + +msgid "" +"The following example uses no proxies at all, overriding environment " +"settings::" +msgstr "" + +msgid "Legacy interface" +msgstr "" + +msgid "" +"The following functions and classes are ported from the Python 2 module " +"``urllib`` (as opposed to ``urllib2``). They might become deprecated at " +"some point in the future." +msgstr "" + +msgid "" +"Copy a network object denoted by a URL to a local file. If the URL points to " +"a local file, the object will not be copied unless filename is supplied. " +"Return a tuple ``(filename, headers)`` where *filename* is the local file " +"name under which the object can be found, and *headers* is whatever the :" +"meth:`info` method of the object returned by :func:`urlopen` returned (for a " +"remote object). Exceptions are the same as for :func:`urlopen`." +msgstr "" + +msgid "" +"The second argument, if present, specifies the file location to copy to (if " +"absent, the location will be a tempfile with a generated name). The third " +"argument, if present, is a callable that will be called once on " +"establishment of the network connection and once after each block read " +"thereafter. The callable will be passed three arguments; a count of blocks " +"transferred so far, a block size in bytes, and the total size of the file. " +"The third argument may be ``-1`` on older FTP servers which do not return a " +"file size in response to a retrieval request." +msgstr "" + +msgid "The following example illustrates the most common usage scenario::" +msgstr "" + +msgid "" +"If the *url* uses the :file:`http:` scheme identifier, the optional *data* " +"argument may be given to specify a ``POST`` request (normally the request " +"type is ``GET``). The *data* argument must be a bytes object in standard :" +"mimetype:`application/x-www-form-urlencoded` format; see the :func:`urllib." +"parse.urlencode` function." +msgstr "" + +msgid "" +":func:`urlretrieve` will raise :exc:`ContentTooShortError` when it detects " +"that the amount of data available was less than the expected amount (which " +"is the size reported by a *Content-Length* header). This can occur, for " +"example, when the download is interrupted." +msgstr "" + +msgid "" +"The *Content-Length* is treated as a lower bound: if there's more data to " +"read, urlretrieve reads more data, but if less data is available, it raises " +"the exception." +msgstr "" + +msgid "" +"You can still retrieve the downloaded data in this case, it is stored in " +"the :attr:`content` attribute of the exception instance." +msgstr "" + +msgid "" +"If no *Content-Length* header was supplied, urlretrieve can not check the " +"size of the data it has downloaded, and just returns it. In this case you " +"just have to assume that the download was successful." +msgstr "" + +msgid "" +"Cleans up temporary files that may have been left behind by previous calls " +"to :func:`urlretrieve`." +msgstr "" + +msgid "" +"Base class for opening and reading URLs. Unless you need to support opening " +"objects using schemes other than :file:`http:`, :file:`ftp:`, or :file:`file:" +"`, you probably want to use :class:`FancyURLopener`." +msgstr "" + +msgid "" +"By default, the :class:`URLopener` class sends a :mailheader:`User-Agent` " +"header of ``urllib/VVV``, where *VVV* is the :mod:`urllib` version number. " +"Applications can define their own :mailheader:`User-Agent` header by " +"subclassing :class:`URLopener` or :class:`FancyURLopener` and setting the " +"class attribute :attr:`version` to an appropriate string value in the " +"subclass definition." +msgstr "" + +msgid "" +"The optional *proxies* parameter should be a dictionary mapping scheme names " +"to proxy URLs, where an empty dictionary turns proxies off completely. Its " +"default value is ``None``, in which case environmental proxy settings will " +"be used if present, as discussed in the definition of :func:`urlopen`, above." +msgstr "" + +msgid "" +"Additional keyword parameters, collected in *x509*, may be used for " +"authentication of the client when using the :file:`https:` scheme. The " +"keywords *key_file* and *cert_file* are supported to provide an SSL key and " +"certificate; both are needed to support client authentication." +msgstr "" + +msgid "" +":class:`URLopener` objects will raise an :exc:`OSError` exception if the " +"server returns an error code." +msgstr "" + +msgid "" +"Open *fullurl* using the appropriate protocol. This method sets up cache " +"and proxy information, then calls the appropriate open method with its input " +"arguments. If the scheme is not recognized, :meth:`open_unknown` is called. " +"The *data* argument has the same meaning as the *data* argument of :func:" +"`urlopen`." +msgstr "" + +msgid "This method always quotes *fullurl* using :func:`~urllib.parse.quote`." +msgstr "" + +msgid "Overridable interface to open unknown URL types." +msgstr "" + +msgid "" +"Retrieves the contents of *url* and places it in *filename*. The return " +"value is a tuple consisting of a local filename and either an :class:`email." +"message.Message` object containing the response headers (for remote URLs) or " +"``None`` (for local URLs). The caller must then open and read the contents " +"of *filename*. If *filename* is not given and the URL refers to a local " +"file, the input filename is returned. If the URL is non-local and " +"*filename* is not given, the filename is the output of :func:`tempfile." +"mktemp` with a suffix that matches the suffix of the last path component of " +"the input URL. If *reporthook* is given, it must be a function accepting " +"three numeric parameters: A chunk number, the maximum size chunks are read " +"in and the total size of the download (-1 if unknown). It will be called " +"once at the start and after each chunk of data is read from the network. " +"*reporthook* is ignored for local URLs." +msgstr "" + +msgid "" +"If the *url* uses the :file:`http:` scheme identifier, the optional *data* " +"argument may be given to specify a ``POST`` request (normally the request " +"type is ``GET``). The *data* argument must in standard :mimetype:" +"`application/x-www-form-urlencoded` format; see the :func:`urllib.parse." +"urlencode` function." +msgstr "" + +msgid "" +"Variable that specifies the user agent of the opener object. To get :mod:" +"`urllib` to tell servers that it is a particular user agent, set this in a " +"subclass as a class variable or in the constructor before calling the base " +"constructor." +msgstr "" + +msgid "" +":class:`FancyURLopener` subclasses :class:`URLopener` providing default " +"handling for the following HTTP response codes: 301, 302, 303, 307 and 401. " +"For the 30x response codes listed above, the :mailheader:`Location` header " +"is used to fetch the actual URL. For 401 response codes (authentication " +"required), basic HTTP authentication is performed. For the 30x response " +"codes, recursion is bounded by the value of the *maxtries* attribute, which " +"defaults to 10." +msgstr "" + +msgid "" +"For all other response codes, the method :meth:`http_error_default` is " +"called which you can override in subclasses to handle the error " +"appropriately." +msgstr "" + +msgid "" +"According to the letter of :rfc:`2616`, 301 and 302 responses to POST " +"requests must not be automatically redirected without confirmation by the " +"user. In reality, browsers do allow automatic redirection of these " +"responses, changing the POST to a GET, and :mod:`urllib` reproduces this " +"behaviour." +msgstr "" + +msgid "" +"The parameters to the constructor are the same as those for :class:" +"`URLopener`." +msgstr "" + +msgid "" +"When performing basic authentication, a :class:`FancyURLopener` instance " +"calls its :meth:`prompt_user_passwd` method. The default implementation " +"asks the users for the required information on the controlling terminal. A " +"subclass may override this method to support more appropriate behavior if " +"needed." +msgstr "" + +msgid "" +"The :class:`FancyURLopener` class offers one additional method that should " +"be overloaded to provide the appropriate behavior:" +msgstr "" + +msgid "" +"Return information needed to authenticate the user at the given host in the " +"specified security realm. The return value should be a tuple, ``(user, " +"password)``, which can be used for basic authentication." +msgstr "" + +msgid "" +"The implementation prompts for this information on the terminal; an " +"application should override this method to use an appropriate interaction " +"model in the local environment." +msgstr "" + +msgid ":mod:`urllib.request` Restrictions" +msgstr "" + +msgid "" +"Currently, only the following protocols are supported: HTTP (versions 0.9 " +"and 1.0), FTP, local files, and data URLs." +msgstr "" + +msgid "Added support for data URLs." +msgstr "" + +msgid "" +"The caching feature of :func:`urlretrieve` has been disabled until someone " +"finds the time to hack proper processing of Expiration time headers." +msgstr "" + +msgid "" +"There should be a function to query whether a particular URL is in the cache." +msgstr "" + +msgid "" +"For backward compatibility, if a URL appears to point to a local file but " +"the file can't be opened, the URL is re-interpreted using the FTP protocol. " +"This can sometimes cause confusing error messages." +msgstr "" + +msgid "" +"The :func:`urlopen` and :func:`urlretrieve` functions can cause arbitrarily " +"long delays while waiting for a network connection to be set up. This means " +"that it is difficult to build an interactive web client using these " +"functions without using threads." +msgstr "" + +msgid "" +"The data returned by :func:`urlopen` or :func:`urlretrieve` is the raw data " +"returned by the server. This may be binary data (such as an image), plain " +"text or (for example) HTML. The HTTP protocol provides type information in " +"the reply header, which can be inspected by looking at the :mailheader:" +"`Content-Type` header. If the returned data is HTML, you can use the " +"module :mod:`html.parser` to parse it." +msgstr "" + +msgid "" +"The code handling the FTP protocol cannot differentiate between a file and a " +"directory. This can lead to unexpected behavior when attempting to read a " +"URL that points to a file that is not accessible. If the URL ends in a ``/" +"``, it is assumed to refer to a directory and will be handled accordingly. " +"But if an attempt to read a file leads to a 550 error (meaning the URL " +"cannot be found or is not accessible, often for permission reasons), then " +"the path is treated as a directory in order to handle the case when a " +"directory is specified by a URL but the trailing ``/`` has been left off. " +"This can cause misleading results when you try to fetch a file whose read " +"permissions make it inaccessible; the FTP code will try to read it, fail " +"with a 550 error, and then perform a directory listing for the unreadable " +"file. If fine-grained control is needed, consider using the :mod:`ftplib` " +"module, subclassing :class:`FancyURLopener`, or changing *_urlopener* to " +"meet your needs." +msgstr "" + +msgid ":mod:`urllib.response` --- Response classes used by urllib" +msgstr "" + +msgid "" +"The :mod:`urllib.response` module defines functions and classes which define " +"a minimal file-like interface, including ``read()`` and ``readline()``. " +"Functions defined by this module are used internally by the :mod:`urllib." +"request` module. The typical response object is a :class:`urllib.response." +"addinfourl` instance:" +msgstr "" + +msgid "" +"URL of the resource retrieved, commonly used to determine if a redirect was " +"followed." +msgstr "" + +msgid "" +"Returns the headers of the response in the form of an :class:`~email.message." +"EmailMessage` instance." +msgstr "" + +msgid "Status code returned by server." +msgstr "" + +msgid "Deprecated in favor of :attr:`~addinfourl.url`." +msgstr "" + +msgid "Deprecated in favor of :attr:`~addinfourl.headers`." +msgstr "" + +msgid "Deprecated in favor of :attr:`~addinfourl.status`." +msgstr "" + +msgid "HTTP" +msgstr "" + +msgid "protocol" +msgstr "" + +msgid "FTP" +msgstr "" + +msgid "HTML" +msgstr "" diff --git a/library/urllib_robotparser.po b/library/urllib.robotparser.po similarity index 91% rename from library/urllib_robotparser.po rename to library/urllib.robotparser.po index 5c367364d8..b154257a2e 100644 --- a/library/urllib_robotparser.po +++ b/library/urllib.robotparser.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +92,7 @@ msgid "" msgstr "" msgid "WWW" -msgstr "" +msgstr "WWW" msgid "World Wide Web" msgstr "" diff --git a/library/uu.po b/library/uu.po index 9ca2db9778..c38e39d7d5 100644 --- a/library/uu.po +++ b/library/uu.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/uuid.po b/library/uuid.po index c44ec8c6d9..f9901ff31c 100644 --- a/library/uuid.po +++ b/library/uuid.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +48,9 @@ msgid "" "Depending on support from the underlying platform, :func:`uuid1` may or may " "not return a \"safe\" UUID. A safe UUID is one which is generated using " "synchronization methods that ensure no two processes can obtain the same " -"UUID. All instances of :class:`UUID` have an :attr:`is_safe` attribute " -"which relays any information about the UUID's safety, using this enumeration:" +"UUID. All instances of :class:`UUID` have an :attr:`~UUID.is_safe` " +"attribute which relays any information about the UUID's safety, using this " +"enumeration:" msgstr "" msgid "The UUID was generated by the platform in a multiprocessing-safe way." @@ -111,51 +113,27 @@ msgid "" msgstr "" msgid "Field" -msgstr "" +msgstr "Pole" msgid "Meaning" msgstr "Znaczenie" -msgid ":attr:`time_low`" -msgstr "" - -msgid "the first 32 bits of the UUID" -msgstr "" - -msgid ":attr:`time_mid`" -msgstr "" - -msgid "the next 16 bits of the UUID" -msgstr "" - -msgid ":attr:`time_hi_version`" +msgid "The first 32 bits of the UUID." msgstr "" -msgid ":attr:`clock_seq_hi_variant`" +msgid "The next 16 bits of the UUID." msgstr "" -msgid "the next 8 bits of the UUID" +msgid "The next 8 bits of the UUID." msgstr "" -msgid ":attr:`clock_seq_low`" +msgid "The last 48 bits of the UUID." msgstr "" -msgid ":attr:`node`" +msgid "The 60-bit timestamp." msgstr "" -msgid "the last 48 bits of the UUID" -msgstr "" - -msgid ":attr:`time`" -msgstr "" - -msgid "the 60-bit timestamp" -msgstr "" - -msgid ":attr:`clock_seq`" -msgstr "" - -msgid "the 14-bit sequence number" +msgid "The 14-bit sequence number." msgstr "" msgid "The UUID as a 32-character lowercase hexadecimal string." @@ -247,7 +225,7 @@ msgstr "" msgid "" "The :mod:`uuid` module defines the following constants for the possible " -"values of the :attr:`variant` attribute:" +"values of the :attr:`~UUID.variant` attribute:" msgstr "" msgid "Reserved for NCS compatibility." @@ -271,7 +249,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "Here are some examples of typical usage of the :mod:`uuid` module::" msgstr "" diff --git a/library/venv.po b/library/venv.po new file mode 100644 index 0000000000..bf637be76b --- /dev/null +++ b/library/venv.po @@ -0,0 +1,585 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`venv` --- Creation of virtual environments" +msgstr "" + +msgid "**Source code:** :source:`Lib/venv/`" +msgstr "**Kod źródłowy:**. :source:`Lib/venv/`" + +msgid "" +"The :mod:`!venv` module supports creating lightweight \"virtual " +"environments\", each with their own independent set of Python packages " +"installed in their :mod:`site` directories. A virtual environment is created " +"on top of an existing Python installation, known as the virtual " +"environment's \"base\" Python, and may optionally be isolated from the " +"packages in the base environment, so only those explicitly installed in the " +"virtual environment are available." +msgstr "" + +msgid "" +"When used from within a virtual environment, common installation tools such " +"as `pip`_ will install Python packages into a virtual environment without " +"needing to be told to do so explicitly." +msgstr "" + +msgid "A virtual environment is (amongst other things):" +msgstr "" + +msgid "" +"Used to contain a specific Python interpreter and software libraries and " +"binaries which are needed to support a project (library or application). " +"These are by default isolated from software in other virtual environments " +"and Python interpreters and libraries installed in the operating system." +msgstr "" + +msgid "" +"Contained in a directory, conventionally either named ``venv`` or ``.venv`` " +"in the project directory, or under a container directory for lots of virtual " +"environments, such as ``~/.virtualenvs``." +msgstr "" + +msgid "Not checked into source control systems such as Git." +msgstr "" + +msgid "" +"Considered as disposable -- it should be simple to delete and recreate it " +"from scratch. You don't place any project code in the environment" +msgstr "" + +msgid "" +"Not considered as movable or copyable -- you just recreate the same " +"environment in the target location." +msgstr "" + +msgid "See :pep:`405` for more background on Python virtual environments." +msgstr "" + +msgid "" +"`Python Packaging User Guide: Creating and using virtual environments " +"`__" +msgstr "" + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + +msgid "Creating virtual environments" +msgstr "Tworzenie środowisk wirtualnych" + +msgid "" +"Creation of :ref:`virtual environments ` is done by executing the " +"command ``venv``::" +msgstr "" + +msgid "" +"Running this command creates the target directory (creating any parent " +"directories that don't exist already) and places a ``pyvenv.cfg`` file in it " +"with a ``home`` key pointing to the Python installation from which the " +"command was run (a common name for the target directory is ``.venv``). It " +"also creates a ``bin`` (or ``Scripts`` on Windows) subdirectory containing a " +"copy/symlink of the Python binary/binaries (as appropriate for the platform " +"or arguments used at environment creation time). It also creates an " +"(initially empty) ``lib/pythonX.Y/site-packages`` subdirectory (on Windows, " +"this is ``Lib\\site-packages``). If an existing directory is specified, it " +"will be re-used." +msgstr "" + +msgid "" +"The use of ``venv`` is now recommended for creating virtual environments." +msgstr "" +"Korzystanie z ``venv`` jest obecnie zalecane do tworzenia środowisk " +"wirtualnych." + +msgid "" +"``pyvenv`` was the recommended tool for creating virtual environments for " +"Python 3.3 and 3.4, and is :ref:`deprecated in Python 3.6 `." +msgstr "" + +msgid "On Windows, invoke the ``venv`` command as follows::" +msgstr "" + +msgid "" +"Alternatively, if you configured the ``PATH`` and ``PATHEXT`` variables for " +"your :ref:`Python installation `::" +msgstr "" + +msgid "The command, if run with ``-h``, will show the available options::" +msgstr "" + +msgid "" +"Add ``--upgrade-deps`` option to upgrade pip + setuptools to the latest on " +"PyPI" +msgstr "" + +msgid "" +"Installs pip by default, added the ``--without-pip`` and ``--copies`` " +"options" +msgstr "" + +msgid "" +"In earlier versions, if the target directory already existed, an error was " +"raised, unless the ``--clear`` or ``--upgrade`` option was provided." +msgstr "" + +msgid "" +"While symlinks are supported on Windows, they are not recommended. Of " +"particular note is that double-clicking ``python.exe`` in File Explorer will " +"resolve the symlink eagerly and ignore the virtual environment." +msgstr "" + +msgid "" +"On Microsoft Windows, it may be required to enable the ``Activate.ps1`` " +"script by setting the execution policy for the user. You can do this by " +"issuing the following PowerShell command:" +msgstr "" + +msgid "" +"PS C:\\> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser" +msgstr "" +"PS C:\\> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser" + +msgid "" +"See `About Execution Policies `_ for more information." +msgstr "" +"Więcej informacji można znaleźć w `Zasady wykonywania `_." + +msgid "" +"The created ``pyvenv.cfg`` file also includes the ``include-system-site-" +"packages`` key, set to ``true`` if ``venv`` is run with the ``--system-site-" +"packages`` option, ``false`` otherwise." +msgstr "" + +msgid "" +"Unless the ``--without-pip`` option is given, :mod:`ensurepip` will be " +"invoked to bootstrap ``pip`` into the virtual environment." +msgstr "" + +msgid "" +"Multiple paths can be given to ``venv``, in which case an identical virtual " +"environment will be created, according to the given options, at each " +"provided path." +msgstr "" + +msgid "How venvs work" +msgstr "Jak działają venvs" + +msgid "" +"When a Python interpreter is running from a virtual environment, :data:`sys." +"prefix` and :data:`sys.exec_prefix` point to the directories of the virtual " +"environment, whereas :data:`sys.base_prefix` and :data:`sys." +"base_exec_prefix` point to those of the base Python used to create the " +"environment. It is sufficient to check ``sys.prefix != sys.base_prefix`` to " +"determine if the current interpreter is running from a virtual environment." +msgstr "" + +msgid "" +"A virtual environment may be \"activated\" using a script in its binary " +"directory (``bin`` on POSIX; ``Scripts`` on Windows). This will prepend that " +"directory to your :envvar:`PATH`, so that running :program:`python` will " +"invoke the environment's Python interpreter and you can run installed " +"scripts without having to use their full path. The invocation of the " +"activation script is platform-specific (:samp:`{}` must be replaced by " +"the path to the directory containing the virtual environment):" +msgstr "" + +msgid "Platform" +msgstr "Platforma" + +msgid "Shell" +msgstr "Shell" + +msgid "Command to activate virtual environment" +msgstr "Aktywacja środowiska wirtualnego" + +msgid "POSIX" +msgstr "POSIX" + +msgid "bash/zsh" +msgstr "bash/zsh" + +msgid ":samp:`$ source {}/bin/activate`" +msgstr ":samp:`$ source {}/bin/activate`" + +msgid "fish" +msgstr "ryba" + +msgid ":samp:`$ source {}/bin/activate.fish`" +msgstr ":samp:`$ source {}/bin/activate.fish`" + +msgid "csh/tcsh" +msgstr "csh/tcsh" + +msgid ":samp:`$ source {}/bin/activate.csh`" +msgstr ":samp:`$ source {}/bin/activate.csh`" + +msgid "PowerShell" +msgstr "PowerShell" + +msgid ":samp:`$ {}/bin/Activate.ps1`" +msgstr ":samp:`$ {}/bin/Activate.ps1`" + +msgid "Windows" +msgstr "Windows" + +msgid "cmd.exe" +msgstr "cmd.exe" + +msgid ":samp:`C:\\\\> {}\\\\Scripts\\\\activate.bat`" +msgstr ":samp:`C:\\\\> {}\\\\Scripts\\\\activate.bat`" + +msgid ":samp:`PS C:\\\\> {}\\\\Scripts\\\\Activate.ps1`" +msgstr ":samp:`PS C:\\\\> {}\\\\Scripts\\\\Activate.ps1`" + +msgid ":program:`fish` and :program:`csh` activation scripts." +msgstr ":program:`fish` oraz skrypty aktywacyjne :program:`csh`." + +msgid "" +"PowerShell activation scripts installed under POSIX for PowerShell Core " +"support." +msgstr "" + +msgid "" +"You don't specifically *need* to activate a virtual environment, as you can " +"just specify the full path to that environment's Python interpreter when " +"invoking Python. Furthermore, all scripts installed in the environment " +"should be runnable without activating it." +msgstr "" + +msgid "" +"In order to achieve this, scripts installed into virtual environments have a " +"\"shebang\" line which points to the environment's Python interpreter, i.e. :" +"samp:`#!/{}/bin/python`. This means that the script will run " +"with that interpreter regardless of the value of :envvar:`PATH`. On Windows, " +"\"shebang\" line processing is supported if you have the :ref:`launcher` " +"installed. Thus, double-clicking an installed script in a Windows Explorer " +"window should run it with the correct interpreter without the environment " +"needing to be activated or on the :envvar:`PATH`." +msgstr "" + +msgid "" +"When a virtual environment has been activated, the :envvar:`!VIRTUAL_ENV` " +"environment variable is set to the path of the environment. Since explicitly " +"activating a virtual environment is not required to use it, :envvar:`!" +"VIRTUAL_ENV` cannot be relied upon to determine whether a virtual " +"environment is being used." +msgstr "" + +msgid "" +"Because scripts installed in environments should not expect the environment " +"to be activated, their shebang lines contain the absolute paths to their " +"environment's interpreters. Because of this, environments are inherently non-" +"portable, in the general case. You should always have a simple means of " +"recreating an environment (for example, if you have a requirements file " +"``requirements.txt``, you can invoke ``pip install -r requirements.txt`` " +"using the environment's ``pip`` to install all of the packages needed by the " +"environment). If for any reason you need to move the environment to a new " +"location, you should recreate it at the desired location and delete the one " +"at the old location. If you move an environment because you moved a parent " +"directory of it, you should recreate the environment in its new location. " +"Otherwise, software installed into the environment may not work as expected." +msgstr "" + +msgid "" +"You can deactivate a virtual environment by typing ``deactivate`` in your " +"shell. The exact mechanism is platform-specific and is an internal " +"implementation detail (typically, a script or shell function will be used)." +msgstr "" + +msgid "API" +msgstr "API" + +msgid "" +"The high-level method described above makes use of a simple API which " +"provides mechanisms for third-party virtual environment creators to " +"customize environment creation according to their needs, the :class:" +"`EnvBuilder` class." +msgstr "" + +msgid "" +"The :class:`EnvBuilder` class accepts the following keyword arguments on " +"instantiation:" +msgstr "" + +msgid "" +"``system_site_packages`` -- a Boolean value indicating that the system " +"Python site-packages should be available to the environment (defaults to " +"``False``)." +msgstr "" + +msgid "" +"``clear`` -- a Boolean value which, if true, will delete the contents of any " +"existing target directory, before creating the environment." +msgstr "" + +msgid "" +"``symlinks`` -- a Boolean value indicating whether to attempt to symlink the " +"Python binary rather than copying." +msgstr "" + +msgid "" +"``upgrade`` -- a Boolean value which, if true, will upgrade an existing " +"environment with the running Python - for use when that Python has been " +"upgraded in-place (defaults to ``False``)." +msgstr "" + +msgid "" +"``with_pip`` -- a Boolean value which, if true, ensures pip is installed in " +"the virtual environment. This uses :mod:`ensurepip` with the ``--default-" +"pip`` option." +msgstr "" + +msgid "" +"``prompt`` -- a String to be used after virtual environment is activated " +"(defaults to ``None`` which means directory name of the environment would be " +"used). If the special string ``\".\"`` is provided, the basename of the " +"current directory is used as the prompt." +msgstr "" + +msgid "``upgrade_deps`` -- Update the base venv modules to the latest on PyPI" +msgstr "" + +msgid "Added the ``with_pip`` parameter" +msgstr "Dodano ``with_pip`` parametr" + +msgid "Added the ``prompt`` parameter" +msgstr "Dodano ``prompt`` parametr" + +msgid "Added the ``upgrade_deps`` parameter" +msgstr "Dodano ``upgrade_deps`` parametr" + +msgid "" +"Creators of third-party virtual environment tools will be free to use the " +"provided :class:`EnvBuilder` class as a base class." +msgstr "" + +msgid "The returned env-builder is an object which has a method, ``create``:" +msgstr "" + +msgid "" +"Create a virtual environment by specifying the target directory (absolute or " +"relative to the current directory) which is to contain the virtual " +"environment. The ``create`` method will either create the environment in " +"the specified directory, or raise an appropriate exception." +msgstr "" + +msgid "" +"The ``create`` method of the :class:`EnvBuilder` class illustrates the hooks " +"available for subclass customization::" +msgstr "" + +msgid "" +"Each of the methods :meth:`ensure_directories`, :meth:" +"`create_configuration`, :meth:`setup_python`, :meth:`setup_scripts` and :" +"meth:`post_setup` can be overridden." +msgstr "" + +msgid "" +"Creates the environment directory and all necessary subdirectories that " +"don't already exist, and returns a context object. This context object is " +"just a holder for attributes (such as paths) for use by the other methods. " +"If the :class:`EnvBuilder` is created with the arg ``clear=True``, contents " +"of the environment directory will be cleared and then all necessary " +"subdirectories will be recreated." +msgstr "" + +msgid "" +"The returned context object is a :class:`types.SimpleNamespace` with the " +"following attributes:" +msgstr "" + +msgid "" +"``env_dir`` - The location of the virtual environment. Used for " +"``__VENV_DIR__`` in activation scripts (see :meth:`install_scripts`)." +msgstr "" + +msgid "" +"``env_name`` - The name of the virtual environment. Used for " +"``__VENV_NAME__`` in activation scripts (see :meth:`install_scripts`)." +msgstr "" + +msgid "" +"``prompt`` - The prompt to be used by the activation scripts. Used for " +"``__VENV_PROMPT__`` in activation scripts (see :meth:`install_scripts`)." +msgstr "" + +msgid "" +"``executable`` - The underlying Python executable used by the virtual " +"environment. This takes into account the case where a virtual environment is " +"created from another virtual environment." +msgstr "" + +msgid "``inc_path`` - The include path for the virtual environment." +msgstr "" + +msgid "``lib_path`` - The purelib path for the virtual environment." +msgstr "" + +msgid "``bin_path`` - The script path for the virtual environment." +msgstr "" + +msgid "" +"``bin_name`` - The name of the script path relative to the virtual " +"environment location. Used for ``__VENV_BIN_NAME__`` in activation scripts " +"(see :meth:`install_scripts`)." +msgstr "" + +msgid "" +"``env_exe`` - The name of the Python interpreter in the virtual environment. " +"Used for ``__VENV_PYTHON__`` in activation scripts (see :meth:" +"`install_scripts`)." +msgstr "" + +msgid "" +"``env_exec_cmd`` - The name of the Python interpreter, taking into account " +"filesystem redirections. This can be used to run Python in the virtual " +"environment." +msgstr "" + +msgid "" +"The *venv* :ref:`sysconfig installation scheme ` is used " +"to construct the paths of the created directories." +msgstr "" + +msgid "Creates the ``pyvenv.cfg`` configuration file in the environment." +msgstr "" + +msgid "" +"Creates a copy or symlink to the Python executable in the environment. On " +"POSIX systems, if a specific executable ``python3.x`` was used, symlinks to " +"``python`` and ``python3`` will be created pointing to that executable, " +"unless files with those names already exist." +msgstr "" + +msgid "" +"Installs activation scripts appropriate to the platform into the virtual " +"environment." +msgstr "" + +msgid "" +"Upgrades the core venv dependency packages (currently ``pip`` and " +"``setuptools``) in the environment. This is done by shelling out to the " +"``pip`` executable in the environment." +msgstr "" + +msgid "" +"A placeholder method which can be overridden in third party implementations " +"to pre-install packages in the virtual environment or perform other post-" +"creation steps." +msgstr "" + +msgid "" +"Windows now uses redirector scripts for ``python[w].exe`` instead of copying " +"the actual binaries. In 3.7.2 only :meth:`setup_python` does nothing unless " +"running from a build in the source tree." +msgstr "" + +msgid "" +"Windows copies the redirector scripts as part of :meth:`setup_python` " +"instead of :meth:`setup_scripts`. This was not the case in 3.7.2. When using " +"symlinks, the original executables will be linked." +msgstr "" + +msgid "" +"In addition, :class:`EnvBuilder` provides this utility method that can be " +"called from :meth:`setup_scripts` or :meth:`post_setup` in subclasses to " +"assist in installing custom scripts into the virtual environment." +msgstr "" + +msgid "" +"*path* is the path to a directory that should contain subdirectories " +"\"common\", \"posix\", \"nt\", each containing scripts destined for the bin " +"directory in the environment. The contents of \"common\" and the directory " +"corresponding to :data:`os.name` are copied after some text replacement of " +"placeholders:" +msgstr "" + +msgid "" +"``__VENV_DIR__`` is replaced with the absolute path of the environment " +"directory." +msgstr "" + +msgid "" +"``__VENV_NAME__`` is replaced with the environment name (final path segment " +"of environment directory)." +msgstr "" + +msgid "" +"``__VENV_PROMPT__`` is replaced with the prompt (the environment name " +"surrounded by parentheses and with a following space)" +msgstr "" + +msgid "" +"``__VENV_BIN_NAME__`` is replaced with the name of the bin directory (either " +"``bin`` or ``Scripts``)." +msgstr "" + +msgid "" +"``__VENV_PYTHON__`` is replaced with the absolute path of the environment's " +"executable." +msgstr "" + +msgid "" +"The directories are allowed to exist (for when an existing environment is " +"being upgraded)." +msgstr "" + +msgid "There is also a module-level convenience function:" +msgstr "" + +msgid "" +"Create an :class:`EnvBuilder` with the given keyword arguments, and call " +"its :meth:`~EnvBuilder.create` method with the *env_dir* argument." +msgstr "" + +msgid "An example of extending ``EnvBuilder``" +msgstr "Przykład rozszerzenia ``EnvBuilder``" + +msgid "" +"The following script shows how to extend :class:`EnvBuilder` by implementing " +"a subclass which installs setuptools and pip into a created virtual " +"environment::" +msgstr "" + +msgid "" +"This script is also available for download `online `_." +msgstr "" +"Ten skrypt jest również dostępny do pobrania `online `_." + +msgid "Environments" +msgstr "Environments" + +msgid "virtual" +msgstr "wirtualne" diff --git a/library/warnings.po b/library/warnings.po index 21829147ae..5da5aa79de 100644 --- a/library/warnings.po +++ b/library/warnings.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -109,7 +109,7 @@ msgid "Description" msgstr "Opis" msgid ":exc:`Warning`" -msgstr "" +msgstr ":exc:`Warning`" msgid "" "This is the base class of all warning category classes. It is a subclass " @@ -117,13 +117,13 @@ msgid "" msgstr "" msgid ":exc:`UserWarning`" -msgstr "" +msgstr ":exc:`UserWarning`" msgid "The default category for :func:`warn`." msgstr "" msgid ":exc:`DeprecationWarning`" -msgstr "" +msgstr ":exc:`DeprecationWarning`" msgid "" "Base category for warnings about deprecated features when those warnings are " @@ -132,19 +132,19 @@ msgid "" msgstr "" msgid ":exc:`SyntaxWarning`" -msgstr "" +msgstr ":exc:`SyntaxWarning`" msgid "Base category for warnings about dubious syntactic features." msgstr "" msgid ":exc:`RuntimeWarning`" -msgstr "" +msgstr ":exc:`RuntimeWarning`" msgid "Base category for warnings about dubious runtime features." msgstr "" msgid ":exc:`FutureWarning`" -msgstr "" +msgstr ":exc:`FutureWarning`" msgid "" "Base category for warnings about deprecated features when those warnings are " @@ -152,7 +152,7 @@ msgid "" msgstr "" msgid ":exc:`PendingDeprecationWarning`" -msgstr "" +msgstr ":exc:`PendingDeprecationWarning`" msgid "" "Base category for warnings about features that will be deprecated in the " @@ -160,7 +160,7 @@ msgid "" msgstr "" msgid ":exc:`ImportWarning`" -msgstr "" +msgstr ":exc:`ImportWarning`" msgid "" "Base category for warnings triggered during the process of importing a " @@ -168,20 +168,20 @@ msgid "" msgstr "" msgid ":exc:`UnicodeWarning`" -msgstr "" +msgstr ":exc:`UnicodeWarning`" msgid "Base category for warnings related to Unicode." msgstr "" msgid ":exc:`BytesWarning`" -msgstr "" +msgstr ":exc:`BytesWarning`" msgid "" "Base category for warnings related to :class:`bytes` and :class:`bytearray`." msgstr "" msgid ":exc:`ResourceWarning`" -msgstr "" +msgstr ":exc:`ResourceWarning`" msgid "" "Base category for warnings related to resource usage (ignored by default)." diff --git a/library/wave.po b/library/wave.po new file mode 100644 index 0000000000..71485c4609 --- /dev/null +++ b/library/wave.po @@ -0,0 +1,242 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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:`wave` --- Read and write WAV files" +msgstr "" + +msgid "**Source code:** :source:`Lib/wave.py`" +msgstr "" + +msgid "" +"The :mod:`wave` module provides a convenient interface to the Waveform Audio " +"\"WAVE\" (or \"WAV\") file format. Only files using ``WAVE_FORMAT_PCM`` are " +"supported. Note that this does not include files using " +"``WAVE_FORMAT_EXTENSIBLE`` even if the subformat is PCM." +msgstr "" + +msgid "The :mod:`wave` module defines the following function and exception:" +msgstr "" + +msgid "" +"If *file* is a string, open the file by that name, otherwise treat it as a " +"file-like object. *mode* can be:" +msgstr "" + +msgid "``'rb'``" +msgstr "" + +msgid "Read only mode." +msgstr "" + +msgid "``'wb'``" +msgstr "" + +msgid "Write only mode." +msgstr "" + +msgid "Note that it does not allow read/write WAV files." +msgstr "" + +msgid "" +"A *mode* of ``'rb'`` returns a :class:`Wave_read` object, while a *mode* of " +"``'wb'`` returns a :class:`Wave_write` object. If *mode* is omitted and a " +"file-like object is passed as *file*, ``file.mode`` is used as the default " +"value for *mode*." +msgstr "" + +msgid "" +"If you pass in a file-like object, the wave object will not close it when " +"its ``close()`` method is called; it is the caller's responsibility to close " +"the file object." +msgstr "" + +msgid "" +"The :func:`.open` function may be used in a :keyword:`with` statement. When " +"the :keyword:`!with` block completes, the :meth:`Wave_read.close()` or :meth:" +"`Wave_write.close()` method is called." +msgstr "" + +msgid "Added support for unseekable files." +msgstr "" + +msgid "" +"An error raised when something is impossible because it violates the WAV " +"specification or hits an implementation deficiency." +msgstr "" + +msgid "Wave_read Objects" +msgstr "" + +msgid "Read a WAV file." +msgstr "" + +msgid "" +"Wave_read objects, as returned by :func:`.open`, have the following methods:" +msgstr "" + +msgid "" +"Close the stream if it was opened by :mod:`wave`, and make the instance " +"unusable. This is called automatically on object collection." +msgstr "" + +msgid "Returns number of audio channels (``1`` for mono, ``2`` for stereo)." +msgstr "" + +msgid "Returns sample width in bytes." +msgstr "" + +msgid "Returns sampling frequency." +msgstr "" + +msgid "Returns number of audio frames." +msgstr "" + +msgid "Returns compression type (``'NONE'`` is the only supported type)." +msgstr "" + +msgid "" +"Human-readable version of :meth:`getcomptype`. Usually ``'not compressed'`` " +"parallels ``'NONE'``." +msgstr "" + +msgid "" +"Returns a :func:`~collections.namedtuple` ``(nchannels, sampwidth, " +"framerate, nframes, comptype, compname)``, equivalent to output of the " +"``get*()`` methods." +msgstr "" + +msgid "" +"Reads and returns at most *n* frames of audio, as a :class:`bytes` object." +msgstr "" + +msgid "Rewind the file pointer to the beginning of the audio stream." +msgstr "" + +msgid "" +"The following two methods are defined for compatibility with the :mod:`aifc` " +"module, and don't do anything interesting." +msgstr "" + +msgid "Returns ``None``." +msgstr "Returns ``None``." + +msgid "Raise an error." +msgstr "" + +msgid "" +"The following two methods define a term \"position\" which is compatible " +"between them, and is otherwise implementation dependent." +msgstr "" + +msgid "Set the file pointer to the specified position." +msgstr "" + +msgid "Return current file pointer position." +msgstr "" + +msgid "Wave_write Objects" +msgstr "" + +msgid "Write a WAV file." +msgstr "" + +msgid "Wave_write objects, as returned by :func:`.open`." +msgstr "" + +msgid "" +"For seekable output streams, the ``wave`` header will automatically be " +"updated to reflect the number of frames actually written. For unseekable " +"streams, the *nframes* value must be accurate when the first frame data is " +"written. An accurate *nframes* value can be achieved either by calling :" +"meth:`setnframes` or :meth:`setparams` with the number of frames that will " +"be written before :meth:`close` is called and then using :meth:" +"`writeframesraw` to write the frame data, or by calling :meth:`writeframes` " +"with all of the frame data to be written. In the latter case :meth:" +"`writeframes` will calculate the number of frames in the data and set " +"*nframes* accordingly before writing the frame data." +msgstr "" + +msgid "Wave_write objects have the following methods:" +msgstr "" + +msgid "" +"Make sure *nframes* is correct, and close the file if it was opened by :mod:" +"`wave`. This method is called upon object collection. It will raise an " +"exception if the output stream is not seekable and *nframes* does not match " +"the number of frames actually written." +msgstr "" + +msgid "Set the number of channels." +msgstr "" + +msgid "Set the sample width to *n* bytes." +msgstr "" + +msgid "Set the frame rate to *n*." +msgstr "" + +msgid "A non-integral input to this method is rounded to the nearest integer." +msgstr "" + +msgid "" +"Set the number of frames to *n*. This will be changed later if the number " +"of frames actually written is different (this update attempt will raise an " +"error if the output stream is not seekable)." +msgstr "" + +msgid "" +"Set the compression type and description. At the moment, only compression " +"type ``NONE`` is supported, meaning no compression." +msgstr "" + +msgid "" +"The *tuple* should be ``(nchannels, sampwidth, framerate, nframes, comptype, " +"compname)``, with values valid for the ``set*()`` methods. Sets all " +"parameters." +msgstr "" + +msgid "" +"Return current position in the file, with the same disclaimer for the :meth:" +"`Wave_read.tell` and :meth:`Wave_read.setpos` methods." +msgstr "" + +msgid "Write audio frames, without correcting *nframes*." +msgstr "" + +msgid "Any :term:`bytes-like object` is now accepted." +msgstr "" + +msgid "" +"Write audio frames and make sure *nframes* is correct. It will raise an " +"error if the output stream is not seekable and the total number of frames " +"that have been written after *data* has been written does not match the " +"previously set value for *nframes*." +msgstr "" + +msgid "" +"Note that it is invalid to set any parameters after calling :meth:" +"`writeframes` or :meth:`writeframesraw`, and any attempt to do so will " +"raise :exc:`wave.Error`." +msgstr "" diff --git a/library/weakref.po b/library/weakref.po new file mode 100644 index 0000000000..893034430b --- /dev/null +++ b/library/weakref.po @@ -0,0 +1,502 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`weakref` --- Weak references" +msgstr "" + +msgid "**Source code:** :source:`Lib/weakref.py`" +msgstr "" + +msgid "" +"The :mod:`weakref` module allows the Python programmer to create :dfn:`weak " +"references` to objects." +msgstr "" + +msgid "" +"In the following, the term :dfn:`referent` means the object which is " +"referred to by a weak reference." +msgstr "" + +msgid "" +"A weak reference to an object is not enough to keep the object alive: when " +"the only remaining references to a referent are weak references, :term:" +"`garbage collection` is free to destroy the referent and reuse its memory " +"for something else. However, until the object is actually destroyed the " +"weak reference may return the object even if there are no strong references " +"to it." +msgstr "" + +msgid "" +"A primary use for weak references is to implement caches or mappings holding " +"large objects, where it's desired that a large object not be kept alive " +"solely because it appears in a cache or mapping." +msgstr "" + +msgid "" +"For example, if you have a number of large binary image objects, you may " +"wish to associate a name with each. If you used a Python dictionary to map " +"names to images, or images to names, the image objects would remain alive " +"just because they appeared as values or keys in the dictionaries. The :" +"class:`WeakKeyDictionary` and :class:`WeakValueDictionary` classes supplied " +"by the :mod:`weakref` module are an alternative, using weak references to " +"construct mappings that don't keep objects alive solely because they appear " +"in the mapping objects. If, for example, an image object is a value in a :" +"class:`WeakValueDictionary`, then when the last remaining references to that " +"image object are the weak references held by weak mappings, garbage " +"collection can reclaim the object, and its corresponding entries in weak " +"mappings are simply deleted." +msgstr "" + +msgid "" +":class:`WeakKeyDictionary` and :class:`WeakValueDictionary` use weak " +"references in their implementation, setting up callback functions on the " +"weak references that notify the weak dictionaries when a key or value has " +"been reclaimed by garbage collection. :class:`WeakSet` implements the :" +"class:`set` interface, but keeps weak references to its elements, just like " +"a :class:`WeakKeyDictionary` does." +msgstr "" + +msgid "" +":class:`finalize` provides a straight forward way to register a cleanup " +"function to be called when an object is garbage collected. This is simpler " +"to use than setting up a callback function on a raw weak reference, since " +"the module automatically ensures that the finalizer remains alive until the " +"object is collected." +msgstr "" + +msgid "" +"Most programs should find that using one of these weak container types or :" +"class:`finalize` is all they need -- it's not usually necessary to create " +"your own weak references directly. The low-level machinery is exposed by " +"the :mod:`weakref` module for the benefit of advanced uses." +msgstr "" + +msgid "" +"Not all objects can be weakly referenced. Objects which support weak " +"references include class instances, functions written in Python (but not in " +"C), instance methods, sets, frozensets, some :term:`file objects `, :term:`generators `, type objects, sockets, arrays, " +"deques, regular expression pattern objects, and code objects." +msgstr "" + +msgid "Added support for thread.lock, threading.Lock, and code objects." +msgstr "" + +msgid "" +"Several built-in types such as :class:`list` and :class:`dict` do not " +"directly support weak references but can add support through subclassing::" +msgstr "" + +msgid "" +"Other built-in types such as :class:`tuple` and :class:`int` do not support " +"weak references even when subclassed." +msgstr "" + +msgid "" +"Extension types can easily be made to support weak references; see :ref:" +"`weakref-support`." +msgstr "" + +msgid "" +"When ``__slots__`` are defined for a given type, weak reference support is " +"disabled unless a ``'__weakref__'`` string is also present in the sequence " +"of strings in the ``__slots__`` declaration. See :ref:`__slots__ " +"documentation ` for details." +msgstr "" + +msgid "" +"Return a weak reference to *object*. The original object can be retrieved " +"by calling the reference object if the referent is still alive; if the " +"referent is no longer alive, calling the reference object will cause :const:" +"`None` to be returned. If *callback* is provided and not :const:`None`, and " +"the returned weakref object is still alive, the callback will be called when " +"the object is about to be finalized; the weak reference object will be " +"passed as the only parameter to the callback; the referent will no longer be " +"available." +msgstr "" + +msgid "" +"It is allowable for many weak references to be constructed for the same " +"object. Callbacks registered for each weak reference will be called from the " +"most recently registered callback to the oldest registered callback." +msgstr "" + +msgid "" +"Exceptions raised by the callback will be noted on the standard error " +"output, but cannot be propagated; they are handled in exactly the same way " +"as exceptions raised from an object's :meth:`~object.__del__` method." +msgstr "" + +msgid "" +"Weak references are :term:`hashable` if the *object* is hashable. They will " +"maintain their hash value even after the *object* was deleted. If :func:" +"`hash` is called the first time only after the *object* was deleted, the " +"call will raise :exc:`TypeError`." +msgstr "" + +msgid "" +"Weak references support tests for equality, but not ordering. If the " +"referents are still alive, two references have the same equality " +"relationship as their referents (regardless of the *callback*). If either " +"referent has been deleted, the references are equal only if the reference " +"objects are the same object." +msgstr "" + +msgid "This is a subclassable type rather than a factory function." +msgstr "" + +msgid "" +"This read-only attribute returns the callback currently associated to the " +"weakref. If there is no callback or if the referent of the weakref is no " +"longer alive then this attribute will have value ``None``." +msgstr "" + +msgid "Added the :attr:`__callback__` attribute." +msgstr "" + +msgid "" +"Return a proxy to *object* which uses a weak reference. This supports use " +"of the proxy in most contexts instead of requiring the explicit " +"dereferencing used with weak reference objects. The returned object will " +"have a type of either ``ProxyType`` or ``CallableProxyType``, depending on " +"whether *object* is callable. Proxy objects are not :term:`hashable` " +"regardless of the referent; this avoids a number of problems related to " +"their fundamentally mutable nature, and prevents their use as dictionary " +"keys. *callback* is the same as the parameter of the same name to the :func:" +"`ref` function." +msgstr "" + +msgid "" +"Accessing an attribute of the proxy object after the referent is garbage " +"collected raises :exc:`ReferenceError`." +msgstr "" + +msgid "" +"Extended the operator support on proxy objects to include the matrix " +"multiplication operators ``@`` and ``@=``." +msgstr "" + +msgid "" +"Return the number of weak references and proxies which refer to *object*." +msgstr "" + +msgid "" +"Return a list of all weak reference and proxy objects which refer to " +"*object*." +msgstr "" + +msgid "" +"Mapping class that references keys weakly. Entries in the dictionary will " +"be discarded when there is no longer a strong reference to the key. This " +"can be used to associate additional data with an object owned by other parts " +"of an application without adding attributes to those objects. This can be " +"especially useful with objects that override attribute accesses." +msgstr "" + +msgid "" +"Note that when a key with equal value to an existing key (but not equal " +"identity) is inserted into the dictionary, it replaces the value but does " +"not replace the existing key. Due to this, when the reference to the " +"original key is deleted, it also deletes the entry in the dictionary::" +msgstr "" + +msgid "A workaround would be to remove the key prior to reassignment::" +msgstr "" + +msgid "Added support for ``|`` and ``|=`` operators, specified in :pep:`584`." +msgstr "" + +msgid "" +":class:`WeakKeyDictionary` objects have an additional method that exposes " +"the internal references directly. The references are not guaranteed to be " +"\"live\" at the time they are used, so the result of calling the references " +"needs to be checked before being used. This can be used to avoid creating " +"references that will cause the garbage collector to keep the keys around " +"longer than needed." +msgstr "" + +msgid "Return an iterable of the weak references to the keys." +msgstr "" + +msgid "" +"Mapping class that references values weakly. Entries in the dictionary will " +"be discarded when no strong reference to the value exists any more." +msgstr "" + +msgid "" +"Added support for ``|`` and ``|=`` operators, as specified in :pep:`584`." +msgstr "" + +msgid "" +":class:`WeakValueDictionary` objects have an additional method that has the " +"same issues as the :meth:`WeakKeyDictionary.keyrefs` method." +msgstr "" + +msgid "Return an iterable of the weak references to the values." +msgstr "" + +msgid "" +"Set class that keeps weak references to its elements. An element will be " +"discarded when no strong reference to it exists any more." +msgstr "" + +msgid "" +"A custom :class:`ref` subclass which simulates a weak reference to a bound " +"method (i.e., a method defined on a class and looked up on an instance). " +"Since a bound method is ephemeral, a standard weak reference cannot keep " +"hold of it. :class:`WeakMethod` has special code to recreate the bound " +"method until either the object or the original function dies::" +msgstr "" + +msgid "" +"*callback* is the same as the parameter of the same name to the :func:`ref` " +"function." +msgstr "" + +msgid "" +"Return a callable finalizer object which will be called when *obj* is " +"garbage collected. Unlike an ordinary weak reference, a finalizer will " +"always survive until the reference object is collected, greatly simplifying " +"lifecycle management." +msgstr "" + +msgid "" +"A finalizer is considered *alive* until it is called (either explicitly or " +"at garbage collection), and after that it is *dead*. Calling a live " +"finalizer returns the result of evaluating ``func(*arg, **kwargs)``, whereas " +"calling a dead finalizer returns :const:`None`." +msgstr "" + +msgid "" +"Exceptions raised by finalizer callbacks during garbage collection will be " +"shown on the standard error output, but cannot be propagated. They are " +"handled in the same way as exceptions raised from an object's :meth:`~object." +"__del__` method or a weak reference's callback." +msgstr "" + +msgid "" +"When the program exits, each remaining live finalizer is called unless its :" +"attr:`atexit` attribute has been set to false. They are called in reverse " +"order of creation." +msgstr "" + +msgid "" +"A finalizer will never invoke its callback during the later part of the :" +"term:`interpreter shutdown` when module globals are liable to have been " +"replaced by :const:`None`." +msgstr "" + +msgid "" +"If *self* is alive then mark it as dead and return the result of calling " +"``func(*args, **kwargs)``. If *self* is dead then return :const:`None`." +msgstr "" + +msgid "" +"If *self* is alive then mark it as dead and return the tuple ``(obj, func, " +"args, kwargs)``. If *self* is dead then return :const:`None`." +msgstr "" + +msgid "" +"If *self* is alive then return the tuple ``(obj, func, args, kwargs)``. If " +"*self* is dead then return :const:`None`." +msgstr "" + +msgid "Property which is true if the finalizer is alive, false otherwise." +msgstr "" + +msgid "" +"A writable boolean property which by default is true. When the program " +"exits, it calls all remaining live finalizers for which :attr:`.atexit` is " +"true. They are called in reverse order of creation." +msgstr "" + +msgid "" +"It is important to ensure that *func*, *args* and *kwargs* do not own any " +"references to *obj*, either directly or indirectly, since otherwise *obj* " +"will never be garbage collected. In particular, *func* should not be a " +"bound method of *obj*." +msgstr "" + +msgid "The type object for weak references objects." +msgstr "" + +msgid "The type object for proxies of objects which are not callable." +msgstr "" + +msgid "The type object for proxies of callable objects." +msgstr "" + +msgid "" +"Sequence containing all the type objects for proxies. This can make it " +"simpler to test if an object is a proxy without being dependent on naming " +"both proxy types." +msgstr "" + +msgid ":pep:`205` - Weak References" +msgstr "" + +msgid "" +"The proposal and rationale for this feature, including links to earlier " +"implementations and information about similar features in other languages." +msgstr "" + +msgid "Weak Reference Objects" +msgstr "" + +msgid "" +"Weak reference objects have no methods and no attributes besides :attr:`ref." +"__callback__`. A weak reference object allows the referent to be obtained, " +"if it still exists, by calling it:" +msgstr "" + +msgid "" +"If the referent no longer exists, calling the reference object returns :" +"const:`None`:" +msgstr "" + +msgid "" +"Testing that a weak reference object is still live should be done using the " +"expression ``ref() is not None``. Normally, application code that needs to " +"use a reference object should follow this pattern::" +msgstr "" + +msgid "" +"Using a separate test for \"liveness\" creates race conditions in threaded " +"applications; another thread can cause a weak reference to become " +"invalidated before the weak reference is called; the idiom shown above is " +"safe in threaded applications as well as single-threaded applications." +msgstr "" + +msgid "" +"Specialized versions of :class:`ref` objects can be created through " +"subclassing. This is used in the implementation of the :class:" +"`WeakValueDictionary` to reduce the memory overhead for each entry in the " +"mapping. This may be most useful to associate additional information with a " +"reference, but could also be used to insert additional processing on calls " +"to retrieve the referent." +msgstr "" + +msgid "" +"This example shows how a subclass of :class:`ref` can be used to store " +"additional information about an object and affect the value that's returned " +"when the referent is accessed::" +msgstr "" + +msgid "Example" +msgstr "Przykład" + +msgid "" +"This simple example shows how an application can use object IDs to retrieve " +"objects that it has seen before. The IDs of the objects can then be used in " +"other data structures without forcing the objects to remain alive, but the " +"objects can still be retrieved by ID if they do." +msgstr "" + +msgid "Finalizer Objects" +msgstr "" + +msgid "" +"The main benefit of using :class:`finalize` is that it makes it simple to " +"register a callback without needing to preserve the returned finalizer " +"object. For instance" +msgstr "" + +msgid "" +"The finalizer can be called directly as well. However the finalizer will " +"invoke the callback at most once." +msgstr "" + +msgid "" +"You can unregister a finalizer using its :meth:`~finalize.detach` method. " +"This kills the finalizer and returns the arguments passed to the constructor " +"when it was created." +msgstr "" + +msgid "" +"Unless you set the :attr:`~finalize.atexit` attribute to :const:`False`, a " +"finalizer will be called when the program exits if it is still alive. For " +"instance" +msgstr "" + +msgid "Comparing finalizers with :meth:`~object.__del__` methods" +msgstr "" + +msgid "" +"Suppose we want to create a class whose instances represent temporary " +"directories. The directories should be deleted with their contents when the " +"first of the following events occurs:" +msgstr "" + +msgid "the object is garbage collected," +msgstr "" + +msgid "the object's :meth:`!remove` method is called, or" +msgstr "" + +msgid "the program exits." +msgstr "" + +msgid "" +"We might try to implement the class using a :meth:`~object.__del__` method " +"as follows::" +msgstr "" + +msgid "" +"Starting with Python 3.4, :meth:`~object.__del__` methods no longer prevent " +"reference cycles from being garbage collected, and module globals are no " +"longer forced to :const:`None` during :term:`interpreter shutdown`. So this " +"code should work without any issues on CPython." +msgstr "" + +msgid "" +"However, handling of :meth:`~object.__del__` methods is notoriously " +"implementation specific, since it depends on internal details of the " +"interpreter's garbage collector implementation." +msgstr "" + +msgid "" +"A more robust alternative can be to define a finalizer which only references " +"the specific functions and objects that it needs, rather than having access " +"to the full state of the object::" +msgstr "" + +msgid "" +"Defined like this, our finalizer only receives a reference to the details it " +"needs to clean up the directory appropriately. If the object never gets " +"garbage collected the finalizer will still be called at exit." +msgstr "" + +msgid "" +"The other advantage of weakref based finalizers is that they can be used to " +"register finalizers for classes where the definition is controlled by a " +"third party, such as running code when a module is unloaded::" +msgstr "" + +msgid "" +"If you create a finalizer object in a daemonic thread just as the program " +"exits then there is the possibility that the finalizer does not get called " +"at exit. However, in a daemonic thread :func:`atexit.register`, ``try: ... " +"finally: ...`` and ``with: ...`` do not guarantee that cleanup occurs either." +msgstr "" diff --git a/library/webbrowser.po b/library/webbrowser.po index 71657a7518..38e77afc66 100644 --- a/library/webbrowser.po +++ b/library/webbrowser.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -156,13 +156,13 @@ msgid "Notes" msgstr "Notatki" msgid "``'mozilla'``" -msgstr "" +msgstr "``'mozilla'``" msgid ":class:`Mozilla('mozilla')`" msgstr "" msgid "``'firefox'``" -msgstr "" +msgstr "``'firefox'``" msgid "``'netscape'``" msgstr "" @@ -210,7 +210,7 @@ msgid ":class:`BackgroundBrowser('mosaic')`" msgstr "" msgid "``'opera'``" -msgstr "" +msgstr "``'opera'``" msgid ":class:`Opera()`" msgstr "" @@ -240,7 +240,7 @@ msgid ":class:`GenericBrowser('lynx')`" msgstr "" msgid "``'w3m'``" -msgstr "" +msgstr "``'w3m'``" msgid ":class:`GenericBrowser('w3m')`" msgstr "" @@ -255,7 +255,7 @@ msgid "\\(2)" msgstr "\\(2)" msgid "``'macosx'``" -msgstr "" +msgstr "``'macosx'``" msgid ":class:`MacOSXOSAScript('default')`" msgstr "" @@ -270,25 +270,25 @@ msgid ":class:`MacOSXOSAScript('safari')`" msgstr "" msgid "``'google-chrome'``" -msgstr "" +msgstr "``'google-chrome'``" msgid ":class:`Chrome('google-chrome')`" msgstr "" msgid "``'chrome'``" -msgstr "" +msgstr "``'chrome'``" msgid ":class:`Chrome('chrome')`" msgstr "" msgid "``'chromium'``" -msgstr "" +msgstr "``'chromium'``" msgid ":class:`Chromium('chromium')`" msgstr "" msgid "``'chromium-browser'``" -msgstr "" +msgstr "``'chromium-browser'``" msgid ":class:`Chromium('chromium-browser')`" msgstr "" diff --git a/library/winreg.po b/library/winreg.po index febe209f63..3a9f7aeb0a 100644 --- a/library/winreg.po +++ b/library/winreg.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Michał Biliński , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Michał Biliński , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -211,13 +210,13 @@ msgid "Meaning" msgstr "Znaczenie" msgid "``0``" -msgstr "" +msgstr "``0``" msgid "A string that identifies the value name" msgstr "" msgid "``1``" -msgstr "" +msgstr "``1``" msgid "" "An object that holds the value data, and whose type depends on the " @@ -225,7 +224,7 @@ msgid "" msgstr "" msgid "``2``" -msgstr "" +msgstr "``2``" msgid "" "An integer that identifies the type of the value data (see table in docs " @@ -285,8 +284,8 @@ msgid "" msgstr "" msgid "" -"A call to :func:`LoadKey` fails if the calling process does not have the :" -"const:`SE_RESTORE_PRIVILEGE` privilege. Note that privileges are different " +"A call to :func:`LoadKey` fails if the calling process does not have the :c:" +"data:`!SE_RESTORE_PRIVILEGE` privilege. Note that privileges are different " "from permissions -- see the `RegLoadKey documentation `__ for more details." msgstr "" @@ -405,7 +404,7 @@ msgstr "" msgid "" "If *key* represents a key on a remote computer, the path described by " "*file_name* is relative to the remote computer. The caller of this method " -"must possess the :const:`SeBackupPrivilege` security privilege. Note that " +"must possess the **SeBackupPrivilege** security privilege. Note that " "privileges are different than permissions -- see the `Conflicts Between User " "Rights and Permissions documentation `__ for more details." @@ -530,7 +529,7 @@ msgid "Constants" msgstr "Stały" msgid "" -"The following constants are defined for use in many :mod:`_winreg` functions." +"The following constants are defined for use in many :mod:`winreg` functions." msgstr "" msgid "HKEY_* Constants" @@ -714,7 +713,8 @@ msgid "" "accept an integer, however, use of the handle object is encouraged." msgstr "" -msgid "Handle objects provide semantics for :meth:`__bool__` -- thus ::" +msgid "" +"Handle objects provide semantics for :meth:`~object.__bool__` -- thus ::" msgstr "" msgid "" diff --git a/library/winsound.po b/library/winsound.po index ef37753bbd..1eccb32145 100644 --- a/library/winsound.po +++ b/library/winsound.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -41,9 +41,9 @@ msgid "" msgstr "" msgid "" -"Call the underlying :c:func:`PlaySound` function from the Platform API. The " -"*sound* parameter may be a filename, a system sound alias, audio data as a :" -"term:`bytes-like object`, or ``None``. Its interpretation depends on the " +"Call the underlying :c:func:`!PlaySound` function from the Platform API. " +"The *sound* parameter may be a filename, a system sound alias, audio data as " +"a :term:`bytes-like object`, or ``None``. Its interpretation depends on the " "value of *flags*, which can be a bitwise ORed combination of the constants " "described below. If the *sound* parameter is ``None``, any currently playing " "waveform sound is stopped. If the system indicates an error, :exc:" @@ -51,7 +51,7 @@ msgid "" msgstr "" msgid "" -"Call the underlying :c:func:`MessageBeep` function from the Platform API. " +"Call the underlying :c:func:`!MessageBeep` function from the Platform API. " "This plays a sound as specified in the registry. The *type* argument " "specifies which sound to play; possible values are ``-1``, " "``MB_ICONASTERISK``, ``MB_ICONEXCLAMATION``, ``MB_ICONHAND``, " diff --git a/library/xdrlib.po b/library/xdrlib.po index 5f517935f6..314ce670a9 100644 --- a/library/xdrlib.po +++ b/library/xdrlib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:17+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:21+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/library/xml_dom_minidom.po b/library/xml.dom.minidom.po similarity index 97% rename from library/xml_dom_minidom.po rename to library/xml.dom.minidom.po index 9280998d5a..1bd9a40edf 100644 --- a/library/xml_dom_minidom.po +++ b/library/xml.dom.minidom.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:18+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -290,10 +290,10 @@ msgid "" msgstr "" msgid ":class:`DOMTimeStamp`" -msgstr "" +msgstr ":class:`DOMTimeStamp`" msgid ":class:`EntityReference`" -msgstr "" +msgstr ":class:`EntityReference`" msgid "" "Most of these reflect information in the XML document that is not of general " diff --git a/library/xml_dom.po b/library/xml.dom.po similarity index 93% rename from library/xml_dom.po rename to library/xml.dom.po index 640cafcae6..7450388d65 100644 --- a/library/xml_dom.po +++ b/library/xml.dom.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:18+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -205,91 +204,91 @@ msgid "Purpose" msgstr "" msgid ":class:`DOMImplementation`" -msgstr "" +msgstr ":class:`DOMImplementation`" msgid ":ref:`dom-implementation-objects`" -msgstr "" +msgstr ":ref:`dom-implementation-objects`" msgid "Interface to the underlying implementation." msgstr "" msgid ":class:`Node`" -msgstr "" +msgstr ":class:`Node`" msgid ":ref:`dom-node-objects`" -msgstr "" +msgstr ":ref:`dom-node-objects`" msgid "Base interface for most objects in a document." msgstr "" msgid ":class:`NodeList`" -msgstr "" +msgstr ":class:`NodeList`" msgid ":ref:`dom-nodelist-objects`" -msgstr "" +msgstr ":ref:`dom-nodelist-objects`" msgid "Interface for a sequence of nodes." msgstr "" msgid ":class:`DocumentType`" -msgstr "" +msgstr ":class:`DocumentType`" msgid ":ref:`dom-documenttype-objects`" -msgstr "" +msgstr ":ref:`dom-documenttype-objects`" msgid "Information about the declarations needed to process a document." msgstr "" msgid ":class:`Document`" -msgstr "" +msgstr ":class:`Document`" msgid ":ref:`dom-document-objects`" -msgstr "" +msgstr ":ref:`dom-document-objects`" msgid "Object which represents an entire document." msgstr "" msgid ":class:`Element`" -msgstr "" +msgstr ":class:`Element`" msgid ":ref:`dom-element-objects`" -msgstr "" +msgstr ":ref:`dom-element-objects`" msgid "Element nodes in the document hierarchy." msgstr "" msgid ":class:`Attr`" -msgstr "" +msgstr ":class:`Attr`" msgid ":ref:`dom-attr-objects`" -msgstr "" +msgstr ":ref:`dom-attr-objects`" msgid "Attribute value nodes on element nodes." msgstr "" msgid ":class:`Comment`" -msgstr "" +msgstr ":class:`Comment`" msgid ":ref:`dom-comment-objects`" -msgstr "" +msgstr ":ref:`dom-comment-objects`" msgid "Representation of comments in the source document." msgstr "" msgid ":class:`Text`" -msgstr "" +msgstr ":class:`Text`" msgid ":ref:`dom-text-objects`" -msgstr "" +msgstr ":ref:`dom-text-objects`" msgid "Nodes containing textual content from the document." msgstr "" msgid ":class:`ProcessingInstruction`" -msgstr "" +msgstr ":class:`ProcessingInstruction`" msgid ":ref:`dom-pi-objects`" -msgstr "" +msgstr ":ref:`dom-pi-objects`" msgid "Processing instruction representation." msgstr "" @@ -760,8 +759,8 @@ msgstr "" msgid "" "There are also experimental methods that give this class more mapping " -"behavior. You can use them or you can use the standardized :meth:" -"`getAttribute\\*` family of methods on the :class:`Element` objects." +"behavior. You can use them or you can use the standardized :meth:`!" +"getAttribute\\*` family of methods on the :class:`Element` objects." msgstr "" msgid "Comment Objects" @@ -936,94 +935,94 @@ msgid "Exception" msgstr "" msgid ":const:`DOMSTRING_SIZE_ERR`" -msgstr "" +msgstr ":const:`DOMSTRING_SIZE_ERR`" msgid ":exc:`DomstringSizeErr`" -msgstr "" +msgstr ":exc:`DomstringSizeErr`" msgid ":const:`HIERARCHY_REQUEST_ERR`" -msgstr "" +msgstr ":const:`HIERARCHY_REQUEST_ERR`" msgid ":exc:`HierarchyRequestErr`" -msgstr "" +msgstr ":exc:`HierarchyRequestErr`" msgid ":const:`INDEX_SIZE_ERR`" -msgstr "" +msgstr ":const:`INDEX_SIZE_ERR`" msgid ":exc:`IndexSizeErr`" -msgstr "" +msgstr ":exc:`IndexSizeErr`" msgid ":const:`INUSE_ATTRIBUTE_ERR`" -msgstr "" +msgstr ":const:`INUSE_ATTRIBUTE_ERR`" msgid ":exc:`InuseAttributeErr`" -msgstr "" +msgstr ":exc:`InuseAttributeErr`" msgid ":const:`INVALID_ACCESS_ERR`" -msgstr "" +msgstr ":const:`INVALID_ACCESS_ERR`" msgid ":exc:`InvalidAccessErr`" -msgstr "" +msgstr ":exc:`InvalidAccessErr`" msgid ":const:`INVALID_CHARACTER_ERR`" -msgstr "" +msgstr ":const:`INVALID_CHARACTER_ERR`" msgid ":exc:`InvalidCharacterErr`" -msgstr "" +msgstr ":exc:`InvalidCharacterErr`" msgid ":const:`INVALID_MODIFICATION_ERR`" -msgstr "" +msgstr ":const:`INVALID_MODIFICATION_ERR`" msgid ":exc:`InvalidModificationErr`" -msgstr "" +msgstr ":exc:`InvalidModificationErr`" msgid ":const:`INVALID_STATE_ERR`" -msgstr "" +msgstr ":const:`INVALID_STATE_ERR`" msgid ":exc:`InvalidStateErr`" -msgstr "" +msgstr ":exc:`InvalidStateErr`" msgid ":const:`NAMESPACE_ERR`" -msgstr "" +msgstr ":const:`NAMESPACE_ERR`" msgid ":exc:`NamespaceErr`" -msgstr "" +msgstr ":exc:`NamespaceErr`" msgid ":const:`NOT_FOUND_ERR`" -msgstr "" +msgstr ":const:`NOT_FOUND_ERR`" msgid ":exc:`NotFoundErr`" -msgstr "" +msgstr ":exc:`NotFoundErr`" msgid ":const:`NOT_SUPPORTED_ERR`" -msgstr "" +msgstr ":const:`NOT_SUPPORTED_ERR`" msgid ":exc:`NotSupportedErr`" -msgstr "" +msgstr ":exc:`NotSupportedErr`" msgid ":const:`NO_DATA_ALLOWED_ERR`" -msgstr "" +msgstr ":const:`NO_DATA_ALLOWED_ERR`" msgid ":exc:`NoDataAllowedErr`" -msgstr "" +msgstr ":exc:`NoDataAllowedErr`" msgid ":const:`NO_MODIFICATION_ALLOWED_ERR`" -msgstr "" +msgstr ":const:`NO_MODIFICATION_ALLOWED_ERR`" msgid ":exc:`NoModificationAllowedErr`" -msgstr "" +msgstr ":exc:`NoModificationAllowedErr`" msgid ":const:`SYNTAX_ERR`" -msgstr "" +msgstr ":const:`SYNTAX_ERR`" msgid ":exc:`SyntaxErr`" -msgstr "" +msgstr ":exc:`SyntaxErr`" msgid ":const:`WRONG_DOCUMENT_ERR`" -msgstr "" +msgstr ":const:`WRONG_DOCUMENT_ERR`" msgid ":exc:`WrongDocumentErr`" -msgstr "" +msgstr ":exc:`WrongDocumentErr`" msgid "Conformance" msgstr "" @@ -1049,28 +1048,28 @@ msgid "Python Type" msgstr "typ Pythona" msgid "``boolean``" -msgstr "" +msgstr "``boolean``" msgid "``bool`` or ``int``" -msgstr "" +msgstr "``bool`` or ``int``" msgid "``int``" -msgstr "" +msgstr "``int``" msgid "``long int``" -msgstr "" +msgstr "``long int``" msgid "``unsigned int``" -msgstr "" +msgstr "``unsigned int``" msgid "``DOMString``" msgstr "" msgid "``str`` or ``bytes``" -msgstr "" +msgstr "``str`` or ``bytes``" msgid "``null``" -msgstr "" +msgstr "``null``" msgid "``None``" msgstr "``None`` - z ang. - ``Żaden``" diff --git a/library/xml.dom.pulldom.po b/library/xml.dom.pulldom.po new file mode 100644 index 0000000000..b03cb8016f --- /dev/null +++ b/library/xml.dom.pulldom.po @@ -0,0 +1,146 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`xml.dom.pulldom` --- Support for building partial DOM trees" +msgstr "" + +msgid "**Source code:** :source:`Lib/xml/dom/pulldom.py`" +msgstr "" + +msgid "" +"The :mod:`xml.dom.pulldom` module provides a \"pull parser\" which can also " +"be asked to produce DOM-accessible fragments of the document where " +"necessary. The basic concept involves pulling \"events\" from a stream of " +"incoming XML and processing them. In contrast to SAX which also employs an " +"event-driven processing model together with callbacks, the user of a pull " +"parser is responsible for explicitly pulling events from the stream, looping " +"over those events until either processing is finished or an error condition " +"occurs." +msgstr "" + +msgid "" +"The :mod:`xml.dom.pulldom` module is not secure against maliciously " +"constructed data. If you need to parse untrusted or unauthenticated data " +"see :ref:`xml-vulnerabilities`." +msgstr "" + +msgid "" +"The SAX parser no longer processes general external entities by default to " +"increase security by default. To enable processing of external entities, " +"pass a custom parser instance in::" +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "``event`` is a constant and can be one of:" +msgstr "" + +msgid ":data:`START_ELEMENT`" +msgstr ":data:`START_ELEMENT`" + +msgid ":data:`END_ELEMENT`" +msgstr ":data:`END_ELEMENT`" + +msgid ":data:`COMMENT`" +msgstr ":data:`COMMENT`" + +msgid ":data:`START_DOCUMENT`" +msgstr ":data:`START_DOCUMENT`" + +msgid ":data:`END_DOCUMENT`" +msgstr ":data:`END_DOCUMENT`" + +msgid ":data:`CHARACTERS`" +msgstr ":data:`CHARACTERS`" + +msgid ":data:`PROCESSING_INSTRUCTION`" +msgstr ":data:`PROCESSING_INSTRUCTION`" + +msgid ":data:`IGNORABLE_WHITESPACE`" +msgstr ":data:`IGNORABLE_WHITESPACE`" + +msgid "" +"``node`` is an object of type :class:`xml.dom.minidom.Document`, :class:`xml." +"dom.minidom.Element` or :class:`xml.dom.minidom.Text`." +msgstr "" + +msgid "" +"Since the document is treated as a \"flat\" stream of events, the document " +"\"tree\" is implicitly traversed and the desired elements are found " +"regardless of their depth in the tree. In other words, one does not need to " +"consider hierarchical issues such as recursive searching of the document " +"nodes, although if the context of elements were important, one would either " +"need to maintain some context-related state (i.e. remembering where one is " +"in the document at any given point) or to make use of the :func:" +"`DOMEventStream.expandNode` method and switch to DOM-related processing." +msgstr "" + +msgid "Subclass of :class:`xml.sax.handler.ContentHandler`." +msgstr "" + +msgid "" +"Return a :class:`DOMEventStream` from the given input. *stream_or_string* " +"may be either a file name, or a file-like object. *parser*, if given, must " +"be an :class:`~xml.sax.xmlreader.XMLReader` object. This function will " +"change the document handler of the parser and activate namespace support; " +"other parser configuration (like setting an entity resolver) must have been " +"done in advance." +msgstr "" + +msgid "" +"If you have XML in a string, you can use the :func:`parseString` function " +"instead:" +msgstr "" + +msgid "" +"Return a :class:`DOMEventStream` that represents the (Unicode) *string*." +msgstr "" + +msgid "Default value for the *bufsize* parameter to :func:`parse`." +msgstr "" + +msgid "" +"The value of this variable can be changed before calling :func:`parse` and " +"the new value will take effect." +msgstr "" + +msgid "DOMEventStream Objects" +msgstr "" + +msgid "Support for :meth:`~object.__getitem__` method has been removed." +msgstr "" + +msgid "" +"Return a tuple containing *event* and the current *node* as :class:`xml.dom." +"minidom.Document` if event equals :data:`START_DOCUMENT`, :class:`xml.dom." +"minidom.Element` if event equals :data:`START_ELEMENT` or :data:" +"`END_ELEMENT` or :class:`xml.dom.minidom.Text` if event equals :data:" +"`CHARACTERS`. The current node does not contain information about its " +"children, unless :func:`expandNode` is called." +msgstr "" + +msgid "Expands all children of *node* into *node*. Example::" +msgstr "" diff --git a/library/xml_etree_elementtree.po b/library/xml.etree.elementtree.po similarity index 94% rename from library/xml_etree_elementtree.po rename to library/xml.etree.elementtree.po index b081a0d242..3306565069 100644 --- a/library/xml_etree_elementtree.po +++ b/library/xml.etree.elementtree.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:18+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +37,7 @@ msgstr "" msgid "This module will use a fast implementation whenever available." msgstr "" -msgid "The :mod:`xml.etree.cElementTree` module is deprecated." +msgid "The :mod:`!xml.etree.cElementTree` module is deprecated." msgstr "" msgid "" @@ -73,8 +72,8 @@ msgid "Parsing XML" msgstr "" msgid "" -"We'll be using the following XML document as the sample data for this " -"section:" +"We'll be using the fictive :file:`country_data.xml` XML document as the " +"sample data for this section:" msgstr "" msgid "We can import this data by reading from a file::" @@ -146,6 +145,12 @@ msgid "" "memory." msgstr "" +msgid "" +"Where *immediate* feedback through events is wanted, calling method :meth:" +"`XMLPullParser.flush` can help reduce delay; please make sure to study the " +"related security notes." +msgstr "" + msgid "Finding interesting elements" msgstr "" @@ -252,7 +257,7 @@ msgid "" msgstr "" msgid "Example" -msgstr "" +msgstr "Przykład" msgid "" "Here's an example that demonstrates some of the XPath capabilities of the " @@ -290,7 +295,7 @@ msgid "Support for star-wildcards was added." msgstr "" msgid "``*``" -msgstr "" +msgstr "``*``" msgid "" "Selects all child elements, including comments and processing instructions. " @@ -298,7 +303,7 @@ msgid "" msgstr "" msgid "``.``" -msgstr "" +msgstr "``.``" msgid "" "Selects the current node. This is mostly useful at the beginning of the " @@ -306,7 +311,7 @@ msgid "" msgstr "" msgid "``//``" -msgstr "" +msgstr "``//``" msgid "" "Selects all subelements, on all levels beneath the current element. For " @@ -314,7 +319,7 @@ msgid "" msgstr "" msgid "``..``" -msgstr "" +msgstr "``..``" msgid "" "Selects the parent element. Returns ``None`` if the path attempts to reach " @@ -322,13 +327,13 @@ msgid "" msgstr "" msgid "``[@attrib]``" -msgstr "" +msgstr "``[@attrib]``" msgid "Selects all elements that have the given attribute." msgstr "" msgid "``[@attrib='value']``" -msgstr "" +msgstr "``[@attrib='value']``" msgid "" "Selects all elements for which the given attribute has the given value. The " @@ -336,7 +341,7 @@ msgid "" msgstr "" msgid "``[@attrib!='value']``" -msgstr "" +msgstr "``[@attrib!='value']``" msgid "" "Selects all elements for which the given attribute does not have the given " @@ -352,7 +357,7 @@ msgid "" msgstr "" msgid "``[.='text']``" -msgstr "" +msgstr "``[.='text']``" msgid "" "Selects all elements whose complete text content, including descendants, " @@ -360,7 +365,7 @@ msgid "" msgstr "" msgid "``[.!='text']``" -msgstr "" +msgstr "``[.!='text']``" msgid "" "Selects all elements whose complete text content, including descendants, " @@ -368,7 +373,7 @@ msgid "" msgstr "" msgid "``[tag='text']``" -msgstr "" +msgstr "``[tag='text']``" msgid "" "Selects all elements that have a child named ``tag`` whose complete text " @@ -376,7 +381,7 @@ msgid "" msgstr "" msgid "``[tag!='text']``" -msgstr "" +msgstr "``[tag!='text']``" msgid "" "Selects all elements that have a child named ``tag`` whose complete text " @@ -537,8 +542,10 @@ msgid "" "omitted, only ``\"end\"`` events are reported. *parser* is an optional " "parser instance. If not given, the standard :class:`XMLParser` parser is " "used. *parser* must be a subclass of :class:`XMLParser` and can only use " -"the default :class:`TreeBuilder` as a target. Returns an :term:`iterator` " -"providing ``(event, elem)`` pairs." +"the default :class:`TreeBuilder` as a target. Returns an :term:`iterator` " +"providing ``(event, elem)`` pairs; it has a ``root`` attribute that " +"references the root element of the resulting XML tree once *source* is fully " +"read." msgstr "" msgid "" @@ -581,9 +588,9 @@ msgstr "" msgid "" "Note that :class:`XMLParser` skips over processing instructions in the input " -"instead of creating comment objects for them. An :class:`ElementTree` will " -"only contain processing instruction nodes if they have been inserted into to " -"the tree using one of the :class:`Element` methods." +"instead of creating PI objects for them. An :class:`ElementTree` will only " +"contain processing instruction nodes if they have been inserted into to the " +"tree using one of the :class:`Element` methods." msgstr "" msgid "" @@ -618,10 +625,10 @@ msgid "" "Returns an (optionally) encoded string containing the XML data." msgstr "" -msgid "The *short_empty_elements* parameter." +msgid "Added the *short_empty_elements* parameter." msgstr "" -msgid "The *xml_declaration* and *default_namespace* parameters." +msgid "Added the *xml_declaration* and *default_namespace* parameters." msgstr "" msgid "" @@ -735,7 +742,7 @@ msgid "" "string. If the loader fails, it can return None or raise an exception." msgstr "" -msgid "The *base_url* and *max_depth* parameters." +msgid "Added the *base_url* and *max_depth* parameters." msgstr "" msgid "Element Objects" @@ -1081,7 +1088,7 @@ msgid "" msgstr "" msgid "" -"Creates a comment with the given *target* name and *text*. If " +"Creates a process instruction with the given *target* name and *text*. If " "``insert_pis`` is true, this will also add it to the tree." msgstr "" @@ -1143,6 +1150,21 @@ msgstr "" msgid "Feeds data to the parser. *data* is encoded data." msgstr "" +msgid "" +"Triggers parsing of any previously fed unparsed data, which can be used to " +"ensure more immediate feedback, in particular with Expat >=2.6.0. The " +"implementation of :meth:`flush` temporarily disables reparse deferral with " +"Expat (if currently enabled) and triggers a reparse. Disabling reparse " +"deferral has security consequences; please see :meth:`xml.parsers.expat." +"xmlparser.SetReparseDeferralEnabled` for details." +msgstr "" + +msgid "" +"Note that :meth:`flush` has been backported to some prior releases of " +"CPython as a security fix. Check for availability of :meth:`flush` using :" +"func:`hasattr` if used in code running across a variety of Python versions." +msgstr "" + msgid "" ":meth:`XMLParser.feed` calls *target*\\'s ``start(tag, attrs_dict)`` method " "for each opening tag, its ``end(tag)`` method for each closing tag, and data " diff --git a/library/xml.sax.handler.po b/library/xml.sax.handler.po new file mode 100644 index 0000000000..600a079845 --- /dev/null +++ b/library/xml.sax.handler.po @@ -0,0 +1,510 @@ +# 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:18+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:`xml.sax.handler` --- Base classes for SAX handlers" +msgstr "" + +msgid "**Source code:** :source:`Lib/xml/sax/handler.py`" +msgstr "" + +msgid "" +"The SAX API defines five kinds of handlers: content handlers, DTD handlers, " +"error handlers, entity resolvers and lexical handlers. Applications normally " +"only need to implement those interfaces whose events they are interested in; " +"they can implement the interfaces in a single object or in multiple objects. " +"Handler implementations should inherit from the base classes provided in the " +"module :mod:`xml.sax.handler`, so that all methods get default " +"implementations." +msgstr "" + +msgid "" +"This is the main callback interface in SAX, and the one most important to " +"applications. The order of events in this interface mirrors the order of the " +"information in the document." +msgstr "" + +msgid "Handle DTD events." +msgstr "" + +msgid "" +"This interface specifies only those DTD events required for basic parsing " +"(unparsed entities and attributes)." +msgstr "" + +msgid "" +"Basic interface for resolving entities. If you create an object implementing " +"this interface, then register the object with your Parser, the parser will " +"call the method in your object to resolve all external entities." +msgstr "" + +msgid "" +"Interface used by the parser to present error and warning messages to the " +"application. The methods of this object control whether errors are " +"immediately converted to exceptions or are handled in some other way." +msgstr "" + +msgid "" +"Interface used by the parser to represent low frequency events which may not " +"be of interest to many applications." +msgstr "" + +msgid "" +"In addition to these classes, :mod:`xml.sax.handler` provides symbolic " +"constants for the feature and property names." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/features/namespaces\"``" +msgstr "" + +msgid "true: Perform Namespace processing." +msgstr "" + +msgid "" +"false: Optionally do not perform Namespace processing (implies namespace-" +"prefixes; default)." +msgstr "" + +msgid "access: (parsing) read-only; (not parsing) read/write" +msgstr "" + +msgid "value: ``\"http://xml.org/sax/features/namespace-prefixes\"``" +msgstr "" + +msgid "" +"true: Report the original prefixed names and attributes used for Namespace " +"declarations." +msgstr "" + +msgid "" +"false: Do not report attributes used for Namespace declarations, and " +"optionally do not report original prefixed names (default)." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/features/string-interning\"``" +msgstr "" + +msgid "" +"true: All element names, prefixes, attribute names, Namespace URIs, and " +"local names are interned using the built-in intern function." +msgstr "" + +msgid "" +"false: Names are not necessarily interned, although they may be (default)." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/features/validation\"``" +msgstr "" + +msgid "" +"true: Report all validation errors (implies external-general-entities and " +"external-parameter-entities)." +msgstr "" + +msgid "false: Do not report validation errors." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/features/external-general-entities\"``" +msgstr "" + +msgid "true: Include all external general (text) entities." +msgstr "" + +msgid "false: Do not include external general entities." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/features/external-parameter-entities\"``" +msgstr "" + +msgid "" +"true: Include all external parameter entities, including the external DTD " +"subset." +msgstr "" + +msgid "" +"false: Do not include any external parameter entities, even the external DTD " +"subset." +msgstr "" + +msgid "List of all features." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/properties/lexical-handler\"``" +msgstr "" + +msgid "data type: xml.sax.handler.LexicalHandler (not supported in Python 2)" +msgstr "" + +msgid "" +"description: An optional extension handler for lexical events like comments." +msgstr "" + +msgid "access: read/write" +msgstr "" + +msgid "value: ``\"http://xml.org/sax/properties/declaration-handler\"``" +msgstr "" + +msgid "data type: xml.sax.sax2lib.DeclHandler (not supported in Python 2)" +msgstr "" + +msgid "" +"description: An optional extension handler for DTD-related events other than " +"notations and unparsed entities." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/properties/dom-node\"``" +msgstr "" + +msgid "data type: org.w3c.dom.Node (not supported in Python 2)" +msgstr "" + +msgid "" +"description: When parsing, the current DOM node being visited if this is a " +"DOM iterator; when not parsing, the root DOM node for iteration." +msgstr "" + +msgid "value: ``\"http://xml.org/sax/properties/xml-string\"``" +msgstr "" + +msgid "data type: Bytes" +msgstr "" + +msgid "" +"description: The literal string of characters that was the source for the " +"current event." +msgstr "" + +msgid "access: read-only" +msgstr "" + +msgid "List of all known property names." +msgstr "" + +msgid "ContentHandler Objects" +msgstr "" + +msgid "" +"Users are expected to subclass :class:`ContentHandler` to support their " +"application. The following methods are called by the parser on the " +"appropriate events in the input document:" +msgstr "" + +msgid "" +"Called by the parser to give the application a locator for locating the " +"origin of document events." +msgstr "" + +msgid "" +"SAX parsers are strongly encouraged (though not absolutely required) to " +"supply a locator: if it does so, it must supply the locator to the " +"application by invoking this method before invoking any of the other methods " +"in the DocumentHandler interface." +msgstr "" + +msgid "" +"The locator allows the application to determine the end position of any " +"document-related event, even if the parser is not reporting an error. " +"Typically, the application will use this information for reporting its own " +"errors (such as character content that does not match an application's " +"business rules). The information returned by the locator is probably not " +"sufficient for use with a search engine." +msgstr "" + +msgid "" +"Note that the locator will return correct information only during the " +"invocation of the events in this interface. The application should not " +"attempt to use it at any other time." +msgstr "" + +msgid "Receive notification of the beginning of a document." +msgstr "" + +msgid "" +"The SAX parser will invoke this method only once, before any other methods " +"in this interface or in DTDHandler (except for :meth:`setDocumentLocator`)." +msgstr "" + +msgid "Receive notification of the end of a document." +msgstr "" + +msgid "" +"The SAX parser will invoke this method only once, and it will be the last " +"method invoked during the parse. The parser shall not invoke this method " +"until it has either abandoned parsing (because of an unrecoverable error) or " +"reached the end of input." +msgstr "" + +msgid "Begin the scope of a prefix-URI Namespace mapping." +msgstr "" + +msgid "" +"The information from this event is not necessary for normal Namespace " +"processing: the SAX XML reader will automatically replace prefixes for " +"element and attribute names when the ``feature_namespaces`` feature is " +"enabled (the default)." +msgstr "" + +msgid "" +"There are cases, however, when applications need to use prefixes in " +"character data or in attribute values, where they cannot safely be expanded " +"automatically; the :meth:`startPrefixMapping` and :meth:`endPrefixMapping` " +"events supply the information to the application to expand prefixes in those " +"contexts itself, if necessary." +msgstr "" + +msgid "" +"Note that :meth:`startPrefixMapping` and :meth:`endPrefixMapping` events are " +"not guaranteed to be properly nested relative to each-other: all :meth:" +"`startPrefixMapping` events will occur before the corresponding :meth:" +"`startElement` event, and all :meth:`endPrefixMapping` events will occur " +"after the corresponding :meth:`endElement` event, but their order is not " +"guaranteed." +msgstr "" + +msgid "End the scope of a prefix-URI mapping." +msgstr "" + +msgid "" +"See :meth:`startPrefixMapping` for details. This event will always occur " +"after the corresponding :meth:`endElement` event, but the order of :meth:" +"`endPrefixMapping` events is not otherwise guaranteed." +msgstr "" + +msgid "Signals the start of an element in non-namespace mode." +msgstr "" + +msgid "" +"The *name* parameter contains the raw XML 1.0 name of the element type as a " +"string and the *attrs* parameter holds an object of the :class:`~xml.sax." +"xmlreader.Attributes` interface (see :ref:`attributes-objects`) containing " +"the attributes of the element. The object passed as *attrs* may be re-used " +"by the parser; holding on to a reference to it is not a reliable way to keep " +"a copy of the attributes. To keep a copy of the attributes, use the :meth:" +"`copy` method of the *attrs* object." +msgstr "" + +msgid "Signals the end of an element in non-namespace mode." +msgstr "" + +msgid "" +"The *name* parameter contains the name of the element type, just as with " +"the :meth:`startElement` event." +msgstr "" + +msgid "Signals the start of an element in namespace mode." +msgstr "" + +msgid "" +"The *name* parameter contains the name of the element type as a ``(uri, " +"localname)`` tuple, the *qname* parameter contains the raw XML 1.0 name used " +"in the source document, and the *attrs* parameter holds an instance of the :" +"class:`~xml.sax.xmlreader.AttributesNS` interface (see :ref:`attributes-ns-" +"objects`) containing the attributes of the element. If no namespace is " +"associated with the element, the *uri* component of *name* will be " +"``None``. The object passed as *attrs* may be re-used by the parser; " +"holding on to a reference to it is not a reliable way to keep a copy of the " +"attributes. To keep a copy of the attributes, use the :meth:`copy` method " +"of the *attrs* object." +msgstr "" + +msgid "" +"Parsers may set the *qname* parameter to ``None``, unless the " +"``feature_namespace_prefixes`` feature is activated." +msgstr "" + +msgid "Signals the end of an element in namespace mode." +msgstr "" + +msgid "" +"The *name* parameter contains the name of the element type, just as with " +"the :meth:`startElementNS` method, likewise the *qname* parameter." +msgstr "" + +msgid "Receive notification of character data." +msgstr "" + +msgid "" +"The Parser will call this method to report each chunk of character data. SAX " +"parsers may return all contiguous character data in a single chunk, or they " +"may split it into several chunks; however, all of the characters in any " +"single event must come from the same external entity so that the Locator " +"provides useful information." +msgstr "" + +msgid "" +"*content* may be a string or bytes instance; the ``expat`` reader module " +"always produces strings." +msgstr "" + +msgid "" +"The earlier SAX 1 interface provided by the Python XML Special Interest " +"Group used a more Java-like interface for this method. Since most parsers " +"used from Python did not take advantage of the older interface, the simpler " +"signature was chosen to replace it. To convert old code to the new " +"interface, use *content* instead of slicing content with the old *offset* " +"and *length* parameters." +msgstr "" + +msgid "Receive notification of ignorable whitespace in element content." +msgstr "" + +msgid "" +"Validating Parsers must use this method to report each chunk of ignorable " +"whitespace (see the W3C XML 1.0 recommendation, section 2.10): non-" +"validating parsers may also use this method if they are capable of parsing " +"and using content models." +msgstr "" + +msgid "" +"SAX parsers may return all contiguous whitespace in a single chunk, or they " +"may split it into several chunks; however, all of the characters in any " +"single event must come from the same external entity, so that the Locator " +"provides useful information." +msgstr "" + +msgid "Receive notification of a processing instruction." +msgstr "" + +msgid "" +"The Parser will invoke this method once for each processing instruction " +"found: note that processing instructions may occur before or after the main " +"document element." +msgstr "" + +msgid "" +"A SAX parser should never report an XML declaration (XML 1.0, section 2.8) " +"or a text declaration (XML 1.0, section 4.3.1) using this method." +msgstr "" + +msgid "Receive notification of a skipped entity." +msgstr "" + +msgid "" +"The Parser will invoke this method once for each entity skipped. Non-" +"validating processors may skip entities if they have not seen the " +"declarations (because, for example, the entity was declared in an external " +"DTD subset). All processors may skip external entities, depending on the " +"values of the ``feature_external_ges`` and the ``feature_external_pes`` " +"properties." +msgstr "" + +msgid "DTDHandler Objects" +msgstr "" + +msgid ":class:`DTDHandler` instances provide the following methods:" +msgstr "" + +msgid "Handle a notation declaration event." +msgstr "" + +msgid "Handle an unparsed entity declaration event." +msgstr "" + +msgid "EntityResolver Objects" +msgstr "" + +msgid "" +"Resolve the system identifier of an entity and return either the system " +"identifier to read from as a string, or an InputSource to read from. The " +"default implementation returns *systemId*." +msgstr "" + +msgid "ErrorHandler Objects" +msgstr "" + +msgid "" +"Objects with this interface are used to receive error and warning " +"information from the :class:`~xml.sax.xmlreader.XMLReader`. If you create " +"an object that implements this interface, then register the object with " +"your :class:`~xml.sax.xmlreader.XMLReader`, the parser will call the methods " +"in your object to report all warnings and errors. There are three levels of " +"errors available: warnings, (possibly) recoverable errors, and unrecoverable " +"errors. All methods take a :exc:`SAXParseException` as the only parameter. " +"Errors and warnings may be converted to an exception by raising the passed-" +"in exception object." +msgstr "" + +msgid "" +"Called when the parser encounters a recoverable error. If this method does " +"not raise an exception, parsing may continue, but further document " +"information should not be expected by the application. Allowing the parser " +"to continue may allow additional errors to be discovered in the input " +"document." +msgstr "" + +msgid "" +"Called when the parser encounters an error it cannot recover from; parsing " +"is expected to terminate when this method returns." +msgstr "" + +msgid "" +"Called when the parser presents minor warning information to the " +"application. Parsing is expected to continue when this method returns, and " +"document information will continue to be passed to the application. Raising " +"an exception in this method will cause parsing to end." +msgstr "" + +msgid "LexicalHandler Objects" +msgstr "" + +msgid "Optional SAX2 handler for lexical events." +msgstr "" + +msgid "" +"This handler is used to obtain lexical information about an XML document. " +"Lexical information includes information describing the document encoding " +"used and XML comments embedded in the document, as well as section " +"boundaries for the DTD and for any CDATA sections. The lexical handlers are " +"used in the same manner as content handlers." +msgstr "" + +msgid "" +"Set the LexicalHandler of an XMLReader by using the setProperty method with " +"the property identifier ``'http://xml.org/sax/properties/lexical-handler'``." +msgstr "" + +msgid "" +"Reports a comment anywhere in the document (including the DTD and outside " +"the document element)." +msgstr "" + +msgid "" +"Reports the start of the DTD declarations if the document has an associated " +"DTD." +msgstr "" + +msgid "Reports the end of DTD declaration." +msgstr "" + +msgid "Reports the start of a CDATA marked section." +msgstr "" + +msgid "" +"The contents of the CDATA marked section will be reported through the " +"characters handler." +msgstr "" + +msgid "Reports the end of a CDATA marked section." +msgstr "" diff --git a/library/xml.sax.po b/library/xml.sax.po new file mode 100644 index 0000000000..5c436c9aac --- /dev/null +++ b/library/xml.sax.po @@ -0,0 +1,199 @@ +# 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:18+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:`xml.sax` --- Support for SAX2 parsers" +msgstr "" + +msgid "**Source code:** :source:`Lib/xml/sax/__init__.py`" +msgstr "" + +msgid "" +"The :mod:`xml.sax` package provides a number of modules which implement the " +"Simple API for XML (SAX) interface for Python. The package itself provides " +"the SAX exceptions and the convenience functions which will be most used by " +"users of the SAX API." +msgstr "" + +msgid "" +"The :mod:`xml.sax` module is not secure against maliciously constructed " +"data. If you need to parse untrusted or unauthenticated data see :ref:`xml-" +"vulnerabilities`." +msgstr "" + +msgid "" +"The SAX parser no longer processes general external entities by default to " +"increase security. Before, the parser created network connections to fetch " +"remote files or loaded local files from the file system for DTD and " +"entities. The feature can be enabled again with method :meth:`~xml.sax." +"xmlreader.XMLReader.setFeature` on the parser object and argument :data:" +"`~xml.sax.handler.feature_external_ges`." +msgstr "" + +msgid "The convenience functions are:" +msgstr "" + +msgid "" +"Create and return a SAX :class:`~xml.sax.xmlreader.XMLReader` object. The " +"first parser found will be used. If *parser_list* is provided, it must be " +"an iterable of strings which name modules that have a function named :func:" +"`create_parser`. Modules listed in *parser_list* will be used before " +"modules in the default list of parsers." +msgstr "" + +msgid "The *parser_list* argument can be any iterable, not just a list." +msgstr "" + +msgid "" +"Create a SAX parser and use it to parse a document. The document, passed in " +"as *filename_or_stream*, can be a filename or a file object. The *handler* " +"parameter needs to be a SAX :class:`~handler.ContentHandler` instance. If " +"*error_handler* is given, it must be a SAX :class:`~handler.ErrorHandler` " +"instance; if omitted, :exc:`SAXParseException` will be raised on all " +"errors. There is no return value; all work must be done by the *handler* " +"passed in." +msgstr "" + +msgid "" +"Similar to :func:`parse`, but parses from a buffer *string* received as a " +"parameter. *string* must be a :class:`str` instance or a :term:`bytes-like " +"object`." +msgstr "" + +msgid "Added support of :class:`str` instances." +msgstr "" + +msgid "" +"A typical SAX application uses three kinds of objects: readers, handlers and " +"input sources. \"Reader\" in this context is another term for parser, i.e. " +"some piece of code that reads the bytes or characters from the input source, " +"and produces a sequence of events. The events then get distributed to the " +"handler objects, i.e. the reader invokes a method on the handler. A SAX " +"application must therefore obtain a reader object, create or open the input " +"sources, create the handlers, and connect these objects all together. As " +"the final step of preparation, the reader is called to parse the input. " +"During parsing, methods on the handler objects are called based on " +"structural and syntactic events from the input data." +msgstr "" + +msgid "" +"For these objects, only the interfaces are relevant; they are normally not " +"instantiated by the application itself. Since Python does not have an " +"explicit notion of interface, they are formally introduced as classes, but " +"applications may use implementations which do not inherit from the provided " +"classes. The :class:`~xml.sax.xmlreader.InputSource`, :class:`~xml.sax." +"xmlreader.Locator`, :class:`~xml.sax.xmlreader.Attributes`, :class:`~xml.sax." +"xmlreader.AttributesNS`, and :class:`~xml.sax.xmlreader.XMLReader` " +"interfaces are defined in the module :mod:`xml.sax.xmlreader`. The handler " +"interfaces are defined in :mod:`xml.sax.handler`. For convenience, :class:" +"`~xml.sax.xmlreader.InputSource` (which is often instantiated directly) and " +"the handler classes are also available from :mod:`xml.sax`. These " +"interfaces are described below." +msgstr "" + +msgid "" +"In addition to these classes, :mod:`xml.sax` provides the following " +"exception classes." +msgstr "" + +msgid "" +"Encapsulate an XML error or warning. This class can contain basic error or " +"warning information from either the XML parser or the application: it can be " +"subclassed to provide additional functionality or to add localization. Note " +"that although the handlers defined in the :class:`~xml.sax.handler." +"ErrorHandler` interface receive instances of this exception, it is not " +"required to actually raise the exception --- it is also useful as a " +"container for information." +msgstr "" + +msgid "" +"When instantiated, *msg* should be a human-readable description of the " +"error. The optional *exception* parameter, if given, should be ``None`` or " +"an exception that was caught by the parsing code and is being passed along " +"as information." +msgstr "" + +msgid "This is the base class for the other SAX exception classes." +msgstr "" + +msgid "" +"Subclass of :exc:`SAXException` raised on parse errors. Instances of this " +"class are passed to the methods of the SAX :class:`~xml.sax.handler." +"ErrorHandler` interface to provide information about the parse error. This " +"class supports the SAX :class:`~xml.sax.xmlreader.Locator` interface as well " +"as the :class:`SAXException` interface." +msgstr "" + +msgid "" +"Subclass of :exc:`SAXException` raised when a SAX :class:`~xml.sax.xmlreader." +"XMLReader` is confronted with an unrecognized feature or property. SAX " +"applications and extensions may use this class for similar purposes." +msgstr "" + +msgid "" +"Subclass of :exc:`SAXException` raised when a SAX :class:`~xml.sax.xmlreader." +"XMLReader` is asked to enable a feature that is not supported, or to set a " +"property to a value that the implementation does not support. SAX " +"applications and extensions may use this class for similar purposes." +msgstr "" + +msgid "`SAX: The Simple API for XML `_" +msgstr "" + +msgid "" +"This site is the focal point for the definition of the SAX API. It provides " +"a Java implementation and online documentation. Links to implementations " +"and historical information are also available." +msgstr "" + +msgid "Module :mod:`xml.sax.handler`" +msgstr "" + +msgid "Definitions of the interfaces for application-provided objects." +msgstr "" + +msgid "Module :mod:`xml.sax.saxutils`" +msgstr "" + +msgid "Convenience functions for use in SAX applications." +msgstr "" + +msgid "Module :mod:`xml.sax.xmlreader`" +msgstr "" + +msgid "Definitions of the interfaces for parser-provided objects." +msgstr "" + +msgid "SAXException Objects" +msgstr "" + +msgid "" +"The :class:`SAXException` exception class supports the following methods:" +msgstr "" + +msgid "Return a human-readable message describing the error condition." +msgstr "" + +msgid "Return an encapsulated exception object, or ``None``." +msgstr "" diff --git a/library/xml.sax.reader.po b/library/xml.sax.reader.po new file mode 100644 index 0000000000..bfa7a92381 --- /dev/null +++ b/library/xml.sax.reader.po @@ -0,0 +1,359 @@ +# 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:18+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:`xml.sax.xmlreader` --- Interface for XML parsers" +msgstr "" + +msgid "**Source code:** :source:`Lib/xml/sax/xmlreader.py`" +msgstr "" + +msgid "" +"SAX parsers implement the :class:`XMLReader` interface. They are implemented " +"in a Python module, which must provide a function :func:`create_parser`. " +"This function is invoked by :func:`xml.sax.make_parser` with no arguments " +"to create a new parser object." +msgstr "" + +msgid "Base class which can be inherited by SAX parsers." +msgstr "" + +msgid "" +"In some cases, it is desirable not to parse an input source at once, but to " +"feed chunks of the document as they get available. Note that the reader will " +"normally not read the entire file, but read it in chunks as well; still :" +"meth:`parse` won't return until the entire document is processed. So these " +"interfaces should be used if the blocking behaviour of :meth:`parse` is not " +"desirable." +msgstr "" + +msgid "" +"When the parser is instantiated it is ready to begin accepting data from the " +"feed method immediately. After parsing has been finished with a call to " +"close the reset method must be called to make the parser ready to accept new " +"data, either from feed or using the parse method." +msgstr "" + +msgid "" +"Note that these methods must *not* be called during parsing, that is, after " +"parse has been called and before it returns." +msgstr "" + +msgid "" +"By default, the class also implements the parse method of the XMLReader " +"interface using the feed, close and reset methods of the IncrementalParser " +"interface as a convenience to SAX 2.0 driver writers." +msgstr "" + +msgid "" +"Interface for associating a SAX event with a document location. A locator " +"object will return valid results only during calls to DocumentHandler " +"methods; at any other time, the results are unpredictable. If information is " +"not available, methods may return ``None``." +msgstr "" + +msgid "" +"Encapsulation of the information needed by the :class:`XMLReader` to read " +"entities." +msgstr "" + +msgid "" +"This class may include information about the public identifier, system " +"identifier, byte stream (possibly with character encoding information) and/" +"or the character stream of an entity." +msgstr "" + +msgid "" +"Applications will create objects of this class for use in the :meth:" +"`XMLReader.parse` method and for returning from EntityResolver.resolveEntity." +msgstr "" + +msgid "" +"An :class:`InputSource` belongs to the application, the :class:`XMLReader` " +"is not allowed to modify :class:`InputSource` objects passed to it from the " +"application, although it may make copies and modify those." +msgstr "" + +msgid "" +"This is an implementation of the :class:`Attributes` interface (see section :" +"ref:`attributes-objects`). This is a dictionary-like object which " +"represents the element attributes in a :meth:`startElement` call. In " +"addition to the most useful dictionary operations, it supports a number of " +"other methods as described by the interface. Objects of this class should be " +"instantiated by readers; *attrs* must be a dictionary-like object containing " +"a mapping from attribute names to attribute values." +msgstr "" + +msgid "" +"Namespace-aware variant of :class:`AttributesImpl`, which will be passed to :" +"meth:`startElementNS`. It is derived from :class:`AttributesImpl`, but " +"understands attribute names as two-tuples of *namespaceURI* and *localname*. " +"In addition, it provides a number of methods expecting qualified names as " +"they appear in the original document. This class implements the :class:" +"`AttributesNS` interface (see section :ref:`attributes-ns-objects`)." +msgstr "" + +msgid "XMLReader Objects" +msgstr "" + +msgid "The :class:`XMLReader` interface supports the following methods:" +msgstr "" + +msgid "" +"Process an input source, producing SAX events. The *source* object can be a " +"system identifier (a string identifying the input source -- typically a file " +"name or a URL), a :class:`pathlib.Path` or :term:`path-like ` object, or an :class:`InputSource` object. When :meth:`parse` " +"returns, the input is completely processed, and the parser object can be " +"discarded or reset." +msgstr "" + +msgid "Added support of character streams." +msgstr "" + +msgid "Added support of path-like objects." +msgstr "" + +msgid "Return the current :class:`~xml.sax.handler.ContentHandler`." +msgstr "" + +msgid "" +"Set the current :class:`~xml.sax.handler.ContentHandler`. If no :class:" +"`~xml.sax.handler.ContentHandler` is set, content events will be discarded." +msgstr "" + +msgid "Return the current :class:`~xml.sax.handler.DTDHandler`." +msgstr "" + +msgid "" +"Set the current :class:`~xml.sax.handler.DTDHandler`. If no :class:`~xml." +"sax.handler.DTDHandler` is set, DTD events will be discarded." +msgstr "" + +msgid "Return the current :class:`~xml.sax.handler.EntityResolver`." +msgstr "" + +msgid "" +"Set the current :class:`~xml.sax.handler.EntityResolver`. If no :class:" +"`~xml.sax.handler.EntityResolver` is set, attempts to resolve an external " +"entity will result in opening the system identifier for the entity, and fail " +"if it is not available." +msgstr "" + +msgid "Return the current :class:`~xml.sax.handler.ErrorHandler`." +msgstr "" + +msgid "" +"Set the current error handler. If no :class:`~xml.sax.handler.ErrorHandler` " +"is set, errors will be raised as exceptions, and warnings will be printed." +msgstr "" + +msgid "Allow an application to set the locale for errors and warnings." +msgstr "" + +msgid "" +"SAX parsers are not required to provide localization for errors and " +"warnings; if they cannot support the requested locale, however, they must " +"raise a SAX exception. Applications may request a locale change in the " +"middle of a parse." +msgstr "" + +msgid "" +"Return the current setting for feature *featurename*. If the feature is not " +"recognized, :exc:`SAXNotRecognizedException` is raised. The well-known " +"featurenames are listed in the module :mod:`xml.sax.handler`." +msgstr "" + +msgid "" +"Set the *featurename* to *value*. If the feature is not recognized, :exc:" +"`SAXNotRecognizedException` is raised. If the feature or its setting is not " +"supported by the parser, *SAXNotSupportedException* is raised." +msgstr "" + +msgid "" +"Return the current setting for property *propertyname*. If the property is " +"not recognized, a :exc:`SAXNotRecognizedException` is raised. The well-known " +"propertynames are listed in the module :mod:`xml.sax.handler`." +msgstr "" + +msgid "" +"Set the *propertyname* to *value*. If the property is not recognized, :exc:" +"`SAXNotRecognizedException` is raised. If the property or its setting is not " +"supported by the parser, *SAXNotSupportedException* is raised." +msgstr "" + +msgid "IncrementalParser Objects" +msgstr "" + +msgid "" +"Instances of :class:`IncrementalParser` offer the following additional " +"methods:" +msgstr "" + +msgid "Process a chunk of *data*." +msgstr "" + +msgid "" +"Assume the end of the document. That will check well-formedness conditions " +"that can be checked only at the end, invoke handlers, and may clean up " +"resources allocated during parsing." +msgstr "" + +msgid "" +"This method is called after close has been called to reset the parser so " +"that it is ready to parse new documents. The results of calling parse or " +"feed after close without calling reset are undefined." +msgstr "" + +msgid "Locator Objects" +msgstr "" + +msgid "Instances of :class:`Locator` provide these methods:" +msgstr "" + +msgid "Return the column number where the current event begins." +msgstr "" + +msgid "Return the line number where the current event begins." +msgstr "" + +msgid "Return the public identifier for the current event." +msgstr "" + +msgid "Return the system identifier for the current event." +msgstr "" + +msgid "InputSource Objects" +msgstr "" + +msgid "Sets the public identifier of this :class:`InputSource`." +msgstr "" + +msgid "Returns the public identifier of this :class:`InputSource`." +msgstr "" + +msgid "Sets the system identifier of this :class:`InputSource`." +msgstr "" + +msgid "Returns the system identifier of this :class:`InputSource`." +msgstr "" + +msgid "Sets the character encoding of this :class:`InputSource`." +msgstr "" + +msgid "" +"The encoding must be a string acceptable for an XML encoding declaration " +"(see section 4.3.3 of the XML recommendation)." +msgstr "" + +msgid "" +"The encoding attribute of the :class:`InputSource` is ignored if the :class:" +"`InputSource` also contains a character stream." +msgstr "" + +msgid "Get the character encoding of this InputSource." +msgstr "" + +msgid "Set the byte stream (a :term:`binary file`) for this input source." +msgstr "" + +msgid "" +"The SAX parser will ignore this if there is also a character stream " +"specified, but it will use a byte stream in preference to opening a URI " +"connection itself." +msgstr "" + +msgid "" +"If the application knows the character encoding of the byte stream, it " +"should set it with the setEncoding method." +msgstr "" + +msgid "Get the byte stream for this input source." +msgstr "" + +msgid "" +"The getEncoding method will return the character encoding for this byte " +"stream, or ``None`` if unknown." +msgstr "" + +msgid "Set the character stream (a :term:`text file`) for this input source." +msgstr "" + +msgid "" +"If there is a character stream specified, the SAX parser will ignore any " +"byte stream and will not attempt to open a URI connection to the system " +"identifier." +msgstr "" + +msgid "Get the character stream for this input source." +msgstr "" + +msgid "The :class:`Attributes` Interface" +msgstr "" + +msgid "" +":class:`Attributes` objects implement a portion of the :term:`mapping " +"protocol `, including the methods :meth:`~collections.abc.Mapping." +"copy`, :meth:`~collections.abc.Mapping.get`, :meth:`~object.__contains__`, :" +"meth:`~collections.abc.Mapping.items`, :meth:`~collections.abc.Mapping." +"keys`, and :meth:`~collections.abc.Mapping.values`. The following methods " +"are also provided:" +msgstr "" + +msgid "Return the number of attributes." +msgstr "" + +msgid "Return the names of the attributes." +msgstr "" + +msgid "" +"Returns the type of the attribute *name*, which is normally ``'CDATA'``." +msgstr "" + +msgid "Return the value of attribute *name*." +msgstr "" + +msgid "The :class:`AttributesNS` Interface" +msgstr "" + +msgid "" +"This interface is a subtype of the :class:`Attributes` interface (see " +"section :ref:`attributes-objects`). All methods supported by that interface " +"are also available on :class:`AttributesNS` objects." +msgstr "" + +msgid "The following methods are also available:" +msgstr "" + +msgid "Return the value for a qualified name." +msgstr "" + +msgid "Return the ``(namespace, localname)`` pair for a qualified *name*." +msgstr "" + +msgid "Return the qualified name for a ``(namespace, localname)`` pair." +msgstr "" + +msgid "Return the qualified names of all attributes." +msgstr "" diff --git a/library/xml.sax.utils.po b/library/xml.sax.utils.po new file mode 100644 index 0000000000..12d6e2a928 --- /dev/null +++ b/library/xml.sax.utils.po @@ -0,0 +1,105 @@ +# 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:18+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:`xml.sax.saxutils` --- SAX Utilities" +msgstr "" + +msgid "**Source code:** :source:`Lib/xml/sax/saxutils.py`" +msgstr "" + +msgid "" +"The module :mod:`xml.sax.saxutils` contains a number of classes and " +"functions that are commonly useful when creating SAX applications, either in " +"direct use, or as base classes." +msgstr "" + +msgid "Escape ``'&'``, ``'<'``, and ``'>'`` in a string of data." +msgstr "" + +msgid "" +"You can escape other strings of data by passing a dictionary as the optional " +"*entities* parameter. The keys and values must all be strings; each key " +"will be replaced with its corresponding value. The characters ``'&'``, " +"``'<'`` and ``'>'`` are always escaped, even if *entities* is provided." +msgstr "" + +msgid "Unescape ``'&'``, ``'<'``, and ``'>'`` in a string of data." +msgstr "" + +msgid "" +"You can unescape other strings of data by passing a dictionary as the " +"optional *entities* parameter. The keys and values must all be strings; " +"each key will be replaced with its corresponding value. ``'&'``, " +"``'<'``, and ``'>'`` are always unescaped, even if *entities* is " +"provided." +msgstr "" + +msgid "" +"Similar to :func:`escape`, but also prepares *data* to be used as an " +"attribute value. The return value is a quoted version of *data* with any " +"additional required replacements. :func:`quoteattr` will select a quote " +"character based on the content of *data*, attempting to avoid encoding any " +"quote characters in the string. If both single- and double-quote characters " +"are already in *data*, the double-quote characters will be encoded and " +"*data* will be wrapped in double-quotes. The resulting string can be used " +"directly as an attribute value::" +msgstr "" + +msgid "" +"This function is useful when generating attribute values for HTML or any " +"SGML using the reference concrete syntax." +msgstr "" + +msgid "" +"This class implements the :class:`~xml.sax.handler.ContentHandler` interface " +"by writing SAX events back into an XML document. In other words, using an :" +"class:`XMLGenerator` as the content handler will reproduce the original " +"document being parsed. *out* should be a file-like object which will default " +"to *sys.stdout*. *encoding* is the encoding of the output stream which " +"defaults to ``'iso-8859-1'``. *short_empty_elements* controls the formatting " +"of elements that contain no content: if ``False`` (the default) they are " +"emitted as a pair of start/end tags, if set to ``True`` they are emitted as " +"a single self-closed tag." +msgstr "" + +msgid "The *short_empty_elements* parameter." +msgstr "" + +msgid "" +"This class is designed to sit between an :class:`~xml.sax.xmlreader." +"XMLReader` and the client application's event handlers. By default, it does " +"nothing but pass requests up to the reader and events on to the handlers " +"unmodified, but subclasses can override specific methods to modify the event " +"stream or the configuration requests as they pass through." +msgstr "" + +msgid "" +"This function takes an input source and an optional base URL and returns a " +"fully resolved :class:`~xml.sax.xmlreader.InputSource` object ready for " +"reading. The input source can be given as a string, a file-like object, or " +"an :class:`~xml.sax.xmlreader.InputSource` object; parsers will use this " +"function to implement the polymorphic *source* argument to their :meth:" +"`parse` method." +msgstr "" diff --git a/library/xmlrpc_client.po b/library/xmlrpc.client.po similarity index 96% rename from library/xmlrpc_client.po rename to library/xmlrpc.client.po index 8985076453..131c190407 100644 --- a/library/xmlrpc_client.po +++ b/library/xmlrpc.client.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:18+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -125,10 +125,10 @@ msgid "Python type" msgstr "" msgid "``boolean``" -msgstr "" +msgstr "``boolean``" msgid ":class:`bool`" -msgstr "" +msgstr ":class:`bool`" msgid "``int``, ``i1``, ``i2``, ``i4``, ``i8`` or ``biginteger``" msgstr "" @@ -139,19 +139,19 @@ msgid "" msgstr "" msgid "``double`` or ``float``" -msgstr "" +msgstr "``double`` or ``float``" msgid ":class:`float`. Values get the ```` tag." msgstr "" msgid "``string``" -msgstr "" +msgstr "``string``" msgid ":class:`str`" -msgstr "" +msgstr ":class:`str`" msgid "``array``" -msgstr "" +msgstr "``array``" msgid "" ":class:`list` or :class:`tuple` containing conformable elements. Arrays are " @@ -159,7 +159,7 @@ msgid "" msgstr "" msgid "``struct``" -msgstr "" +msgstr "``struct``" msgid "" ":class:`dict`. Keys must be strings, values may be any conformable type. " @@ -168,7 +168,7 @@ msgid "" msgstr "" msgid "``dateTime.iso8601``" -msgstr "" +msgstr "``dateTime.iso8601``" msgid "" ":class:`DateTime` or :class:`datetime.datetime`. Returned type depends on " @@ -176,7 +176,7 @@ msgid "" msgstr "" msgid "``base64``" -msgstr "" +msgstr "``base64``" msgid "" ":class:`Binary`, :class:`bytes` or :class:`bytearray`. Returned type " @@ -184,14 +184,14 @@ msgid "" msgstr "" msgid "``nil``" -msgstr "" +msgstr "``nil``" msgid "" "The ``None`` constant. Passing is allowed only if *allow_none* is true." msgstr "" msgid "``bigdecimal``" -msgstr "" +msgstr "``bigdecimal``" msgid ":class:`decimal.Decimal`. Returned type only." msgstr "" @@ -340,8 +340,8 @@ msgid "" msgstr "" msgid "" -"It also supports certain of Python's built-in operators through rich " -"comparison and :meth:`__repr__` methods." +"It also supports certain of Python's built-in operators through :meth:`rich " +"comparison ` and :meth:`~object.__repr__` methods." msgstr "" msgid "Binary Objects" @@ -381,7 +381,7 @@ msgstr "" msgid "" "It also supports certain of Python's built-in operators through :meth:" -"`__eq__` and :meth:`__ne__` methods." +"`~object.__eq__` and :meth:`~object.__ne__` methods." msgstr "" msgid "" diff --git a/library/xmlrpc.server.po b/library/xmlrpc.server.po new file mode 100644 index 0000000000..8c9e220b07 --- /dev/null +++ b/library/xmlrpc.server.po @@ -0,0 +1,301 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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:`xmlrpc.server` --- Basic XML-RPC servers" +msgstr "" + +msgid "**Source code:** :source:`Lib/xmlrpc/server.py`" +msgstr "" + +msgid "" +"The :mod:`xmlrpc.server` module provides a basic server framework for XML-" +"RPC servers written in Python. Servers can either be free standing, using :" +"class:`SimpleXMLRPCServer`, or embedded in a CGI environment, using :class:" +"`CGIXMLRPCRequestHandler`." +msgstr "" + +msgid "" +"The :mod:`xmlrpc.server` module is not secure against maliciously " +"constructed data. If you need to parse untrusted or unauthenticated data " +"see :ref:`xml-vulnerabilities`." +msgstr "" + +msgid ":ref:`Availability `: not Emscripten, not WASI." +msgstr "" + +msgid "" +"This module does not work or is not available on WebAssembly platforms " +"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for " +"more information." +msgstr "" + +msgid "" +"Create a new server instance. This class provides methods for registration " +"of functions that can be called by the XML-RPC protocol. The " +"*requestHandler* parameter should be a factory for request handler " +"instances; it defaults to :class:`SimpleXMLRPCRequestHandler`. The *addr* " +"and *requestHandler* parameters are passed to the :class:`socketserver." +"TCPServer` constructor. If *logRequests* is true (the default), requests " +"will be logged; setting this parameter to false will turn off logging. The " +"*allow_none* and *encoding* parameters are passed on to :mod:`xmlrpc.client` " +"and control the XML-RPC responses that will be returned from the server. The " +"*bind_and_activate* parameter controls whether :meth:`server_bind` and :meth:" +"`server_activate` are called immediately by the constructor; it defaults to " +"true. Setting it to false allows code to manipulate the " +"*allow_reuse_address* class variable before the address is bound. The " +"*use_builtin_types* parameter is passed to the :func:`~xmlrpc.client.loads` " +"function and controls which types are processed when date/times values or " +"binary data are received; it defaults to false." +msgstr "" + +msgid "The *use_builtin_types* flag was added." +msgstr "" + +msgid "" +"Create a new instance to handle XML-RPC requests in a CGI environment. The " +"*allow_none* and *encoding* parameters are passed on to :mod:`xmlrpc.client` " +"and control the XML-RPC responses that will be returned from the server. The " +"*use_builtin_types* parameter is passed to the :func:`~xmlrpc.client.loads` " +"function and controls which types are processed when date/times values or " +"binary data are received; it defaults to false." +msgstr "" + +msgid "" +"Create a new request handler instance. This request handler supports " +"``POST`` requests and modifies logging so that the *logRequests* parameter " +"to the :class:`SimpleXMLRPCServer` constructor parameter is honored." +msgstr "" + +msgid "SimpleXMLRPCServer Objects" +msgstr "" + +msgid "" +"The :class:`SimpleXMLRPCServer` class is based on :class:`socketserver." +"TCPServer` and provides a means of creating simple, stand alone XML-RPC " +"servers." +msgstr "" + +msgid "" +"Register a function that can respond to XML-RPC requests. If *name* is " +"given, it will be the method name associated with *function*, otherwise :" +"attr:`function.__name__` will be used. *name* is a string, and may contain " +"characters not legal in Python identifiers, including the period character." +msgstr "" + +msgid "" +"This method can also be used as a decorator. When used as a decorator, " +"*name* can only be given as a keyword argument to register *function* under " +"*name*. If no *name* is given, :attr:`function.__name__` will be used." +msgstr "" + +msgid ":meth:`register_function` can be used as a decorator." +msgstr "" + +msgid "" +"Register an object which is used to expose method names which have not been " +"registered using :meth:`register_function`. If *instance* contains a :meth:" +"`_dispatch` method, it is called with the requested method name and the " +"parameters from the request. Its API is ``def _dispatch(self, method, " +"params)`` (note that *params* does not represent a variable argument list). " +"If it calls an underlying function to perform its task, that function is " +"called as ``func(*params)``, expanding the parameter list. The return value " +"from :meth:`_dispatch` is returned to the client as the result. If " +"*instance* does not have a :meth:`_dispatch` method, it is searched for an " +"attribute matching the name of the requested method." +msgstr "" + +msgid "" +"If the optional *allow_dotted_names* argument is true and the instance does " +"not have a :meth:`_dispatch` method, then if the requested method name " +"contains periods, each component of the method name is searched for " +"individually, with the effect that a simple hierarchical search is " +"performed. The value found from this search is then called with the " +"parameters from the request, and the return value is passed back to the " +"client." +msgstr "" + +msgid "" +"Enabling the *allow_dotted_names* option allows intruders to access your " +"module's global variables and may allow intruders to execute arbitrary code " +"on your machine. Only use this option on a secure, closed network." +msgstr "" + +msgid "" +"Registers the XML-RPC introspection functions ``system.listMethods``, " +"``system.methodHelp`` and ``system.methodSignature``." +msgstr "" + +msgid "Registers the XML-RPC multicall function system.multicall." +msgstr "" + +msgid "" +"An attribute value that must be a tuple listing valid path portions of the " +"URL for receiving XML-RPC requests. Requests posted to other paths will " +"result in a 404 \"no such page\" HTTP error. If this tuple is empty, all " +"paths will be considered valid. The default value is ``('/', '/RPC2')``." +msgstr "" + +msgid "SimpleXMLRPCServer Example" +msgstr "" + +msgid "Server code::" +msgstr "" + +msgid "" +"The following client code will call the methods made available by the " +"preceding server::" +msgstr "" + +msgid "" +":meth:`register_function` can also be used as a decorator. The previous " +"server example can register functions in a decorator way::" +msgstr "" + +msgid "" +"The following example included in the :file:`Lib/xmlrpc/server.py` module " +"shows a server allowing dotted names and registering a multicall function." +msgstr "" + +msgid "" +"Enabling the *allow_dotted_names* option allows intruders to access your " +"module's global variables and may allow intruders to execute arbitrary code " +"on your machine. Only use this example only within a secure, closed network." +msgstr "" + +msgid "This ExampleService demo can be invoked from the command line::" +msgstr "" + +msgid "" +"The client that interacts with the above server is included in ``Lib/xmlrpc/" +"client.py``::" +msgstr "" + +msgid "" +"This client which interacts with the demo XMLRPC server can be invoked as::" +msgstr "" + +msgid "CGIXMLRPCRequestHandler" +msgstr "" + +msgid "" +"The :class:`CGIXMLRPCRequestHandler` class can be used to handle XML-RPC " +"requests sent to Python CGI scripts." +msgstr "" + +msgid "" +"Register an object which is used to expose method names which have not been " +"registered using :meth:`register_function`. If instance contains a :meth:" +"`_dispatch` method, it is called with the requested method name and the " +"parameters from the request; the return value is returned to the client as " +"the result. If instance does not have a :meth:`_dispatch` method, it is " +"searched for an attribute matching the name of the requested method; if the " +"requested method name contains periods, each component of the method name " +"is searched for individually, with the effect that a simple hierarchical " +"search is performed. The value found from this search is then called with " +"the parameters from the request, and the return value is passed back to " +"the client." +msgstr "" + +msgid "" +"Register the XML-RPC introspection functions ``system.listMethods``, " +"``system.methodHelp`` and ``system.methodSignature``." +msgstr "" + +msgid "Register the XML-RPC multicall function ``system.multicall``." +msgstr "" + +msgid "" +"Handle an XML-RPC request. If *request_text* is given, it should be the POST " +"data provided by the HTTP server, otherwise the contents of stdin will be " +"used." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "Documenting XMLRPC server" +msgstr "" + +msgid "" +"These classes extend the above classes to serve HTML documentation in " +"response to HTTP GET requests. Servers can either be free standing, using :" +"class:`DocXMLRPCServer`, or embedded in a CGI environment, using :class:" +"`DocCGIXMLRPCRequestHandler`." +msgstr "" + +msgid "" +"Create a new server instance. All parameters have the same meaning as for :" +"class:`SimpleXMLRPCServer`; *requestHandler* defaults to :class:" +"`DocXMLRPCRequestHandler`." +msgstr "" + +msgid "Create a new instance to handle XML-RPC requests in a CGI environment." +msgstr "" + +msgid "" +"Create a new request handler instance. This request handler supports XML-RPC " +"POST requests, documentation GET requests, and modifies logging so that the " +"*logRequests* parameter to the :class:`DocXMLRPCServer` constructor " +"parameter is honored." +msgstr "" + +msgid "DocXMLRPCServer Objects" +msgstr "" + +msgid "" +"The :class:`DocXMLRPCServer` class is derived from :class:" +"`SimpleXMLRPCServer` and provides a means of creating self-documenting, " +"stand alone XML-RPC servers. HTTP POST requests are handled as XML-RPC " +"method calls. HTTP GET requests are handled by generating pydoc-style HTML " +"documentation. This allows a server to provide its own web-based " +"documentation." +msgstr "" + +msgid "" +"Set the title used in the generated HTML documentation. This title will be " +"used inside the HTML \"title\" element." +msgstr "" + +msgid "" +"Set the name used in the generated HTML documentation. This name will appear " +"at the top of the generated documentation inside a \"h1\" element." +msgstr "" + +msgid "" +"Set the description used in the generated HTML documentation. This " +"description will appear as a paragraph, below the server name, in the " +"documentation." +msgstr "" + +msgid "DocCGIXMLRPCRequestHandler" +msgstr "" + +msgid "" +"The :class:`DocCGIXMLRPCRequestHandler` class is derived from :class:" +"`CGIXMLRPCRequestHandler` and provides a means of creating self-documenting, " +"XML-RPC CGI scripts. HTTP POST requests are handled as XML-RPC method calls. " +"HTTP GET requests are handled by generating pydoc-style HTML documentation. " +"This allows a server to provide its own web-based documentation." +msgstr "" diff --git a/library/zipapp.po b/library/zipapp.po index 2e4403cf90..5aab54def4 100644 --- a/library/zipapp.po +++ b/library/zipapp.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:18+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -204,7 +204,7 @@ msgid "" "ZipFile`` class, and must supply the methods needed by that class." msgstr "" -msgid "Added the *filter* and *compressed* arguments." +msgid "Added the *filter* and *compressed* parameters." msgstr "" msgid "" @@ -307,13 +307,6 @@ msgid "" "command line)." msgstr "" -msgid "" -"Optionally, delete the ``.dist-info`` directories created by pip in the " -"``myapp`` directory. These hold metadata for pip to manage the packages, and " -"as you won't be making any further use of pip they aren't required - " -"although it won't do any harm if you leave them." -msgstr "" - msgid "Package the application using:" msgstr "" diff --git a/library/zipfile.po b/library/zipfile.po index a1f77346d8..9c0ee6c258 100644 --- a/library/zipfile.po +++ b/library/zipfile.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:18+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -247,7 +246,7 @@ msgstr "" msgid "Add the *compresslevel* parameter." msgstr "" -msgid "The *strict_timestamps* keyword-only argument" +msgid "The *strict_timestamps* keyword-only parameter." msgstr "" msgid "" @@ -626,7 +625,7 @@ msgid "" "`ZipFile` constructor, and one additional parameter, *optimize*." msgstr "" -msgid "The *optimize* parameter." +msgid "Added the *optimize* parameter." msgstr "" msgid "" @@ -677,7 +676,7 @@ msgstr "" msgid "The :meth:`writepy` method makes archives with file names like this::" msgstr "" -msgid "The *filterfunc* parameter." +msgid "Added the *filterfunc* parameter." msgstr "" msgid "The *pathname* parameter accepts a :term:`path-like object`." @@ -717,6 +716,9 @@ msgstr "" msgid "The *filename* parameter accepts a :term:`path-like object`." msgstr "" +msgid "Added the *strict_timestamps* keyword-only parameter." +msgstr "" + msgid "Instances have the following methods and attributes:" msgstr "" @@ -741,37 +743,37 @@ msgid "Value" msgstr "Wartość" msgid "``0``" -msgstr "" +msgstr "``0``" msgid "Year (>= 1980)" msgstr "" msgid "``1``" -msgstr "" +msgstr "``1``" msgid "Month (one-based)" msgstr "" msgid "``2``" -msgstr "" +msgstr "``2``" msgid "Day of month (one-based)" msgstr "" msgid "``3``" -msgstr "" +msgstr "``3``" msgid "Hours (zero-based)" msgstr "" msgid "``4``" -msgstr "" +msgstr "``4``" msgid "Minutes (zero-based)" msgstr "" msgid "``5``" -msgstr "" +msgstr "``5``" msgid "Seconds (zero-based)" msgstr "" diff --git a/library/zipimport.po b/library/zipimport.po index a750f61d6e..a692df17ba 100644 --- a/library/zipimport.po +++ b/library/zipimport.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:18+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -148,8 +148,8 @@ msgid "" "wasn't found." msgstr "" -msgid ":exc:`IOError` used to be raised instead of :exc:`OSError`." -msgstr "" +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 "" "Return the value ``__file__`` would be set to if the specified module was " diff --git a/library/zoneinfo.po b/library/zoneinfo.po index 718a6a7004..74116840c4 100644 --- a/library/zoneinfo.po +++ b/library/zoneinfo.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:19+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/license.po b/license.po index 06980afd1f..c7b7509f24 100644 --- a/license.po +++ b/license.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -156,7 +156,7 @@ msgid "2.2 and above" msgstr "" msgid "2001-now" -msgstr "" +msgstr "2001-teraz" msgid "" "GPL-compatible doesn't mean that we're distributing Python under the GPL. " @@ -245,8 +245,8 @@ msgid "Sockets" msgstr "" msgid "" -"The :mod:`socket` module uses the functions, :func:`getaddrinfo`, and :func:" -"`getnameinfo`, which are coded in separate source files from the WIDE " +"The :mod:`socket` module uses the functions, :c:func:`!getaddrinfo`, and :c:" +"func:`!getnameinfo`, which are coded in separate source files from the WIDE " "Project, https://www.wide.ad.jp/. ::" msgstr "" @@ -283,9 +283,9 @@ msgid "The :mod:`xmlrpc.client` module contains the following notice::" msgstr "" msgid "test_epoll" -msgstr "" +msgstr "test_epoll" -msgid "The :mod:`test_epoll` module contains the following notice::" +msgid "The :mod:`!test.test_epoll` module contains the following notice::" msgstr "" msgid "Select kqueue" @@ -297,7 +297,7 @@ msgid "" msgstr "" msgid "SipHash24" -msgstr "" +msgstr "SipHash24" msgid "" "The file :file:`Python/pyhash.c` contains Marek Majkowski' implementation of " @@ -317,26 +317,28 @@ msgid "" msgstr "" msgid "OpenSSL" -msgstr "" +msgstr "OpenSSL" msgid "" "The modules :mod:`hashlib`, :mod:`posix`, :mod:`ssl`, :mod:`crypt` use the " "OpenSSL library for added performance if made available by the operating " "system. Additionally, the Windows and macOS installers for Python may " "include a copy of the OpenSSL libraries, so we include a copy of the OpenSSL " -"license here::" +"license here. For the OpenSSL 3.0 release, and later releases derived from " +"that, the Apache License v2 applies::" msgstr "" msgid "expat" msgstr "" msgid "" -"The :mod:`pyexpat` extension is built using an included copy of the expat " -"sources unless the build is configured ``--with-system-expat``::" +"The :mod:`pyexpat ` extension is built using an included " +"copy of the expat sources unless the build is configured ``--with-system-" +"expat``::" msgstr "" msgid "libffi" -msgstr "" +msgstr "libffi" msgid "" "The :mod:`_ctypes` extension is built using an included copy of the libffi " @@ -344,7 +346,7 @@ msgid "" msgstr "" msgid "zlib" -msgstr "" +msgstr "zlib" msgid "" "The :mod:`zlib` extension is built using an included copy of the zlib " @@ -381,5 +383,48 @@ msgid "Audioop" msgstr "" msgid "" -"The audioop module uses the code base in g771.c file of the SoX project::" +"The audioop module uses the code base in g771.c file of the SoX project. " +"https://sourceforge.net/projects/sox/files/sox/12.17.7/sox-12.17.7.tar.gz" +msgstr "" + +msgid "" +"This source code is a product of Sun Microsystems, Inc. and is provided for " +"unrestricted use. Users may copy or modify this source code without charge." +msgstr "" + +msgid "" +"SUN SOURCE CODE IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING " +"THE WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR " +"PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE." +msgstr "" + +msgid "" +"Sun source code is provided with no support and without any obligation on " +"the part of Sun Microsystems, Inc. to assist in its use, correction, " +"modification or enhancement." +msgstr "" + +msgid "" +"SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE " +"INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY THIS SOFTWARE OR " +"ANY PART THEREOF." +msgstr "" + +msgid "" +"In no event will Sun Microsystems, Inc. be liable for any lost revenue or " +"profits or other special, indirect and consequential damages, even if Sun " +"has been advised of the possibility of such damages." +msgstr "" + +msgid "" +"Sun Microsystems, Inc. 2550 Garcia Avenue Mountain View, California 94043" +msgstr "" + +msgid "asyncio" +msgstr "" + +msgid "" +"Parts of the :mod:`asyncio` module are incorporated from `uvloop 0.16 " +"`_, which is distributed " +"under the MIT license::" msgstr "" diff --git a/manage_translation.py b/manage_translation.py index b512606e27..b56065d6e9 100755 --- a/manage_translation.py +++ b/manage_translation.py @@ -9,22 +9,23 @@ # # * fetch: fetch translations from transifex.com and strip source lines from the # files. -# * regenerate_tx_config: recreate configuration for all resources. +# * recreate_tx_config: recreate configuration for all resources. from argparse import ArgumentParser import os +from contextlib import chdir from dataclasses import dataclass from difflib import SequenceMatcher from itertools import combinations from pathlib import Path -from re import match from subprocess import call import sys -from typing import Self, Callable -from urllib.parse import urlparse, parse_qs +from tempfile import TemporaryDirectory +from typing import Self, Generator, Iterable from warnings import warn from polib import pofile +from transifex.api import transifex_api LANGUAGE = 'pl' @@ -33,76 +34,74 @@ def fetch(): """ Fetch translations from Transifex, remove source lines. """ - if call("tx --version", shell=True) != 0: + if (code := call("tx --version", shell=True)) != 0: sys.stderr.write("The Transifex client app is required.\n") - exit(1) + exit(code) lang = LANGUAGE - pull_returncode = call( - f'tx pull -l {lang} --minimum-perc=1 --force --skip', shell=True - ) - if pull_returncode != 0: - exit(pull_returncode) - for root, _, po_files in os.walk('.'): - for po_file in po_files: - if not po_file.endswith(".po"): - continue - po_path = os.path.join(root, po_file) - call(f'msgcat --no-location -o {po_path} {po_path}', shell=True) + _call(f'tx pull -l {lang} --minimum-perc=1 --force --skip') + for file in Path().rglob('*.po'): + _call(f'msgcat --no-location -o {file} {file}') + +def _call(command: str): + if (return_code := call(command, shell=True)) != 0: + exit(return_code) -RESOURCE_NAME_MAP = {'glossary_': 'glossary'} -PROJECT_SLUG = 'python-newest' +PROJECT_SLUG = 'python-311' +VERSION = '3.11' def recreate_tx_config(): """ Regenerate Transifex client config for all resources. """ - resources = _get_resources() - with open('.tx/config', 'w') as config: - config.writelines( - ( - '[main]\n', - 'host = https://www.transifex.com\n', - ) - ) - for resource in resources: - slug = resource.slug - name = RESOURCE_NAME_MAP.get(slug, slug) - if slug == '0': - continue - elif '--' in slug: - directory, file_name = name.split('--') - if match(r'\d+_\d+', file_name): - file_name = file_name.replace('_', '.') - config.writelines( - ( - '\n', - f'[o:python-doc:p:{PROJECT_SLUG}:r:{slug}]\n', - f'file_filter = {directory}/{file_name}.po\n', - 'type = PO\n', - 'source_lang = en\n', - ) - ) - else: - config.writelines( - ( - '\n', - f'[o:python-doc:p:{PROJECT_SLUG}:r:{slug}]\n', - f'file_filter = {name}.po\n', - 'type = PO\n', - 'source_lang = en\n', - ) - ) + with TemporaryDirectory() as directory: + with chdir(directory): + _clone_cpython_repo(VERSION) + _build_gettext() + with chdir(Path(directory) / 'cpython/Doc/locales'): + _create_txconfig() + _update_txconfig_resources() + with open('.tx/config', 'r') as file: + contents = file.read() + contents = contents.replace('.//LC_MESSAGES/', '') + with open('.tx/config', 'w') as file: + file.write(contents) + warn_about_files_to_delete() + +def warn_about_files_to_delete(): + files = list(_get_files_to_delete()) + if not files: + return + warn(f'Found {len(files)} file(s) to delete: {", ".join(files)}.') + +def _get_files_to_delete(): + with open('.tx/config') as config_file: + config = config_file.read() + for file in Path().rglob('*.po'): + if os.fsdecode(file) not in config: + yield os.fsdecode(file) -@dataclass -class Resource: - slug: str +def _clone_cpython_repo(version: str): + _call(f'git clone -b {version} --single-branch https://github.com/python/cpython.git --depth 1') - @classmethod - def from_api_v3_entry(cls, data: dict) -> Self: - return cls(slug=data['attributes']['slug']) + +def _build_gettext(): + _call( + "make -C cpython/Doc/ ALLSPHINXOPTS='-E -b gettext -D gettext_compact=0 -d build/.doctrees . locales/pot' build" + ) + + +def _create_txconfig(): + _call('sphinx-intl create-txconfig') + + +def _update_txconfig_resources(): + _call( + f'sphinx-intl update-txconfig-resources --transifex-organization-name python-doc ' + f'--transifex-project-name={PROJECT_SLUG} --locale-dir . --pot-dir pot' + ) @dataclass @@ -114,79 +113,62 @@ class ResourceLanguageStatistics: translated_strings: int @classmethod - def from_api_v3_entry(cls, data: dict) -> Self: + def from_api_entry(cls, data: transifex_api.ResourceLanguageStats) -> Self: return cls( - name=data['id'].removeprefix(f'o:python-doc:p:{PROJECT_SLUG}:r:').removesuffix(f':l:{LANGUAGE}'), - total_words=data['attributes']['total_words'], - translated_words=data['attributes']['translated_words'], - total_strings=data['attributes']['total_strings'], - translated_strings=data['attributes']['translated_strings'], + name=data.id.removeprefix(f'o:python-doc:p:{PROJECT_SLUG}:r:').removesuffix(f':l:{LANGUAGE}'), + total_words=data.attributes['total_words'], + translated_words=data.attributes['translated_words'], + total_strings=data.attributes['total_strings'], + translated_strings=data.attributes['translated_strings'], ) -def _get_from_api_v3_with_cursor(url: str, params: dict) -> list[dict]: - from requests import get - - resources = [] - cursor = None +def _get_tx_token() -> str: if os.path.exists('.tx/api-key'): with open('.tx/api-key') as f: transifex_api_key = f.read() else: transifex_api_key = os.getenv('TX_TOKEN', '') - while True: - response = get( - url, - params=params | ({'page[cursor]': cursor} if cursor else {}), - headers={'Authorization': f'Bearer {transifex_api_key}'} - ) - response.raise_for_status() - response_json = response.json() - response_list = response_json['data'] - resources.extend(response_list) - if not response_json['links'].get('next'): # for stats no key, for list resources null - break - cursor, *_ = parse_qs(urlparse(response_json['links']['next']).query)['page[cursor]'] - return resources - - -def _get_resources() -> list[Resource]: - resources = _get_from_api_v3_with_cursor( - 'https://rest.api.transifex.com/resources', {'filter[project]': f'o:python-doc:p:{PROJECT_SLUG}'} - ) - return [Resource.from_api_v3_entry(entry) for entry in resources] + return transifex_api_key + + +def _get_resources() -> list[transifex_api.Resource]: + transifex_api.setup(auth=_get_tx_token()) + return transifex_api.Resource.filter(project=f'o:python-doc:p:{PROJECT_SLUG}').all() def get_resource_language_stats() -> list[ResourceLanguageStatistics]: - resources = _get_from_api_v3_with_cursor( - 'https://rest.api.transifex.com/resource_language_stats', - {'filter[project]': f'o:python-doc:p:{PROJECT_SLUG}', 'filter[language]': f'l:{LANGUAGE}'} - ) - return [ResourceLanguageStatistics.from_api_v3_entry(entry) for entry in resources] + transifex_api.setup(auth=_get_tx_token()) + resources = transifex_api.ResourceLanguageStats.filter( + project=f'o:python-doc:p:{PROJECT_SLUG}', language=f'l:{LANGUAGE}' + ).all() + return [ResourceLanguageStatistics.from_api_entry(entry) for entry in resources] -def progress_from_resources(resources: list[ResourceLanguageStatistics], filter_function: Callable) -> float: - filtered = filter(filter_function, resources) - pairs = ((e.translated_words, e.total_words) for e in filtered) +def progress_from_resources(resources: Iterable[ResourceLanguageStatistics]) -> float: + pairs = ((e.translated_words, e.total_words) for e in resources) translated_total, total_total = (sum(counts) for counts in zip(*pairs)) return translated_total / total_total * 100 def get_number_of_translators(): - translators = _fetch_translators() + translators = set(_fetch_translators()) + _remove_bot(translators) _remove_aliases(translators) _check_for_new_aliases(translators) return len(translators) -def _fetch_translators() -> set[str]: - translators = set() +def _fetch_translators() -> Generator[str, None, None]: for file in Path().rglob('*.po'): header = pofile(file).header.splitlines() for translator_record in header[header.index('Translators:') + 1:]: translator, _year = translator_record.split(', ') - translators.add(translator) - return translators + yield translator + + +def _remove_bot(translators: set[str]) -> None: + translators.remove("Transifex Bot <>") def _remove_aliases(translators: set[str]) -> None: @@ -209,7 +191,7 @@ def language_switcher(entry: ResourceLanguageStatistics) -> bool: if __name__ == "__main__": - RUNNABLE_SCRIPTS = ('fetch', 'recreate_tx_config') + RUNNABLE_SCRIPTS = ('fetch', 'recreate_tx_config', 'warn_about_files_to_delete') parser = ArgumentParser() parser.add_argument('cmd', choices=RUNNABLE_SCRIPTS) diff --git a/reference/compound_stmts.po b/reference/compound_stmts.po index 2d5c0f4630..9c10c03bd7 100644 --- a/reference/compound_stmts.po +++ b/reference/compound_stmts.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:19+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -353,49 +354,50 @@ msgid "" "with_item`) is evaluated to obtain a context manager." msgstr "" -msgid "The context manager's :meth:`__enter__` is loaded for later use." +msgid "" +"The context manager's :meth:`~object.__enter__` is loaded for later use." msgstr "" -msgid "The context manager's :meth:`__exit__` is loaded for later use." +msgid "The context manager's :meth:`~object.__exit__` is loaded for later use." msgstr "" -msgid "The context manager's :meth:`__enter__` method is invoked." +msgid "The context manager's :meth:`~object.__enter__` method is invoked." msgstr "" msgid "" "If a target was included in the :keyword:`with` statement, the return value " -"from :meth:`__enter__` is assigned to it." +"from :meth:`~object.__enter__` is assigned to it." msgstr "" msgid "" -"The :keyword:`with` statement guarantees that if the :meth:`__enter__` " -"method returns without an error, then :meth:`__exit__` will always be " -"called. Thus, if an error occurs during the assignment to the target list, " -"it will be treated the same as an error occurring within the suite would be. " -"See step 7 below." +"The :keyword:`with` statement guarantees that if the :meth:`~object." +"__enter__` method returns without an error, then :meth:`~object.__exit__` " +"will always be called. Thus, if an error occurs during the assignment to the " +"target list, it will be treated the same as an error occurring within the " +"suite would be. See step 7 below." msgstr "" msgid "The suite is executed." msgstr "" msgid "" -"The context manager's :meth:`__exit__` method is invoked. If an exception " -"caused the suite to be exited, its type, value, and traceback are passed as " -"arguments to :meth:`__exit__`. Otherwise, three :const:`None` arguments are " -"supplied." +"The context manager's :meth:`~object.__exit__` method is invoked. If an " +"exception caused the suite to be exited, its type, value, and traceback are " +"passed as arguments to :meth:`~object.__exit__`. Otherwise, three :const:" +"`None` arguments are supplied." msgstr "" msgid "" "If the suite was exited due to an exception, and the return value from the :" -"meth:`__exit__` method was false, the exception is reraised. If the return " -"value was true, the exception is suppressed, and execution continues with " -"the statement following the :keyword:`with` statement." +"meth:`~object.__exit__` method was false, the exception is reraised. If the " +"return value was true, the exception is suppressed, and execution continues " +"with the statement following the :keyword:`with` statement." msgstr "" msgid "" "If the suite was exited for any reason other than an exception, the return " -"value from :meth:`__exit__` is ignored, and execution proceeds at the normal " -"location for the kind of exit that was taken." +"value from :meth:`~object.__exit__` is ignored, and execution proceeds at " +"the normal location for the kind of exit that was taken." msgstr "" msgid "The following code::" @@ -589,10 +591,10 @@ msgid ":ref:`or-patterns` containing at least one irrefutable pattern" msgstr "" msgid ":ref:`capture-patterns`" -msgstr "" +msgstr ":ref:`capture-patterns`" msgid ":ref:`wildcard-patterns`" -msgstr "" +msgstr ":ref:`wildcard-patterns`" msgid "parenthesized irrefutable patterns" msgstr "" @@ -872,7 +874,7 @@ msgid "check ```` is a sequence" msgstr "" msgid "``len(subject) == ``" -msgstr "" +msgstr "``len(subject) == ``" msgid "" "``P1`` matches ``[0]`` (note that this match can also bind names)" @@ -928,7 +930,7 @@ msgid "" "Key-value pairs are matched using the two-argument form of the mapping " "subject's ``get()`` method. Matched key-value pairs must already be present " "in the mapping, and not created on-the-fly via :meth:`__missing__` or :meth:" -"`__getitem__`." +"`~object.__getitem__`." msgstr "" msgid "" @@ -1044,7 +1046,7 @@ msgid "If there are duplicate keywords, :exc:`TypeError` is raised." msgstr "" msgid ":ref:`class-pattern-matching`" -msgstr "" +msgstr ":ref:`class-pattern-matching`" msgid "" "II. Once all positional patterns have been converted to keyword patterns," @@ -1059,37 +1061,37 @@ msgid "" msgstr "" msgid ":class:`bool`" -msgstr "" +msgstr ":class:`bool`" msgid ":class:`bytearray`" -msgstr "" +msgstr ":class:`bytearray`" msgid ":class:`bytes`" -msgstr "" +msgstr ":class:`bytes`" msgid ":class:`dict`" -msgstr "" +msgstr ":class:`dict`" msgid ":class:`float`" -msgstr "" +msgstr ":class:`float`" msgid ":class:`frozenset`" -msgstr "" +msgstr ":class:`frozenset`" msgid ":class:`int`" -msgstr "" +msgstr ":class:`int`" msgid ":class:`list`" -msgstr "" +msgstr ":class:`list`" msgid ":class:`set`" -msgstr "" +msgstr ":class:`set`" msgid ":class:`str`" -msgstr "" +msgstr ":class:`str`" msgid ":class:`tuple`" -msgstr "" +msgstr ":class:`tuple`" msgid "" "These classes accept a single positional argument, and the pattern there is " @@ -1258,7 +1260,7 @@ msgstr "" msgid "" "Ability to type hint variable declarations, including class variables and " -"instance variables" +"instance variables." msgstr "" msgid ":pep:`563` - Postponed Evaluation of Annotations" @@ -1269,6 +1271,14 @@ msgid "" "in a string form at runtime instead of eager evaluation." msgstr "" +msgid ":pep:`318` - Decorators for Functions and Methods" +msgstr "" + +msgid "" +"Function and method decorators were introduced. Class decorators were " +"introduced in :pep:`3129`." +msgstr "" + msgid "Class definitions" msgstr "" @@ -1454,7 +1464,7 @@ msgid "" msgstr "" msgid "" -"a builtin class that has its (CPython) :data:`Py_TPFLAGS_SEQUENCE` bit set" +"a builtin class that has its (CPython) :c:macro:`Py_TPFLAGS_SEQUENCE` bit set" msgstr "" msgid "a class that inherits from any of the above" @@ -1464,16 +1474,16 @@ msgid "The following standard library classes are sequences:" msgstr "" msgid ":class:`array.array`" -msgstr "" +msgstr ":class:`array.array`" msgid ":class:`collections.deque`" -msgstr "" +msgstr ":class:`collections.deque`" msgid ":class:`memoryview`" -msgstr "" +msgstr ":class:`memoryview`" msgid ":class:`range`" -msgstr "" +msgstr ":class:`range`" msgid "" "Subject values of type ``str``, ``bytes``, and ``bytearray`` do not match " @@ -1491,7 +1501,7 @@ msgid "" msgstr "" msgid "" -"a builtin class that has its (CPython) :data:`Py_TPFLAGS_MAPPING` bit set" +"a builtin class that has its (CPython) :c:macro:`Py_TPFLAGS_MAPPING` bit set" msgstr "" msgid "" @@ -1501,8 +1511,8 @@ msgstr "" msgid "" "A string literal appearing as the first statement in the function body is " -"transformed into the function's ``__doc__`` attribute and therefore the " -"function's :term:`docstring`." +"transformed into the function's :attr:`~function.__doc__` attribute and " +"therefore the function's :term:`docstring`." msgstr "" msgid "" @@ -1575,16 +1585,16 @@ msgid "target" msgstr "" msgid "list" -msgstr "" +msgstr "lista" msgid "object" -msgstr "" +msgstr "obiekt" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "range" msgstr "" @@ -1671,7 +1681,7 @@ msgid "definition" msgstr "" msgid "name" -msgstr "" +msgstr "nazwa" msgid "binding" msgstr "" @@ -1695,7 +1705,7 @@ msgid "value" msgstr "" msgid "argument" -msgstr "" +msgstr "argument" msgid "= (equals)" msgstr "" @@ -1704,13 +1714,13 @@ msgid "/ (slash)" msgstr "" msgid "* (asterisk)" -msgstr "* (asterisk)" +msgstr "* (asterysk)" msgid "**" msgstr "**" msgid "annotations" -msgstr "anotacje" +msgstr "adnotacje typów" msgid "->" msgstr "->" @@ -1719,13 +1729,13 @@ msgid "function annotations" msgstr "adnotacje typów funkcji" msgid "lambda" -msgstr "" +msgstr "lambda" msgid "expression" -msgstr "" +msgstr "wyrażenie" msgid "class" -msgstr "" +msgstr "klasa" msgid "execution" msgstr "" @@ -1737,7 +1747,7 @@ msgid "inheritance" msgstr "" msgid "docstring" -msgstr "" +msgstr "docstring" msgid "class definition" msgstr "" diff --git a/reference/datamodel.po b/reference/datamodel.po index e967ed0c3d..112593f877 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Tomasz Rodzen , 2021 -# Krzysztof Abramowicz, 2023 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:19+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +40,8 @@ msgstr "" msgid "" "Every object has an identity, a type and a value. An object's *identity* " "never changes once it has been created; you may think of it as the object's " -"address in memory. The ':keyword:`is`' operator compares the identity of " -"two objects; the :func:`id` function returns an integer representing its " +"address in memory. The :keyword:`is` operator compares the identity of two " +"objects; the :func:`id` function returns an integer representing its " "identity." msgstr "" @@ -92,8 +91,8 @@ msgstr "" msgid "" "Note that the use of the implementation's tracing or debugging facilities " "may keep objects alive that would normally be collectable. Also note that " -"catching an exception with a ':keyword:`try`...\\ :keyword:`except`' " -"statement may keep objects alive." +"catching an exception with a :keyword:`try`...\\ :keyword:`except` statement " +"may keep objects alive." msgstr "" msgid "" @@ -101,9 +100,9 @@ msgid "" "or windows. It is understood that these resources are freed when the object " "is garbage-collected, but since garbage collection is not guaranteed to " "happen, such objects also provide an explicit way to release the external " -"resource, usually a :meth:`close` method. Programs are strongly recommended " -"to explicitly close such objects. The ':keyword:`try`...\\ :keyword:" -"`finally`' statement and the ':keyword:`with`' statement provide convenient " +"resource, usually a :meth:`!close` method. Programs are strongly recommended " +"to explicitly close such objects. The :keyword:`try`...\\ :keyword:" +"`finally` statement and the :keyword:`with` statement provide convenient " "ways to do this." msgstr "" @@ -164,7 +163,7 @@ msgstr "" msgid "" "This type has a single value. There is a single object with this value. " -"This object is accessed through the built-in name ``NotImplemented``. " +"This object is accessed through the built-in name :data:`NotImplemented`. " "Numeric methods and rich comparison methods should return this value if they " "do not implement the operation for the operands provided. (The interpreter " "will then try the reflected operation, or some other fallback, depending on " @@ -175,8 +174,8 @@ msgid "See :ref:`implementing-the-arithmetic-operations` for more details." msgstr "" msgid "" -"Evaluating ``NotImplemented`` in a boolean context is deprecated. While it " -"currently evaluates as true, it will emit a :exc:`DeprecationWarning`. It " +"Evaluating :data:`NotImplemented` in a boolean context is deprecated. While " +"it currently evaluates as true, it will emit a :exc:`DeprecationWarning`. It " "will raise a :exc:`TypeError` in a future version of Python." msgstr "" @@ -190,7 +189,7 @@ msgid "" msgstr "" msgid ":class:`numbers.Number`" -msgstr "" +msgstr ":class:`numbers.Number`" msgid "" "These are created by numeric literals and returned as results by arithmetic " @@ -233,13 +232,19 @@ msgid "" msgstr "" msgid ":class:`numbers.Integral`" -msgstr "" +msgstr ":class:`numbers.Integral`" msgid "" "These represent elements from the mathematical set of integers (positive and " "negative)." msgstr "" +msgid "" +"The rules for integer representation are intended to give the most " +"meaningful interpretation of shift and mask operations involving negative " +"integers." +msgstr "" + msgid "There are two types of integers:" msgstr "" @@ -266,12 +271,6 @@ msgid "" "``\"True\"`` are returned, respectively." msgstr "" -msgid "" -"The rules for integer representation are intended to give the most " -"meaningful interpretation of shift and mask operations involving negative " -"integers." -msgstr "" - msgid ":class:`numbers.Real` (:class:`float`)" msgstr "" @@ -302,14 +301,17 @@ msgid "" "These represent finite ordered sets indexed by non-negative numbers. The " "built-in function :func:`len` returns the number of items of a sequence. " "When the length of a sequence is *n*, the index set contains the numbers 0, " -"1, ..., *n*-1. Item *i* of sequence *a* is selected by ``a[i]``." +"1, ..., *n*-1. Item *i* of sequence *a* is selected by ``a[i]``. Some " +"sequences, including built-in sequences, interpret negative subscripts by " +"adding the sequence length. For example, ``a[-2]`` equals ``a[n-2]``, the " +"second to last item of sequence a with length ``n``." msgstr "" msgid "" "Sequences also support slicing: ``a[i:j]`` selects all items with index *k* " "such that *i* ``<=`` *k* ``<`` *j*. When used as an expression, a slice is " -"a sequence of the same type. This implies that the index set is renumbered " -"so that it starts at 0." +"a sequence of the same type. The comment above about negative indexes also " +"applies to negative slice positions." msgstr "" msgid "" @@ -363,7 +365,7 @@ msgid "" msgstr "" msgid "Bytes" -msgstr "" +msgstr "Bajty" msgid "" "A bytes object is an immutable array. The items are 8-bit bytes, " @@ -382,6 +384,11 @@ msgid "" "`del` (delete) statements." msgstr "" +msgid "" +"The :mod:`collections` and :mod:`array` module provide additional examples " +"of mutable sequence types." +msgstr "" + msgid "There are currently two intrinsic mutable sequence types:" msgstr "" @@ -404,11 +411,6 @@ msgid "" "functionality as immutable :class:`bytes` objects." msgstr "" -msgid "" -"The extension module :mod:`array` provides an additional example of a " -"mutable sequence type, as does the :mod:`collections` module." -msgstr "" - msgid "Set types" msgstr "" @@ -517,39 +519,50 @@ msgid "" "containing the same number of items as the function's formal parameter list." msgstr "" -msgid "Special attributes:" +msgid "Special read-only attributes" msgstr "" msgid "Attribute" -msgstr "" +msgstr "atrybut" msgid "Meaning" msgstr "Znaczenie" -msgid ":attr:`__doc__`" +msgid "" +"A reference to the :class:`dictionary ` that holds the function's :ref:" +"`global variables ` -- the global namespace of the module in which " +"the function was defined." msgstr "" msgid "" -"The function's documentation string, or ``None`` if unavailable; not " -"inherited by subclasses." +"``None`` or a :class:`tuple` of cells that contain bindings for the " +"function's free variables." msgstr "" -msgid "Writable" +msgid "" +"A cell object has the attribute ``cell_contents``. This can be used to get " +"the value of the cell, as well as set the value." msgstr "" -msgid ":attr:`~definition.\\ __name__`" +msgid "Special writable attributes" msgstr "" -msgid "The function's name." +msgid "Most of these attributes check the type of the assigned value:" msgstr "" -msgid ":attr:`~definition.\\ __qualname__`" +msgid "" +"The function's documentation string, or ``None`` if unavailable. Not " +"inherited by subclasses." msgstr "" -msgid "The function's :term:`qualified name`." +msgid "" +"The function's name. See also: :attr:`__name__ attributes `." msgstr "" -msgid ":attr:`__module__`" +msgid "" +"The function's :term:`qualified name`. See also: :attr:`__qualname__ " +"attributes `." msgstr "" msgid "" @@ -557,153 +570,140 @@ msgid "" "unavailable." msgstr "" -msgid ":attr:`__defaults__`" -msgstr "" - msgid "" -"A tuple containing default argument values for those arguments that have " -"defaults, or ``None`` if no arguments have a default value." -msgstr "" - -msgid ":attr:`__code__`" -msgstr "" - -msgid "The code object representing the compiled function body." -msgstr "" - -msgid ":attr:`__globals__`" +"A :class:`tuple` containing default :term:`parameter` values for those " +"parameters that have defaults, or ``None`` if no parameters have a default " +"value." msgstr "" msgid "" -"A reference to the dictionary that holds the function's global variables --- " -"the global namespace of the module in which the function was defined." +"The :ref:`code object ` representing the compiled function " +"body." msgstr "" -msgid "Read-only" -msgstr "" - -msgid ":attr:`~object.__dict__`" -msgstr "" - -msgid "The namespace supporting arbitrary function attributes." +msgid "" +"The namespace supporting arbitrary function attributes. See also: :attr:" +"`__dict__ attributes `." msgstr "" -msgid ":attr:`__closure__`" +msgid "" +"A :class:`dictionary ` containing annotations of :term:`parameters " +"`. The keys of the dictionary are the parameter names, and " +"``'return'`` for the return annotation, if provided. See also: :ref:" +"`annotations-howto`." msgstr "" msgid "" -"``None`` or a tuple of cells that contain bindings for the function's free " -"variables. See below for information on the ``cell_contents`` attribute." +"A :class:`dictionary ` containing defaults for keyword-only :term:" +"`parameters `." msgstr "" -msgid ":attr:`__annotations__`" +msgid "" +"Function objects also support getting and setting arbitrary attributes, " +"which can be used, for example, to attach metadata to functions. Regular " +"attribute dot-notation is used to get and set such attributes." msgstr "" msgid "" -"A dict containing annotations of parameters. The keys of the dict are the " -"parameter names, and ``'return'`` for the return annotation, if provided. " -"For more information on working with this attribute, see :ref:`annotations-" -"howto`." +"CPython's current implementation only supports function attributes on user-" +"defined functions. Function attributes on :ref:`built-in functions ` may be supported in the future." msgstr "" -msgid ":attr:`__kwdefaults__`" +msgid "" +"Additional information about a function's definition can be retrieved from " +"its :ref:`code object ` (accessible via the :attr:`~function." +"__code__` attribute)." msgstr "" -msgid "A dict containing defaults for keyword-only parameters." +msgid "Instance methods" msgstr "" msgid "" -"Most of the attributes labelled \"Writable\" check the type of the assigned " -"value." +"An instance method object combines a class, a class instance and any " +"callable object (normally a user-defined function)." msgstr "" -msgid "" -"Function objects also support getting and setting arbitrary attributes, " -"which can be used, for example, to attach metadata to functions. Regular " -"attribute dot-notation is used to get and set such attributes. *Note that " -"the current implementation only supports function attributes on user-defined " -"functions. Function attributes on built-in functions may be supported in the " -"future.*" +msgid "Special read-only attributes:" msgstr "" msgid "" -"A cell object has the attribute ``cell_contents``. This can be used to get " -"the value of the cell, as well as set the value." +"Refers to the class instance object to which the method is :ref:`bound " +"`" msgstr "" -msgid "" -"Additional information about a function's definition can be retrieved from " -"its code object; see the description of internal types below. The :data:" -"`cell ` type can be accessed in the :mod:`types` module." +msgid "Refers to the original :ref:`function object `" msgstr "" -msgid "Instance methods" +msgid "" +"The method's documentation (same as :attr:`method.__func__.__doc__ `). A :class:`string ` if the original function had a " +"docstring, else ``None``." msgstr "" msgid "" -"An instance method object combines a class, a class instance and any " -"callable object (normally a user-defined function)." +"The name of the method (same as :attr:`method.__func__.__name__ `)" msgstr "" msgid "" -"Special read-only attributes: :attr:`__self__` is the class instance " -"object, :attr:`__func__` is the function object; :attr:`__doc__` is the " -"method's documentation (same as ``__func__.__doc__``); :attr:`~definition." -"__name__` is the method name (same as ``__func__.__name__``); :attr:" -"`__module__` is the name of the module the method was defined in, or " -"``None`` if unavailable." +"The name of the module the method was defined in, or ``None`` if unavailable." msgstr "" msgid "" "Methods also support accessing (but not setting) the arbitrary function " -"attributes on the underlying function object." +"attributes on the underlying :ref:`function object `." msgstr "" msgid "" "User-defined method objects may be created when getting an attribute of a " "class (perhaps via an instance of that class), if that attribute is a user-" -"defined function object or a class method object." +"defined :ref:`function object ` or a :class:" +"`classmethod` object." msgstr "" msgid "" -"When an instance method object is created by retrieving a user-defined " -"function object from a class via one of its instances, its :attr:`__self__` " -"attribute is the instance, and the method object is said to be bound. The " -"new method's :attr:`__func__` attribute is the original function object." +"When an instance method object is created by retrieving a user-defined :ref:" +"`function object ` from a class via one of its " +"instances, its :attr:`~method.__self__` attribute is the instance, and the " +"method object is said to be *bound*. The new method's :attr:`~method." +"__func__` attribute is the original function object." msgstr "" msgid "" -"When an instance method object is created by retrieving a class method " -"object from a class or instance, its :attr:`__self__` attribute is the class " -"itself, and its :attr:`__func__` attribute is the function object underlying " -"the class method." +"When an instance method object is created by retrieving a :class:" +"`classmethod` object from a class or instance, its :attr:`~method.__self__` " +"attribute is the class itself, and its :attr:`~method.__func__` attribute is " +"the function object underlying the class method." msgstr "" msgid "" "When an instance method object is called, the underlying function (:attr:" -"`__func__`) is called, inserting the class instance (:attr:`__self__`) in " -"front of the argument list. For instance, when :class:`C` is a class which " -"contains a definition for a function :meth:`f`, and ``x`` is an instance of :" -"class:`C`, calling ``x.f(1)`` is equivalent to calling ``C.f(x, 1)``." +"`~method.__func__`) is called, inserting the class instance (:attr:`~method." +"__self__`) in front of the argument list. For instance, when :class:`!C` is " +"a class which contains a definition for a function :meth:`!f`, and ``x`` is " +"an instance of :class:`!C`, calling ``x.f(1)`` is equivalent to calling ``C." +"f(x, 1)``." msgstr "" msgid "" -"When an instance method object is derived from a class method object, the " -"\"class instance\" stored in :attr:`__self__` will actually be the class " -"itself, so that calling either ``x.f(1)`` or ``C.f(1)`` is equivalent to " -"calling ``f(C,1)`` where ``f`` is the underlying function." +"When an instance method object is derived from a :class:`classmethod` " +"object, the \"class instance\" stored in :attr:`~method.__self__` will " +"actually be the class itself, so that calling either ``x.f(1)`` or ``C." +"f(1)`` is equivalent to calling ``f(C,1)`` where ``f`` is the underlying " +"function." msgstr "" msgid "" -"Note that the transformation from function object to instance method object " -"happens each time the attribute is retrieved from the instance. In some " -"cases, a fruitful optimization is to assign the attribute to a local " -"variable and call that local variable. Also notice that this transformation " -"only happens for user-defined functions; other callable objects (and all non-" -"callable objects) are retrieved without transformation. It is also " -"important to note that user-defined functions which are attributes of a " -"class instance are not converted to bound methods; this *only* happens when " -"the function is an attribute of the class." +"Note that the transformation from :ref:`function object ` to instance method object happens each time the attribute is " +"retrieved from the instance. In some cases, a fruitful optimization is to " +"assign the attribute to a local variable and call that local variable. Also " +"notice that this transformation only happens for user-defined functions; " +"other callable objects (and all non-callable objects) are retrieved without " +"transformation. It is also important to note that user-defined functions " +"which are attributes of a class instance are not converted to bound methods; " +"this *only* happens when the function is an attribute of the class." msgstr "" msgid "Generator functions" @@ -760,11 +760,24 @@ msgid "" "A built-in function object is a wrapper around a C function. Examples of " "built-in functions are :func:`len` and :func:`math.sin` (:mod:`math` is a " "standard built-in module). The number and type of the arguments are " -"determined by the C function. Special read-only attributes: :attr:`__doc__` " -"is the function's documentation string, or ``None`` if unavailable; :attr:" -"`~definition.__name__` is the function's name; :attr:`__self__` is set to " -"``None`` (but see the next item); :attr:`__module__` is the name of the " -"module the function was defined in or ``None`` if unavailable." +"determined by the C function. Special read-only attributes:" +msgstr "" + +msgid "" +":attr:`!__doc__` is the function's documentation string, or ``None`` if " +"unavailable. See :attr:`function.__doc__`." +msgstr "" + +msgid "" +":attr:`!__name__` is the function's name. See :attr:`function.__name__`." +msgstr "" + +msgid ":attr:`!__self__` is set to ``None`` (but see the next item)." +msgstr "" + +msgid "" +":attr:`!__module__` is the name of the module the function was defined in or " +"``None`` if unavailable. See :attr:`function.__module__`." msgstr "" msgid "Built-in methods" @@ -775,7 +788,9 @@ msgid "" "containing an object passed to the C function as an implicit extra " "argument. An example of a built-in method is ``alist.append()``, assuming " "*alist* is a list object. In this case, the special read-only attribute :" -"attr:`__self__` is set to the object denoted by *alist*." +"attr:`!__self__` is set to the object denoted by *alist*. (The attribute has " +"the same semantics as it does with :attr:`other instance methods `.)" msgstr "" msgid "Classes" @@ -785,7 +800,7 @@ msgid "" "Classes are callable. These objects normally act as factories for new " "instances of themselves, but variations are possible for class types that " "override :meth:`~object.__new__`. The arguments of the call are passed to :" -"meth:`__new__` and, in the typical case, to :meth:`~object.__init__` to " +"meth:`!__new__` and, in the typical case, to :meth:`~object.__init__` to " "initialize the new instance." msgstr "" @@ -805,12 +820,13 @@ msgid "" "the :ref:`import system ` as invoked either by the :keyword:" "`import` statement, or by calling functions such as :func:`importlib." "import_module` and built-in :func:`__import__`. A module object has a " -"namespace implemented by a dictionary object (this is the dictionary " -"referenced by the ``__globals__`` attribute of functions defined in the " -"module). Attribute references are translated to lookups in this dictionary, " -"e.g., ``m.x`` is equivalent to ``m.__dict__[\"x\"]``. A module object does " -"not contain the code object used to initialize the module (since it isn't " -"needed once the initialization is done)." +"namespace implemented by a :class:`dictionary ` object (this is the " +"dictionary referenced by the :attr:`~function.__globals__` attribute of " +"functions defined in the module). Attribute references are translated to " +"lookups in this dictionary, e.g., ``m.x`` is equivalent to ``m." +"__dict__[\"x\"]``. A module object does not contain the code object used to " +"initialize the module (since it isn't needed once the initialization is " +"done)." msgstr "" msgid "" @@ -827,6 +843,9 @@ msgstr "" msgid "The module's name." msgstr "" +msgid ":attr:`__doc__`" +msgstr "" + msgid "The module's documentation string, or ``None`` if unavailable." msgstr "" @@ -841,6 +860,9 @@ msgid "" "library, it's the pathname of the shared library file." msgstr "" +msgid ":attr:`__annotations__`" +msgstr "" + msgid "" "A dictionary containing :term:`variable annotations ` " "collected during module body execution. For best practices on working with :" @@ -878,13 +900,13 @@ msgid "" msgstr "" msgid "" -"When a class attribute reference (for class :class:`C`, say) would yield a " +"When a class attribute reference (for class :class:`!C`, say) would yield a " "class method object, it is transformed into an instance method object whose :" -"attr:`__self__` attribute is :class:`C`. When it would yield a static " -"method object, it is transformed into the object wrapped by the static " -"method object. See section :ref:`descriptors` for another way in which " -"attributes retrieved from a class may differ from those actually contained " -"in its :attr:`~object.__dict__`." +"attr:`~method.__self__` attribute is :class:`!C`. When it would yield a :" +"class:`staticmethod` object, it is transformed into the object wrapped by " +"the static method object. See section :ref:`descriptors` for another way in " +"which attributes retrieved from a class may differ from those actually " +"contained in its :attr:`~object.__dict__`." msgstr "" msgid "" @@ -897,15 +919,24 @@ msgid "" "below)." msgstr "" +msgid "Special attributes:" +msgstr "" + msgid ":attr:`~definition.__name__`" msgstr "" msgid "The class name." msgstr "" +msgid ":attr:`__module__`" +msgstr "" + msgid "The name of the module in which the class was defined." msgstr "" +msgid ":attr:`~object.__dict__`" +msgstr "" + msgid "The dictionary containing the class's namespace." msgstr "" @@ -936,8 +967,8 @@ msgid "" "found there, and the instance's class has an attribute by that name, the " "search continues with the class attributes. If a class attribute is found " "that is a user-defined function object, it is transformed into an instance " -"method object whose :attr:`__self__` attribute is the instance. Static " -"method and class method objects are also transformed; see above under " +"method object whose :attr:`~method.__self__` attribute is the instance. " +"Static method and class method objects are also transformed; see above under " "\"Classes\". See section :ref:`descriptors` for another way in which " "attributes of a class retrieved via its instances may differ from the " "objects actually stored in the class's :attr:`~object.__dict__`. If no " @@ -1003,64 +1034,120 @@ msgid "" "no references (directly or indirectly) to mutable objects." msgstr "" +msgid "The function name" +msgstr "" + +msgid "The fully qualified function name" +msgstr "" + +msgid "" +"The total number of positional :term:`parameters ` (including " +"positional-only parameters and parameters with default values) that the " +"function has" +msgstr "" + +msgid "" +"The number of positional-only :term:`parameters ` (including " +"arguments with default values) that the function has" +msgstr "" + +msgid "" +"The number of keyword-only :term:`parameters ` (including " +"arguments with default values) that the function has" +msgstr "" + +msgid "" +"The number of :ref:`local variables ` used by the function " +"(including parameters)" +msgstr "" + +msgid "" +"A :class:`tuple` containing the names of the local variables in the function " +"(starting with the parameter names)" +msgstr "" + +msgid "" +"A :class:`tuple` containing the names of :ref:`local variables ` " +"that are referenced by nested functions inside the function" +msgstr "" + +msgid "A :class:`tuple` containing the names of free variables in the function" +msgstr "" + +msgid "" +"A string representing the sequence of :term:`bytecode` instructions in the " +"function" +msgstr "" + msgid "" -"Special read-only attributes: :attr:`co_name` gives the function name; :attr:" -"`co_qualname` gives the fully qualified function name; :attr:`co_argcount` " -"is the total number of positional arguments (including positional-only " -"arguments and arguments with default values); :attr:`co_posonlyargcount` is " -"the number of positional-only arguments (including arguments with default " -"values); :attr:`co_kwonlyargcount` is the number of keyword-only arguments " -"(including arguments with default values); :attr:`co_nlocals` is the number " -"of local variables used by the function (including arguments); :attr:" -"`co_varnames` is a tuple containing the names of the local variables " -"(starting with the argument names); :attr:`co_cellvars` is a tuple " -"containing the names of local variables that are referenced by nested " -"functions; :attr:`co_freevars` is a tuple containing the names of free " -"variables; :attr:`co_code` is a string representing the sequence of bytecode " -"instructions; :attr:`co_consts` is a tuple containing the literals used by " -"the bytecode; :attr:`co_names` is a tuple containing the names used by the " -"bytecode; :attr:`co_filename` is the filename from which the code was " -"compiled; :attr:`co_firstlineno` is the first line number of the function; :" -"attr:`co_lnotab` is a string encoding the mapping from bytecode offsets to " -"line numbers (for details see the source code of the interpreter); :attr:" -"`co_stacksize` is the required stack size; :attr:`co_flags` is an integer " -"encoding a number of flags for the interpreter." +"A :class:`tuple` containing the literals used by the :term:`bytecode` in the " +"function" +msgstr "" + +msgid "" +"A :class:`tuple` containing the names used by the :term:`bytecode` in the " +"function" +msgstr "" + +msgid "The name of the file from which the code was compiled" +msgstr "" + +msgid "The line number of the first line of the function" +msgstr "" + +msgid "" +"A string encoding the mapping from :term:`bytecode` offsets to line numbers. " +"For details, see the source code of the interpreter." +msgstr "" + +msgid "The required stack size of the code object" msgstr "" msgid "" -"The following flag bits are defined for :attr:`co_flags`: bit ``0x04`` is " -"set if the function uses the ``*arguments`` syntax to accept an arbitrary " -"number of positional arguments; bit ``0x08`` is set if the function uses the " -"``**keywords`` syntax to accept arbitrary keyword arguments; bit ``0x20`` is " -"set if the function is a generator." +"An :class:`integer ` encoding a number of flags for the interpreter." +msgstr "" + +msgid "" +"The following flag bits are defined for :attr:`~codeobject.co_flags`: bit " +"``0x04`` is set if the function uses the ``*arguments`` syntax to accept an " +"arbitrary number of positional arguments; bit ``0x08`` is set if the " +"function uses the ``**keywords`` syntax to accept arbitrary keyword " +"arguments; bit ``0x20`` is set if the function is a generator. See :ref:" +"`inspect-module-co-flags` for details on the semantics of each flags that " +"might be present." msgstr "" msgid "" "Future feature declarations (``from __future__ import division``) also use " -"bits in :attr:`co_flags` to indicate whether a code object was compiled with " -"a particular feature enabled: bit ``0x2000`` is set if the function was " -"compiled with future division enabled; bits ``0x10`` and ``0x1000`` were " -"used in earlier versions of Python." +"bits in :attr:`~codeobject.co_flags` to indicate whether a code object was " +"compiled with a particular feature enabled: bit ``0x2000`` is set if the " +"function was compiled with future division enabled; bits ``0x10`` and " +"``0x1000`` were used in earlier versions of Python." msgstr "" -msgid "Other bits in :attr:`co_flags` are reserved for internal use." +msgid "" +"Other bits in :attr:`~codeobject.co_flags` are reserved for internal use." msgstr "" msgid "" -"If a code object represents a function, the first item in :attr:`co_consts` " -"is the documentation string of the function, or ``None`` if undefined." +"If a code object represents a function, the first item in :attr:`~codeobject." +"co_consts` is the documentation string of the function, or ``None`` if " +"undefined." +msgstr "" + +msgid "Methods on code objects" msgstr "" msgid "" -"Returns an iterable over the source code positions of each bytecode " +"Returns an iterable over the source code positions of each :term:`bytecode` " "instruction in the code object." msgstr "" msgid "" -"The iterator returns tuples containing the ``(start_line, end_line, " -"start_column, end_column)``. The *i-th* tuple corresponds to the position of " -"the source code that compiled to the *i-th* instruction. Column information " -"is 0-indexed utf-8 byte offsets on the given source line." +"The iterator returns :class:`tuple`\\s containing the ``(start_line, " +"end_line, start_column, end_column)``. The *i-th* tuple corresponds to the " +"position of the source code that compiled to the *i-th* code unit. Column " +"information is 0-indexed utf-8 byte offsets on the given source line." msgstr "" msgid "" @@ -1096,58 +1183,138 @@ msgid "" "environment variable can be used." msgstr "" +msgid "" +"Returns an iterator that yields information about successive ranges of :term:" +"`bytecode`\\s. Each item yielded is a ``(start, end, lineno)`` :class:" +"`tuple`:" +msgstr "" + +msgid "" +"``start`` (an :class:`int`) represents the offset (inclusive) of the start " +"of the :term:`bytecode` range" +msgstr "" + +msgid "" +"``end`` (an :class:`int`) represents the offset (exclusive) of the end of " +"the :term:`bytecode` range" +msgstr "" + +msgid "" +"``lineno`` is an :class:`int` representing the line number of the :term:" +"`bytecode` range, or ``None`` if the bytecodes in the given range have no " +"line number" +msgstr "" + +msgid "The items yielded will have the following properties:" +msgstr "" + +msgid "The first range yielded will have a ``start`` of 0." +msgstr "" + +msgid "" +"The ``(start, end)`` ranges will be non-decreasing and consecutive. That is, " +"for any pair of :class:`tuple`\\s, the ``start`` of the second will be equal " +"to the ``end`` of the first." +msgstr "" + +msgid "No range will be backwards: ``end >= start`` for all triples." +msgstr "" + +msgid "" +"The last :class:`tuple` yielded will have ``end`` equal to the size of the :" +"term:`bytecode`." +msgstr "" + +msgid "" +"Zero-width ranges, where ``start == end``, are allowed. Zero-width ranges " +"are used for lines that are present in the source code, but have been " +"eliminated by the :term:`bytecode` compiler." +msgstr "" + +msgid ":pep:`626` - Precise line numbers for debugging and other tools." +msgstr "" + +msgid "The PEP that introduced the :meth:`!co_lines` method." +msgstr "" + +msgid "" +"Return a copy of the code object with new values for the specified fields." +msgstr "" + msgid "Frame objects" msgstr "" msgid "" -"Frame objects represent execution frames. They may occur in traceback " -"objects (see below), and are also passed to registered trace functions." +"Frame objects represent execution frames. They may occur in :ref:`traceback " +"objects `, and are also passed to registered trace " +"functions." msgstr "" msgid "" -"Special read-only attributes: :attr:`f_back` is to the previous stack frame " -"(towards the caller), or ``None`` if this is the bottom stack frame; :attr:" -"`f_code` is the code object being executed in this frame; :attr:`f_locals` " -"is the dictionary used to look up local variables; :attr:`f_globals` is used " -"for global variables; :attr:`f_builtins` is used for built-in (intrinsic) " -"names; :attr:`f_lasti` gives the precise instruction (this is an index into " -"the bytecode string of the code object)." +"Points to the previous stack frame (towards the caller), or ``None`` if this " +"is the bottom stack frame" msgstr "" msgid "" -"Accessing ``f_code`` raises an :ref:`auditing event ` ``object." +"The :ref:`code object ` being executed in this frame. " +"Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"f_code\"``." msgstr "" msgid "" -"Special writable attributes: :attr:`f_trace`, if not ``None``, is a function " -"called for various events during code execution (this is used by the " -"debugger). Normally an event is triggered for each new source line - this " -"can be disabled by setting :attr:`f_trace_lines` to :const:`False`." +"The dictionary used by the frame to look up :ref:`local variables `" +msgstr "" + +msgid "" +"The dictionary used by the frame to look up :ref:`global variables `" +msgstr "" + +msgid "" +"The dictionary used by the frame to look up :ref:`built-in (intrinsic) names " +"`" +msgstr "" + +msgid "" +"The \"precise instruction\" of the frame object (this is an index into the :" +"term:`bytecode` string of the :ref:`code object `)" +msgstr "" + +msgid "" +"If not ``None``, this is a function called for various events during code " +"execution (this is used by debuggers). Normally an event is triggered for " +"each new source line (see :attr:`~frame.f_trace_lines`)." msgstr "" msgid "" -"Implementations *may* allow per-opcode events to be requested by setting :" -"attr:`f_trace_opcodes` to :const:`True`. Note that this may lead to " -"undefined interpreter behaviour if exceptions raised by the trace function " -"escape to the function being traced." +"Set this attribute to :const:`False` to disable triggering a tracing event " +"for each source line." msgstr "" msgid "" -":attr:`f_lineno` is the current line number of the frame --- writing to this " -"from within a trace function jumps to the given line (only for the bottom-" -"most frame). A debugger can implement a Jump command (aka Set Next " -"Statement) by writing to f_lineno." +"Set this attribute to :const:`True` to allow per-opcode events to be " +"requested. Note that this may lead to undefined interpreter behaviour if " +"exceptions raised by the trace function escape to the function being traced." +msgstr "" + +msgid "" +"The current line number of the frame -- writing to this from within a trace " +"function jumps to the given line (only for the bottom-most frame). A " +"debugger can implement a Jump command (aka Set Next Statement) by writing to " +"this attribute." +msgstr "" + +msgid "Frame object methods" msgstr "" msgid "Frame objects support one method:" msgstr "" msgid "" -"This method clears all references to local variables held by the frame. " -"Also, if the frame belonged to a generator, the generator is finalized. " -"This helps break reference cycles involving frame objects (for example when " -"catching an exception and storing its traceback for later use)." +"This method clears all references to :ref:`local variables ` held by " +"the frame. Also, if the frame belonged to a :term:`generator`, the " +"generator is finalized. This helps break reference cycles involving frame " +"objects (for example when catching an :ref:`exception ` " +"and storing its :ref:`traceback ` for later use)." msgstr "" msgid ":exc:`RuntimeError` is raised if the frame is currently executing." @@ -1157,9 +1324,12 @@ msgid "Traceback objects" msgstr "" msgid "" -"Traceback objects represent a stack trace of an exception. A traceback " -"object is implicitly created when an exception occurs, and may also be " -"explicitly created by calling :class:`types.TracebackType`." +"Traceback objects represent the stack trace of an :ref:`exception `. A traceback object is implicitly created when an exception occurs, " +"and may also be explicitly created by calling :class:`types.TracebackType`." +msgstr "" + +msgid "Traceback objects can now be explicitly instantiated from Python code." msgstr "" msgid "" @@ -1167,45 +1337,53 @@ msgid "" "unwinds the execution stack, at each unwound level a traceback object is " "inserted in front of the current traceback. When an exception handler is " "entered, the stack trace is made available to the program. (See section :ref:" -"`try`.) It is accessible as the third item of the tuple returned by ``sys." -"exc_info()``, and as the ``__traceback__`` attribute of the caught exception." +"`try`.) It is accessible as the third item of the tuple returned by :func:" +"`sys.exc_info`, and as the :attr:`~BaseException.__traceback__` attribute of " +"the caught exception." msgstr "" msgid "" "When the program contains no suitable handler, the stack trace is written " "(nicely formatted) to the standard error stream; if the interpreter is " -"interactive, it is also made available to the user as ``sys.last_traceback``." +"interactive, it is also made available to the user as :data:`sys." +"last_traceback`." msgstr "" msgid "" "For explicitly created tracebacks, it is up to the creator of the traceback " -"to determine how the ``tb_next`` attributes should be linked to form a full " -"stack trace." +"to determine how the :attr:`~traceback.tb_next` attributes should be linked " +"to form a full stack trace." msgstr "" msgid "" -"Special read-only attributes: :attr:`tb_frame` points to the execution frame " -"of the current level; :attr:`tb_lineno` gives the line number where the " -"exception occurred; :attr:`tb_lasti` indicates the precise instruction. The " -"line number and last instruction in the traceback may differ from the line " -"number of its frame object if the exception occurred in a :keyword:`try` " -"statement with no matching except clause or with a finally clause." +"Points to the execution :ref:`frame ` of the current level." msgstr "" msgid "" -"Accessing ``tb_frame`` raises an :ref:`auditing event ` ``object." +"Accessing this attribute raises an :ref:`auditing event ` ``object." "__getattr__`` with arguments ``obj`` and ``\"tb_frame\"``." msgstr "" +msgid "Gives the line number where the exception occurred" +msgstr "" + +msgid "Indicates the \"precise instruction\"." +msgstr "" + msgid "" -"Special writable attribute: :attr:`tb_next` is the next level in the stack " -"trace (towards the frame where the exception occurred), or ``None`` if there " -"is no next level." +"The line number and last instruction in the traceback may differ from the " +"line number of its :ref:`frame object ` if the exception " +"occurred in a :keyword:`try` statement with no matching except clause or " +"with a :keyword:`finally` clause." msgstr "" msgid "" -"Traceback objects can now be explicitly instantiated from Python code, and " -"the ``tb_next`` attribute of existing instances can be updated." +"The special writable attribute :attr:`!tb_next` is the next level in the " +"stack trace (towards the frame where the exception occurred), or ``None`` if " +"there is no next level." +msgstr "" + +msgid "This attribute is now writable" msgstr "" msgid "Slice objects" @@ -1254,8 +1432,9 @@ msgid "" "A class method object, like a static method object, is a wrapper around " "another object that alters the way in which that object is retrieved from " "classes and class instances. The behaviour of class method objects upon such " -"retrieval is described above, under \"User-defined methods\". Class method " -"objects are created by the built-in :func:`classmethod` constructor." +"retrieval is described above, under :ref:`\"instance methods\" `. Class method objects are created by the built-in :func:" +"`classmethod` constructor." msgstr "" msgid "Special method names" @@ -1487,8 +1666,8 @@ msgid "" msgstr "" msgid "" -"A rich comparison method may return the singleton ``NotImplemented`` if it " -"does not implement the operation for a given pair of arguments. By " +"A rich comparison method may return the singleton :data:`NotImplemented` if " +"it does not implement the operation for a given pair of arguments. By " "convention, ``False`` and ``True`` are returned for a successful comparison. " "However, these methods can return any value, so if the comparison operator " "is used in a Boolean context (e.g., in the condition of an ``if`` " @@ -1497,11 +1676,11 @@ msgid "" msgstr "" msgid "" -"By default, ``object`` implements :meth:`__eq__` by using ``is``, returning " -"``NotImplemented`` in the case of a false comparison: ``True if x is y else " -"NotImplemented``. For :meth:`__ne__`, by default it delegates to :meth:" -"`__eq__` and inverts the result unless it is ``NotImplemented``. There are " -"no other implied relationships among the comparison operators or default " +"By default, ``object`` implements :meth:`__eq__` by using ``is``, returning :" +"data:`NotImplemented` in the case of a false comparison: ``True if x is y " +"else NotImplemented``. For :meth:`__ne__`, by default it delegates to :meth:" +"`__eq__` and inverts the result unless it is :data:`!NotImplemented`. There " +"are no other implied relationships among the comparison operators or default " "implementations; for example, the truth of ``(x`. See :ref:`special-lookup`." msgstr "" msgid "" @@ -1716,8 +1901,8 @@ msgid "" msgstr "" msgid "" -"Called when :func:`dir` is called on the object. A sequence must be " -"returned. :func:`dir` converts the returned sequence to a list and sorts it." +"Called when :func:`dir` is called on the object. An iterable must be " +"returned. :func:`dir` converts the returned iterable to a list and sorts it." msgstr "" msgid "Customizing module attribute access" @@ -1735,7 +1920,7 @@ msgid "" msgstr "" msgid "" -"The ``__dir__`` function should accept no arguments, and return a sequence " +"The ``__dir__`` function should accept no arguments, and return an iterable " "of strings that represents the names accessible on module. If present, this " "function overrides the standard :func:`dir` search on a module." msgstr "" @@ -1815,7 +2000,12 @@ msgid "" msgstr "" msgid "" -"The attribute :attr:`__objclass__` is interpreted by the :mod:`inspect` " +"Instances of descriptors may also have the :attr:`!__objclass__` attribute " +"present:" +msgstr "" + +msgid "" +"The attribute :attr:`!__objclass__` is interpreted by the :mod:`inspect` " "module as specifying the class where this object was defined (setting this " "appropriately can assist in runtime introspection of dynamic class " "attributes). For callables, it may indicate that an instance of the given " @@ -1891,16 +2081,17 @@ msgid "" "For instance bindings, the precedence of descriptor invocation depends on " "which descriptor methods are defined. A descriptor can define any " "combination of :meth:`~object.__get__`, :meth:`~object.__set__` and :meth:" -"`~object.__delete__`. If it does not define :meth:`__get__`, then accessing " -"the attribute will return the descriptor object itself unless there is a " -"value in the object's instance dictionary. If the descriptor defines :meth:" -"`__set__` and/or :meth:`__delete__`, it is a data descriptor; if it defines " -"neither, it is a non-data descriptor. Normally, data descriptors define " -"both :meth:`__get__` and :meth:`__set__`, while non-data descriptors have " -"just the :meth:`__get__` method. Data descriptors with :meth:`__get__` and :" -"meth:`__set__` (and/or :meth:`__delete__`) defined always override a " -"redefinition in an instance dictionary. In contrast, non-data descriptors " -"can be overridden by instances." +"`~object.__delete__`. If it does not define :meth:`!__get__`, then " +"accessing the attribute will return the descriptor object itself unless " +"there is a value in the object's instance dictionary. If the descriptor " +"defines :meth:`!__set__` and/or :meth:`!__delete__`, it is a data " +"descriptor; if it defines neither, it is a non-data descriptor. Normally, " +"data descriptors define both :meth:`!__get__` and :meth:`!__set__`, while " +"non-data descriptors have just the :meth:`!__get__` method. Data " +"descriptors with :meth:`!__get__` and :meth:`!__set__` (and/or :meth:`!" +"__delete__`) defined always override a redefinition in an instance " +"dictionary. In contrast, non-data descriptors can be overridden by " +"instances." msgstr "" msgid "" @@ -1917,7 +2108,7 @@ msgid "" msgstr "" msgid "__slots__" -msgstr "" +msgstr "__slots__" msgid "" "*__slots__* allow us to explicitly declare data members (like properties) " @@ -1937,7 +2128,7 @@ msgid "" "`~object.__dict__` and *__weakref__* for each instance." msgstr "" -msgid "Notes on using *__slots__*" +msgid "Notes on using *__slots__*:" msgstr "" msgid "" @@ -2038,8 +2229,8 @@ msgid "" msgstr "" msgid "" -"Keyword arguments which are given to a new class are passed to the parent's " -"class ``__init_subclass__``. For compatibility with other classes using " +"Keyword arguments which are given to a new class are passed to the parent " +"class's ``__init_subclass__``. For compatibility with other classes using " "``__init_subclass__``, one should take out the needed keyword arguments and " "pass the others over to the base class, as in::" msgstr "" @@ -2129,13 +2320,13 @@ msgid "" msgstr "" msgid ":func:`types.resolve_bases`" -msgstr "" +msgstr ":func:`types.resolve_bases`" msgid "Dynamically resolve bases that are not instances of :class:`type`." msgstr "" msgid ":pep:`560`" -msgstr "" +msgstr ":pep:`560`" msgid "Core support for typing module and generic types." msgstr "" @@ -2471,51 +2662,51 @@ msgid "" "a mapping; the difference is that for a sequence, the allowable keys should " "be the integers *k* for which ``0 <= k < N`` where *N* is the length of the " "sequence, or :class:`slice` objects, which define a range of items. It is " -"also recommended that mappings provide the methods :meth:`keys`, :meth:" -"`values`, :meth:`items`, :meth:`get`, :meth:`clear`, :meth:`setdefault`, :" -"meth:`pop`, :meth:`popitem`, :meth:`!copy`, and :meth:`update` behaving " +"also recommended that mappings provide the methods :meth:`!keys`, :meth:`!" +"values`, :meth:`!items`, :meth:`!get`, :meth:`!clear`, :meth:`!setdefault`, :" +"meth:`!pop`, :meth:`!popitem`, :meth:`!copy`, and :meth:`!update` behaving " "similar to those for Python's standard :class:`dictionary ` objects. " "The :mod:`collections.abc` module provides a :class:`~collections.abc." "MutableMapping` :term:`abstract base class` to help create those methods " "from a base set of :meth:`~object.__getitem__`, :meth:`~object." -"__setitem__`, :meth:`~object.__delitem__`, and :meth:`keys`. Mutable " -"sequences should provide methods :meth:`append`, :meth:`count`, :meth:" -"`index`, :meth:`extend`, :meth:`insert`, :meth:`pop`, :meth:`remove`, :meth:" -"`reverse` and :meth:`sort`, like Python standard :class:`list` objects. " -"Finally, sequence types should implement addition (meaning concatenation) " -"and multiplication (meaning repetition) by defining the methods :meth:" -"`~object.__add__`, :meth:`~object.__radd__`, :meth:`~object.__iadd__`, :meth:" -"`~object.__mul__`, :meth:`~object.__rmul__` and :meth:`~object.__imul__` " -"described below; they should not define other numerical operators. It is " -"recommended that both mappings and sequences implement the :meth:`~object." -"__contains__` method to allow efficient use of the ``in`` operator; for " -"mappings, ``in`` should search the mapping's keys; for sequences, it should " -"search through the values. It is further recommended that both mappings and " -"sequences implement the :meth:`~object.__iter__` method to allow efficient " -"iteration through the container; for mappings, :meth:`__iter__` should " -"iterate through the object's keys; for sequences, it should iterate through " -"the values." +"__setitem__`, :meth:`~object.__delitem__`, and :meth:`!keys`. Mutable " +"sequences should provide methods :meth:`!append`, :meth:`!count`, :meth:`!" +"index`, :meth:`!extend`, :meth:`!insert`, :meth:`!pop`, :meth:`!remove`, :" +"meth:`!reverse` and :meth:`!sort`, like Python standard :class:`list` " +"objects. Finally, sequence types should implement addition (meaning " +"concatenation) and multiplication (meaning repetition) by defining the " +"methods :meth:`~object.__add__`, :meth:`~object.__radd__`, :meth:`~object." +"__iadd__`, :meth:`~object.__mul__`, :meth:`~object.__rmul__` and :meth:" +"`~object.__imul__` described below; they should not define other numerical " +"operators. It is recommended that both mappings and sequences implement " +"the :meth:`~object.__contains__` method to allow efficient use of the ``in`` " +"operator; for mappings, ``in`` should search the mapping's keys; for " +"sequences, it should search through the values. It is further recommended " +"that both mappings and sequences implement the :meth:`~object.__iter__` " +"method to allow efficient iteration through the container; for mappings, :" +"meth:`!__iter__` should iterate through the object's keys; for sequences, it " +"should iterate through the values." msgstr "" msgid "" "Called to implement the built-in function :func:`len`. Should return the " "length of the object, an integer ``>=`` 0. Also, an object that doesn't " -"define a :meth:`__bool__` method and whose :meth:`__len__` method returns " -"zero is considered to be false in a Boolean context." +"define a :meth:`~object.__bool__` method and whose :meth:`!__len__` method " +"returns zero is considered to be false in a Boolean context." msgstr "" msgid "" -"In CPython, the length is required to be at most :attr:`sys.maxsize`. If the " -"length is larger than :attr:`!sys.maxsize` some features (such as :func:" +"In CPython, the length is required to be at most :data:`sys.maxsize`. If the " +"length is larger than :data:`!sys.maxsize` some features (such as :func:" "`len`) may raise :exc:`OverflowError`. To prevent raising :exc:`!" "OverflowError` by truth value testing, an object must define a :meth:" -"`__bool__` method." +"`~object.__bool__` method." msgstr "" msgid "" "Called to implement :func:`operator.length_hint`. Should return an estimated " "length for the object (which may be greater or less than the actual length). " -"The length must be an integer ``>=`` 0. The return value may also be :const:" +"The length must be an integer ``>=`` 0. The return value may also be :data:" "`NotImplemented`, which is treated the same as if the ``__length_hint__`` " "method didn't exist at all. This method is purely an optimization and is " "never required for correctness." @@ -2533,11 +2724,10 @@ msgstr "" msgid "" "Called to implement evaluation of ``self[key]``. For :term:`sequence` types, " -"the accepted keys should be integers and slice objects. Note that the " -"special interpretation of negative indexes (if the class wishes to emulate " -"a :term:`sequence` type) is up to the :meth:`__getitem__` method. If *key* " -"is of an inappropriate type, :exc:`TypeError` may be raised; if of a value " -"outside the set of indexes for the sequence (after any special " +"the accepted keys should be integers. Optionally, they may support :class:" +"`slice` objects as well. Negative index support is also optional. If *key* " +"is of an inappropriate type, :exc:`TypeError` may be raised; if *key* is a " +"value outside the set of indexes for the sequence (after any special " "interpretation of negative values), :exc:`IndexError` should be raised. For :" "term:`mapping` types, if *key* is missing (not in the container), :exc:" "`KeyError` should be raised." @@ -2641,7 +2831,7 @@ msgstr "" msgid "" "If one of those methods does not support the operation with the supplied " -"arguments, it should return ``NotImplemented``." +"arguments, it should return :data:`NotImplemented`." msgstr "" msgid "" @@ -2652,8 +2842,8 @@ msgid "" "support the corresponding operation [#]_ and the operands are of different " "types. [#]_ For instance, to evaluate the expression ``x - y``, where *y* is " "an instance of a class that has an :meth:`__rsub__` method, ``type(y)." -"__rsub__(y, x)`` is called if ``type(x).__sub__(x, y)`` returns " -"*NotImplemented*." +"__rsub__(y, x)`` is called if ``type(x).__sub__(x, y)`` returns :data:" +"`NotImplemented`." msgstr "" msgid "" @@ -2674,14 +2864,16 @@ msgid "" "(``+=``, ``-=``, ``*=``, ``@=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, " "``>>=``, ``&=``, ``^=``, ``|=``). These methods should attempt to do the " "operation in-place (modifying *self*) and return the result (which could be, " -"but does not have to be, *self*). If a specific method is not defined, the " -"augmented assignment falls back to the normal methods. For instance, if *x* " -"is an instance of a class with an :meth:`__iadd__` method, ``x += y`` is " -"equivalent to ``x = x.__iadd__(y)`` . Otherwise, ``x.__add__(y)`` and ``y." -"__radd__(x)`` are considered, as with the evaluation of ``x + y``. In " -"certain situations, augmented assignment can result in unexpected errors " -"(see :ref:`faq-augmented-assignment-tuple-error`), but this behavior is in " -"fact part of the data model." +"but does not have to be, *self*). If a specific method is not defined, or " +"if that method returns :data:`NotImplemented`, the augmented assignment " +"falls back to the normal methods. For instance, if *x* is an instance of a " +"class with an :meth:`__iadd__` method, ``x += y`` is equivalent to ``x = x." +"__iadd__(y)`` . If :meth:`__iadd__` does not exist, or if ``x.__iadd__(y)`` " +"returns :data:`!NotImplemented`, ``x.__add__(y)`` and ``y.__radd__(x)`` are " +"considered, as with the evaluation of ``x + y``. In certain situations, " +"augmented assignment can result in unexpected errors (see :ref:`faq-" +"augmented-assignment-tuple-error`), but this behavior is in fact part of the " +"data model." msgstr "" msgid "" @@ -2765,7 +2957,7 @@ msgid "" msgstr "" msgid "" -"Note that :meth:`__exit__` methods should not reraise the passed-in " +"Note that :meth:`~object.__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" @@ -2910,7 +3102,7 @@ msgid "" "__await__`. If *value* is not ``None``, this method delegates to the :meth:" "`~generator.send` method of the iterator that caused the coroutine to " "suspend. The result (return value, :exc:`StopIteration`, or other " -"exception) is the same as when iterating over the :meth:`__await__` return " +"exception) is the same as when iterating over the :meth:`!__await__` return " "value, described above." msgstr "" @@ -2987,13 +3179,13 @@ msgid "" msgstr "" msgid "" -"Semantically similar to :meth:`__enter__`, the only difference being that it " -"must return an *awaitable*." +"Semantically similar to :meth:`~object.__enter__`, the only difference being " +"that it must return an *awaitable*." msgstr "" msgid "" -"Semantically similar to :meth:`__exit__`, the only difference being that it " -"must return an *awaitable*." +"Semantically similar to :meth:`~object.__exit__`, the only difference being " +"that it must return an *awaitable*." msgstr "" msgid "An example of an asynchronous context manager class::" @@ -3017,8 +3209,8 @@ msgstr "" msgid "" "\"Does not support\" here means that the class has no such method, or the " -"method returns ``NotImplemented``. Do not set the method to ``None`` if you " -"want to force fallback to the right operand's reflected method—that will " +"method returns :data:`NotImplemented`. Do not set the method to ``None`` if " +"you want to force fallback to the right operand's reflected method—that will " "instead have the opposite effect of explicitly *blocking* such fallback." msgstr "" @@ -3029,19 +3221,19 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "data" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "id" msgstr "" msgid "type" -msgstr "" +msgstr "typ" msgid "identity of an object" msgstr "" @@ -3059,7 +3251,7 @@ msgid "immutable object" msgstr "" msgid "garbage collection" -msgstr "" +msgstr "zbieranie śmieci" msgid "reference counting" msgstr "" @@ -3080,7 +3272,7 @@ msgid "module" msgstr "moduł" msgid "C" -msgstr "" +msgstr "C" msgid "language" msgstr "" @@ -3089,16 +3281,16 @@ msgid "attribute" msgstr "atrybut" msgid "special" -msgstr "" +msgstr "specjalne" msgid "generic" msgstr "" msgid "..." -msgstr "" +msgstr "..." msgid "ellipsis literal" -msgstr "" +msgstr "Literalny zapis wielokropka" msgid "numeric" msgstr "" @@ -3106,18 +3298,18 @@ msgstr "" msgid "integer" msgstr "" -msgid "Boolean" +msgid "representation" msgstr "" +msgid "Boolean" +msgstr "Wartość logiczna" + msgid "False" msgstr "" msgid "True" msgstr "" -msgid "representation" -msgstr "" - msgid "floating point" msgstr "" @@ -3131,10 +3323,10 @@ msgid "complex" msgstr "" msgid "len" -msgstr "" +msgstr "len" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "index operation" msgstr "" @@ -3155,7 +3347,7 @@ msgid "immutable" msgstr "" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "immutable sequences" msgstr "" @@ -3173,7 +3365,7 @@ msgid "Unicode" msgstr "" msgid "tuple" -msgstr "" +msgstr "tuple" msgid "singleton" msgstr "" @@ -3199,20 +3391,23 @@ msgstr "" msgid "statement" msgstr "instrukcja" -msgid "list" +msgid "array" msgstr "" -msgid "bytearray" +msgid "collections" msgstr "" -msgid "array" +msgid "list" +msgstr "lista" + +msgid "bytearray" msgstr "" msgid "set type" msgstr "" msgid "set" -msgstr "" +msgstr "zestaw" msgid "frozenset" msgstr "" @@ -3221,7 +3416,7 @@ msgid "mapping" msgstr "" msgid "dictionary" -msgstr "" +msgstr "słownik" msgid "dbm.ndbm" msgstr "" @@ -3242,7 +3437,7 @@ msgid "invocation" msgstr "" msgid "argument" -msgstr "" +msgstr "argument" msgid "user-defined" msgstr "" @@ -3250,44 +3445,44 @@ msgstr "" msgid "user-defined function" msgstr "" -msgid "__doc__ (function attribute)" +msgid "__closure__ (function attribute)" msgstr "" -msgid "__name__ (function attribute)" +msgid "__globals__ (function attribute)" msgstr "" -msgid "__module__ (function attribute)" +msgid "global" msgstr "" -msgid "__dict__ (function attribute)" +msgid "namespace" msgstr "" -msgid "__defaults__ (function attribute)" +msgid "__doc__ (function attribute)" msgstr "" -msgid "__closure__ (function attribute)" +msgid "__name__ (function attribute)" msgstr "" -msgid "__code__ (function attribute)" +msgid "__module__ (function attribute)" msgstr "" -msgid "__globals__ (function attribute)" +msgid "__dict__ (function attribute)" msgstr "" -msgid "__annotations__ (function attribute)" +msgid "__defaults__ (function attribute)" msgstr "" -msgid "__kwdefaults__ (function attribute)" +msgid "__code__ (function attribute)" msgstr "" -msgid "global" +msgid "__annotations__ (function attribute)" msgstr "" -msgid "namespace" +msgid "__kwdefaults__ (function attribute)" msgstr "" msgid "method" -msgstr "" +msgstr "metoda" msgid "user-defined method" msgstr "" @@ -3308,10 +3503,10 @@ msgid "__module__ (method attribute)" msgstr "" msgid "generator" -msgstr "" +msgstr "generator" msgid "iterator" -msgstr "" +msgstr "iterator" msgid "coroutine" msgstr "" @@ -3329,7 +3524,7 @@ msgid "built-in" msgstr "" msgid "import" -msgstr "" +msgstr "import" msgid "__name__ (module attribute)" msgstr "" @@ -3347,7 +3542,7 @@ msgid "__dict__ (module attribute)" msgstr "" msgid "class" -msgstr "" +msgstr "klasa" msgid "class instance" msgstr "" @@ -3383,7 +3578,7 @@ msgid "__class__ (instance attribute)" msgstr "" msgid "open" -msgstr "" +msgstr "otwórz" msgid "io" msgstr "" @@ -3614,7 +3809,7 @@ msgid "__str__() (object method)" msgstr "" msgid "format() (built-in function)" -msgstr "" +msgstr "format() (wbudowana funkcja)" msgid "print() (built-in function)" msgstr "" @@ -3647,7 +3842,7 @@ msgid "__class__ (module attribute)" msgstr "" msgid "metaclass" -msgstr "" +msgstr "metaklasa" msgid "= (equals)" msgstr "" diff --git a/reference/executionmodel.po b/reference/executionmodel.po index 28b2008a32..79715832d3 100644 --- a/reference/executionmodel.po +++ b/reference/executionmodel.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:19+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -326,7 +325,7 @@ msgid "scope" msgstr "" msgid "name" -msgstr "" +msgstr "nazwa" msgid "binding" msgstr "" @@ -356,7 +355,7 @@ msgid "module" msgstr "moduł" msgid "__main__" -msgstr "" +msgstr "__main__" msgid "restricted" msgstr "" diff --git a/reference/expressions.po b/reference/expressions.po index 2b29ac1499..9e91eba863 100644 --- a/reference/expressions.po +++ b/reference/expressions.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2023 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -272,27 +272,27 @@ msgid "Dictionary displays" msgstr "" msgid "" -"A dictionary display is a possibly empty series of key/datum pairs enclosed " -"in curly braces:" +"A dictionary display is a possibly empty series of dict items (key/value " +"pairs) enclosed in curly braces:" msgstr "" msgid "A dictionary display yields a new dictionary object." msgstr "" msgid "" -"If a comma-separated sequence of key/datum pairs is given, they are " -"evaluated from left to right to define the entries of the dictionary: each " -"key object is used as a key into the dictionary to store the corresponding " -"datum. This means that you can specify the same key multiple times in the " -"key/datum list, and the final dictionary's value for that key will be the " -"last one given." +"If a comma-separated sequence of dict items is given, they are evaluated " +"from left to right to define the entries of the dictionary: each key object " +"is used as a key into the dictionary to store the corresponding value. This " +"means that you can specify the same key multiple times in the dict item " +"list, and the final dictionary's value for that key will be the last one " +"given." msgstr "" msgid "" "A double asterisk ``**`` denotes :dfn:`dictionary unpacking`. Its operand " "must be a :term:`mapping`. Each mapping item is added to the new " -"dictionary. Later values replace values already set by earlier key/datum " -"pairs and earlier dictionary unpackings." +"dictionary. Later values replace values already set by earlier dict items " +"and earlier dictionary unpackings." msgstr "" msgid "Unpacking into dictionary displays, originally proposed by :pep:`448`." @@ -309,7 +309,7 @@ msgid "" "Restrictions on the types of the key values are listed earlier in section :" "ref:`types`. (To summarize, the key type should be :term:`hashable`, which " "excludes all mutable objects.) Clashes between duplicate keys are not " -"detected; the last datum (textually rightmost in the display) stored for a " +"detected; the last value (textually rightmost in the display) stored for a " "given key value prevails." msgstr "" @@ -742,11 +742,21 @@ msgstr "" msgid "" "The primary must evaluate to an object of a type that supports attribute " "references, which most objects do. This object is then asked to produce the " -"attribute whose name is the identifier. This production can be customized " -"by overriding the :meth:`__getattr__` method. If this attribute is not " -"available, the exception :exc:`AttributeError` is raised. Otherwise, the " -"type and value of the object produced is determined by the object. Multiple " -"evaluations of the same attribute reference may yield different objects." +"attribute whose name is the identifier. The type and value produced is " +"determined by the object. Multiple evaluations of the same attribute " +"reference may yield different objects." +msgstr "" + +msgid "" +"This production can be customized by overriding the :meth:`~object." +"__getattribute__` method or the :meth:`~object.__getattr__` method. The :" +"meth:`!__getattribute__` method is called first and either returns a value " +"or raises :exc:`AttributeError` if the attribute is not available." +msgstr "" + +msgid "" +"If an :exc:`AttributeError` is raised and the object has a :meth:`!" +"__getattr__` method, that method is called as a fallback." msgstr "" msgid "Subscriptions" @@ -806,9 +816,9 @@ msgid "" "the last item of ``x``. The resulting value must be a nonnegative integer " "less than the number of items in the sequence, and the subscription selects " "the item whose index is that value (counting from zero). Since the support " -"for negative indices and slicing occurs in the object's :meth:`__getitem__` " -"method, subclasses overriding this method will need to explicitly add that " -"support." +"for negative indices and slicing occurs in the object's :meth:`~object." +"__getitem__` method, subclasses overriding this method will need to " +"explicitly add that support." msgstr "" msgid "" @@ -837,16 +847,16 @@ msgstr "" msgid "" "The semantics for a slicing are as follows. The primary is indexed (using " -"the same :meth:`__getitem__` method as normal subscription) with a key that " -"is constructed from the slice list, as follows. If the slice list contains " -"at least one comma, the key is a tuple containing the conversion of the " -"slice items; otherwise, the conversion of the lone slice item is the key. " -"The conversion of a slice item that is an expression is that expression. " -"The conversion of a proper slice is a slice object (see section :ref:" -"`types`) whose :attr:`~slice.start`, :attr:`~slice.stop` and :attr:`~slice." -"step` attributes are the values of the expressions given as lower bound, " -"upper bound and stride, respectively, substituting ``None`` for missing " -"expressions." +"the same :meth:`~object.__getitem__` method as normal subscription) with a " +"key that is constructed from the slice list, as follows. If the slice list " +"contains at least one comma, the key is a tuple containing the conversion of " +"the slice items; otherwise, the conversion of the lone slice item is the " +"key. The conversion of a slice item that is an expression is that " +"expression. The conversion of a proper slice is a slice object (see " +"section :ref:`types`) whose :attr:`~slice.start`, :attr:`~slice.stop` and :" +"attr:`~slice.step` attributes are the values of the expressions given as " +"lower bound, upper bound and stride, respectively, substituting ``None`` for " +"missing expressions." msgstr "" msgid "Calls" @@ -865,8 +875,8 @@ msgstr "" msgid "" "The primary must evaluate to a callable object (user-defined functions, " "built-in functions, methods of built-in objects, class objects, methods of " -"class instances, and all objects having a :meth:`__call__` method are " -"callable). All argument expressions are evaluated before the call is " +"class instances, and all objects having a :meth:`~object.__call__` method " +"are callable). All argument expressions are evaluated before the call is " "attempted. Please refer to section :ref:`function` for the syntax of " "formal :term:`parameter` lists." msgstr "" @@ -1013,8 +1023,8 @@ msgid "a class instance:" msgstr "" msgid "" -"The class must define a :meth:`__call__` method; the effect is then the same " -"as if that method was called." +"The class must define a :meth:`~object.__call__` method; the effect is then " +"the same as if that method was called." msgstr "" msgid "Await expression" @@ -1060,7 +1070,8 @@ msgid "" msgstr "" msgid "" -"This operation can be customized using the special :meth:`__pow__` method." +"This operation can be customized using the special :meth:`~object.__pow__` " +"method." msgstr "" msgid "Unary arithmetic and bitwise operations" @@ -1071,20 +1082,20 @@ msgstr "" msgid "" "The unary ``-`` (minus) operator yields the negation of its numeric " -"argument; the operation can be overridden with the :meth:`__neg__` special " -"method." +"argument; the operation can be overridden with the :meth:`~object.__neg__` " +"special method." msgstr "" msgid "" "The unary ``+`` (plus) operator yields its numeric argument unchanged; the " -"operation can be overridden with the :meth:`__pos__` special method." +"operation can be overridden with the :meth:`~object.__pos__` special method." msgstr "" msgid "" "The unary ``~`` (invert) operator yields the bitwise inversion of its " "integer argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. " "It only applies to integral numbers or to custom objects that override the :" -"meth:`__invert__` special method." +"meth:`~object.__invert__` special method." msgstr "" msgid "" @@ -1112,8 +1123,8 @@ msgid "" msgstr "" msgid "" -"This operation can be customized using the special :meth:`__mul__` and :meth:" -"`__rmul__` methods." +"This operation can be customized using the special :meth:`~object.__mul__` " +"and :meth:`~object.__rmul__` methods." msgstr "" msgid "" @@ -1131,8 +1142,8 @@ msgid "" msgstr "" msgid "" -"This operation can be customized using the special :meth:`__truediv__` and :" -"meth:`__floordiv__` methods." +"This operation can be customized using the special :meth:`~object." +"__truediv__` and :meth:`~object.__floordiv__` methods." msgstr "" msgid "" @@ -1162,8 +1173,8 @@ msgid "" msgstr "" msgid "" -"The *modulo* operation can be customized using the special :meth:`__mod__` " -"method." +"The *modulo* operation can be customized using the special :meth:`~object." +"__mod__` method." msgstr "" msgid "" @@ -1180,8 +1191,8 @@ msgid "" msgstr "" msgid "" -"This operation can be customized using the special :meth:`__add__` and :meth:" -"`__radd__` methods." +"This operation can be customized using the special :meth:`~object.__add__` " +"and :meth:`~object.__radd__` methods." msgstr "" msgid "" @@ -1190,7 +1201,8 @@ msgid "" msgstr "" msgid "" -"This operation can be customized using the special :meth:`__sub__` method." +"This operation can be customized using the special :meth:`~object.__sub__` " +"method." msgstr "" msgid "Shifting operations" @@ -1206,8 +1218,8 @@ msgid "" msgstr "" msgid "" -"This operation can be customized using the special :meth:`__lshift__` and :" -"meth:`__rshift__` methods." +"This operation can be customized using the special :meth:`~object." +"__lshift__` and :meth:`~object.__rshift__` methods." msgstr "" msgid "" @@ -1223,20 +1235,20 @@ msgstr "" msgid "" "The ``&`` operator yields the bitwise AND of its arguments, which must be " -"integers or one of them must be a custom object overriding :meth:`__and__` " -"or :meth:`__rand__` special methods." +"integers or one of them must be a custom object overriding :meth:`~object." +"__and__` or :meth:`~object.__rand__` special methods." msgstr "" msgid "" "The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, " "which must be integers or one of them must be a custom object overriding :" -"meth:`__xor__` or :meth:`__rxor__` special methods." +"meth:`~object.__xor__` or :meth:`~object.__rxor__` special methods." msgstr "" msgid "" "The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which " "must be integers or one of them must be a custom object overriding :meth:" -"`__or__` or :meth:`__ror__` special methods." +"`~object.__or__` or :meth:`~object.__ror__` special methods." msgstr "" msgid "Comparisons" @@ -1298,7 +1310,7 @@ msgid "" "Because all types are (direct or indirect) subtypes of :class:`object`, they " "inherit the default comparison behavior from :class:`object`. Types can " "customize their comparison behavior by implementing :dfn:`rich comparison " -"methods` like :meth:`__lt__`, described in :ref:`customization`." +"methods` like :meth:`~object.__lt__`, described in :ref:`customization`." msgstr "" msgid "" @@ -1348,7 +1360,7 @@ msgid "" msgstr "" msgid "" -"``None`` and ``NotImplemented`` are singletons. :PEP:`8` advises that " +"``None`` and :data:`NotImplemented` are singletons. :PEP:`8` advises that " "comparisons for singletons should always be done with ``is`` or ``is not``, " "never the equality operators." msgstr "" @@ -1526,25 +1538,25 @@ msgid "" msgstr "" msgid "" -"For user-defined classes which define the :meth:`__contains__` method, ``x " -"in y`` returns ``True`` if ``y.__contains__(x)`` returns a true value, and " -"``False`` otherwise." +"For user-defined classes which define the :meth:`~object.__contains__` " +"method, ``x in y`` returns ``True`` if ``y.__contains__(x)`` returns a true " +"value, and ``False`` otherwise." msgstr "" msgid "" -"For user-defined classes which do not define :meth:`__contains__` but do " -"define :meth:`__iter__`, ``x in y`` is ``True`` if some value ``z``, for " -"which the expression ``x is z or x == z`` is true, is produced while " -"iterating over ``y``. If an exception is raised during the iteration, it is " -"as if :keyword:`in` raised that exception." +"For user-defined classes which do not define :meth:`~object.__contains__` " +"but do define :meth:`~object.__iter__`, ``x in y`` is ``True`` if some value " +"``z``, for which the expression ``x is z or x == z`` is true, is produced " +"while iterating over ``y``. If an exception is raised during the iteration, " +"it is as if :keyword:`in` raised that exception." msgstr "" msgid "" "Lastly, the old-style iteration protocol is tried: if a class defines :meth:" -"`__getitem__`, ``x in y`` is ``True`` if and only if there is a non-negative " -"integer index *i* such that ``x is y[i] or x == y[i]``, and no lower integer " -"index raises the :exc:`IndexError` exception. (If any other exception is " -"raised, it is as if :keyword:`in` raised that exception)." +"`~object.__getitem__`, ``x in y`` is ``True`` if and only if there is a non-" +"negative integer index *i* such that ``x is y[i] or x == y[i]``, and no " +"lower integer index raises the :exc:`IndexError` exception. (If any other " +"exception is raised, it is as if :keyword:`in` raised that exception)." msgstr "" msgid "" @@ -1571,8 +1583,8 @@ msgid "" "``False``, ``None``, numeric zero of all types, and empty strings and " "containers (including strings, tuples, lists, dictionaries, sets and " "frozensets). All other values are interpreted as true. User-defined " -"objects can customize their truth value by providing a :meth:`__bool__` " -"method." +"objects can customize their truth value by providing a :meth:`~object." +"__bool__` method." msgstr "" msgid "" @@ -1617,11 +1629,12 @@ msgid "Or, when processing a file stream in chunks:" msgstr "" msgid "" -"Assignment expressions must be surrounded by parentheses when used as sub-" -"expressions in slicing, conditional, lambda, keyword-argument, and " -"comprehension-if expressions and in ``assert`` and ``with`` statements. In " -"all other places where they can be used, parentheses are not required, " -"including in ``if`` and ``while`` statements." +"Assignment expressions must be surrounded by parentheses when used as " +"expression statements and when used as sub-expressions in slicing, " +"conditional, lambda, keyword-argument, and comprehension-if expressions and " +"in ``assert``, ``with``, and ``assignment`` statements. In all other places " +"where they can be used, parentheses are not required, including in ``if`` " +"and ``while`` statements." msgstr "" msgid "See :pep:`572` for more details about assignment expressions." @@ -1681,11 +1694,11 @@ msgid "" msgstr "" msgid "" -"The trailing comma is required only to create a single tuple (a.k.a. a " -"*singleton*); it is optional in all other cases. A single expression " -"without a trailing comma doesn't create a tuple, but rather yields the value " -"of that expression. (To create an empty tuple, use an empty pair of " -"parentheses: ``()``.)" +"A trailing comma is required only to create a one-item tuple, such as ``1," +"``; it is optional in all other cases. A single expression without a " +"trailing comma doesn't create a tuple, but rather yields the value of that " +"expression. (To create an empty tuple, use an empty pair of parentheses: " +"``()``.)" msgstr "" msgid "Evaluation order" @@ -1747,19 +1760,19 @@ msgid ":keyword:`await x `" msgstr "" msgid "``**``" -msgstr "" +msgstr "``**``" msgid "Exponentiation [#]_" msgstr "" msgid "``+x``, ``-x``, ``~x``" -msgstr "" +msgstr "``+x``, ``-x``, ``~x``" msgid "Positive, negative, bitwise NOT" msgstr "" msgid "``*``, ``@``, ``/``, ``//``, ``%``" -msgstr "" +msgstr "``*``, ``@``, ``/``, ``//``, ``%``" msgid "" "Multiplication, matrix multiplication, division, floor division, remainder " @@ -1767,31 +1780,31 @@ msgid "" msgstr "" msgid "``+``, ``-``" -msgstr "" +msgstr "``+``, ``-``" msgid "Addition and subtraction" msgstr "" msgid "``<<``, ``>>``" -msgstr "" +msgstr "``<<``, ``>>``" msgid "Shifts" msgstr "" msgid "``&``" -msgstr "" +msgstr "``&``" msgid "Bitwise AND" msgstr "" msgid "``^``" -msgstr "" +msgstr "``^``" msgid "Bitwise XOR" msgstr "" msgid "``|``" -msgstr "" +msgstr "``|``" msgid "Bitwise OR" msgstr "" @@ -1811,13 +1824,13 @@ msgid "Boolean NOT" msgstr "" msgid ":keyword:`and`" -msgstr "" +msgstr ":keyword:`and`" msgid "Boolean AND" msgstr "" msgid ":keyword:`or`" -msgstr "" +msgstr ":keyword:`or`" msgid "Boolean OR" msgstr "" @@ -1829,13 +1842,13 @@ msgid "Conditional expression" msgstr "" msgid ":keyword:`lambda`" -msgstr "" +msgstr ":keyword:`lambda`" msgid "Lambda expression" msgstr "" msgid "``:=``" -msgstr "" +msgstr "``:=``" msgid "Assignment expression" msgstr "" @@ -1904,7 +1917,7 @@ msgid "" msgstr "" msgid "expression" -msgstr "" +msgstr "wyrażenie" msgid "BNF" msgstr "" @@ -1919,7 +1932,7 @@ msgid "atom" msgstr "" msgid "name" -msgstr "" +msgstr "nazwa" msgid "identifier" msgstr "" @@ -1931,7 +1944,7 @@ msgid "NameError" msgstr "" msgid "mangling" -msgstr "" +msgstr "maglowanie" msgid "private" msgstr "" @@ -1949,10 +1962,10 @@ msgid "data" msgstr "" msgid "type" -msgstr "" +msgstr "typ" msgid "object" -msgstr "" +msgstr "obiekt" msgid "parenthesized form" msgstr "" @@ -1967,7 +1980,7 @@ msgid "empty" msgstr "" msgid "tuple" -msgstr "" +msgstr "tuple" msgid "comma" msgstr "" @@ -1994,7 +2007,7 @@ msgid "await" msgstr "" msgid "list" -msgstr "" +msgstr "lista" msgid "display" msgstr "" @@ -2009,7 +2022,7 @@ msgid "expression list" msgstr "" msgid "set" -msgstr "" +msgstr "zestaw" msgid "{} (curly brackets)" msgstr "" @@ -2018,15 +2031,15 @@ msgid "set expression" msgstr "" msgid "dictionary" -msgstr "" +msgstr "słownik" msgid "key" msgstr "" -msgid "datum" +msgid "value" msgstr "" -msgid "key/datum pair" +msgid "key/value pair" msgstr "" msgid "dictionary expression" @@ -2051,7 +2064,7 @@ msgid "hashable" msgstr "" msgid "generator" -msgstr "" +msgstr "generator" msgid "generator expression" msgstr "" @@ -2114,13 +2127,13 @@ msgid "subscription" msgstr "" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "mapping" msgstr "" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "item" msgstr "" @@ -2150,7 +2163,7 @@ msgid "call" msgstr "" msgid "argument" -msgstr "" +msgstr "argument" msgid "call semantics" msgstr "" @@ -2168,7 +2181,7 @@ msgid "parameter" msgstr "" msgid "* (asterisk)" -msgstr "* (asterisk)" +msgstr "* (asterysk)" msgid "user-defined" msgstr "" @@ -2177,16 +2190,16 @@ msgid "user-defined function" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "method" -msgstr "" +msgstr "metoda" msgid "built-in method" msgstr "" msgid "class" -msgstr "" +msgstr "klasa" msgid "class object" msgstr "" @@ -2258,7 +2271,7 @@ msgid "ZeroDivisionError" msgstr "" msgid "division" -msgstr "" +msgstr "podział" msgid "/ (slash)" msgstr "" @@ -2321,7 +2334,7 @@ msgid "comparison" msgstr "" msgid "C" -msgstr "" +msgstr "C" msgid "language" msgstr "" @@ -2339,7 +2352,7 @@ msgid ">=" msgstr "" msgid "==" -msgstr "" +msgstr "==" msgid "!=" msgstr "" @@ -2375,7 +2388,7 @@ msgid "Conditional" msgstr "" msgid "Boolean" -msgstr "" +msgstr "Wartość logiczna" msgid "not" msgstr "" @@ -2405,7 +2418,7 @@ msgid "else" msgstr "" msgid "lambda" -msgstr "" +msgstr "lambda" msgid "form" msgstr "" diff --git a/reference/import.po b/reference/import.po index 4028615c57..483dd893f1 100644 --- a/reference/import.po +++ b/reference/import.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -77,7 +77,7 @@ msgid "" msgstr "" msgid ":mod:`importlib`" -msgstr "" +msgstr ":mod:`importlib`" msgid "" "The :mod:`importlib` module provides a rich API for interacting with the " @@ -373,7 +373,8 @@ msgid "" "The :meth:`~importlib.abc.MetaPathFinder.find_spec` method of meta path " "finders replaced :meth:`~importlib.abc.MetaPathFinder.find_module`, which is " "now deprecated. While it will continue to work without change, the import " -"machinery will try it only if the finder does not implement ``find_spec()``." +"machinery will try it only if the finder does not implement :meth:" +"`~importlib.abc.MetaPathFinder.find_spec`." msgstr "" msgid "" @@ -888,7 +889,7 @@ msgstr "" msgid "" ":data:`sys.path` contains a list of strings providing search locations for " -"modules and packages. It is initialized from the :data:`PYTHONPATH` " +"modules and packages. It is initialized from the :envvar:`PYTHONPATH` " "environment variable and various other installation- and implementation-" "specific defaults. Entries in :data:`sys.path` can name directories on the " "file system, zip files, and potentially other \"locations\" (see the :mod:" @@ -1097,7 +1098,7 @@ msgid "" msgstr "" msgid "__main__.__spec__" -msgstr "" +msgstr "__main__.__spec__" msgid "" "Depending on how :mod:`__main__` is initialized, ``__main__.__spec__`` gets " @@ -1212,7 +1213,7 @@ msgid "import machinery" msgstr "" msgid "package" -msgstr "" +msgstr "pakiet" msgid "regular" msgstr "" @@ -1221,16 +1222,16 @@ msgid "namespace" msgstr "" msgid "portion" -msgstr "" +msgstr "część" msgid "sys.modules" msgstr "" msgid "finder" -msgstr "" +msgstr "wyszukiwarka" msgid "loader" -msgstr "" +msgstr "ładowarka" msgid "module spec" msgstr "" @@ -1248,7 +1249,7 @@ msgid "hooks" msgstr "" msgid "import" -msgstr "" +msgstr "import" msgid "meta" msgstr "" diff --git a/reference/index.po b/reference/index.po index 3eab12e32f..b42d952171 100644 --- a/reference/index.po +++ b/reference/index.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/reference/introduction.po b/reference/introduction.po index 7580d9c46e..7e8a3e64cb 100644 --- a/reference/introduction.po +++ b/reference/introduction.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +76,7 @@ msgid "Known implementations include:" msgstr "" msgid "CPython" -msgstr "" +msgstr "CPython" msgid "" "This is the original and most-maintained implementation of Python, written " @@ -140,8 +140,9 @@ msgid "Notation" msgstr "" msgid "" -"The descriptions of lexical analysis and syntax use a modified BNF grammar " -"notation. This uses the following style of definition:" +"The descriptions of lexical analysis and syntax use a modified `Backus–Naur " +"form (BNF) `_ " +"grammar notation. This uses the following style of definition:" msgstr "" msgid "" diff --git a/reference/lexical_analysis.po b/reference/lexical_analysis.po index 0dde6e0492..20c3fffdc3 100644 --- a/reference/lexical_analysis.po +++ b/reference/lexical_analysis.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,10 +104,9 @@ msgid "which is recognized by Bram Moolenaar's VIM." msgstr "" msgid "" -"If no encoding declaration is found, the default encoding is UTF-8. In " -"addition, if the first bytes of the file are the UTF-8 byte-order mark " -"(``b'\\xef\\xbb\\xbf'``), the declared file encoding is UTF-8 (this is " -"supported, among others, by Microsoft's :program:`notepad`)." +"If no encoding declaration is found, the default encoding is UTF-8. If the " +"implicit or explicit encoding of a file is UTF-8, an initial UTF-8 byte-" +"order mark (b'\\xef\\xbb\\xbf') is ignored rather than being a syntax error." msgstr "" msgid "" @@ -378,13 +377,13 @@ msgid "" msgstr "" msgid "``_*``" -msgstr "" +msgstr "``_*``" msgid "Not imported by ``from module import *``." msgstr "" msgid "``_``" -msgstr "" +msgstr "``_``" msgid "" "In a ``case`` pattern within a :keyword:`match` statement, ``_`` is a :ref:" @@ -413,7 +412,7 @@ msgid "It is also commonly used for unused variables." msgstr "" msgid "``__*__``" -msgstr "" +msgstr "``__*__``" msgid "" "System-defined names, informally known as \"dunder\" names. These names are " @@ -425,7 +424,7 @@ msgid "" msgstr "" msgid "``__*``" -msgstr "" +msgstr "``__*``" msgid "" "Class-private names. Names in this category, when used within the context " @@ -505,6 +504,9 @@ msgid "" "either ``'`` or ``\"``.)" msgstr "" +msgid "Escape sequences" +msgstr "" + msgid "" "Unless an ``'r'`` or ``'R'`` prefix is present, escape sequences in string " "and bytes literals are interpreted according to rules similar to those used " @@ -530,67 +532,67 @@ msgid "\\(1)" msgstr "\\(1)" msgid "``\\\\``" -msgstr "" +msgstr "``\\\\``" msgid "Backslash (``\\``)" msgstr "" msgid "``\\'``" -msgstr "" +msgstr "``\\'``" msgid "Single quote (``'``)" msgstr "" msgid "``\\\"``" -msgstr "" +msgstr "``\\\"``" msgid "Double quote (``\"``)" msgstr "" msgid "``\\a``" -msgstr "" +msgstr "``\\a``" msgid "ASCII Bell (BEL)" msgstr "" msgid "``\\b``" -msgstr "" +msgstr "``\\b``" msgid "ASCII Backspace (BS)" msgstr "" msgid "``\\f``" -msgstr "" +msgstr "``\\f``" msgid "ASCII Formfeed (FF)" msgstr "" msgid "``\\n``" -msgstr "" +msgstr "``\\n``" msgid "ASCII Linefeed (LF)" msgstr "" msgid "``\\r``" -msgstr "" +msgstr "``\\r``" msgid "ASCII Carriage Return (CR)" msgstr "" msgid "``\\t``" -msgstr "" +msgstr "``\\t``" msgid "ASCII Horizontal Tab (TAB)" msgstr "" msgid "``\\v``" -msgstr "" +msgstr "``\\v``" msgid "ASCII Vertical Tab (VT)" msgstr "" -msgid "``\\ooo``" -msgstr "" +msgid ":samp:`\\\\\\\\{ooo}`" +msgstr ":samp:`\\\\\\\\{ooo}`" msgid "Character with octal value *ooo*" msgstr "" @@ -598,8 +600,8 @@ msgstr "" msgid "(2,4)" msgstr "" -msgid "``\\xhh``" -msgstr "" +msgid ":samp:`\\\\x{hh}`" +msgstr ":samp:`\\\\x{hh}`" msgid "Character with hex value *hh*" msgstr "" @@ -610,8 +612,8 @@ msgstr "" msgid "Escape sequences only recognized in string literals are:" msgstr "" -msgid "``\\N{name}``" -msgstr "" +msgid ":samp:`\\\\N\\\\{{name}\\\\}`" +msgstr ":samp:`\\\\N\\\\{{name}\\\\}`" msgid "Character named *name* in the Unicode database" msgstr "" @@ -619,8 +621,8 @@ msgstr "" msgid "\\(5)" msgstr "\\(5)" -msgid "``\\uxxxx``" -msgstr "" +msgid ":samp:`\\\\u{xxxx}`" +msgstr ":samp:`\\\\u{xxxx}`" msgid "Character with 16-bit hex value *xxxx*" msgstr "" @@ -628,8 +630,8 @@ msgstr "" msgid "\\(6)" msgstr "" -msgid "``\\Uxxxxxxxx``" -msgstr "" +msgid ":samp:`\\\\U{xxxxxxxx}`" +msgstr ":samp:`\\\\U{xxxxxxxx}`" msgid "Character with 32-bit hex value *xxxxxxxx*" msgstr "" @@ -726,7 +728,7 @@ msgid "" "with plain string literals." msgstr "" -msgid "Formatted string literals" +msgid "f-strings" msgstr "" msgid "" @@ -792,10 +794,10 @@ msgstr "" msgid "" "The result is then formatted using the :func:`format` protocol. The format " -"specifier is passed to the :meth:`__format__` method of the expression or " -"conversion result. An empty string is passed when the format specifier is " -"omitted. The formatted result is then included in the final value of the " -"whole string." +"specifier is passed to the :meth:`~object.__format__` method of the " +"expression or conversion result. An empty string is passed when the format " +"specifier is omitted. The formatted result is then included in the final " +"value of the whole string." msgstr "" msgid "" @@ -949,3 +951,309 @@ msgstr "Przypisy" msgid "https://www.unicode.org/Public/11.0.0/ucd/NameAliases.txt" msgstr "" + +msgid "lexical analysis" +msgstr "" + +msgid "parser" +msgstr "" + +msgid "token" +msgstr "" + +msgid "line structure" +msgstr "" + +msgid "logical line" +msgstr "" + +msgid "physical line" +msgstr "" + +msgid "line joining" +msgstr "" + +msgid "NEWLINE token" +msgstr "" + +msgid "comment" +msgstr "komentarz" + +msgid "hash character" +msgstr "" + +msgid "# (hash)" +msgstr "# (hash)" + +msgid "source character set" +msgstr "" + +msgid "encoding declarations (source file)" +msgstr "" + +msgid "source encoding declaration" +msgstr "" + +msgid "line continuation" +msgstr "" + +msgid "backslash character" +msgstr "" + +msgid "blank line" +msgstr "" + +msgid "indentation" +msgstr "" + +msgid "leading whitespace" +msgstr "" + +msgid "space" +msgstr "" + +msgid "tab" +msgstr "" + +msgid "grouping" +msgstr "" + +msgid "statement grouping" +msgstr "" + +msgid "INDENT token" +msgstr "" + +msgid "DEDENT token" +msgstr "" + +msgid "identifier" +msgstr "" + +msgid "name" +msgstr "nazwa" + +msgid "keyword" +msgstr "" + +msgid "reserved word" +msgstr "" + +msgid "soft keyword" +msgstr "" + +msgid "_, identifiers" +msgstr "" + +msgid "__, identifiers" +msgstr "" + +msgid "literal" +msgstr "" + +msgid "constant" +msgstr "" + +msgid "string literal" +msgstr "" + +msgid "bytes literal" +msgstr "" + +msgid "ASCII" +msgstr "" + +msgid "' (single quote)" +msgstr "" + +msgid "\" (double quote)" +msgstr "" + +msgid "u'" +msgstr "" + +msgid "u\"" +msgstr "" + +msgid "triple-quoted string" +msgstr "" + +msgid "Unicode Consortium" +msgstr "" + +msgid "raw string" +msgstr "" + +msgid "\"\"\"" +msgstr "" + +msgid "'''" +msgstr "" + +msgid "b'" +msgstr "" + +msgid "b\"" +msgstr "" + +msgid "r'" +msgstr "" + +msgid "raw string literal" +msgstr "" + +msgid "r\"" +msgstr "" + +msgid "f'" +msgstr "" + +msgid "formatted string literal" +msgstr "sformatowany literał ciągu znaków" + +msgid "f\"" +msgstr "" + +msgid "escape sequence" +msgstr "" + +msgid "Standard C" +msgstr "" + +msgid "C" +msgstr "C" + +msgid "\\ (backslash)" +msgstr "" + +msgid "\\\\" +msgstr "" + +msgid "\\a" +msgstr "" + +msgid "\\b" +msgstr "" + +msgid "\\f" +msgstr "" + +msgid "\\n" +msgstr "" + +msgid "\\r" +msgstr "" + +msgid "\\t" +msgstr "" + +msgid "\\v" +msgstr "" + +msgid "\\x" +msgstr "" + +msgid "\\u" +msgstr "" + +msgid "\\U" +msgstr "" + +msgid "unrecognized escape sequence" +msgstr "" + +msgid "interpolated string literal" +msgstr "interpolowany literał ciąg znaków" + +msgid "string" +msgstr "ciąg znaków" + +msgid "formatted literal" +msgstr "sformatowany literał" + +msgid "interpolated literal" +msgstr "interpolowany literał" + +msgid "f-string" +msgstr "f-string" + +msgid "fstring" +msgstr "fstring" + +msgid "{} (curly brackets)" +msgstr "" + +msgid "in formatted string literal" +msgstr "" + +msgid "! (exclamation)" +msgstr "" + +msgid ": (colon)" +msgstr ": (dwukropek)" + +msgid "= (equals)" +msgstr "" + +msgid "for help in debugging using string literals" +msgstr "" + +msgid "number" +msgstr "" + +msgid "numeric literal" +msgstr "" + +msgid "integer literal" +msgstr "" + +msgid "floating point literal" +msgstr "" + +msgid "hexadecimal literal" +msgstr "" + +msgid "octal literal" +msgstr "" + +msgid "binary literal" +msgstr "" + +msgid "decimal literal" +msgstr "" + +msgid "imaginary literal" +msgstr "" + +msgid "complex literal" +msgstr "" + +msgid "0b" +msgstr "" + +msgid "0o" +msgstr "" + +msgid "0x" +msgstr "" + +msgid "_ (underscore)" +msgstr "" + +msgid "in numeric literal" +msgstr "" + +msgid ". (dot)" +msgstr "" + +msgid "e" +msgstr "" + +msgid "j" +msgstr "" + +msgid "operators" +msgstr "" + +msgid "delimiters" +msgstr "" diff --git a/reference/simple_stmts.po b/reference/simple_stmts.po index 11fe34bb2b..3253472ce9 100644 --- a/reference/simple_stmts.po +++ b/reference/simple_stmts.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2023 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -184,15 +184,15 @@ msgstr "" msgid "" "If the primary is a mapping object (such as a dictionary), the subscript " "must have a type compatible with the mapping's key type, and the mapping is " -"then asked to create a key/datum pair which maps the subscript to the " +"then asked to create a key/value pair which maps the subscript to the " "assigned object. This can either replace an existing key/value pair with " "the same key value, or insert a new key/value pair (if no key with the same " "value existed)." msgstr "" msgid "" -"For user-defined objects, the :meth:`__setitem__` method is called with " -"appropriate arguments." +"For user-defined objects, the :meth:`~object.__setitem__` method is called " +"with appropriate arguments." msgstr "" msgid "" @@ -316,8 +316,8 @@ msgid "" "If the right hand side is present, an annotated assignment performs the " "actual assignment before evaluating annotations (where applicable). If the " "right hand side is not present for an expression target, then the " -"interpreter evaluates the target except for the last :meth:`__setitem__` or :" -"meth:`__setattr__` call." +"interpreter evaluates the target except for the last :meth:`~object." +"__setitem__` or :meth:`~object.__setattr__` call." msgstr "" msgid ":pep:`526` - Syntax for Variable Annotations" @@ -503,9 +503,9 @@ msgstr "" msgid "" "A traceback object is normally created automatically when an exception is " -"raised and attached to it as the :attr:`__traceback__` attribute, which is " -"writable. You can create an exception and set your own traceback in one step " -"using the :meth:`~BaseException.with_traceback` exception method (which " +"raised and attached to it as the :attr:`~BaseException.__traceback__` " +"attribute. You can create an exception and set your own traceback in one " +"step using the :meth:`~BaseException.with_traceback` exception method (which " "returns the same exception instance, with its traceback set to its " "argument), like so::" msgstr "" @@ -514,11 +514,11 @@ msgid "" "The ``from`` clause is used for exception chaining: if given, the second " "*expression* must be another exception class or instance. If the second " "expression is an exception instance, it will be attached to the raised " -"exception as the :attr:`__cause__` attribute (which is writable). If the " -"expression is an exception class, the class will be instantiated and the " -"resulting exception instance will be attached to the raised exception as " -"the :attr:`__cause__` attribute. If the raised exception is not handled, " -"both exceptions will be printed::" +"exception as the :attr:`~BaseException.__cause__` attribute (which is " +"writable). If the expression is an exception class, the class will be " +"instantiated and the resulting exception instance will be attached to the " +"raised exception as the :attr:`!__cause__` attribute. If the raised " +"exception is not handled, both exceptions will be printed:" msgstr "" msgid "" @@ -526,12 +526,12 @@ msgid "" "exception is already being handled. An exception may be handled when an :" "keyword:`except` or :keyword:`finally` clause, or a :keyword:`with` " "statement, is used. The previous exception is then attached as the new " -"exception's :attr:`__context__` attribute::" +"exception's :attr:`~BaseException.__context__` attribute:" msgstr "" msgid "" "Exception chaining can be explicitly suppressed by specifying :const:`None` " -"in the ``from`` clause::" +"in the ``from`` clause:" msgstr "" msgid "" @@ -544,8 +544,8 @@ msgid ":const:`None` is now permitted as ``Y`` in ``raise X from Y``." msgstr "" msgid "" -"The ``__suppress_context__`` attribute to suppress automatic display of the " -"exception context." +"Added the :attr:`~BaseException.__suppress_context__` attribute to suppress " +"automatic display of the exception context." msgstr "" msgid "" @@ -682,7 +682,7 @@ msgid "" msgstr "" msgid "Examples::" -msgstr "" +msgstr "Przykłady::" msgid "" "If the list of identifiers is replaced by a star (``'*'``), all public names " @@ -818,7 +818,7 @@ msgstr "" msgid "" "Code compiled by calls to the built-in functions :func:`exec` and :func:" -"`compile` that occur in a module :mod:`M` containing a future statement " +"`compile` that occur in a module :mod:`!M` containing a future statement " "will, by default, use the new syntax or semantics associated with the future " "statement. This can be controlled by optional arguments to :func:`compile` " "--- see the documentation of that function for details." @@ -914,25 +914,25 @@ msgid "statement" msgstr "instrukcja" msgid "expression" -msgstr "" +msgstr "wyrażenie" msgid "list" -msgstr "" +msgstr "lista" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "repr" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "None" msgstr "" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "conversion" msgstr "" @@ -968,7 +968,7 @@ msgid "binding" msgstr "" msgid "name" -msgstr "" +msgstr "nazwa" msgid "rebinding" msgstr "" @@ -989,7 +989,7 @@ msgid "in target list" msgstr "" msgid "* (asterisk)" -msgstr "* (asterisk)" +msgstr "* (asterysk)" msgid "in assignment target list" msgstr "" @@ -1007,13 +1007,13 @@ msgid "subscription" msgstr "" msgid "sequence" -msgstr "" +msgstr "sekwencja" msgid "mapping" msgstr "" msgid "dictionary" -msgstr "" +msgstr "słownik" msgid "slicing" msgstr "" @@ -1040,7 +1040,7 @@ msgid "/=" msgstr "" msgid "%=" -msgstr "" +msgstr "%=" msgid "&=" msgstr "" @@ -1088,7 +1088,7 @@ msgid "expression list" msgstr "" msgid "__debug__" -msgstr "" +msgstr "__debug__" msgid "exception" msgstr "" @@ -1127,7 +1127,7 @@ msgid "definition" msgstr "" msgid "class" -msgstr "" +msgstr "klasa" msgid "keyword" msgstr "" @@ -1139,10 +1139,10 @@ msgid "yield" msgstr "" msgid "generator" -msgstr "" +msgstr "generator" msgid "iterator" -msgstr "" +msgstr "iterator" msgid "StopIteration" msgstr "" @@ -1190,13 +1190,13 @@ msgid "continue" msgstr "" msgid "import" -msgstr "" +msgstr "import" msgid "module" msgstr "moduł" msgid "importing" -msgstr "" +msgstr "import" msgid "from" msgstr "" @@ -1220,7 +1220,7 @@ msgid "future" msgstr "" msgid "__future__" -msgstr "" +msgstr "__future__" msgid "future statement" msgstr "" @@ -1229,7 +1229,7 @@ msgid "identifier list" msgstr "" msgid "exec" -msgstr "" +msgstr "exec" msgid "eval" msgstr "" diff --git a/reference/toplevel_components.po b/reference/toplevel_components.po index 225292c476..e78232fe97 100644 --- a/reference/toplevel_components.po +++ b/reference/toplevel_components.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +119,7 @@ msgid "sys" msgstr "sys" msgid "__main__" -msgstr "" +msgstr "__main__" msgid "builtins" msgstr "builtins" @@ -131,7 +131,7 @@ msgid "UNIX" msgstr "" msgid "Windows" -msgstr "" +msgstr "Windows" msgid "command line" msgstr "" @@ -143,7 +143,7 @@ msgid "input" msgstr "" msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "eval" msgstr "" diff --git a/sphinx.po b/sphinx.po index 202577edaa..23ef5e7cf0 100644 --- a/sphinx.po +++ b/sphinx.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,14 +43,35 @@ msgstr "" msgid "Deprecated since version {deprecated}, removed in version {removed}" msgstr "Zdezaprobowane w wersji {deprecated}, usunięte w wersji {removed}" +msgid "Part of the" +msgstr "Część" + +msgid "Limited API" +msgstr "ograniczonego API" + +msgid "Stable ABI" +msgstr "stabilnego ABI" + +msgid "(as an opaque struct)" +msgstr "(jako nieprzezroczysta struktura)" + +msgid "(including all members)" +msgstr "(w tym wszystkie składniki)" + +msgid "since version %s" +msgstr "od wersji %s" + +msgid "(Only some members are part of the stable ABI.)" +msgstr "(tylko niektóre składniki są częścią stabilnego ABI)" + msgid "Return value: Always NULL." -msgstr "" +msgstr "Wartość zwracana: zawsze NULL." msgid "Return value: New reference." -msgstr "" +msgstr "Wartość zwracana: nowa referencja." msgid "Return value: Borrowed reference." -msgstr "" +msgstr "Wartość zwracana: pożyczona referencja." msgid "in development" msgstr "w rozwoju" @@ -71,128 +91,132 @@ msgstr "niewspierany" msgid "Welcome! This is the official documentation for Python %(release)s." msgstr "Witamy! To jest oficjalna dokumentacja Pythona %(release)s." -msgid "Parts of the documentation:" -msgstr "Części dokumentacji:" +msgid "Documentation sections:" +msgstr "Sekcje dokumentacji:" msgid "What's new in Python %(version)s?" msgstr "Co nowego w Pythonie %(version)s?" msgid "" -"or all \"What's new\" documents since 2.0" +"Or all \"What's new\" documents since Python " +"2.0" msgstr "" -"lub wszystkie dokumenty „Co nowego” od 2.0" +"Lub wszystkie dokumenty „Co nowego” od 2.0" msgid "Tutorial" msgstr "Tutorial" -msgid "start here" -msgstr "zacznij tutaj" +msgid "Start here: a tour of Python's syntax and features" +msgstr "Zacznij tutaj: wycieczka po składni i funkcjach Pythona" -msgid "Library Reference" +msgid "Library reference" msgstr "Dokumentacja biblioteki" -msgid "keep this under your pillow" -msgstr "do trzymania pod poduszką" +msgid "Standard library and builtins" +msgstr "Biblioteka standardowa i funkcje wbudowane" -msgid "Language Reference" +msgid "Language reference" msgstr "Dokumentacja języka" -msgid "describes syntax and language elements" -msgstr "opisuje składnię i elementy języka" +msgid "Syntax and language elements" +msgstr "Składnia i elementy języka" -msgid "Python Setup and Usage" -msgstr "Instalacja i używanie Pythona" +msgid "Python setup and usage" +msgstr "Konfiguracja i użytkowanie Pythona" -msgid "how to use Python on different platforms" -msgstr "jak używać Pythona na różnych platformach" +msgid "How to install, configure, and use Python" +msgstr "Jak zainstalować, skonfigurować i używać Pythona" msgid "Python HOWTOs" msgstr "Pythonowe „Jak to zrobić?”" -msgid "in-depth documents on specific topics" -msgstr "szczegółowe dokumenty na określone tematy" +msgid "In-depth topic manuals" +msgstr "Szczegółowe podręczniki tematyczne" -msgid "Installing Python Modules" +msgid "Installing Python modules" msgstr "Instalacja modułów Pythona" -msgid "installing from the Python Package Index & other sources" -msgstr "instalowanie z Python Package Index i innych źródeł" +msgid "Third-party modules and PyPI.org" +msgstr "Moduły zewnętrzne i PyPI.org" -msgid "Distributing Python Modules" +msgid "Distributing Python modules" msgstr "Dystrybucja modułów Pythona" -msgid "publishing modules for installation by others" -msgstr "publikowanie modułów do instalacji przez innych" +msgid "Publishing modules for use by other people" +msgstr "Publikowanie modułów do użytku przez inne osoby" -msgid "Extending and Embedding" +msgid "Extending and embedding" msgstr "Rozszerzanie i embedowanie" -msgid "tutorial for C/C++ programmers" -msgstr "tutorial dla programistów C/C++" +msgid "For C/C++ programmers" +msgstr "Dla programistów C/C++" -msgid "Python/C API" -msgstr "API Python/C" +msgid "Python's C API" +msgstr "API C Pythona" -msgid "reference for C/C++ programmers" -msgstr "dokumentacja dla programistów C/C++" +msgid "C API reference" +msgstr "Dokumentacja API C" msgid "FAQs" msgstr "Często zadawane pytania" -msgid "frequently asked questions (with answers!)" -msgstr "i odpowiedzi!" +msgid "Frequently asked questions (with answers!)" +msgstr "Często zadawane pytania (z odpowiedziami!)" -msgid "Indices and tables:" -msgstr "Wskaźniki i tabele:" +msgid "Indices, glossary, and search:" +msgstr "Indeksy, glosariusz i wyszukiwanie:" -msgid "Global Module Index" +msgid "Global module index" msgstr "Globalny spis modułów" -msgid "quick access to all modules" -msgstr "szybki dostęp do wszystkich modułów" +msgid "All modules and libraries" +msgstr "Wszystkie moduły i biblioteki" -msgid "General Index" +msgid "General index" msgstr "Indeks ogólny" -msgid "all functions, classes, terms" -msgstr "wszystkie funkcje, klasy, warunki" +msgid "All functions, classes, and terms" +msgstr "Wszystkie funkcje, klasy i pojęcia" msgid "Glossary" msgstr "Glosariusz" -msgid "the most important terms explained" -msgstr "wyjaśniamy najważniejsze pojęcia" +msgid "Terms explained" +msgstr "Wyjaśnienia terminów" msgid "Search page" msgstr "Strona wyszukiwania" -msgid "search this documentation" -msgstr "wyszukaj w dokumentacji" +msgid "Search this documentation" +msgstr "Wyszukaj w dokumentacji" -msgid "Complete Table of Contents" -msgstr "Spis treści" +msgid "Complete table of contents" +msgstr "Pełny spis treści" -msgid "lists all sections and subsections" -msgstr "wyświetla wszystkie sekcje i podsekcje" +msgid "Lists all sections and subsections" +msgstr "Spis wszystkich sekcji i podsekcji" -msgid "Meta information:" -msgstr "Metainformacje:" +msgid "Project information:" +msgstr "Informacje o projekcie:" -msgid "Reporting bugs" +msgid "Reporting issues" msgstr "Zgłaszanie błędów" msgid "Contributing to Docs" msgstr "Rozwijanie dokumentacji" -msgid "About the documentation" -msgstr "O dokumentacji" +msgid "Download the documentation" +msgstr "Pobierz dokumentację" -msgid "History and License of Python" +msgid "History and license of Python" msgstr "Historia i licencja Pythona" msgid "Copyright" msgstr "Prawa autorskie" +msgid "About the documentation" +msgstr "O dokumentacji" + msgid "Download" msgstr "Pobieranie" @@ -231,19 +255,22 @@ msgstr "Python Developer’s Guide" msgid "" "This document is for an old version of Python that is no longer supported.\n" -" You should upgrade, and read the " +" You should upgrade, and read the" msgstr "" -"Ten dokument dotyczy starej wersji Pythona, która nie jest już wspierana.\n" -"Powinieneś przejść na wyższą wersję i przeczytać" +"Ten dokument dotyczy starej wersji Pythona, która nie jest już wspierana. " +"Powinieneś(-nnaś) przejść na wyższą wersję i czytać" -msgid " Python documentation for the current stable release" +msgid "Python documentation for the current stable release" msgstr "dokumentację Pythona dla bieżącego stabilnego wydania" msgid "" "This is a deploy preview created from a pull request.\n" -" For authoritative documentation, see the " +" For authoritative documentation, see" msgstr "" +"Jest to podgląd wdrożenia utworzony na podstawie pull requestu. Aby uzyskać " +"wiarygodną dokumentację, zobacz" -msgid " the current stable release" -msgstr "" +msgid "the current stable release" +msgstr "bieżącą stabilną wersję" diff --git a/tutorial/appendix.po b/tutorial/appendix.po index 7e795ec6c7..f5cb8493da 100644 --- a/tutorial/appendix.po +++ b/tutorial/appendix.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,10 +38,10 @@ msgid "" "input came from a file, it exits with a nonzero exit status after printing " "the stack trace. (Exceptions handled by an :keyword:`except` clause in a :" "keyword:`try` statement are not errors in this context.) Some errors are " -"unconditionally fatal and cause an exit with a nonzero exit; this applies to " -"internal inconsistencies and some cases of running out of memory. All error " -"messages are written to the standard error stream; normal output from " -"executed commands is written to standard output." +"unconditionally fatal and cause an exit with a nonzero exit status; this " +"applies to internal inconsistencies and some cases of running out of " +"memory. All error messages are written to the standard error stream; normal " +"output from executed commands is written to standard output." msgstr "" "Gdy wystąpi błąd, interpreter wyświetla komunikat błędu i ślad stosu. W " "trybie interaktywnym zwraca je do wiersza polecenia; jeżeli wejście pochodzi " @@ -153,16 +152,25 @@ msgid "" "want to use the startup file in a script, you must do this explicitly in the " "script::" msgstr "" +"Jeśli chcesz odczytać dodatkowy plik rozruchowy z bieżącego katalogu, możesz " +"zaprogramować to w globalnym pliku rozruchowym używając kodu takiego jak " +"``if os.path.isfile('.pythonrc.py'): exec(open('.pythonrc.py').read())``. " +"Jeśli chcesz użyć pliku rozruchowego w skrypcie, musisz to zrobić jawnie w " +"skrypcie::" msgid "The Customization Modules" -msgstr "" +msgstr "Moduły dostosowywania" msgid "" -"Python provides two hooks to let you customize it: :mod:`sitecustomize` and :" -"mod:`usercustomize`. To see how it works, you need first to find the " +"Python provides two hooks to let you customize it: :index:`sitecustomize` " +"and :index:`usercustomize`. To see how it works, you need first to find the " "location of your user site-packages directory. Start Python and run this " "code::" msgstr "" +"Python udostępnia dwa haki umożliwiające jego dostosowanie: :index:" +"`sitecustomize` i :index:`usercustomize`. Aby zobaczyć jak to działa, " +"należy najpierw znaleźć lokalizację katalogu pakietów użytkownika. Uruchom " +"Python i uruchom ten kod::" msgid "" "Now you can create a file named :file:`usercustomize.py` in that directory " @@ -170,13 +178,21 @@ msgid "" "unless it is started with the :option:`-s` option to disable the automatic " "import." msgstr "" +"Teraz możesz stworzyć plik o nazwie :file:`usercustomize.py` w tym katalogu " +"i umieścić w nim co tylko chcesz. Będzie to miało wpływ na każde wywołanie " +"Pythona, chyba że zostanie on uruchomiony z opcją :option:`-s`, aby wyłączyć " +"automatyczny import." msgid "" -":mod:`sitecustomize` works in the same way, but is typically created by an " +":index:`sitecustomize` works in the same way, but is typically created by an " "administrator of the computer in the global site-packages directory, and is " -"imported before :mod:`usercustomize`. See the documentation of the :mod:" +"imported before :index:`usercustomize`. See the documentation of the :mod:" "`site` module for more details." msgstr "" +":index:`sitecustomize` działa w ten sam sposób, ale jest zwykle tworzony " +"przez administratora komputera w globalnym katalogu pakietów i jest " +"importowany przed :index:`usercustomize`. Więcej szczegółów można znaleźć w " +"dokumentacji :mod:`site` moduł ." msgid "Footnotes" msgstr "Przypisy" diff --git a/tutorial/appetite.po b/tutorial/appetite.po index 3daebda657..d18331444c 100644 --- a/tutorial/appetite.po +++ b/tutorial/appetite.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/tutorial/classes.po b/tutorial/classes.po index 20c95d2e9b..f37a8b4487 100644 --- a/tutorial/classes.po +++ b/tutorial/classes.po @@ -1,21 +1,21 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Tomasz Rodzen , 2021 -# Maciej Olko , 2022 +# Waldemar Stoczkowski, 2023 +# Maciej Olko , 2024 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:49+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,11 +35,11 @@ msgid "" "attributes attached to it for maintaining its state. Class instances can " "also have methods (defined by its class) for modifying its state." msgstr "" -"Klasy dostarczają sposoby powiązania informacji i funkcjonalności. " -"Stworzenie nowej klasy, tworzy nowy typ obiektu, pozwalający na tworzenie " -"nowych instancji tego typu. Każda instancja klasy może mieć atrybuty " -"przypisane w celu utrzymania jej stanu. Instancje klas mogą również posiadać " -"metody (zdefiniowane przez jej klasę) w celu modyfikacje ich stanu." +"Klasy umożliwiają łączenie danych i funkcjonalności. Tworzenie nowej klasy, " +"tworzy nowy *typ* obiektu, umożliwiając tworzenie nowych *instancji* tego " +"typu. Do każdej instancji klasy można przypisać atrybuty służące do " +"utrzymywania jej stanu. Instancje klas mogą również posiadać metody " +"(zdefiniowane przez klasę) umożliwiające modyfikację ich stanu." msgid "" "Compared with other programming languages, Python's class mechanism adds " @@ -55,14 +55,14 @@ msgid "" msgstr "" "W porównaniu do innych języków programowania, w Pythonie, mechanizm " "dodawania nowych klas wymaga niewielkiej ilości nowej składni i semantyki. " -"Jest to połączenie mechanizmu klas, które można znaleźć w C++ i Modula-3. " -"Klasy w Pythonie dostarczają wszystkie standardowe cechy Programowania " -"Obiektowego: mechanizm dziedziczenia klas pozwala na tworzenie wielu " -"bazowych klas, pochodne klasy mogą nadpisać każdą metodę klasy lub klas " -"bazowej i metoda może przywołać metody klas bazowych o tej samej nazwie. " -"Obiekty mogą zawierać dowolną ilość i rodzaj danych. Zarówno klasy jak i " -"moduły są częścią dynamicznej natury Python'a: są tworzone w trakcje " -"działania programu i mogą być modyfikowane później, po stworzeniu." +"Jest to połączenie mechanizmu klas, które można znaleźć w C++ i Modula-3. " +"Klasy w Pythonie dostarczają wszystkie standardowe cechy programowania " +"obiektowego: mechanizm dziedziczenia klas pozwala na wiele klas bazowych, " +"klasy pochodne mogą nadpisać każdą metodę klasy lub klas bazowych i metoda " +"może wywołać metody klas bazowych o tej samej nazwie. Obiekty mogą zawierać " +"dowolną ilość i rodzaj danych. Zarówno klasy jak i moduły są częścią " +"dynamicznej natury Pythona: są tworzone w trakcie działania programu i mogą " +"być modyfikowane później, po stworzeniu." msgid "" "In C++ terminology, normally class members (including the data members) are " @@ -77,18 +77,18 @@ msgid "" "(arithmetic operators, subscripting etc.) can be redefined for class " "instances." msgstr "" -"Korzystając z terminologii C++, składniki klas (także pola)są *publiczne* (z " -"wyjątkiem zobacz :ref:`tut-private`), a wszystkie metody są *wirtualne*. " -"Podobnie jak w Moduli-3, nie ma skrótów pozwalających na odnoszenie się do " -"składników klas z ich metod: metoda jest deklarowana poprzez podanie wprost " -"jako pierwszego argumentu obiektu, który w czasie wywołania metody zostanie " -"jej przekazany niejawnie. Podobnie jak w Smalltalku, same klasy także są " -"obiektami. Dostarcza nam to wyrażeń semantycznych pozwalających na " -"importowanie i zmianę nazw klasy. Inaczej niż w C++ i Moduli-3 wbudowane " -"typy mogą stanowić klasy z których klasa użytkownika będzie dziedziczyć. " -"Podobnie jak w C++, większość wbudowanych operatorów ze specjalną składnią " -"(operatory arytmetyczne, indeksowanie) mogą być przedefiniowane przez " -"instancje klasy." +"Korzystając z terminologii C++, składniki klas (także pola) są *publiczne* " +"(z wyjątkiem zobacz poniżej :ref:`tut-private`), a wszystkie metody są " +"*wirtualne*. Podobnie jak w Moduli-3, nie ma skrótów pozwalających na " +"odnoszenie się do składników klas z ich metod: metoda jest deklarowana " +"poprzez podanie wprost jako pierwszego argumentu obiektu, który w czasie " +"wywołania metody zostanie jej przekazany niejawnie. Podobnie jak w " +"Smalltalku, same klasy także są obiektami. Dostarcza nam to wyrażeń " +"semantycznych pozwalających na importowanie i zmianę nazw klasy. Inaczej niż " +"w C++ i Moduli-3 wbudowane typy mogą stanowić klasy, z których klasa " +"użytkownika będzie dziedziczyć. Podobnie jak w C++, większość wbudowanych " +"operatorów ze specjalną składnią (operatory arytmetyczne, indeksowanie) może " +"być przedefiniowane przez instancje klasy." msgid "" "(Lacking universally accepted terminology to talk about classes, I will make " @@ -97,8 +97,8 @@ msgid "" "but I expect that few readers have heard of it.)" msgstr "" "(Z powodu braku ogólnie zaakceptowanej terminologii w kontekście klas, będę " -"używał terminów ze Samlltalk i C++. Użyłbym Modula-3 ponieważ semantyka " -"programowania obiektowego jest mu bliższa Pythonowi niż C++ ale zakładam, że " +"używał terminów ze Smalltalk i C++. Użyłbym Modula-3 ponieważ semantyka jego " +"programowania obiektowego jest bliższa Pythonowi niż C++ ale zakładam, że " "mniej czytelników o nim słyszało.)" msgid "A Word About Names and Objects" @@ -118,9 +118,22 @@ msgid "" "the caller will see the change --- this eliminates the need for two " "different argument passing mechanisms as in Pascal." msgstr "" +"Obiekty mają indywidualność, a wiele nazw (w wielu zakresach) może być " +"powiązanych z tym samym obiektem. Jest to znane jako aliasing w innych " +"językach. Zwykle nie jest to doceniane na pierwszy rzut oka w Pythonie i " +"można je bezpiecznie zignorować, gdy mamy do czynienia z niezmiennymi typami " +"podstawowymi (liczby, ciągi znaków, krotki). Jednak aliasing ma " +"prawdopodobnie zaskakujący wpływ na semantykę kodu Pythona, który obejmuje " +"zmienne obiekty, takie jak listy, słowniki i większość innych typów. Jest to " +"zwykle wykorzystywane z korzyścią dla programu, ponieważ aliasy pod pewnymi " +"względami zachowują się jak wskaźniki. Na przykład przekazanie obiektu jest " +"tanie, ponieważ implementacja przekazuje tylko wskaźnik; a jeśli funkcja " +"modyfikuje obiekt przekazany jako argument, wywołujący zobaczy zmianę --- " +"eliminuje to potrzebę stosowania dwóch różnych mechanizmów przekazywania " +"argumentów, jak w Pascalu." msgid "Python Scopes and Namespaces" -msgstr "" +msgstr "Zasięgi widoczności i przestrzenie nazw w Pythonie" msgid "" "Before introducing classes, I first have to tell you something about " @@ -129,9 +142,13 @@ msgid "" "understand what's going on. Incidentally, knowledge about this subject is " "useful for any advanced Python programmer." msgstr "" +"Przed wprowadzeniem klas, najpierw muszę powiedzieć ci coś o zasadach " +"zakresu Pythona. Definicje klas stosują kilka zgrabnych sztuczek z " +"przestrzeniami nazw, a żeby w pełni zrozumieć, co się dzieje, trzeba " +"wiedzieć, jak działają zakresy i przestrzenie nazw." msgid "Let's begin with some definitions." -msgstr "" +msgstr "Zacznijmy od kilku definicji." msgid "" "A *namespace* is a mapping from names to objects. Most namespaces are " @@ -146,6 +163,17 @@ msgid "" "may both define a function ``maximize`` without confusion --- users of the " "modules must prefix it with the module name." msgstr "" +"*Przestrzeń nazw* to odwzorowanie z nazw na obiekty. Większość przestrzeni " +"nazw jest obecnie implementowana jako słowniki Pythona, ale to zwykle nie " +"jest zauważalne w żaden sposób (z wyjątkiem wydajności), a to może się " +"zmienić w przyszłości. Przykładami przestrzeni nazw są: zbiór nazw " +"wbudowanych (zawierający funkcje np. :func:`abs` i nazwy wbudowanych " +"wyjątków); nazwy globalne w module; oraz nazwy lokalne w wywołaniu funkcji. " +"W pewnym sensie zbiór atrybutów obiektu również tworzy przestrzeń nazw. " +"Ważną rzeczą, którą należy wiedzieć o przestrzeniach nazw, jest to, że nie " +"ma absolutnie żadnych relacji między nazwami w różnych przestrzeniach nazw; " +"na przykład, dwa różne moduły mogą zdefiniować funkcję ``maximize`` bez " +"zamieszania --- użytkownicy modułów muszą poprzedzić go nazwą modułu." msgid "" "By the way, I use the word *attribute* for any name following a dot --- for " @@ -156,14 +184,28 @@ msgid "" "happens to be a straightforward mapping between the module's attributes and " "the global names defined in the module: they share the same namespace! [#]_" msgstr "" +"Nawiasem mówiąc, używam słowa *atrybut* dla każdej nazwy następującej po " +"kropce --- na przykład w wyrażeniu ``z.real``, ``real`` jest atrybutem " +"obiektu ``z``. Ściśle mówiąc, odniesienia do nazw w modułach są " +"odniesieniami atrybutowymi: w wyrażeniu ``modname.funcname``, ``modname`` " +"jest obiektem modułu, a ``funcname`` jest jego atrybutem. W tym przypadku " +"istnieje proste odwzorowanie między atrybutami modułu i nazwami globalnymi " +"zdefiniowanymi w module: mają tę samą przestrzeń nazw! [#]_" msgid "" "Attributes may be read-only or writable. In the latter case, assignment to " "attributes is possible. Module attributes are writable: you can write " "``modname.the_answer = 42``. Writable attributes may also be deleted with " "the :keyword:`del` statement. For example, ``del modname.the_answer`` will " -"remove the attribute :attr:`the_answer` from the object named by ``modname``." +"remove the attribute :attr:`!the_answer` from the object named by " +"``modname``." msgstr "" +"Atrybuty mogą być tylko do odczytu lub zapisywalne. W tym drugim przypadku " +"możliwe jest przypisanie do atrybutu. Atrybuty modułu są zapisywalne: można " +"zapisać ``modname.the_answer = 42``. Zapisywalne atrybuty można również " +"usunąć za pomocą instrukcji :keyword:`del`. Na przykład, ``del modname." +"the_answer`` usunie atrybut :attr:`!the_answer` z obiektu o nazwie " +"``modname``." msgid "" "Namespaces are created at different moments and have different lifetimes. " @@ -176,6 +218,16 @@ msgid "" "`__main__`, so they have their own global namespace. (The built-in names " "actually also live in a module; this is called :mod:`builtins`.)" msgstr "" +"Przestrzenie nazw są tworzone w różnych momentach i mają różny czas życia. " +"Przestrzeń nazw zawierająca nazwy wbudowane jest tworzona podczas " +"uruchamiania interpretera Pythona i nigdy nie jest usuwana. Globalna " +"przestrzeń nazw dla modułu jest tworzona, gdy wczytywana jest definicja " +"modułu; zwykle przestrzenie nazw modułu również trwają do zakończenia " +"działania interpretera. Instrukcje wykonywane przez wywołanie interpretera " +"najwyższego poziomu, zarówno odczytane z pliku skryptu, jak i interaktywnie, " +"są uważane za część modułu o nazwie :mod:`__main__`, więc mają swoją własną " +"globalną przestrzeń nazw. (Nazwy wbudowane w rzeczywistości również znajdują " +"się w module; nazwany jest on :mod:`builtins`)." msgid "" "The local namespace for a function is created when the function is called, " @@ -184,34 +236,52 @@ msgid "" "describe what actually happens.) Of course, recursive invocations each have " "their own local namespace." msgstr "" +"Lokalna przestrzeń nazw dla funkcji jest tworzona przy wywołaniu funkcji i " +"usuwana, gdy funkcja zwraca wynik lub rzuca wyjątek, którego nie obsługuje. " +"(Właściwie, zapominanie byłoby lepszym słowem na opisanie tego, co " +"faktycznie się dzieje). Oczywiście, każde wywołanie rekurencyjne ma swoją " +"własną lokalną przestrzeń nazw." msgid "" "A *scope* is a textual region of a Python program where a namespace is " "directly accessible. \"Directly accessible\" here means that an unqualified " "reference to a name attempts to find the name in the namespace." msgstr "" +"*Zakres* to tekstowy obszar programu Python, w którym przestrzeń nazw jest " +"bezpośrednio dostępna. „Bezpośrednio dostępna” oznacza tutaj, że " +"niekwalifikowane odwołanie do nazwy próbuje znaleźć ją w przestrzeni nazw." msgid "" "Although scopes are determined statically, they are used dynamically. At any " "time during execution, there are 3 or 4 nested scopes whose namespaces are " "directly accessible:" msgstr "" +"Chociaż zakresy są określane statycznie, są używane dynamicznie. Cały czas w " +"trakcie wykonywania programu istnieją 3 lub 4 zagnieżdżone zakresy, których " +"przestrzenie nazw są bezpośrednio dostępne:" msgid "the innermost scope, which is searched first, contains the local names" msgstr "" +"najbardziej wewnętrzny zakres, który jest przeszukiwany jako pierwszy, " +"zawiera nazwy lokalne" msgid "" "the scopes of any enclosing functions, which are searched starting with the " "nearest enclosing scope, contain non-local, but also non-global names" msgstr "" +"zakresy wszystkich otaczających funkcji, które są przeszukiwane począwszy od " +"najbliższego otaczającego zakresu, zawierają nazwy nielokalne, ale także " +"nieglobalne" msgid "the next-to-last scope contains the current module's global names" -msgstr "" +msgstr "przedostatni zakres zawiera globalne nazwy bieżącego modułu" msgid "" "the outermost scope (searched last) is the namespace containing built-in " "names" msgstr "" +"najbardziej zewnętrznym zakresem (przeszukiwanym jako ostatni) jest " +"przestrzeń nazw zawierająca nazwy wbudowane" msgid "" "If a name is declared global, then all references and assignments go " @@ -222,6 +292,14 @@ msgid "" "*new* local variable in the innermost scope, leaving the identically named " "outer variable unchanged)." msgstr "" +"Jeśli nazwa jest zadeklarowana jako globalna, wtedy wszystkie referencje i " +"przypisania przechodzą bezpośrednio do przedostatniego zakresu zawierającego " +"globalne nazwy modułu. Aby ponownie powiązać zmienne znajdujące się poza " +"najbardziej wewnętrznym zakresem, można użyć instrukcji :keyword:`nonlocal`; " +"jeśli nie są zadeklarowane jako nielokalne, zmienne te są tylko do odczytu " +"(próba zapisu do takiej zmiennej po prostu utworzy *nową* zmienną lokalną w " +"najbardziej wewnętrznym zakresie, pozostawiając identycznie nazwaną zmienną " +"zewnętrzną bez zmian)." msgid "" "Usually, the local scope references the local names of the (textually) " @@ -229,6 +307,10 @@ msgid "" "namespace as the global scope: the module's namespace. Class definitions " "place yet another namespace in the local scope." msgstr "" +"Zazwyczaj zakres lokalny odwołuje się do nazw lokalnych (tekstowo) bieżącej " +"funkcji. Poza funkcjami, zakres lokalny odwołuje się do tej samej " +"przestrzeni nazw, co zakres globalny: przestrzeni nazw modułu. Definicje " +"klas umieszczają jeszcze jedną przestrzeń nazw w zakresie lokalnym." msgid "" "It is important to realize that scopes are determined textually: the global " @@ -239,6 +321,14 @@ msgid "" "at \"compile\" time, so don't rely on dynamic name resolution! (In fact, " "local variables are already determined statically.)" msgstr "" +"Ważne jest, aby zdać sobie sprawę, że zakresy są określane tekstowo: " +"globalny zakres funkcji zdefiniowany w module jest przestrzenią nazw tego " +"modułu, bez względu na to, skąd lub przez jaki alias funkcja jest " +"wywoływana. Z drugiej strony, rzeczywiste wyszukiwanie nazw odbywa się " +"dynamicznie, w czasie wykonywania --- jednak definicja języka ewoluuje w " +"kierunku statycznego rozpoznawania nazw, w czasie „kompilacji”, więc nie " +"należy polegać na dynamicznym rozpoznawaniu nazw! (W rzeczywistości zmienne " +"lokalne są już określane statycznie)." msgid "" "A special quirk of Python is that -- if no :keyword:`global` or :keyword:" @@ -250,6 +340,14 @@ msgid "" "particular, :keyword:`import` statements and function definitions bind the " "module or function name in the local scope." msgstr "" +"Szczególnym dziwactwem Pythona jest to, że – jeśli nie działa instrukcja :" +"keyword:`global` lub :keyword:`nonlocal` – przypisanie do nazw zawsze trafia " +"do najbardziej wewnętrznego zakresu. Przypisania nie kopiują danych – po " +"prostu wiążą nazwy z obiektami. To samo dotyczy usuwania: instrukcja ``del " +"x`` usuwa wiązanie ``x`` z przestrzeni nazw, do której odwołuje się zakres " +"lokalny. W rzeczywistości wszystkie operacje, które wprowadzają nowe nazwy, " +"używają zakresu lokalnego: w szczególności instrukcje :keyword:`import` i " +"definicje funkcji wiążą nazwę modułu lub funkcji w zakresie lokalnym." msgid "" "The :keyword:`global` statement can be used to indicate that particular " @@ -257,18 +355,25 @@ msgid "" "`nonlocal` statement indicates that particular variables live in an " "enclosing scope and should be rebound there." msgstr "" +"Instrukcja :keyword:`global` może być użyta do wskazania, że określone " +"zmienne znajdują się w zakresie globalnym i powinny być tam ponownie " +"wiązane; instrukcja :keyword:`nonlocal` wskazuje, że określone zmienne " +"znajdują się w zakresie otaczającym i powinny być tam ponownie wiązane." msgid "Scopes and Namespaces Example" -msgstr "" +msgstr "Przykład zakresów i przestrzeni nazw" msgid "" "This is an example demonstrating how to reference the different scopes and " "namespaces, and how :keyword:`global` and :keyword:`nonlocal` affect " "variable binding::" msgstr "" +"Oto przykład pokazujący, jak odwoływać się do różnych zakresów i przestrzeni " +"nazw oraz jak :keyword:`global` i :keyword:`nonlocal` wpływają na wiązanie " +"zmiennych::" msgid "The output of the example code is:" -msgstr "" +msgstr "Wyjście przykładowego kodu to:" msgid "" "Note how the *local* assignment (which is default) didn't change " @@ -276,25 +381,33 @@ msgid "" "changed *scope_test*\\'s binding of *spam*, and the :keyword:`global` " "assignment changed the module-level binding." msgstr "" +"Zauważ, że *lokalne* przypisanie (które jest domyślne) nie zmieniło wiązania " +"*spam* w *scope_test*. Przypisanie :keyword:`nonlocal` zmieniło wiązanie " +"*spam* w *scope_test*, a przypisanie :keyword:`global` zmieniło wiązanie na " +"poziomie modułu." msgid "" "You can also see that there was no previous binding for *spam* before the :" "keyword:`global` assignment." msgstr "" +"Można również zauważyć, że nie było wcześniejszego powiązania dla *spam* " +"przed przypisaniem :keyword:`global`." msgid "A First Look at Classes" -msgstr "" +msgstr "Pierwsze spojrzenie na klasy" msgid "" "Classes introduce a little bit of new syntax, three new object types, and " "some new semantics." msgstr "" +"Klasy wprowadzają trochę nowej składni, trzy nowe typy obiektów i trochę " +"nowej semantyki." msgid "Class Definition Syntax" -msgstr "" +msgstr "Składnia definicji klasy" msgid "The simplest form of class definition looks like this::" -msgstr "" +msgstr "Najprostsza forma definicji klasy wygląda następująco::" msgid "" "Class definitions, like function definitions (:keyword:`def` statements) " @@ -302,6 +415,10 @@ msgid "" "a class definition in a branch of an :keyword:`if` statement, or inside a " "function.)" msgstr "" +"Definicje klas, podobnie jak definicje funkcji (instrukcje :keyword:`def`), " +"muszą zostać wykonane, zanim będą miały jakikolwiek efekt. (Można sobie " +"wyobrazić umieszczenie definicji klasy w gałęzi instrukcji :keyword:`if` lub " +"wewnątrz funkcji.)" msgid "" "In practice, the statements inside a class definition will usually be " @@ -310,6 +427,11 @@ msgid "" "normally have a peculiar form of argument list, dictated by the calling " "conventions for methods --- again, this is explained later." msgstr "" +"W praktyce, instrukcje wewnątrz definicji klasy będą zwykle definicjami " +"funkcji, ale inne instrukcje są dozwolone, a czasem przydatne --- wrócimy do " +"tego później. Definicje funkcji wewnątrz klasy zwykle mają specyficzną formę " +"listy argumentów, podyktowaną konwencjami wywoływania metod --- ponownie, " +"zostanie to wyjaśnione później." msgid "" "When a class definition is entered, a new namespace is created, and used as " @@ -317,6 +439,10 @@ msgid "" "new namespace. In particular, function definitions bind the name of the new " "function here." msgstr "" +"Po wejściu w definicję klasy tworzona jest nowa przestrzeń nazw i używana " +"jako zakres lokalny --- a zatem wszystkie przypisania do zmiennych lokalnych " +"trafiają do tej nowej przestrzeni nazw. W szczególności, definicje funkcji " +"wiążą nazwę nowej funkcji w tej przestrzeni nazw." msgid "" "When a class definition is left normally (via the end), a *class object* is " @@ -324,17 +450,26 @@ msgid "" "created by the class definition; we'll learn more about class objects in the " "next section. The original local scope (the one in effect just before the " "class definition was entered) is reinstated, and the class object is bound " -"here to the class name given in the class definition header (:class:" -"`ClassName` in the example)." +"here to the class name given in the class definition header (:class:`!" +"ClassName` in the example)." msgstr "" +"Kiedy definicja klasy jest opuszczana normalnie (przez koniec), tworzony " +"jest *obiekt klasy*. Jest to w zasadzie opakowanie wokół zawartości " +"przestrzeni nazw utworzonej przez definicję klasy; dowiemy się więcej o " +"obiektach klas w następnej sekcji. Oryginalny zakres lokalny (ten, który " +"obowiązywał tuż przed wprowadzeniem definicji klasy) zostaje przywrócony, a " +"obiekt klasy jest powiązany z nazwą klasy podaną w nagłówku definicja klasy " +"(:class:`!ClassName` w przykładzie)." msgid "Class Objects" -msgstr "" +msgstr "Obiekty klas" msgid "" "Class objects support two kinds of operations: attribute references and " "instantiation." msgstr "" +"Obiekty klas obsługują dwa rodzaje operacji: odniesienia do atrybutów i " +"tworzenie instancji." msgid "" "*Attribute references* use the standard syntax used for all attribute " @@ -342,12 +477,17 @@ msgid "" "that were in the class's namespace when the class object was created. So, " "if the class definition looked like this::" msgstr "" +"*Odniesienia do atrybutów* używają standardowej składni używanej dla " +"wszystkich odniesień do atrybutów w Pythonie: ``obj.name``. Prawidłowe " +"nazwy atrybutów to wszystkie nazwy, które znajdowały się w przestrzeni nazw " +"klasy, gdy obiekt klasy został utworzony. Tak więc, jeśli definicja klasy " +"wyglądała tak::" msgid "" "then ``MyClass.i`` and ``MyClass.f`` are valid attribute references, " "returning an integer and a function object, respectively. Class attributes " "can also be assigned to, so you can change the value of ``MyClass.i`` by " -"assignment. :attr:`__doc__` is also a valid attribute, returning the " +"assignment. :attr:`!__doc__` is also a valid attribute, returning the " "docstring belonging to the class: ``\"A simple example class\"``." msgstr "" @@ -356,49 +496,73 @@ msgid "" "object is a parameterless function that returns a new instance of the class. " "For example (assuming the above class)::" msgstr "" +"*Instancjonowanie* klasy używa notacji funkcji. Wystarczy wyobrazić sobie, " +"że obiekt klasy jest bezparametrową funkcją, która zwraca nową instancję " +"klasy. Na przykład (zakładając powyższą klasę)::" msgid "" "creates a new *instance* of the class and assigns this object to the local " "variable ``x``." msgstr "" +"tworzy nową *instancję* klasy i przypisuje ten obiekt do zmiennej lokalnej " +"``x``." msgid "" "The instantiation operation (\"calling\" a class object) creates an empty " "object. Many classes like to create objects with instances customized to a " "specific initial state. Therefore a class may define a special method named :" -"meth:`__init__`, like this::" +"meth:`~object.__init__`, like this::" msgstr "" +"Operacja instancjonowania („wywołanie” obiektu klasy) tworzy pusty obiekt. " +"Wiele klas lubi tworzyć obiekty z instancjami dostosowanymi do określonego " +"stanu początkowego. Dlatego klasa może zdefiniować specjalną metodę o " +"nazwie :meth:`~object.__init__`, taką jak ta::" msgid "" -"When a class defines an :meth:`__init__` method, class instantiation " -"automatically invokes :meth:`__init__` for the newly created class " +"When a class defines an :meth:`~object.__init__` method, class instantiation " +"automatically invokes :meth:`!__init__` for the newly created class " "instance. So in this example, a new, initialized instance can be obtained " "by::" msgstr "" +"Gdy klasa definiuje metodę :meth:`~object.__init__`, instancjonowanie klasy " +"automatycznie wywołuje :meth:`!__init__` dla nowo utworzonej instancji " +"klasy. Tak więc w tym przykładzie nową, zainicjalizowaną instancję można " +"uzyskać przez::" msgid "" -"Of course, the :meth:`__init__` method may have arguments for greater " -"flexibility. In that case, arguments given to the class instantiation " -"operator are passed on to :meth:`__init__`. For example, ::" +"Of course, the :meth:`~object.__init__` method may have arguments for " +"greater flexibility. In that case, arguments given to the class " +"instantiation operator are passed on to :meth:`!__init__`. For example, ::" msgstr "" +"Oczywiście metoda :meth:`~object.__init__` może mieć argumenty dla większej " +"elastyczności. W takim przypadku argumenty podane operatorowi " +"instancjonowania klasy są przekazywane do :meth:`!__init__`. Na przykład ::" msgid "Instance Objects" -msgstr "" +msgstr "Obiekty instancji" msgid "" "Now what can we do with instance objects? The only operations understood by " "instance objects are attribute references. There are two kinds of valid " "attribute names: data attributes and methods." msgstr "" +"Co możemy zrobić z obiektami instancji? Jedynymi operacjami rozumianymi " +"przez obiekty instancji są odniesienia do atrybutów. Istnieją dwa rodzaje " +"poprawnych nazw atrybutów: atrybuty danych i metody." msgid "" "*data attributes* correspond to \"instance variables\" in Smalltalk, and to " "\"data members\" in C++. Data attributes need not be declared; like local " "variables, they spring into existence when they are first assigned to. For " -"example, if ``x`` is the instance of :class:`MyClass` created above, the " +"example, if ``x`` is the instance of :class:`!MyClass` created above, the " "following piece of code will print the value ``16``, without leaving a " "trace::" msgstr "" +"*Dane atrybut* odpowiadają \"zmiennym instancji\" i \"członkom danych\" w C+" +"+. Dane atrybut nie muszą być deklarowane; podobnie jak zmienne lokalne, " +"powstają, gdy zostaną po raz pierwszy przypisane. Na przykład, jeśli ``x`` " +"jest instancją :class:`!MyClass` utworzoną powyżej, poniższy fragment kodu " +"wydrukuje wartość ``16``, bez pozostawiania śladu::" msgid "" "The other kind of instance attribute reference is a *method*. A method is a " @@ -418,31 +582,45 @@ msgid "" "not, since ``MyClass.i`` is not. But ``x.f`` is not the same thing as " "``MyClass.f`` --- it is a *method object*, not a function object." msgstr "" +"Prawidłowe nazwy metod obiektu instancji zależą od jego klasy. Z definicji " +"wszystkie atrybuty klasy, które są obiektami funkcji definiują odpowiednie " +"metody jej instancji. Tak więc w naszym przykładzie, ``x.f`` jest poprawnym " +"odwołaniem do metody, ponieważ ``MyClass.f`` jest funkcją, ale ``x.i`` nie " +"jest, ponieważ ``MyClass.i`` nie jest. Ale ``x.f`` nie jest tym samym co " +"``MyClass.f`` --- jest *obiektem metody*, a nie obiektem funkcji." msgid "Method Objects" -msgstr "" +msgstr "Obiekty metod" msgid "Usually, a method is called right after it is bound::" -msgstr "" +msgstr "Zazwyczaj metoda jest wywoływana zaraz po jej powiązaniu::" msgid "" -"In the :class:`MyClass` example, this will return the string ``'hello " +"In the :class:`!MyClass` example, this will return the string ``'hello " "world'``. However, it is not necessary to call a method right away: ``x.f`` " "is a method object, and can be stored away and called at a later time. For " "example::" msgstr "" +"W przykładzie :class:`!MyClass` będzie to zwracać napis ``'hello world'`` . " +"Nie jest jednak konieczne wywoływanie metody od razu: ``x.f`` jest obiektem " +"metody i może być przechowywany i wywoływany później. Na przykład::" msgid "will continue to print ``hello world`` until the end of time." -msgstr "" +msgstr "będzie drukować ``hello world`` do końca czasu." msgid "" "What exactly happens when a method is called? You may have noticed that ``x." "f()`` was called without an argument above, even though the function " -"definition for :meth:`f` specified an argument. What happened to the " +"definition for :meth:`!f` specified an argument. What happened to the " "argument? Surely Python raises an exception when a function that requires an " "argument is called without any --- even if the argument isn't actually " "used..." msgstr "" +"Co dokładnie dzieje się, gdy wywoływana jest metoda? Być może zauważyłeś, " +"że ``x.f()`` został wywołany bez argument powyżej, mimo że definicja funkcja " +"dla :meth:`!f` określała argument. Co się stało z argumentem? Z pewnością " +"Python rzucić wyjątek, gdy funkcja, który wymaga argument jest wywoływany " +"bez żadnego --- nawet jeśli argument nie jest faktycznie używany...." msgid "" "Actually, you may have guessed the answer: the special thing about methods " @@ -453,27 +631,42 @@ msgid "" "that is created by inserting the method's instance object before the first " "argument." msgstr "" - -msgid "" -"If you still don't understand how methods work, a look at the implementation " -"can perhaps clarify matters. When a non-data attribute of an instance is " -"referenced, the instance's class is searched. If the name denotes a valid " -"class attribute that is a function object, a method object is created by " -"packing (pointers to) the instance object and the function object just found " -"together in an abstract object: this is the method object. When the method " -"object is called with an argument list, a new argument list is constructed " -"from the instance object and the argument list, and the function object is " -"called with this new argument list." -msgstr "" +"Właściwie, być może zgadłeś odpowiedź: szczególną rzeczą w metodach jest to, " +"że obiekt instancji jest przekazywany jako pierwszy argument z funkcja. W " +"naszym przykładzie wywołanie ``x.f()`` jest dokładnie równoważne wywołaniu " +"``MyClass.f(x)``. Ogólnie rzecz biorąc, wywołanie metody z listą *n* " +"argument jest równoważne wywołaniu odpowiedniej funkcja z listą argument, " +"która jest tworzona przez wstawienie obiektu instancji metody przed " +"pierwszym argument." + +msgid "" +"In general, methods work as follows. When a non-data attribute of an " +"instance is referenced, the instance's class is searched. If the name " +"denotes a valid class attribute that is a function object, references to " +"both the instance object and the function object are packed into a method " +"object. When the method object is called with an argument list, a new " +"argument list is constructed from the instance object and the argument list, " +"and the function object is called with this new argument list." +msgstr "" +"Ogólnie rzecz biorąc, metody działają w następujący sposób. Gdy odwoływane " +"jest nie-dane atrybut instancji, wyszukiwana jest klasa instancji. Jeśli " +"nazwa wskazuje na prawidłową klasę atrybut, która jest obiektem funkcja, " +"odwołania zarówno do obiektu instancji, jak i obiektu funkcja są pakowane do " +"obiektu metody. Gdy obiekt metody jest wywoływany z listą argument, nowa " +"lista argument jest konstruowana z instancji obiektu i listy argument, a " +"obiekt funkcja jest wywoływany z tą nową listą argument." msgid "Class and Instance Variables" -msgstr "" +msgstr "Zmienne klas i instancji" msgid "" "Generally speaking, instance variables are for data unique to each instance " "and class variables are for attributes and methods shared by all instances " "of the class::" msgstr "" +"Ogólnie rzecz biorąc, zmienne instancji są dla danych unikalnych dla każdej " +"instancji, a zmienne klasy są dla atrybutów i metod współdzielonych przez " +"wszystkie instancje klasy::" msgid "" "As discussed in :ref:`tut-object`, shared data can have possibly surprising " @@ -482,17 +675,25 @@ msgid "" "not be used as a class variable because just a single list would be shared " "by all *Dog* instances::" msgstr "" +"Jak omówiono w :ref:`tut-object`, współdzielone dane mogą mieć zaskakujące " +"efekty z udziałem :term:`mutable` obiektów takich jak listy i słownik. Na " +"przykład, lista *sztuczki* w poniższym kodzie nie powinna być używana jako " +"zmienna klasowa, ponieważ tylko jedna lista byłaby współdzielona przez " +"wszystkie instancje klasy *Dog*::" msgid "Correct design of the class should use an instance variable instead::" msgstr "" +"Prawidłowy projekt klasy powinien zamiast tego używać zmiennej instancji::" msgid "Random Remarks" -msgstr "" +msgstr "Uwagi losowe" msgid "" "If the same attribute name occurs in both an instance and in a class, then " "attribute lookup prioritizes the instance::" msgstr "" +"Jeśli ten sam atrybut występuje zarówno w instancji, jak i w klasie, wówczas " +"wyszukiwanie atrybut nadaje priorytet instancji::" msgid "" "Data attributes may be referenced by methods as well as by ordinary users " @@ -503,6 +704,14 @@ msgid "" "implementation details and control access to an object if necessary; this " "can be used by extensions to Python written in C.)" msgstr "" +"Do danych atrybut mogą odwoływać się zarówno metody, jak i zwykli " +"użytkownicy (\"klienci\") obiektu. Innymi słowy, klasy nie nadają się do " +"implementacji czysto abstrakcyjnych typów danych. W rzeczywistości nic w " +"Python nie umożliwia wymuszenia ukrywania danych --- wszystko opiera się na " +"konwencji. (Z drugiej strony, implementacja Python, napisana w C, może " +"całkowicie ukryć szczegóły implementacji i kontrolować dostęp do obiektu, " +"jeśli to konieczne; może to być wykorzystane przez rozszerzenia Python " +"napisane w C)." msgid "" "Clients should use data attributes with care --- clients may mess up " @@ -511,6 +720,12 @@ msgid "" "without affecting the validity of the methods, as long as name conflicts are " "avoided --- again, a naming convention can save a lot of headaches here." msgstr "" +"Klienci powinni używać danych atrybut z ostrożnością --- klienci mogą zepsuć " +"niezmienniki utrzymywane przez metody poprzez stemplowanie ich danych " +"atrybut. Należy pamiętać, że klienci mogą dodawać własne dane atrybut do " +"obiektu instancji bez wpływu na ważność metod, o ile unika się konfliktów " +"nazw --- ponownie, konwencja nazewnictwa może tutaj zaoszczędzić wiele " +"problemow." msgid "" "There is no shorthand for referencing data attributes (or other methods!) " @@ -518,6 +733,10 @@ msgid "" "methods: there is no chance of confusing local variables and instance " "variables when glancing through a method." msgstr "" +"Nie ma skrótu do odwoływania się do danych atrybut (lub innych metod!) z " +"poziomu metod. Uważam, że w rzeczywistości zwiększa to czytelność metod: " +"nie ma szans na pomylenie zmiennych lokalnych i zmiennych instancji podczas " +"przeglądania metody." msgid "" "Often, the first argument of a method is called ``self``. This is nothing " @@ -527,6 +746,12 @@ msgid "" "that a *class browser* program might be written that relies upon such a " "convention." msgstr "" +"Często pierwsza argument metody jest nazywana ``self``. Jest to nic więcej " +"niż konwencja: nazwa ``self`` nie ma absolutnie żadnego specjalnego " +"znaczenia dla Python. Należy jednak pamiętać, że nieprzestrzeganie tej " +"konwencji może sprawić, że kod będzie mniej czytelny dla innych programistów " +"Python, a także możliwe jest napisanie programu *przeglądarki klas*, który " +"opiera się na takiej konwencji." msgid "" "Any function object that is a class attribute defines a method for instances " @@ -534,18 +759,28 @@ msgid "" "textually enclosed in the class definition: assigning a function object to a " "local variable in the class is also ok. For example::" msgstr "" +"Każdy obiekt funkcja będący klasą atrybut definiuje metodę dla instancji tej " +"klasy. Nie jest konieczne, aby definicja funkcja była tekstowo zawarta w " +"definicja klasy: przypisanie obiektu funkcja do zmiennej lokalnej w klasie " +"jest również w porządku. Na przykład::" msgid "" -"Now ``f``, ``g`` and ``h`` are all attributes of class :class:`C` that refer " -"to function objects, and consequently they are all methods of instances of :" -"class:`C` --- ``h`` being exactly equivalent to ``g``. Note that this " -"practice usually only serves to confuse the reader of a program." +"Now ``f``, ``g`` and ``h`` are all attributes of class :class:`!C` that " +"refer to function objects, and consequently they are all methods of " +"instances of :class:`!C` --- ``h`` being exactly equivalent to ``g``. Note " +"that this practice usually only serves to confuse the reader of a program." msgstr "" +"Teraz ``f``, ``g`` i ``h`` są wszystkie atrybut klasy :class:`!C`, które " +"odnoszą się do obiektów funkcja, a w konsekwencji wszystkie są metodami " +"instancji :class:`!C` --- ``h`` jest dokładnie równoważne ``g``. Zauważ, że " +"ta praktyka zwykle służy jedynie do zmylenia czytelnika programu." msgid "" "Methods may call other methods by using method attributes of the ``self`` " "argument::" msgstr "" +"Metody mogą wywoływać inne metody przy użyciu metody atrybut z ``self`` " +"argument ::" msgid "" "Methods may reference global names in the same way as ordinary functions. " @@ -558,23 +793,37 @@ msgid "" "itself defined in this global scope, and in the next section we'll find some " "good reasons why a method would want to reference its own class." msgstr "" +"Metody mogą odwoływać się do nazw globalnych w taki sam sposób jak zwykłe " +"funkcje. Zakres globalny powiązany z metodą to moduł zawierający jej " +"definicję. (Klasa nigdy nie jest używana jako zakres globalny.) Podczas gdy " +"rzadko można napotkać dobry powód do używania danych globalnych w metodzie, " +"istnieje wiele uzasadnionych zastosowań zakresu globalnego: po pierwsze, " +"funkcja i moduł importowane do zakresu globalnego mogą być używane przez " +"metody, a także funkcja i klasy w nim zdefiniowane. Zazwyczaj klasa " +"zawierająca metodę sama jest zdefiniowana w tym globalnym zakresie, a w " +"następnej sekcji znajdziemy kilka dobrych powodów, dla których metoda " +"chciałaby odwoływać się do własnej klasy." msgid "" "Each value is an object, and therefore has a *class* (also called its " "*type*). It is stored as ``object.__class__``." msgstr "" +"Każda wartość jest obiektem, a zatem ma *klasę* (zwaną również *typem*). " +"Jest ona przechowywana jako ``object.__class__``." msgid "Inheritance" -msgstr "" +msgstr "Dziedziczenie" msgid "" "Of course, a language feature would not be worthy of the name \"class\" " "without supporting inheritance. The syntax for a derived class definition " "looks like this::" msgstr "" +"Oczywiście funkcja językowa nie byłaby godna nazwy \"klasa\" bez obsługi " +"dziedziczenia. Składnia pochodnej definicja klasy wygląda tak::" msgid "" -"The name :class:`BaseClassName` must be defined in a scope containing the " +"The name :class:`!BaseClassName` must be defined in a scope containing the " "derived class definition. In place of a base class name, other arbitrary " "expressions are also allowed. This can be useful, for example, when the " "base class is defined in another module::" @@ -588,6 +837,12 @@ msgid "" "rule is applied recursively if the base class itself is derived from some " "other class." msgstr "" +"Wykonanie pochodnej definicja klasy przebiega tak samo, jak w przypadku " +"klasa bazowa. Gdy konstruowany jest obiekt klasy, zapamiętywany jest klasa " +"bazowa. Jest to wykorzystywane do rozwiązywania referencji atrybut: jeśli " +"żądany atrybut nie zostanie znaleziony w klasie, wyszukiwanie jest " +"kontynuowane w klasie bazowej. Ta reguła jest stosowana rekurencyjnie, jeśli " +"sama klasa bazowa jest pochodną innej klasy." msgid "" "There's nothing special about instantiation of derived classes: " @@ -596,6 +851,11 @@ msgid "" "searched, descending down the chain of base classes if necessary, and the " "method reference is valid if this yields a function object." msgstr "" +"Nie ma nic specjalnego w instancjonowaniu klas pochodnych: " +"``DerivedClassName()`` tworzy nową instancję klasy. Odniesienia do metod są " +"rozwiązywane w następujący sposób: odpowiednia klasa atrybut jest " +"przeszukiwana, w razie potrzeby schodząc w dół łańcucha klas bazowych, a " +"odniesienie do metody jest ważne, jeśli daje to obiekt funkcja." msgid "" "Derived classes may override methods of their base classes. Because methods " @@ -604,6 +864,12 @@ msgid "" "class may end up calling a method of a derived class that overrides it. " "(For C++ programmers: all methods in Python are effectively ``virtual``.)" msgstr "" +"Klasy pochodne mogą nadpisywać metody swoich klas bazowych. Ponieważ metody " +"nie mają specjalnych przywilejów podczas wywoływania innych metod tego " +"samego obiektu, metoda klasa bazowa, która wywołuje inną metodę zdefiniowaną " +"w tym samym klasa bazowa może skończyć się wywołaniem metody klasy " +"pochodnej, która ją nadpisuje. (Dla programistów C++: wszystkie metody w " +"Python są efektywnie ``virtual``)." msgid "" "An overriding method in a derived class may in fact want to extend rather " @@ -613,15 +879,24 @@ msgid "" "well. (Note that this only works if the base class is accessible as " "``BaseClassName`` in the global scope.)" msgstr "" +"Metoda nadrzędna w klasie pochodnej może w rzeczywistości chcieć rozszerzyć, " +"a nie tylko zastąpić metodę klasa bazowa o tej samej nazwie. Istnieje prosty " +"sposób na bezpośrednie wywołanie metody klasa bazowa: wystarczy wywołać " +"``BaseClassName.methodname(self, arguments)``. Jest to czasami przydatne " +"również dla klientów. (Należy pamiętać, że działa to tylko wtedy, gdy klasa " +"bazowa jest dostępna jako ``BaseClassName`` w zakresie globalnym)." msgid "Python has two built-in functions that work with inheritance:" -msgstr "" +msgstr "Python ma dwa wbudowane funkcje, które pracuja z dziedziczeniem:" msgid "" "Use :func:`isinstance` to check an instance's type: ``isinstance(obj, int)`` " "will be ``True`` only if ``obj.__class__`` is :class:`int` or some class " "derived from :class:`int`." msgstr "" +"Użyj :func:`isinstance` do sprawdzenia typu instancji: ``isinstance(obj, " +"int)`` będzie ``True`` tylko wtedy, gdy ``obj.__class__`` jest :class:`int` " +"lub jakąś klasą pochodną od :class:`int`." msgid "" "Use :func:`issubclass` to check class inheritance: ``issubclass(bool, int)`` " @@ -629,24 +904,37 @@ msgid "" "``issubclass(float, int)`` is ``False`` since :class:`float` is not a " "subclass of :class:`int`." msgstr "" +"Użyj :func:`issubclass` do sprawdzenia dziedziczenia klas: " +"``issubclass(bool, int)`` jest ``True``, ponieważ :class:`bool` jest " +"podklasa z :class:`int`. Jednak ``issubclass(float, int)`` jest ``False``, " +"ponieważ :class:`float` nie jest podklasa z :class:`int`." msgid "Multiple Inheritance" -msgstr "" +msgstr "Dziedziczenie wielokrotne" msgid "" "Python supports a form of multiple inheritance as well. A class definition " "with multiple base classes looks like this::" msgstr "" +"Python obsługuje również dziedziczenie wielokrotne. Strona definicja klasy " +"z wieloma klasami bazowymi wygląda tak::" msgid "" "For most purposes, in the simplest cases, you can think of the search for " "attributes inherited from a parent class as depth-first, left-to-right, not " "searching twice in the same class where there is an overlap in the " -"hierarchy. Thus, if an attribute is not found in :class:`DerivedClassName`, " -"it is searched for in :class:`Base1`, then (recursively) in the base classes " -"of :class:`Base1`, and if it was not found there, it was searched for in :" -"class:`Base2`, and so on." +"hierarchy. Thus, if an attribute is not found in :class:`!DerivedClassName`, " +"it is searched for in :class:`!Base1`, then (recursively) in the base " +"classes of :class:`!Base1`, and if it was not found there, it was searched " +"for in :class:`!Base2`, and so on." msgstr "" +"Dla większości celów, w najprostszych przypadkach, można myśleć o " +"wyszukiwaniu atrybut odziedziczonym po klasie nadrzędnej jako o wyszukiwaniu " +"w głąb, od lewej do prawej, nie szukając dwa razy w tej samej klasie, gdy " +"hierarchia się pokrywa. Tak więc, jeśli atrybut nie zostanie znaleziony w :" +"class:`!DerivedClassName`, jest szukany w :class:`!Base1`, a następnie " +"(rekurencyjnie) w klasach bazowych :class:`!Base1`, a jeśli nie zostanie tam " +"znaleziony, jest szukany w :class:`!Base2` i tak dalej." msgid "" "In fact, it is slightly more complex than that; the method resolution order " @@ -655,6 +943,12 @@ msgid "" "method and is more powerful than the super call found in single-inheritance " "languages." msgstr "" +"W rzeczywistości jest to nieco bardziej skomplikowane; kolejność " +"rozwiązywania metod zmienia się dynamicznie, aby wspierać kooperacyjne " +"wywołania :func:`super`. Podejście to jest znane w niektórych innych " +"językach wielokrotnego dziedziczenia jako call-next-method i jest bardziej " +"wydajne niż super wywołanie występujące w językach pojedynczego " +"dziedziczenia." msgid "" "Dynamic ordering is necessary because all cases of multiple inheritance " @@ -673,7 +967,7 @@ msgid "" msgstr "" msgid "Private Variables" -msgstr "" +msgstr "Zmienne prywatne" msgid "" "\"Private\" instance variables that cannot be accessed except from inside an " @@ -683,6 +977,13 @@ msgid "" "a function, a method or a data member). It should be considered an " "implementation detail and subject to change without notice." msgstr "" +"\"Prywatne\" zmienne instancje, do których nie można uzyskać dostępu inaczej " +"niż z wnętrza obiektu, nie istnieją w Python. Istnieje jednak konwencja, " +"której przestrzega większość kodu Python: nazwa poprzedzona podkreśleniem " +"(np. ``_spam``) powinna być traktowana jako niepubliczna część API " +"(niezależnie od tego, czy jest to funkcja, metoda czy członek danych). " +"Należy ją traktować jako szczegół implementacji i może ona ulec zmianie bez " +"powiadomienia." msgid "" "Since there is a valid use-case for class-private members (namely to avoid " @@ -694,11 +995,22 @@ msgid "" "stripped. This mangling is done without regard to the syntactic position of " "the identifier, as long as it occurs within the definition of a class." msgstr "" +"Ponieważ istnieje uzasadniony przypadek użycia dla członków klasy-prywatnej " +"(mianowicie, aby uniknąć kolizji nazw z nazwami zdefiniowanymi przez " +"podklasa), istnieje ograniczone wsparcie dla takiego mechanizmu, zwanego :" +"dfn:`name mangling`. Każdy identyfikator w postaci ``__spam`` (co najmniej " +"dwa początkowe podkreślenia, co najwyżej jedno końcowe podkreślenie) jest " +"tekstowo zastępowany przez ``_classname__spam``, gdzie ``classname`` jest " +"bieżącą nazwą klasy z usuniętymi początkowymi podkreśleniami. Zamiana ta " +"jest wykonywana bez względu na pozycję składniową identyfikatora, o ile " +"występuje on w definicji klasy." msgid "" "Name mangling is helpful for letting subclasses override methods without " "breaking intraclass method calls. For example::" msgstr "" +"Manipulowanie nazwami jest pomocne w umożliwieniu podklasa nadpisywania " +"metod bez przerywania wywołań metod wewnątrzklasowych. Na przykład::" msgid "" "The above example would work even if ``MappingSubclass`` were to introduce a " @@ -706,6 +1018,10 @@ msgid "" "the ``Mapping`` class and ``_MappingSubclass__update`` in the " "``MappingSubclass`` class respectively." msgstr "" +"Powyższy przykład zadziała nawet wtedy, gdy ``MappingSubclass`` wprowadzi " +"identyfikator ``__update``, ponieważ zostanie on zastąpiony odpowiednio " +"``_Mapping__update`` w klasie ``Mapping`` i ``_MappingSubclass__update`` w " +"klasie ``MappingSubclass``." msgid "" "Note that the mangling rules are designed mostly to avoid accidents; it " @@ -713,6 +1029,10 @@ msgid "" "private. This can even be useful in special circumstances, such as in the " "debugger." msgstr "" +"Należy pamiętać, że reguły mieszania zostały zaprojektowane głównie w celu " +"uniknięcia wypadków; nadal możliwy jest dostęp lub modyfikacja zmiennej, " +"która jest uważana za prywatną. Może to być nawet przydatne w szczególnych " +"okolicznościach, takich jak debugger." msgid "" "Notice that code passed to ``exec()`` or ``eval()`` does not consider the " @@ -722,38 +1042,60 @@ msgid "" "applies to ``getattr()``, ``setattr()`` and ``delattr()``, as well as when " "referencing ``__dict__`` directly." msgstr "" +"Zauważ, że kod przekazany do ``exec()`` lub ``eval()`` nie uważa nazwy klasy " +"wywołującej za bieżącą klasę; jest to podobne do efektu ``global`` " +"instrukcja , którego efekt jest również ograniczony do kodu, który jest " +"kompilowany bajtowo. To samo ograniczenie dotyczy ``getattr()``, " +"``setattr()`` i ``delattr()``, a także bezpośredniego odwoływania się do " +"``__dict__``." msgid "Odds and Ends" -msgstr "" +msgstr "Przypadki losowe" msgid "" "Sometimes it is useful to have a data type similar to the Pascal \"record\" " "or C \"struct\", bundling together a few named data items. The idiomatic " "approach is to use :mod:`dataclasses` for this purpose::" msgstr "" +"Czasami przydatne jest posiadanie typu danych podobnego do \"rekordu\" " +"Pascala lub \"struktury\" C, łączącego kilka nazwanych elementów danych. " +"Idiomatycznym podejściem jest użycie w tym celu :mod:`dataclasses`::" msgid "" "A piece of Python code that expects a particular abstract data type can " "often be passed a class that emulates the methods of that data type " "instead. For instance, if you have a function that formats some data from a " -"file object, you can define a class with methods :meth:`read` and :meth:`!" -"readline` that get the data from a string buffer instead, and pass it as an " -"argument." +"file object, you can define a class with methods :meth:`~io.TextIOBase.read` " +"and :meth:`~io.TextIOBase.readline` that get the data from a string buffer " +"instead, and pass it as an argument." msgstr "" +"Fragment kodu Python, który oczekuje określonego abstrakcyjnego typu danych, " +"może często zostać przekazany klasie, która emuluje metody tego typu " +"danych. Na przykład, jeśli masz klasę funkcja, która formatuje pewne dane z " +"obiektu pliku, możesz zdefiniować klasę z metodami :meth:`~io.TextIOBase." +"read` i :meth:`~io.TextIOBase.readline`, które pobierają dane z bufora napis " +"i przekazują je jako argument." msgid "" -"Instance method objects have attributes, too: ``m.__self__`` is the instance " -"object with the method :meth:`m`, and ``m.__func__`` is the function object " -"corresponding to the method." +":ref:`Instance method objects ` have attributes, too: :" +"attr:`m.__self__ ` is the instance object with the method :" +"meth:`!m`, and :attr:`m.__func__ ` is the :ref:`function " +"object ` corresponding to the method." msgstr "" +":ref:`Obiekty metod instancji ` także mają atrybuty: :attr:" +"`m.__self__ ` jest obiektem instancji z metodą :meth:`!m`, " +"i :attr:`m.__func__ ` jest :ref:`obiektem funkcji ` odpowiadającym metodzie." msgid "Iterators" -msgstr "" +msgstr "Iteratory" msgid "" "By now you have probably noticed that most container objects can be looped " "over using a :keyword:`for` statement::" msgstr "" +"Prawdopodobnie zauważyłeś już, że większość obiektów kontenera można " +"iterować za pomocą :keyword:`for` instrukcja ::" msgid "" "This style of access is clear, concise, and convenient. The use of " @@ -766,16 +1108,31 @@ msgid "" "terminate. You can call the :meth:`~iterator.__next__` method using the :" "func:`next` built-in function; this example shows how it all works::" msgstr "" +"Ten styl dostępu jest jasny, zwięzły i wygodny. Użycie iterators przenika i " +"ujednolica Python. Za kulisami, :keyword:`for` instrukcja wywołuje :func:" +"`iter` na obiekcie kontenera. Obiekt funkcja zwracać i iterator definiują " +"metodę :meth:`~iterator.__next__`, która uzyskuje dostęp do elementów w " +"kontenerze jeden po drugim. Gdy nie ma więcej elementów, :meth:`~iterator." +"__next__` rzucić wyjątek :exc:`StopIteration`, który informuje pętlę :" +"keyword:`!for` o zakończeniu. Metodę :meth:`~iterator.__next__` można " +"wywołać za pomocą :func:`next` wbudowanej funkcja; ten przykład pokazuje, " +"jak to wszystko działa::" msgid "" "Having seen the mechanics behind the iterator protocol, it is easy to add " -"iterator behavior to your classes. Define an :meth:`__iter__` method which " -"returns an object with a :meth:`~iterator.__next__` method. If the class " -"defines :meth:`__next__`, then :meth:`__iter__` can just return ``self``::" +"iterator behavior to your classes. Define an :meth:`~container.__iter__` " +"method which returns an object with a :meth:`~iterator.__next__` method. If " +"the class defines :meth:`!__next__`, then :meth:`!__iter__` can just return " +"``self``::" msgstr "" +"Po zapoznaniu się z mechaniką stojącą za protokołem iterator, łatwo jest " +"dodać iterator zachowanie do swoich klas. Zdefiniuj metodę :meth:" +"`~container.__iter__`, która zwracać obiekt z metodą :meth:`~iterator." +"__next__`. Jeśli klasa definiuje :meth:`!__next__`, to :meth:`!__iter__` " +"może po prostu zwracać ``self`` ::" msgid "Generators" -msgstr "" +msgstr "Generatory" msgid "" ":term:`Generators ` are a simple and powerful tool for creating " @@ -785,13 +1142,24 @@ msgid "" "the data values and which statement was last executed). An example shows " "that generators can be trivially easy to create::" msgstr "" +":term:`Generatory ` są prostym i potężnym narzędziem do tworzenia " +"iteratorów. Są one pisane jak zwykłe funkcje, ale używają instrukcji :" +"keyword:`yield` za każdym razem, gdy chcą zwracać dane. Za każdym razem, " +"gdy :func:`next` jest na nim wywoływany, generator wznawia działanie od " +"miejsca, w którym zostało przerwane (pamięta wszystkie wartości danych i " +"które instrukcje było ostatnio wykonywane). Przykład pokazuje, że tworzenie " +"generatorów może być banalnie proste::" msgid "" "Anything that can be done with generators can also be done with class-based " "iterators as described in the previous section. What makes generators so " -"compact is that the :meth:`__iter__` and :meth:`~generator.__next__` methods " -"are created automatically." +"compact is that the :meth:`~iterator.__iter__` and :meth:`~generator." +"__next__` methods are created automatically." msgstr "" +"Wszystko, co można zrobić za pomocą generatorów, można również zrobić za " +"pomocą iteratorów opartych na klasach, jak opisano w poprzedniej sekcji. " +"Kompaktowość generatorów polega na tym, że metody :meth:`~iterator.__iter__` " +"i :meth:`~generator.__next__` są tworzone automatycznie." msgid "" "Another key feature is that the local variables and execution state are " @@ -799,6 +1167,10 @@ msgid "" "and much more clear than an approach using instance variables like ``self." "index`` and ``self.data``." msgstr "" +"Inną kluczową cechą jest to, że zmienne lokalne i stan wykonania są " +"automatycznie zapisywane między wywołaniami. Sprawia to, że funkcja jest " +"łatwiejszy do napisania i znacznie bardziej przejrzysty niż podejście " +"wykorzystujące zmienne instancji, takie jak ``self.index`` i ``self.data``." msgid "" "In addition to automatic method creation and saving program state, when " @@ -806,9 +1178,13 @@ msgid "" "combination, these features make it easy to create iterators with no more " "effort than writing a regular function." msgstr "" +"Oprócz automatycznego tworzenia metod i zapisywania stanu programu, po " +"zakończeniu generatory automatycznie rzucić :exc:`StopIteration` . W " +"połączeniu, funkcje te ułatwiają tworzenie iteratorów bez większego wysiłku " +"niż napisanie zwykłego funkcja." msgid "Generator Expressions" -msgstr "" +msgstr "generator wyrażenia" msgid "" "Some simple generators can be coded succinctly as expressions using a syntax " @@ -818,9 +1194,16 @@ msgid "" "compact but less versatile than full generator definitions and tend to be " "more memory friendly than equivalent list comprehensions." msgstr "" +"Niektóre proste generatory mogą być kodowane w zwięzły sposób jako wyrażenia " +"przy użyciu składni podobnej do list comprehensions, ale z nawiasami zamiast " +"nawiasów kwadratowych. Wyrażenia te są przeznaczone do sytuacji, w których " +"generator jest używane od razu przez otaczającą je funkcja. Wyrażenia " +"generator są bardziej zwięzłe, ale mniej wszechstronne niż pełne definicje " +"generator i zwykle są bardziej przyjazne dla pamięci niż równoważne " +"wyrażenia listowe." msgid "Examples::" -msgstr "" +msgstr "Przykłady::" msgid "Footnotes" msgstr "Przypisy" @@ -835,13 +1218,13 @@ msgid "" msgstr "" msgid "object" -msgstr "" +msgstr "obiekt" msgid "method" -msgstr "" +msgstr "metoda" msgid "name" -msgstr "" +msgstr "nazwa" msgid "mangling" -msgstr "" +msgstr "maglowanie" diff --git a/tutorial/controlflow.po b/tutorial/controlflow.po index 0b3507d64e..098f0d2518 100644 --- a/tutorial/controlflow.po +++ b/tutorial/controlflow.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Bartosz Chmiel , 2021 -# Igor Zubrycki , 2021 -# Lidia Lipinska-Zubrycka , 2021 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:22+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +27,11 @@ msgid "More Control Flow Tools" msgstr "Więcej narzędzi kontroli przepływu" msgid "" -"Besides the :keyword:`while` statement just introduced, Python uses the " -"usual flow control statements known from other languages, with some twists." +"As well as the :keyword:`while` statement just introduced, Python uses a few " +"more that we will encounter in this chapter." msgstr "" -"Oprócz wprowadzonej przed chwilą instrukcji :keyword:`while`, Python używa " -"zwykłych instrukcji kontroli przepływu znanych z innych języków, z drobnymi " -"zmianami." +"Oprócz właśnie przedstawionego wyrażenia :keyword:`while`, Python używa " +"kilku innych, które napotkamy w tym rozdziale." msgid ":keyword:`!if` Statements" msgstr "Instrukcje :keyword:`!if`" @@ -178,24 +174,46 @@ msgstr "" "pętlach" msgid "" -"The :keyword:`break` statement, like in C, breaks out of the innermost " -"enclosing :keyword:`for` or :keyword:`while` loop." +"The :keyword:`break` statement breaks out of the innermost enclosing :" +"keyword:`for` or :keyword:`while` loop." msgstr "" -"Instrukcja :keyword:`break`, tak jak w C, wychodzi z najbardziej wewnętrznej " -"pętli :keyword:`for` lub :keyword:`while` zawierającej tę instrukcję." +"Instrukcja :keyword:`break` przerywa najbardziej wewnętrzną pętlę :keyword:" +"`for` lub :keyword:`while`." msgid "" -"Loop statements may have an :keyword:`!else` clause; it is executed when the " -"loop terminates through exhaustion of the iterable (with :keyword:`for`) or " -"when the condition becomes false (with :keyword:`while`), but not when the " -"loop is terminated by a :keyword:`break` statement. This is exemplified by " -"the following loop, which searches for prime numbers::" +"A :keyword:`!for` or :keyword:`!while` loop can include an :keyword:`!else` " +"clause." msgstr "" -"Instrukcje pętli mogą mieć klauzulę :keyword:`!else`. Jest ona wykonywana, " -"gdy pętla kończy się przez wyczerpanie się iterable'a (w pętli :keyword:" -"`for`) lub kiedy warunek staje się fałszywy (w pętli :keyword:`while`), lecz " -"nie gdy pętli jest przerwana przez instrukcję :keyword:`break`. Ilustruje to " -"poniższa pętla, która wyszukuje liczby pierwsze::" +"Pętla :keyword:`!for` lub :keyword:`!while` może zawierać klauzulę :keyword:" +"`!else`." + +msgid "" +"In a :keyword:`for` loop, the :keyword:`!else` clause is executed after the " +"loop reaches its final iteration." +msgstr "" +"W pętli :keyword:`for` klauzula :keyword:`!else` jest wykonywana po " +"osiągnięciu przez pętlę ostatniej iteracji." + +msgid "" +"In a :keyword:`while` loop, it's executed after the loop's condition becomes " +"false." +msgstr "" +"W pętli :keyword:`while`, klauzula wykonuje się ostatni raz po tym, jak " +"warunek pętli staje się fałszywy." + +msgid "" +"In either kind of loop, the :keyword:`!else` clause is **not** executed if " +"the loop was terminated by a :keyword:`break`." +msgstr "" +"W żadnym rodzaju pętli, klauzula :keyword:`!else` **nie** jest wykonywana, " +"jeśli pętla została przerwana przez :keyword:`break`." + +msgid "" +"This is exemplified in the following :keyword:`!for` loop, which searches " +"for prime numbers::" +msgstr "" +"Jest to zilustrowane w poniższej pętli :keyword:`!for`, która szuka liczb " +"pierwszych::" msgid "" "(Yes, this is the correct code. Look closely: the ``else`` clause belongs " @@ -352,10 +370,11 @@ msgstr "" msgid "" "Patterns can be arbitrarily nested. For example, if we have a short list of " -"points, we could match it like this::" +"Points, with ``__match_args__`` added, we could match it like this::" msgstr "" -"Wzorce mogą być dowolnie zagnieżdżane. Na przykład jeśli mamy krótką listę " -"punktów, możemy je dopasowywać w ten sposób::" +"Wzory mogą być zagnieżdżane w dowolny sposób. Na przykład, jeśli mamy krótką " +"listę punktów, z dodanym ``__match_args__``, możemy dopasować ją w " +"następujący sposób::" msgid "" "We can add an ``if`` clause to a pattern, known as a \"guard\". If the " @@ -564,9 +583,10 @@ msgid "" "the object's type. Different types define different methods. Methods of " "different types may have the same name without causing ambiguity. (It is " "possible to define your own object types and methods, using *classes*, see :" -"ref:`tut-classes`) The method :meth:`append` shown in the example is defined " -"for list objects; it adds a new element at the end of the list. In this " -"example it is equivalent to ``result = result + [a]``, but more efficient." +"ref:`tut-classes`) The method :meth:`!append` shown in the example is " +"defined for list objects; it adds a new element at the end of the list. In " +"this example it is equivalent to ``result = result + [a]``, but more " +"efficient." msgstr "" "Instrukcja ``result.append(a)`` wywołuje *metodę* listy obiektów ``result``. " "Metoda to funkcja, która „należy” do obiektu i jest nazwana ``obj." @@ -574,7 +594,7 @@ msgstr "" "``methodname`` jest nazwą metody, które jest zdefiniowana przez typ obiektu. " "Różne typy definiują różne metody. Metody różnych typów mogą mieć te same " "nazwy bez powodowania dwuznaczności. (Da się definiować własne typy obiektów " -"i metody, używając *klas*, patrz :ref:`tut-classes`.) Metoda :meth:`append` " +"i metody, używając *klas*, patrz :ref:`tut-classes`.) Metoda :meth:`!append` " "pokazana w przykładzie jest zdefiniowana dla listy obiektów; dodaje nowy " "element na końcu listy. W tym przykładzie jest równoważna ``result = result " "+ [a]``, ale bardziej wydajna." @@ -607,21 +627,20 @@ msgstr "Tę funkcję można wywołać na kilka sposobów:" msgid "" "giving only the mandatory argument: ``ask_ok('Do you really want to quit?')``" msgstr "" -"podając tylko wymagany argument: ``ask_ok('Do you really want to quit?')``" +"podając tylko wymagany argument: ``ask_ok('Czy na pewno chcesz wyjść?')``" msgid "" "giving one of the optional arguments: ``ask_ok('OK to overwrite the file?', " "2)``" msgstr "" -"podając jeden z opcjonalnych argumentów: ``ask_ok('OK to overwrite the " -"file?', 2)``" +"podając jeden z opcjonalnych argumentów: ``ask_ok('OK nadpisać plik?', 2)``" msgid "" "or even giving all arguments: ``ask_ok('OK to overwrite the file?', 2, 'Come " "on, only yes or no!')``" msgstr "" -"lub podając wszystkie argumenty: ``ask_ok('OK to overwrite file?', 2, 'Come " -"on, only yes or no!')``" +"lub podając wszystkie argumenty: ``ask_ok('OK nadpisać plik?', 2, 'No coś " +"ty, tylko tak lub nie!')``" msgid "" "This example also introduces the :keyword:`in` keyword. This tests whether " @@ -765,7 +784,7 @@ msgstr "" "słów kluczowych są również nazywane parametrami nazwanymi." msgid "Positional-or-Keyword Arguments" -msgstr "Argumenty pozycyjne-lub-kluczowe" +msgstr "Argumenty pozycyjne-lub-nazwane" msgid "" "If ``/`` and ``*`` are not present in the function definition, arguments may " @@ -775,7 +794,7 @@ msgstr "" "przekazywane i poprzez pozycje i przez słowa kluczowe." msgid "Positional-Only Parameters" -msgstr "Parametry Tylko-Pozycyjne (Positional-Only)" +msgstr "Parametry tylko-pozycyjne (positional-only)" msgid "" "Looking at this in a bit more detail, it is possible to mark certain " @@ -801,7 +820,7 @@ msgstr "" "*tylko-kluczowe*." msgid "Keyword-Only Arguments" -msgstr "Argumenty Tylko-Kluczowe (Keyword-Only)" +msgstr "Argumenty tylko-nazwane (keyword-only)" msgid "" "To mark parameters as *keyword-only*, indicating the parameters must be " @@ -814,7 +833,7 @@ msgstr "" "parametrem, który ma być przekazywany tylko przez słowo kluczowe." msgid "Function Examples" -msgstr "Przykłady Funkcji" +msgstr "Przykłady funkcji" msgid "" "Consider the following example function definitions paying close attention " @@ -1078,8 +1097,8 @@ msgstr "" "oraz :pep:`484` aby uzyskać więcej informacji)." msgid "" -":term:`Annotations ` are stored in the :attr:" -"`__annotations__` attribute of the function as a dictionary and have no " +":term:`Annotations ` are stored in the :attr:`!" +"__annotations__` attribute of the function as a dictionary and have no " "effect on any other part of the function. Parameter annotations are defined " "by a colon after the parameter name, followed by an expression evaluating to " "the value of the annotation. Return annotations are defined by a literal ``-" @@ -1087,8 +1106,8 @@ msgid "" "denoting the end of the :keyword:`def` statement. The following example has " "a required argument, an optional argument, and the return value annotated::" msgstr "" -":term:`Adnotacje ` przechowywane są w atrybucie :attr:" -"`__annotations__` funkcji jako słownik i nie mają oprócz żadnego innego " +":term:`Adnotacje ` przechowywane są w atrybucie :attr:`!" +"__annotations__` funkcji jako słownik i nie mają oprócz żadnego innego " "wpływu na nią. Adnotacje parametrów są definiowane po nazwie parametru i " "dwukropku, jako wyrażenie sprawdzające wartość argumentu. Adonotacje do " "zwracanego wyniku definiuje się pomiędzy nawiasem z listą parametrów a " diff --git a/tutorial/datastructures.po b/tutorial/datastructures.po index dded5db4e6..1600e5e7ff 100644 --- a/tutorial/datastructures.po +++ b/tutorial/datastructures.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +31,7 @@ msgid "" "detail, and adds some new things as well." msgstr "" "Ten rozdział opisuje bardziej szczegółowo niektóre rzeczy, które już " -"poznaliście, oraz również wprowadza nowe elementy." +"poznaliście, a także dodaje kilka nowych." msgid "More on Lists" msgstr "Więcej na temat list" @@ -40,7 +40,8 @@ msgid "" "The list data type has some more methods. Here are all of the methods of " "list objects:" msgstr "" -"Typ danych listy ma kilka więcej metod. To wszystkie metody obiektów listy:" +"Typ danych listy ma kilka dodatkowych metod. Poniżej znajdują się wszystkie " +"metody obiektów typu listy:" msgid "" "Add an item to the end of the list. Equivalent to ``a[len(a):] = [x]``." @@ -66,22 +67,19 @@ msgid "" "Remove the first item from the list whose value is equal to *x*. It raises " "a :exc:`ValueError` if there is no such item." msgstr "" -"Usuń pierwszy element z listy, którego wartość jest równa *x*. Rzuca :exc:" +"Usuwa pierwszy element z listy, którego wartość jest równa *x*. Rzuca :exc:" "`ValueError`, jeśli nie ma takiego elementu." msgid "" "Remove the item at the given position in the list, and return it. If no " "index is specified, ``a.pop()`` removes and returns the last item in the " -"list. (The square brackets around the *i* in the method signature denote " -"that the parameter is optional, not that you should type square brackets at " -"that position. You will see this notation frequently in the Python Library " -"Reference.)" +"list. It raises an :exc:`IndexError` if the list is empty or the index is " +"outside the list range." msgstr "" -"Usuwa element z podanej pozycji na liście i zwraca go. Jeśli indeks nie jest " -"podany, ``a.pop()`` usuwa i zwraca ostatni element listy. (Nawiasy " -"kwadratowe dookoła *i* w sygnaturze metody oznaczają, że ten parametr jest " -"opcjonalny, nie że powinieneś wpisać nawiasy kwadratowe w tym miejscu. Taką " -"notację będziesz często widzieć w dokumentacji biblioteki Pythona.)" +"Usuwa element na podanej pozycji na liście i zwraca go. Jeśli nie podano " +"indeksu, ``a.pop()`` usuwa i zwraca ostatnią pozycję na liście. Funkcja " +"rzuca :exc:`IndexError`, jeśli lista jest pusta lub indeks znajduje się poza " +"zakresem listy." msgid "Remove all items from the list. Equivalent to ``del a[:]``." msgstr "Usuwa wszystkie elementy z listy. Ekwiwalent ``del a[:]``." @@ -154,14 +152,14 @@ msgstr "Używanie list jako stosów" msgid "" "The list methods make it very easy to use a list as a stack, where the last " "element added is the first element retrieved (\"last-in, first-out\"). To " -"add an item to the top of the stack, use :meth:`append`. To retrieve an " -"item from the top of the stack, use :meth:`pop` without an explicit index. " -"For example::" +"add an item to the top of the stack, use :meth:`~list.append`. To retrieve " +"an item from the top of the stack, use :meth:`~list.pop` without an explicit " +"index. For example::" msgstr "" "Metody listy ułatwiają używanie listy jako stosu, gdzie ostatni element " "dodany jest pierwszym elementem pobieranym („last-in, first-out”). Aby dodać " -"element na wierzch stosu, użyj :meth:`append`. Aby pobrać element z wierzchu " -"stosu, użyj :meth:`pop` bez podanego indeksu. Na przykład::" +"element na wierzch stosu, użyj :meth:`~list.append`. Aby pobrać element z " +"wierzchu stosu, użyj :meth:`~list.pop` bez podanego indeksu. Na przykład::" msgid "Using Lists as Queues" msgstr "Używanie list jako kolejek" @@ -307,14 +305,14 @@ msgstr "Instrukcja :keyword:`!del`" msgid "" "There is a way to remove an item from a list given its index instead of its " -"value: the :keyword:`del` statement. This differs from the :meth:`pop` " -"method which returns a value. The :keyword:`!del` statement can also be " -"used to remove slices from a list or clear the entire list (which we did " +"value: the :keyword:`del` statement. This differs from the :meth:`~list." +"pop` method which returns a value. The :keyword:`!del` statement can also " +"be used to remove slices from a list or clear the entire list (which we did " "earlier by assignment of an empty list to the slice). For example::" msgstr "" "Element można usunąć z listy mając jego indeks zamiast wartości: instrukcją :" -"keyword:`del`. Jest ona różna od metody :meth:`pop`, która zwraca wartość. " -"Instrukcji :keyword:`!del` można też użyć do usunięcia slice'ów lub " +"keyword:`del`. Jest ona różna od metody :meth:`~list.pop`, która zwraca " +"wartość. Instrukcji :keyword:`!del` można też użyć do usunięcia slice'ów lub " "wyczyszczenia całej listy (zrobiliśmy to wcześniej przypisując pustą listę " "do slice'a). Na przykład::" @@ -466,7 +464,7 @@ msgid "" "tuple contains any mutable object either directly or indirectly, it cannot " "be used as a key. You can't use lists as keys, since lists can be modified " "in place using index assignments, slice assignments, or methods like :meth:" -"`append` and :meth:`extend`." +"`~list.append` and :meth:`~list.extend`." msgstr "" "Innym przydatnym typem danych wbudowanym w Pythona jest *słownik* (patrz :" "ref:`typesmapping`). Słowniki w innych językach czasem występują jako " @@ -478,7 +476,7 @@ msgstr "" "obiekt, bezpośrednio lub pośrednio, nie można jej użyć jako klucza. Nie " "możesz używać list jako kluczy, jako że listy mogą być modyfikowane „w " "miejscu” przy użyciu przypisań do indeksu, przypisań do slice'ów lub metod " -"jak :meth:`append` i :meth:`extend`." +"jak :meth:`~list.append` i :meth:`~list.extend`." msgid "" "It is best to think of a dictionary as a set of *key: value* pairs, with the " @@ -547,10 +545,10 @@ msgstr "Techniki pętli" msgid "" "When looping through dictionaries, the key and corresponding value can be " -"retrieved at the same time using the :meth:`items` method. ::" +"retrieved at the same time using the :meth:`~dict.items` method. ::" msgstr "" "Podczas iterowania po słownikach, klucz i odpowiadającą mu wartość można " -"pobrać w tym samym czasie używając metody :meth:`items`. ::" +"pobrać w tym samym czasie używając metody :meth:`~dict.items`. ::" msgid "" "When looping through a sequence, the position index and corresponding value " diff --git a/tutorial/errors.po b/tutorial/errors.po index 8f27a69c35..27280bf41b 100644 --- a/tutorial/errors.po +++ b/tutorial/errors.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Ciarbin , 2021 -# Jarosław Piszczała, 2021 -# Maciej Olko , 2022 -# Stefan Ocetkiewicz , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +31,10 @@ msgid "" "tried out the examples you have probably seen some. There are (at least) " "two distinguishable kinds of errors: *syntax errors* and *exceptions*." msgstr "" -"Do tej pory wiadomości o błędach były tylko wspomniane, ale jeśli próbowałaś " -"przykładów to pewnie udało Ci się na nie natknąć. Występują (przynajmniej) " -"dwa charakterystyczne typy błędów: *błędy składni* (syntax errors) oraz " -"*wyjątki* (exceptions)." +"Do tej pory wiadomości o błędach były tylko wspomniane, ale jeśli " +"próbowałaś(-łeś) przykładów to pewnie udało ci się na nie natknąć. Występują " +"(przynajmniej) dwa charakterystyczne typy błędów: *błędy składni* (syntax " +"errors) oraz *wyjątki* (exceptions)." msgid "Syntax Errors" msgstr "Błędy składni" @@ -47,17 +43,23 @@ msgid "" "Syntax errors, also known as parsing errors, are perhaps the most common " "kind of complaint you get while you are still learning Python::" msgstr "" -"Błędy składni, inaczej zwane błędami parsowania, to najczęstrze skargi jakie " -"otrzymasz w swoim kierunku gdy wciąż uczysz się Pythona ::" +"Błędy składni, znane również jako błędy parsowania, są prawdopodobnie " +"najczęstszym rodzajem skarg, które pojawiają się podczas nauki Pythona::" msgid "" -"The parser repeats the offending line and displays a little 'arrow' pointing " -"at the earliest point in the line where the error was detected. The error " -"is caused by (or at least detected at) the token *preceding* the arrow: in " -"the example, the error is detected at the function :func:`print`, since a " -"colon (``':'``) is missing before it. File name and line number are printed " -"so you know where to look in case the input came from a script." +"The parser repeats the offending line and displays little 'arrow's pointing " +"at the token in the line where the error was detected. The error may be " +"caused by the absence of a token *before* the indicated token. In the " +"example, the error is detected at the function :func:`print`, since a colon " +"(``':'``) is missing before it. File name and line number are printed so " +"you know where to look in case the input came from a script." msgstr "" +"Parser powtarza błędną linię i wyświetla małe „strzałki” wskazujące token w " +"linii, w której wykryto błąd. Błąd może być spowodowany brakiem tokenu " +"*przed* wskazywanym tokenem. W przykładzie błąd jest wykryty na funkcji :" +"func:`print`, ponieważ brakuje przed nią dwukropka (``':'``). Nazwa pliku i " +"numer linii są drukowane, abyś wiedział(a), gdzie szukać, w przypadku, gdy " +"dane wejściowe pochodzą ze skryptu." msgid "Exceptions" msgstr "Wyjątki" @@ -87,6 +89,14 @@ msgid "" "convention). Standard exception names are built-in identifiers (not reserved " "keywords)." msgstr "" +"Ostatni wiersz komunikatu o błędzie wskazuje, co się stało. Wyjątki " +"występują w różnych typach, a typ jest drukowany jako część komunikatu: typy " +"w przykładzie to :exc:`ZeroDivisionError`, :exc:`NameError` i :exc:" +"`TypeError`. Ciąg wydrukowany jako typ wyjątku jest nazwą wbudowanego " +"wyjątku, który wystąpił. Jest to prawdą dla wszystkich wbudowanych " +"wyjątków, ale nie musi być prawdą dla wyjątków zdefiniowanych przez " +"użytkownika (choć jest to przydatna konwencja). Standardowe nazwy wyjątków " +"są wbudowanymi identyfikatorami (nie zarezerwowanymi słowami kluczowymi)." msgid "" "The rest of the line provides detail based on the type of exception and what " @@ -101,6 +111,10 @@ msgid "" "a stack traceback listing source lines; however, it will not display lines " "read from standard input." msgstr "" +"Wcześniejsza część komunikatu o błędzie pokazuje kontekst, w którym wystąpił " +"wyjątek, w postaci śladu stosu. Ogólnie rzecz biorąc, zawiera on ślad stosu " +"z listą linii źródłowych; jednak nie wyświetli linii odczytanych ze " +"standardowego wejścia." msgid "" ":ref:`bltin-exceptions` lists the built-in exceptions and their meanings." @@ -117,6 +131,13 @@ msgid "" "generated interruption is signalled by raising the :exc:`KeyboardInterrupt` " "exception. ::" msgstr "" +"Możliwe jest pisanie programów, które obsługują wybrane wyjątki. Spójrzmy na " +"poniższy przykład, który prosi użytkownika o wprowadzenie danych, dopóki nie " +"zostanie wprowadzona poprawna liczba całkowita, ale pozwala użytkownikowi na " +"przerwanie programu (przy użyciu :kbd:`Control-C` lub czegokolwiek innego " +"obsługiwanego przez system operacyjny); zauważ, że przerwanie wygenerowane " +"przez użytkownika jest sygnalizowane przez podniesienie wyjątku :exc:" +"`KeyboardInterrupt`. ::" msgid "The :keyword:`try` statement works as follows." msgstr "Instrukcja :keyword:`try` działa następująco." @@ -141,13 +162,21 @@ msgid "" "named after the :keyword:`except` keyword, the *except clause* is executed, " "and then execution continues after the try/except block." msgstr "" +"Jeśli wyjątek wystąpi podczas wykonywania klauzuli :keyword:`try`, reszta " +"klauzuli jest pomijana. Następnie, jeśli jego typ pasuje do wyjątku " +"nazwanego po słowie kluczowym :keyword:`except`, wykonywana jest *klauzula " +"except*, a następnie wykonanie jest kontynuowane po bloku try/except." msgid "" "If an exception occurs which does not match the exception named in the " "*except clause*, it is passed on to outer :keyword:`try` statements; if no " -"handler is found, it is an *unhandled exception* and execution stops with a " -"message as shown above." +"handler is found, it is an *unhandled exception* and execution stops with an " +"error message." msgstr "" +"Jeśli wystąpi wyjątek, który nie pasuje do wyjątku nazwanego w *klauzuli " +"except*, jest on przekazywany do zewnętrznych instrukcji :keyword:`try`; " +"jeśli nie zostanie znaleziona obsługa, jest to *nieobsłużony wyjątek* i " +"wykonanie zatrzymuje się z komunikatem błędu." msgid "" "A :keyword:`try` statement may have more than one *except clause*, to " @@ -157,6 +186,12 @@ msgid "" "An *except clause* may name multiple exceptions as a parenthesized tuple, " "for example::" msgstr "" +"Instrukcja :keyword:`try` może mieć więcej niż jedną *klauzulę except*, aby " +"określić programy obsługi dla różnych wyjątków. Wykonany zostanie co " +"najwyżej jeden handler. Obsługiwane są tylko wyjątki, które występują w " +"odpowiadających im *klauzulach try*, a nie w kodzie obsługi tej samej " +"instrukcji :keyword:`!try`. *Klauzula except* może określać wiele wyjątków " +"krotką w nawiasach, na przykład::" msgid "" "A class in an :keyword:`except` clause is compatible with an exception if it " @@ -170,25 +205,37 @@ msgid "" "it would have printed B, B, B --- the first matching *except clause* is " "triggered." msgstr "" +"Zauważ, że jeśli *klauzule except* byłyby odwrócone (z ``except B`` na " +"pierwszym miejscu), wypisane zostałoby B, B, B --- uruchamiana jest pierwsza " +"pasująca *klauzula except*." msgid "" "When an exception occurs, it may have associated values, also known as the " "exception's *arguments*. The presence and types of the arguments depend on " "the exception type." msgstr "" +"Gdy wystąpi wyjątek, może on mieć powiązane wartości, znane również jako " +"*argumenty* wyjątku. Obecność i typy argumentów zależą od typu wyjątku." msgid "" "The *except clause* may specify a variable after the exception name. The " "variable is bound to the exception instance which typically has an ``args`` " "attribute that stores the arguments. For convenience, builtin exception " -"types define :meth:`__str__` to print all the arguments without explicitly " -"accessing ``.args``. ::" +"types define :meth:`~object.__str__` to print all the arguments without " +"explicitly accessing ``.args``. ::" msgstr "" +"*Klauzula except* może określać nazwę zmiennej po nazwie wyjątku. Zmienna " +"jest powiązana z instancją wyjątku, która zazwyczaj posiada atrybut ``args`` " +"przechowujący argumenty. Dla wygody, typy wyjątków wbudowanych definiują :" +"meth:`~object.__str__` drukującą wszystkie argumenty bez odwoływania się do " +"``.args``. ::" msgid "" -"The exception's :meth:`__str__` output is printed as the last part " +"The exception's :meth:`~object.__str__` output is printed as the last part " "('detail') of the message for unhandled exceptions." msgstr "" +"Dane wyjściowe metody :meth:`~object.__str__` wyjątku są drukowane jako " +"ostatnia część ('szczegóły') komunikatu dla nieobsłużonych wyjątków." msgid "" ":exc:`BaseException` is the common base class of all exceptions. One of its " @@ -199,6 +246,13 @@ msgid "" "exit` and :exc:`KeyboardInterrupt` which is raised when a user wishes to " "interrupt the program." msgstr "" +":exc:`BaseException` jest wspólną klasą bazową wszystkich wyjątków. Jedna z " +"jej podklas, :exc:`Exception`, jest klasą bazową wszystkich nie-fatalnych " +"wyjątków. Wyjątki, które nie są podklasami :exc:`Exception` nie są zazwyczaj " +"obsługiwane, ponieważ są używane do wskazania, że program powinien się " +"zakończyć. Obejmują one :exc:`SystemExit`, który jest rzucany przez :meth:" +"`sys.exit` i :exc:`KeyboardInterrupt`, które są rzucane, gdy użytkownik chce " +"przerwać program." msgid "" ":exc:`Exception` can be used as a wildcard that catches (almost) everything. " @@ -206,12 +260,19 @@ msgid "" "exceptions that we intend to handle, and to allow any unexpected exceptions " "to propagate on." msgstr "" +":exc:`Exception` może być używany jako symbol wieloznaczny, który " +"przechwytuje (prawie) wszystko. Dobrą praktyką jest jednak jak " +"najdokładniejsze określenie typów wyjątków, które zamierzamy obsługiwać, i " +"umożliwienie propagacji wszelkim nieoczekiwanym wyjątkom." msgid "" "The most common pattern for handling :exc:`Exception` is to print or log the " "exception and then re-raise it (allowing a caller to handle the exception as " "well)::" msgstr "" +"Najczęstszym wzorcem obsługi :exc:`Exception` jest drukowanie lub " +"umieszczenie wyjątku w logach, a następnie ponowne rzucenie go (umożliwiając " +"również obsługę wyjątku funkcji, w której znajduje się wywołanie)::" msgid "" "The :keyword:`try` ... :keyword:`except` statement has an optional *else " @@ -219,6 +280,10 @@ msgid "" "useful for code that must be executed if the *try clause* does not raise an " "exception. For example::" msgstr "" +"Instrukcja :keyword:`try` … :keyword:`except` posiada opcjonalną *klauzulę " +"else*, która, gdy jest obecna, musi następować po wszystkich *klauzulach " +"except*. Jest to przydatne w przypadku kodu, który musi zostać wykonany, " +"jeśli *klauzula try* nie rzuci wyjątku. Na przykład::" msgid "" "The use of the :keyword:`!else` clause is better than adding additional code " @@ -226,12 +291,20 @@ msgid "" "exception that wasn't raised by the code being protected by the :keyword:`!" "try` ... :keyword:`!except` statement." msgstr "" +"Użycie klauzuli :keyword:`!else` jest lepsze niż dodanie dodatkowego kodu do " +"klauzuli :keyword:`try`, ponieważ pozwala uniknąć przypadkowego wychwycenia " +"wyjątku, który nie został rzucony przez kod chroniony instrukcją :keyword:`!" +"try`… :keyword:`!except`." msgid "" "Exception handlers do not handle only exceptions that occur immediately in " "the *try clause*, but also those that occur inside functions that are called " "(even indirectly) in the *try clause*. For example::" msgstr "" +"Instrukcja `try` … `catch` nie obsługuje tylko wyjątków, które występują " +"bezpośrednio w *klauzuli try*, ale także te, które występują wewnątrz " +"funkcji, które są wywoływane (nawet pośrednio) w *klauzuli try*. Na " +"przykład::" msgid "Raising Exceptions" msgstr "Rzucanie wyjątków" @@ -250,12 +323,20 @@ msgid "" "its subclasses). If an exception class is passed, it will be implicitly " "instantiated by calling its constructor with no arguments::" msgstr "" +"Jedyny argument do :keyword:`raise` wskazuje wyjątek, który ma być rzucony. " +"Musi to być albo instancja wyjątku, albo klasa wyjątku (klasa dziedzicząca " +"z :class:`BaseException`, taka jak :exc:`Exception` lub jedna z jej " +"podklas). Jeśli przekazana zostanie klasa wyjątku, zostanie ona niejawnie " +"zainicjowana przez wywołanie jej konstruktora bez argumentów::" msgid "" "If you need to determine whether an exception was raised but don't intend to " "handle it, a simpler form of the :keyword:`raise` statement allows you to re-" "raise the exception::" msgstr "" +"Jeśli chcesz rozpoznać, czy wyjątek został rzucony, ale nie zamierzasz go " +"obsługiwać, prostsza forma instrukcji :keyword:`raise` pozwala na ponowne " +"rzucenie wyjątku::" msgid "Exception Chaining" msgstr "Łańcuch wyjątków" @@ -265,23 +346,32 @@ msgid "" "will have the exception being handled attached to it and included in the " "error message::" msgstr "" +"Jeśli nieobsłużony wyjątek wystąpi wewnątrz sekcji :keyword:`except`, " +"zostanie do niego dołączony obsługiwany wyjątek i uwzględniony w komunikacie " +"o błędzie::" msgid "" "To indicate that an exception is a direct consequence of another, the :" "keyword:`raise` statement allows an optional :keyword:`from` clause::" msgstr "" +"Aby wskazać, że wyjątek jest bezpośrednią konsekwencją innego, instrukcja :" +"keyword:`raise` dopuszcza opcjonalną klauzulę :keyword:`from`::" msgid "This can be useful when you are transforming exceptions. For example::" -msgstr "" +msgstr "Może to być przydatne podczas przekształcania wyjątków. Na przykład::" msgid "" "It also allows disabling automatic exception chaining using the ``from " "None`` idiom::" msgstr "" +"Umożliwia również wyłączenie automatycznego łączenia wyjątków przy użyciu " +"idiomu ``from None``::" msgid "" "For more information about chaining mechanics, see :ref:`bltin-exceptions`." msgstr "" +"Więcej informacji na temat mechaniki łączenia w łańcuchy można znaleźć w " +"rozdziale :ref:`bltin-exceptions`." msgid "User-defined Exceptions" msgstr "Wyjątki zdefiniowane przez użytkownika" @@ -292,6 +382,10 @@ msgid "" "typically be derived from the :exc:`Exception` class, either directly or " "indirectly." msgstr "" +"Programy mogą nazywać własne wyjątki, tworząc nową klasę wyjątków (więcej " +"informacji na temat klas Python można znaleźć w rozdziale :ref:`tut-" +"classes`). Wyjątki powinny zazwyczaj dziedziczyć z klasy :exc:`Exception`, " +"bezpośrednio lub pośrednio." msgid "" "Exception classes can be defined which do anything any other class can do, " @@ -299,25 +393,36 @@ msgid "" "allow information about the error to be extracted by handlers for the " "exception." msgstr "" +"Można zdefiniować klasy wyjątków, które robią wszystko, co może zrobić każda " +"inna klasa, ale zwykle są one proste, często oferując tylko kilka atrybutów, " +"które pozwalają na wyodrębnienie informacji o błędzie przez kod obsługi " +"wyjątku." msgid "" "Most exceptions are defined with names that end in \"Error\", similar to the " "naming of the standard exceptions." msgstr "" +"Większość wyjątków ma nazwy kończące się na „Error”, podobnie jak w " +"przypadku standardowych wyjątków." msgid "" "Many standard modules define their own exceptions to report errors that may " "occur in functions they define." msgstr "" +"Wiele standardowych modułów definiuje własne wyjątki w celu zgłaszania " +"błędów, które mogą wystąpić w zdefiniowanych w nich funkcjach." msgid "Defining Clean-up Actions" -msgstr "" +msgstr "Definiowanie działań porządkujących" msgid "" "The :keyword:`try` statement has another optional clause which is intended " "to define clean-up actions that must be executed under all circumstances. " "For example::" msgstr "" +"Instrukcja :keyword:`try` ma inną opcjonalną klauzulę, która jest " +"przeznaczona do definiowania działań porządkujących, które muszą być " +"wykonane w każdych okolicznościach. Na przykład::" msgid "" "If a :keyword:`finally` clause is present, the :keyword:`!finally` clause " @@ -326,6 +431,11 @@ msgid "" "statement produces an exception. The following points discuss more complex " "cases when an exception occurs:" msgstr "" +"Jeśli klauzula :keyword:`finally` jest obecna, klauzula :keyword:`!finally` " +"wykona się jako ostatnie zadanie przed zakończeniem instrukcji :keyword:" +"`try`. Klauzula :keyword:`!finally` uruchomi się niezależnie od tego, czy " +"instrukcja :keyword:`!try` spowoduje wyjątek. Poniższe punkty omawiają " +"bardziej złożone przypadki wystąpienia wyjątku:" msgid "" "If an exception occurs during execution of the :keyword:`!try` clause, the " @@ -333,17 +443,26 @@ msgid "" "not handled by an :keyword:`!except` clause, the exception is re-raised " "after the :keyword:`!finally` clause has been executed." msgstr "" +"Jeśli podczas wykonywania klauzuli :keyword:`!try` wystąpi wyjątek, może on " +"zostać obsłużony przez klauzulę :keyword:`except`. Jeśli wyjątek nie " +"zostanie obsłużony przez klauzulę :keyword:`!except`, zostanie on ponownie " +"rzucony po wykonaniu klauzuli :keyword:`!finally`." msgid "" "An exception could occur during execution of an :keyword:`!except` or :" "keyword:`!else` clause. Again, the exception is re-raised after the :keyword:" "`!finally` clause has been executed." msgstr "" +"Wyjątek może wystąpić podczas wykonywania klauzul :keyword:`!except` lub :" +"keyword:`!else`. Ponownie, wyjątek jest ponownie rzucany po wykonaniu " +"klauzuli :keyword:`!finally`." msgid "" "If the :keyword:`!finally` clause executes a :keyword:`break`, :keyword:" "`continue` or :keyword:`return` statement, exceptions are not re-raised." msgstr "" +"Jeśli klauzula :keyword:`!finally` wykonuje instrukcje :keyword:`break`, :" +"keyword:`continue` lub :keyword:`return`, wyjątki nie są ponownie rzucane." msgid "" "If the :keyword:`!try` statement reaches a :keyword:`break`, :keyword:" @@ -351,6 +470,10 @@ msgid "" "will execute just prior to the :keyword:`!break`, :keyword:`!continue` or :" "keyword:`!return` statement's execution." msgstr "" +"Jeśli instrukcja :keyword:`!try` osiągnie instrukcję :keyword:`break`, :" +"keyword:`continue` lub :keyword:`return`, klauzula :keyword:`!finally` " +"wykona się tuż przed wykonaniem instrukcji :keyword:`!break`, :keyword:`!" +"continue` lub :keyword:`!return`." msgid "" "If a :keyword:`!finally` clause includes a :keyword:`!return` statement, the " @@ -358,9 +481,13 @@ msgid "" "keyword:`!return` statement, not the value from the :keyword:`!try` " "clause's :keyword:`!return` statement." msgstr "" +"Jeśli klauzula :keyword:`!finally` zawiera instrukcję :keyword:`!return`, " +"zwróconą wartością będzie ta z instrukcji :keyword:`!return` klauzuli :" +"keyword:`!finally`, a nie wartość z instrukcji :keyword:`!return` klauzuli :" +"keyword:`!try`." msgid "For example::" -msgstr "Na przykład::" +msgstr "Dla przykładu::" msgid "A more complicated example::" msgstr "Bardziej skomplikowany przykład::" @@ -371,15 +498,22 @@ msgid "" "keyword:`except` clause and therefore re-raised after the :keyword:`!" "finally` clause has been executed." msgstr "" +"Jak widać, klauzula :keyword:`finally` jest wykonywana w każdym przypadku. :" +"exc:`TypeError` rzucony przez dzielenie dwóch ciągów znaków nie jest " +"obsłużony przez klauzulę :keyword:`except` i dlatego jest ponownie rzucony " +"po wykonaniu klauzuli :keyword:`!finally`." msgid "" "In real world applications, the :keyword:`finally` clause is useful for " "releasing external resources (such as files or network connections), " "regardless of whether the use of the resource was successful." msgstr "" +"W prawdziwych aplikacjach, klauzula :keyword:`finally` jest przydatna do " +"zwalniania zewnętrznych zasobów (takich jak pliki lub połączenia sieciowe), " +"niezależnie od tego, czy użycie zasobu zakończyło się powodzeniem." msgid "Predefined Clean-up Actions" -msgstr "" +msgstr "Predefiniowane akcje porządkujące" msgid "" "Some objects define standard clean-up actions to be undertaken when the " @@ -387,6 +521,11 @@ msgid "" "the object succeeded or failed. Look at the following example, which tries " "to open a file and print its contents to the screen. ::" msgstr "" +"Niektóre obiekty definiują standardowe akcje porządkujące, które mają zostać " +"podjęte, gdy obiekt nie jest już potrzebny, niezależnie od tego, czy " +"operacja przy użyciu obiektu powiodła się, czy nie. Spójrz na poniższy " +"przykład, który próbuje otworzyć plik i wydrukować jego zawartość na " +"ekranie::" msgid "" "The problem with this code is that it leaves the file open for an " @@ -396,6 +535,12 @@ msgid "" "to be used in a way that ensures they are always cleaned up promptly and " "correctly. ::" msgstr "" +"Problem z tym kodem polega na tym, że pozostawia on plik otwarty przez " +"nieokreślony czas po zakończeniu wykonywania tej części kodu. Nie jest to " +"problemem w prostych skryptach, ale może być problemem dla większych " +"aplikacjach. Instrukcja :keyword:`with` pozwala na używanie obiektów takich " +"jak pliki w sposób, który zapewnia, że są one zawsze czyszczone szybko i " +"poprawnie::" msgid "" "After the statement is executed, the file *f* is always closed, even if a " @@ -403,9 +548,13 @@ msgid "" "files, provide predefined clean-up actions will indicate this in their " "documentation." msgstr "" +"Po wykonaniu instrukcji, plik *f* jest zawsze zamykany, nawet jeśli " +"napotkano problem podczas przetwarzania linii. Obiekty, które, podobnie jak " +"pliki, zapewniają predefiniowane akcje czyszczenia, wskażą to w swojej " +"dokumentacji." msgid "Raising and Handling Multiple Unrelated Exceptions" -msgstr "" +msgstr "Rzucanie i obsługa wielu niepowiązanych wyjątków" msgid "" "There are situations where it is necessary to report several exceptions that " @@ -414,12 +563,20 @@ msgid "" "cases where it is desirable to continue execution and collect multiple " "errors rather than raise the first exception." msgstr "" +"Istnieją sytuacje, w których konieczne jest zgłoszenie kilku wyjątków, które " +"wystąpiły. Dzieje się tak często w przypadku frameworków współbieżności, gdy " +"kilka zadań może zakończyć się niepowodzeniem równolegle, ale istnieją " +"również inne przypadki użycia, w których pożądane jest kontynuowanie " +"wykonywania i zbieranie wielu błędów zamiast rzucenia pierwszego wyjątku." msgid "" "The builtin :exc:`ExceptionGroup` wraps a list of exception instances so " "that they can be raised together. It is an exception itself, so it can be " "caught like any other exception. ::" msgstr "" +"Wbudowana :exc:`ExceptionGroup` zawiera listę instancji wyjątków, dzięki " +"czemu mogą one być rzucone razem. Sama w sobie jest wyjątkiem, więc może być " +"przechwycona jak każdy inny wyjątek::" msgid "" "By using ``except*`` instead of ``except``, we can selectively handle only " @@ -428,6 +585,12 @@ msgid "" "extracts from the group exceptions of a certain type while letting all other " "exceptions propagate to other clauses and eventually to be reraised. ::" msgstr "" +"Używając ``except*`` zamiast ``except``, możemy selektywnie obsługiwać tylko " +"te wyjątki w grupie, które pasują do określonego typu. W poniższym " +"przykładzie, który pokazuje zagnieżdżoną grupę wyjątków, każda klauzula " +"``except*`` wyodrębnia z grupy wyjątki określonego typu, pozwalając " +"wszystkim innym wyjątkom propagować się do innych klauzul i ostatecznie być " +"ponownie zgłaszanymi. ::" msgid "" "Note that the exceptions nested in an exception group must be instances, not " @@ -435,9 +598,13 @@ msgid "" "that have already been raised and caught by the program, along the following " "pattern::" msgstr "" +"Należy pamiętać, że wyjątki zagnieżdżone w grupie wyjątków muszą być " +"instancjami, a nie typami. Wynika to z faktu, że w praktyce wyjątki są " +"zazwyczaj tymi, które zostały już rzucone i przechwycone przez program, " +"zgodnie z następującym wzorcem::" msgid "Enriching Exceptions with Notes" -msgstr "" +msgstr "Wzbogacanie wyjątków o notatki" msgid "" "When an exception is created in order to be raised, it is usually " @@ -448,9 +615,18 @@ msgid "" "standard traceback rendering includes all notes, in the order they were " "added, after the exception. ::" msgstr "" +"Gdy wyjątek jest tworzony w celu rzucenia, jest on zwykle inicjowany " +"informacjami opisującymi błąd, który wystąpił. Istnieją przypadki, w których " +"przydatne jest dodanie informacji po przechwyceniu wyjątku. W tym celu " +"wyjątki mają metodę ``add_note(note)``, która akceptuje ciąg znaków i dodaje " +"go do listy notatek wyjątku. Standardowe renderowanie tracebacku zawiera " +"wszystkie notatki, w kolejności, w jakiej zostały dodane, po wyjątku. ::" msgid "" "For example, when collecting exceptions into an exception group, we may want " "to add context information for the individual errors. In the following each " "exception in the group has a note indicating when this error has occurred. ::" msgstr "" +"Na przykład zbierając wyjątki w grupę wyjątków, możemy chcieć dodać " +"informacje kontekstowe dla poszczególnych błędów. Poniżej każdy wyjątek w " +"grupie ma notatkę wskazującą, kiedy wystąpił. ::" diff --git a/tutorial/floatingpoint.po b/tutorial/floatingpoint.po index b7176cbac5..2a2874dd34 100644 --- a/tutorial/floatingpoint.po +++ b/tutorial/floatingpoint.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 -# Ciarbin , 2022 +# Rafael Fontenelle , 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:50+0000\n" -"Last-Translator: Ciarbin , 2022\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -35,12 +34,6 @@ msgid "" "values, the only real difference being that the first is written in base 10 " "fractional notation, and the second in base 2." msgstr "" -"Liczby zmiennoprzecinkowe są reprezentowane w komputerze jako ułamki o " -"podstawie 2 (binarne). Na przykład **dziesiętny** ułamek ``0.125`` ma " -"wartość 1/10 + 2/100 + 5/1000 i analogicznie **binarny** ułamek ``0.001`` ma " -"wartość 0/2 + 0/4 + 1/8. Te dwa ułamki mają identyczne wartości, a jedyną " -"prawdziwą różnicą jest to, że pierwszy jest zapisany w notacji ułamkowej o " -"podstawie 10, a drugi o podstawie 2." msgid "" "Unfortunately, most decimal fractions cannot be represented exactly as " @@ -103,20 +96,11 @@ msgid "" "if Python were to print the true decimal value of the binary approximation " "stored for 0.1, it would have to display ::" msgstr "" -"Wielu użytkowników nie jest świadomych przybliżenia ze względu na sposób " -"wyświetlania wartości. Python wypisuje tylko przybliżenie dziesiętne do " -"prawdziwej wartości dziesiętnej przybliżenia binarnego zapisanego przez " -"maszynę. Na większości maszyn, gdyby Python miał wydrukować prawdziwą " -"wartość dziesiętną przybliżenia binarnego zapisanego dla 0,1 musiałby " -"wyświetlić ::" msgid "" "That is more digits than most people find useful, so Python keeps the number " "of digits manageable by displaying a rounded value instead ::" msgstr "" -"To więcej cyfr, niż większość ludzi uważa za przydatne, więc Python " -"utrzymuje liczbę cyfr tak by były one do opanowania, wyświetlając zamiast " -"tego zaokrągloną wartość ::" msgid "" "Just remember, even though the printed result looks like the exact value of " @@ -171,8 +155,6 @@ msgid "" "For more pleasant output, you may wish to use string formatting to produce a " "limited number of significant digits::" msgstr "" -"Aby uzyskać przyjemniejszy wynik, możesz użyć formatowania ciągu znaków w " -"celu uzyskania ograniczonej liczby cyfr znaczących::" msgid "" "It's important to realize that this is, in a real sense, an illusion: you're " @@ -185,39 +167,37 @@ msgid "" "One illusion may beget another. For example, since 0.1 is not exactly 1/10, " "summing three values of 0.1 may not yield exactly 0.3, either::" msgstr "" -"Jedna iluzja może zrodzić kolejną. Na przykład, z powodu że 0,1 nie jest " -"dokładnie 1/10, zsumowanie trzech wartości 0,1 może nie dać dokładnie 0,3::" msgid "" "Also, since the 0.1 cannot get any closer to the exact value of 1/10 and 0.3 " "cannot get any closer to the exact value of 3/10, then pre-rounding with :" "func:`round` function cannot help::" msgstr "" -"Ponadto, ponieważ 0,1 nie może zbliżyć się do dokładnej wartości 1/10, a 0,3 " -"nie może zbliżyć się do dokładnej wartości 3/10, to wstępne zaokrąglenie za " -"pomocą funkcji :func:`round` nie może pomóc::" msgid "" "Though the numbers cannot be made closer to their intended exact values, " "the :func:`round` function can be useful for post-rounding so that results " "with inexact values become comparable to one another::" msgstr "" -"Chociaż liczb nie można już bardziej przybliżyć do ich dokładnych wartości, " -"funkcja :func:`round` może być przydatna do późniejszego zaokrąglenia, tak " -"aby wyniki z niedokładnymi wartościami stały się porównywalne ze sobą::" msgid "" "Binary floating-point arithmetic holds many surprises like this. The " "problem with \"0.1\" is explained in precise detail below, in the " -"\"Representation Error\" section. See `The Perils of Floating Point " -"`_ for a more complete account of other " -"common surprises." +"\"Representation Error\" section. See `Examples of Floating Point Problems " +"`_ for " +"a pleasant summary of how binary floating-point works and the kinds of " +"problems commonly encountered in practice. Also see `The Perils of Floating " +"Point `_ for a more complete " +"account of other common surprises." msgstr "" "Binarna arytmetyka zmiennoprzecinkowa kryje w sobie wiele takich " -"niespodzianek. Problem z „0,1” został szczegółowo wyjaśniony poniżej, w " -"sekcji „Błąd reprezentacji”. Zobacz `The Perils of Floating Point `_ (Niebezpieczeństwa liczb zmiennoprzecinkowych), " -"aby uzyskać pełniejszy opis innych często spotykanych niespodzianek." +"niespodzianek. Problem z „0,1” został dokładnie wyjaśniony poniżej, w sekcji " +"„Błąd reprezentacji”. Zobacz `Przykłady problemów zmiennoprzecinkowych " +"`_ dla " +"przyjemnego podsumowania jak działa binarna arytmetyka zmiennoprzecinkowa i " +"jakie rodzaje problemów często spotyka się w praktyce. Zobacz także `The " +"Perils of Floating Point `_ dla " +"bardziej kompletnego opisu innych typowych niespodzianek." msgid "" "As that says near the end, \"there are no easy answers.\" Still, don't be " @@ -269,7 +249,7 @@ msgstr "" "1/3 mogły być reprezentowane dokładnie)." msgid "" -"If you are a heavy user of floating point operations you should take a look " +"If you are a heavy user of floating-point operations you should take a look " "at the NumPy package and many other packages for mathematical and " "statistical operations supplied by the SciPy project. See ." @@ -283,31 +263,21 @@ msgid "" "*do* want to know the exact value of a float. The :meth:`float." "as_integer_ratio` method expresses the value of a float as a fraction::" msgstr "" -"Python udostępnia narzędzia, które mogą pomóc w tych rzadkich przypadkach, " -"gdy naprawdę *musisz* poznać dokładną wartość liczby zmiennoprzecinkowej. " -"Metoda :meth:`float.as_integer_ratio` wyraża wartość float jako ułamek::" msgid "" "Since the ratio is exact, it can be used to losslessly recreate the original " "value::" msgstr "" -"Ponieważ stosunek jest dokładny, można go użyć do bezstratnego odtworzenia " -"oryginalnej wartości::" msgid "" "The :meth:`float.hex` method expresses a float in hexadecimal (base 16), " "again giving the exact value stored by your computer::" msgstr "" -"Metoda :meth:`float.hex` wyraża liczbę zmiennoprzecinkową w systemie " -"hexadecymalnym (podstawa 16), ponownie podając dokładną wartość " -"przechowywaną przez komputer::" msgid "" "This precise hexadecimal representation can be used to reconstruct the float " "value exactly::" msgstr "" -"Ta precyzyjna reprezentacja szesnastkowa może być wykorzystana do dokładnego " -"zrekonstruowania wartości liczby zmiennoprzecinkowej::" msgid "" "Since the representation is exact, it is useful for reliably porting values " @@ -327,11 +297,6 @@ msgid "" "so that the errors do not accumulate to the point where they affect the " "final total:" msgstr "" -"Kolejnym pomocnym narzędziem jest funkcja :func:`math.fsum`, która pomaga " -"złagodzić utratę precyzji podczas sumowania. Śledzi „utracone cyfry”, gdy " -"wartości są dodawane do bieżącej sumy. Może to mieć wpływ na ogólną " -"dokładność, aby błędy nie kumulowały się do punktu, w którym wpływają na " -"ostateczny wynik:" msgid "Representation Error" msgstr "Błąd reprezentacji" @@ -359,22 +324,22 @@ msgstr "" "dokładnie takiej liczby dziesiętnej, jakiej oczekujesz." msgid "" -"Why is that? 1/10 is not exactly representable as a binary fraction. Almost " -"all machines today (November 2000) use IEEE-754 floating point arithmetic, " -"and almost all platforms map Python floats to IEEE-754 \"double " -"precision\". 754 doubles contain 53 bits of precision, so on input the " -"computer strives to convert 0.1 to the closest fraction it can of the form " -"*J*/2**\\ *N* where *J* is an integer containing exactly 53 bits. " -"Rewriting ::" +"Why is that? 1/10 is not exactly representable as a binary fraction. Since " +"at least 2000, almost all machines use IEEE 754 binary floating-point " +"arithmetic, and almost all platforms map Python floats to IEEE 754 binary64 " +"\"double precision\" values. IEEE 754 binary64 values contain 53 bits of " +"precision, so on input the computer strives to convert 0.1 to the closest " +"fraction it can of the form *J*/2**\\ *N* where *J* is an integer containing " +"exactly 53 bits. Rewriting ::" msgstr "" -"Dlaczego? 1/10 nie jest dokładnie reprezentowalne jako ułamek binarny. " -"Prawie wszystkie dzisiejsze maszyny (listopad 2000) używają arytmetyki " -"zmiennoprzecinkowej IEEE-754 i prawie wszystkie platformy odwzorowują liczby " -"zmiennoprzecinkowe Pythona na „podwójną precyzję” IEEE-754. Arytmetyka " -"podwójnej precyzji typu 754 zawiera 53 bity dokładności, więc na wejściu " -"komputer stara się zamienić 0,1 na najbliższy możliwy ułamek w postaci " -"*J*/2**\\ *N*, gdzie *J* jest liczbą całkowitą zawierającą dokładnie 53 " -"bity. Zapisując ::" +"Dlaczego? 1/10 nie jest dokładnie reprezentowalna jako ułamek binarny. Od co " +"najmniej 2000 roku, prawie wszystkie dzisiejsze maszyny używają binarnej " +"arytmetyki zmiennoprzecinkowej IEEE-754 i prawie wszystkie platformy " +"odwzorowują liczby zmiennoprzecinkowe Pythona na „podwójną precyzję” " +"IEEE-754 binary64. Wartości IEEE 754 binary64 zawierają 53 bity dokładności, " +"więc na wejściu komputer stara się zamienić 0,1 na najbliższy możliwy ułamek " +"w postaci *J*/2**\\ *N*, gdzie *J* jest liczbą całkowitą zawierającą " +"dokładnie 53 bity. Zapisując ::" msgid "as ::" msgstr "jako ::" @@ -383,30 +348,23 @@ msgid "" "and recalling that *J* has exactly 53 bits (is ``>= 2**52`` but ``< " "2**53``), the best value for *N* is 56::" msgstr "" -"i pamiętając, że *J* ma dokładnie 53 bity (jest ``>= 2**52`` ale ``< " -"2**53``), najlepszą wartością dla *N* jest 56::" msgid "" "That is, 56 is the only value for *N* that leaves *J* with exactly 53 bits. " "The best possible value for *J* is then that quotient rounded::" msgstr "" -"Oznacza to, że 56 jest jedyną wartością dla *N*, która pozostawia *J* " -"dokładnie 53 bity. Najlepszą możliwą wartością dla *J* jest zatem " -"zaokrąglony iloraz::" msgid "" "Since the remainder is more than half of 10, the best approximation is " "obtained by rounding up::" msgstr "" -"Ponieważ reszta jest większa niż połowa z 10, najlepsze przybliżenie " -"uzyskuje się zaokrąglając w górę::" msgid "" -"Therefore the best possible approximation to 1/10 in 754 double precision " -"is::" +"Therefore the best possible approximation to 1/10 in IEEE 754 double " +"precision is::" msgstr "" "Dlatego najlepszym możliwym przybliżeniem do 1/10 w arytmetyce podwójnej " -"precyzji typu 754 jest::" +"precyzji typu IEEE 754 jest::" msgid "" "Dividing both the numerator and denominator by two reduces the fraction to::" @@ -423,18 +381,16 @@ msgstr "" msgid "" "So the computer never \"sees\" 1/10: what it sees is the exact fraction " -"given above, the best 754 double approximation it can get::" +"given above, the best IEEE 754 double approximation it can get:" msgstr "" "Tak więc komputer nigdy nie „widzi” 1/10: to, co widzi, to dokładny ułamek " -"podany powyżej, najlepsze przybliżenie w standardzie podwójnej precyzji 754, " -"jakie może uzyskać::" +"podany powyżej, najlepsze przybliżenie w standardzie podwójnej precyzji IEEE " +"754, jakie może uzyskać:" msgid "" "If we multiply that fraction by 10\\*\\*55, we can see the value out to 55 " "decimal digits::" msgstr "" -"Jeśli pomnożymy ten ułamek przez 10\\*\\*55, otrzymamy wartość z " -"dokładnością do 55 cyfr dziesiętnych::" msgid "" "meaning that the exact number stored in the computer is equal to the decimal " @@ -442,13 +398,8 @@ msgid "" "displaying the full decimal value, many languages (including older versions " "of Python), round the result to 17 significant digits::" msgstr "" -"co oznacza, że ​​dokładna liczba zapisana w komputerze jest równa wartości " -"dziesiętnej 0,1000000000000000055511151231257827021181583404541015625. " -"Zamiast wyświetlać pełną wartość dziesiętną, wiele języków (w tym starsze " -"wersje Pythona) zaokrągla wynik do 17 cyfr znaczących::" msgid "" "The :mod:`fractions` and :mod:`decimal` modules make these calculations " "easy::" msgstr "" -"Moduły :mod:`fractions` oraz :mod:`decimal` ułatwiają tego typu obliczenia::" diff --git a/tutorial/index.po b/tutorial/index.po index 2642cc3ca6..e8a8c7bd10 100644 --- a/tutorial/index.po +++ b/tutorial/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stefan Ocetkiewicz , 2023 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/tutorial/inputoutput.po b/tutorial/inputoutput.po index 557f132963..e728c3f7d6 100644 --- a/tutorial/inputoutput.po +++ b/tutorial/inputoutput.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Waldemar Stoczkowski, 2023 +# Rafael Fontenelle , 2024 # #, 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:50+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,15 +41,16 @@ msgstr "Wymyślniejsze formatowanie wyjścia" msgid "" "So far we've encountered two ways of writing values: *expression statements* " -"and the :func:`print` function. (A third way is using the :meth:`write` " -"method of file objects; the standard output file can be referenced as ``sys." -"stdout``. See the Library Reference for more information on this.)" +"and the :func:`print` function. (A third way is using the :meth:`~io." +"TextIOBase.write` method of file objects; the standard output file can be " +"referenced as ``sys.stdout``. See the Library Reference for more information " +"on this.)" msgstr "" "Do tej pory natknęliśmy się na dwa sposoby wypisywania wartości: *wyrażenia* " -"i funkcję :func:`print`. (Trzecim sposobem jest użycie metody :meth:`write` " -"obiektu pliku; do pliku standardowego wyjścia można odwołać się używając " -"``sys.stdout``. Więcej informacji na ten temat znajdziesz w dokumentacji " -"biblioteki standardowej.)" +"i funkcję :func:`print`. (Trzecim sposobem jest użycie metody :meth:`~io." +"TextIOBase.write` obiektu pliku; do pliku standardowego wyjścia można " +"odwołać się używając ``sys.stdout``. Więcej informacji na ten temat " +"znajdziesz w dokumentacji biblioteki standardowej.)" msgid "" "Often you'll want more control over the formatting of your output than " @@ -215,7 +216,7 @@ msgid "" "If keyword arguments are used in the :meth:`str.format` method, their values " "are referred to by using the name of the argument. ::" msgstr "" -"Jeśli argumenty nazwane są używane w metodzie :meth:`str.format()`, ich " +"Jeśli argumenty nazwane są używane w metodzie :meth:`str.format`, ich " "wartości są przywoływane przy użyciu nazwy argumentu. ::" msgid "Positional and keyword arguments can be arbitrarily combined::" @@ -237,32 +238,43 @@ msgid "" "This could also be done by passing the ``table`` dictionary as keyword " "arguments with the ``**`` notation. ::" msgstr "" +"Można to również zrobić, przekazując dict ``table`` jako argumenty nazwane " +"przy użyciu notacji ``**``. ::" msgid "" "This is particularly useful in combination with the built-in function :func:" "`vars`, which returns a dictionary containing all local variables." msgstr "" +"Jest to szczególnie przydatne w połączeniu z wbudowaną funkcją :func:`vars`, " +"która zwraca słownik zawierający wszystkie zmienne lokalne." msgid "" "As an example, the following lines produce a tidily aligned set of columns " "giving integers and their squares and cubes::" msgstr "" +"Jako przykład, poniższe wiersze tworzą uporządkowany zestaw kolumn " +"zawierających liczby całkowite oraz ich kwadraty i sześciany::" msgid "" "For a complete overview of string formatting with :meth:`str.format`, see :" "ref:`formatstrings`." msgstr "" +"Aby uzyskać pełny przegląd formatowania ciągów znaków za pomocą funkcji :" +"meth:`str.format`, zobacz :ref:`formatstrings`." msgid "Manual String Formatting" -msgstr "" +msgstr "Ręczne formatowanie ciągów znaków" msgid "Here's the same table of squares and cubes, formatted manually::" -msgstr "" +msgstr "Oto ta sama tabela kwadratów i sześcianów, sformatowana ręcznie::" msgid "" "(Note that the one space between each column was added by the way :func:" "`print` works: it always adds spaces between its arguments.)" msgstr "" +"(Zauważ, że jedna spacja między każdą kolumną została dodana przez sposób " +"działania funkcji :func:`print`: zawsze dodaje ona spacje między swoimi " +"argumentami.)" msgid "" "The :meth:`str.rjust` method of string objects right-justifies a string in a " @@ -274,14 +286,25 @@ msgid "" "would be lying about a value. (If you really want truncation you can always " "add a slice operation, as in ``x.ljust(n)[:n]``.)" msgstr "" +"Metoda :meth:`str.rjust` obiektów typu string wyrównuje ciąg znaków do " +"prawej strony w polu o zadanej szerokości poprzez wypełnienie go spacjami po " +"lewej stronie. Istnieją podobne metody :meth:`str.ljust` i :meth:`str." +"center`. Metody te niczego nie wypisują, a jedynie zwracają nowy ciąg " +"znaków. Jeśli wejściowy ciąg jest zbyt długi, nie obcinają go, ale zwracają " +"go bez zmian; spowoduje to bałagan w układzie kolumn, ale zwykle jest to " +"lepsze niż alternatywa, która polegałaby na kłamaniu na temat wartości. " +"(Jeśli naprawdę chcesz przycinania, zawsze możesz dodać operację wycinania, " +"jak w ``x.ljust(n)[:n]``.)" msgid "" "There is another method, :meth:`str.zfill`, which pads a numeric string on " "the left with zeros. It understands about plus and minus signs::" msgstr "" +"Istnieje jeszcze jedna metoda, :meth:`str.zfill`, która wypełnia ciąg " +"liczbowy po lewej stronie zerami. Rozumie ona znaki plus i minus::" msgid "Old string formatting" -msgstr "" +msgstr "Stare formatowanie ciągów znaków" msgid "" "The % operator (modulo) can also be used for string formatting. Given " @@ -289,19 +312,26 @@ msgid "" "zero or more elements of ``values``. This operation is commonly known as " "string interpolation. For example::" msgstr "" +"Operator % (modulo) może być również używany do formatowania ciągów znaków. " +"Dla ``'string' % values``, wystąpienia ``%`` w ciągu znaków ``string`` są " +"zastępowane przez zero lub więcej elementów ``values``. Operacja ta jest " +"powszechnie znana jako interpolacja ciągów znaków. Na przykład::" msgid "" "More information can be found in the :ref:`old-string-formatting` section." -msgstr "" +msgstr "Więcej informacji można znaleźć w sekcji :ref:`old-string-formatting`." msgid "Reading and Writing Files" -msgstr "" +msgstr "Odczytywanie i zapisywanie plików" msgid "" ":func:`open` returns a :term:`file object`, and is most commonly used with " "two positional arguments and one keyword argument: ``open(filename, mode, " "encoding=None)``" msgstr "" +":func:`open` zwraca :term:`obiekt pliku ` i jest najczęściej " +"używany z dwoma argumentami pozycyjnymi i jednym argumentem nazwanym: " +"``open(filename, mode, encoding=None)``" msgid "" "The first argument is a string containing the filename. The second argument " @@ -313,6 +343,14 @@ msgid "" "reading and writing. The *mode* argument is optional; ``'r'`` will be " "assumed if it's omitted." msgstr "" +"Pierwszy argument to ciąg znaków zawierający nazwę pliku. Drugi argument to " +"kolejny ciąg znaków zawierający kilka znaków opisujących sposób, w jaki plik " +"będzie używany. *Tryb* może być ``'r'`` gdy plik będzie tylko do odczytu, " +"``'w'`` tylko do zapisu (istniejący plik o tej samej nazwie zostanie " +"usunięty), a ``'a'`` otwiera plik do dołączania; wszelkie dane zapisane do " +"pliku są automatycznie dodawane na koniec.``'r+'`` otwiera plik zarówno do " +"odczytu, jak i zapisu. Argument *trybu* jest opcjonalny; jeśli zostanie " +"pominięty, zakłada się, że domyślnie został wybrany ``'r'``." msgid "" "Normally, files are opened in :dfn:`text mode`, that means, you read and " @@ -324,6 +362,15 @@ msgid "" "`binary mode`. Binary mode data is read and written as :class:`bytes` " "objects. You can not specify *encoding* when opening file in binary mode." msgstr "" +"Zwykle pliki są otwierane w trybie tekstowym :dfn:`text mode`, co oznacza, " +"że czytasz i zapisujesz ciągi znaków do i z pliku, które są kodowane w " +"określonym *kodowaniu*. Jeśli *kodowanie* nie jest określone, domyślne jest " +"zależne od platformy (patrz :func:`open`). Ponieważ UTF-8 jest współczesnym " +"standardem, zaleca się stosowanie ``encoding=\"utf-8\"``, chyba że wiesz, że " +"musisz użyć innego kodowania. Dodanie ``'b'`` do trybu otwiera plik w trybie " +"binarnym :dfn:`binary mode`. Dane w trybie binarnym są odczytywane i " +"zapisywane jako obiekty :class:`bytes`. Nie możesz określić kodowania " +"podczas otwierania pliku w trybie binarnym." msgid "" "In text mode, the default when reading is to convert platform-specific line " @@ -334,6 +381,14 @@ msgid "" "file:`JPEG` or :file:`EXE` files. Be very careful to use binary mode when " "reading and writing such files." msgstr "" +"W trybie tekstowym domyślnym podczas odczytywania następuje konwersja " +"końcówek linii specyficznych dla platformy (``\\n`` na systemie Unix, " +"``\\r\\n`` na systemie Windows) na pojedynczy znak ``\\n``. Podczas zapisu w " +"trybie tekstowym domyślnym jest konwersja wystąpień ``\\n`` z powrotem na " +"końcówki linii specyficzne dla platformy. Ta niewidoczna modyfikacja danych " +"pliku jest odpowiednia dla plików tekstowych, ale uszkodzi dane binarne, " +"takie jak te w plikach :file:`JPEG` lub :file:`EXE`. Bądź bardzo ostrożny, " +"używając trybu binarnego podczas odczytywania i zapisywania takich plików." msgid "" "It is good practice to use the :keyword:`with` keyword when dealing with " @@ -342,32 +397,48 @@ msgid "" "keyword:`!with` is also much shorter than writing equivalent :keyword:" "`try`\\ -\\ :keyword:`finally` blocks::" msgstr "" +"Używanie :keyword:`with` podczas pracy z obiektami plików należy do dobrych " +"praktyk. Zaletą tego podejścia jest to, że plik jest prawidłowo zamykany po " +"zakończeniu jego bloku, nawet jeśli w pewnym momencie zostanie zgłoszony " +"wyjątek. Użycie :keyword:`!with` jest również znacznie krótsze niż pisanie " +"równoważnych bloków :keyword:`try` - :keyword:`finally`::" msgid "" "If you're not using the :keyword:`with` keyword, then you should call ``f." "close()`` to close the file and immediately free up any system resources " "used by it." msgstr "" +"Jeśli nie używasz :keyword:`with` to powinieneś wywołać ``f.close()`` w celu " +"zamknięcia pliku i natychmiastowego zwolnienia wszystkich zasobów " +"systemowych wykorzystywanych przez ten plik." msgid "" "Calling ``f.write()`` without using the :keyword:`!with` keyword or calling " "``f.close()`` **might** result in the arguments of ``f.write()`` not being " "completely written to the disk, even if the program exits successfully." msgstr "" +"Wywołanie ``f.write()`` bez użycia :keyword:`!with` lub ``f.close()`` " +"**może** spowodować, że argumenty ``f.write()`` nie zostaną w pełni zapisane " +"na dysku, nawet jeśli program zakończy się pomyślnie." msgid "" "After a file object is closed, either by a :keyword:`with` statement or by " "calling ``f.close()``, attempts to use the file object will automatically " "fail. ::" msgstr "" +"Po zamknięciu obiektu pliku, zarówno przez instrukcję :keyword:`with`, jak i " +"``f.close()``, wszystkie próby użycia obiektu pliku automatycznie się nie " +"powiodą. ::" msgid "Methods of File Objects" -msgstr "" +msgstr "Metody obiektów plików" msgid "" "The rest of the examples in this section will assume that a file object " "called ``f`` has already been created." msgstr "" +"Reszta przykładów w tej sekcji zakłada, że obiekt pliku o nazwie ``f`` " +"został już utworzony." msgid "" "To read a file's contents, call ``f.read(size)``, which reads some quantity " @@ -379,6 +450,15 @@ msgid "" "binary mode) are read and returned. If the end of the file has been reached, " "``f.read()`` will return an empty string (``''``). ::" msgstr "" +"Aby odczytać zawartość pliku, należy wywołać polecenie ``f.read(size)``, " +"które odczytuje pewną ilość danych i zwraca je jako ciąg znaków (w trybie " +"tekstowym) lub obiekt bajtowy (w trybie binarnym). *size* jest opcjonalnym " +"argumentem numerycznym. Gdy *size* jest pominięty lub ujemny, zostanie " +"odczytana i zwrócona cała zawartość pliku; to twój problem, jeśli plik jest " +"dwa razy większy niż pamięć twojego komputera. W przeciwnym razie odczytane " +"i zwrócone zostanie co najwyżej *size* znaków (w trybie tekstowym) lub " +"*size* bajtów (w trybie binarnym). Jeśli został osiągnięty koniec pliku, ``f." +"read()`` zwróci pusty ciąg znaków (``''``). ::" msgid "" "``f.readline()`` reads a single line from the file; a newline character " @@ -388,32 +468,51 @@ msgid "" "end of the file has been reached, while a blank line is represented by " "``'\\n'``, a string containing only a single newline. ::" msgstr "" +"``f.readline()`` odczytuje pojedynczą linię z pliku; znak nowej linii " +"(``\\n``) jest pozostawiony na końcu ciągu znaków i jest pomijany tylko w " +"ostatniej linii pliku, jeśli plik nie kończy się nową linią. To sprawia, że " +"wartość zwracana jest jednoznaczna; jeśli ``f.readline()`` zwróci pusty ciąg " +"znaków, koniec pliku został osiągnięty, podczas gdy pusta linia jest " +"reprezentowana przez ``'\\n'``, ciąg znaków zawierający tylko pojedynczą " +"nową linię. ::" msgid "" "For reading lines from a file, you can loop over the file object. This is " "memory efficient, fast, and leads to simple code::" msgstr "" +"Aby odczytać wiersze z pliku, można wykonać pętlę na obiekcie pliku. Jest to " +"wydajne pamięciowo, szybkie i prowadzi do prostego kodu::" msgid "" "If you want to read all the lines of a file in a list you can also use " "``list(f)`` or ``f.readlines()``." msgstr "" +"Jeśli chcesz wczytać wszystkie wiersze pliku w listę, możesz również użyć " +"``list(f)`` lub ``f.readlines()``." msgid "" "``f.write(string)`` writes the contents of *string* to the file, returning " "the number of characters written. ::" msgstr "" +"``f.write(string)`` zapisuje zawartość *string* do pliku, zwracając liczbę " +"zapisanych znaków. ::" msgid "" "Other types of objects need to be converted -- either to a string (in text " "mode) or a bytes object (in binary mode) -- before writing them::" msgstr "" +"Inne typy obiektów muszą zostać przekonwertowane – albo na ciąg znaków (w " +"trybie tekstowym), albo na obiekt bajtowy (w trybie binarnym) – przed ich " +"zapisaniem::" msgid "" "``f.tell()`` returns an integer giving the file object's current position in " "the file represented as number of bytes from the beginning of the file when " "in binary mode and an opaque number when in text mode." msgstr "" +"``f.tell()`` zwraca liczbę całkowitą podającą aktualną pozycję obiektu pliku " +"w pliku reprezentowaną jako liczba bajtów od początku pliku w trybie " +"binarnym i nieprzejrzystą liczbę w trybie tekstowym." msgid "" "To change the file object's position, use ``f.seek(offset, whence)``. The " @@ -424,6 +523,12 @@ msgid "" "omitted and defaults to 0, using the beginning of the file as the reference " "point. ::" msgstr "" +"Aby zmienić pozycję obiektu pliku, należy użyć ``f.seek(offset, whence)``. " +"Pozycja jest obliczana przez dodanie *offset* do punktu odniesienia; punkt " +"odniesienia jest wybierany przez argument *whence*. Wartość *whence* równa 0 " +"mierzy od początku pliku, 1 używa bieżącej pozycji pliku, a 2 używa końca " +"pliku jako punktu odniesienia. *whence* może zostać pominięty i domyślnie " +"przyjmuje wartość 0, używając początku pliku jako punktu odniesienia. ::" msgid "" "In text files (those opened without a ``b`` in the mode string), only seeks " @@ -432,24 +537,39 @@ msgid "" "*offset* values are those returned from the ``f.tell()``, or zero. Any other " "*offset* value produces undefined behaviour." msgstr "" +"W plikach tekstowych (otwieranych bez ``b`` w ciągu znaków trybu) dozwolone " +"jest tylko wyszukiwanie względem początku pliku (wyjątkiem jest wyszukiwanie " +"do samego końca pliku z ``seek(0, 2)``), a jedynymi poprawnymi wartościami " +"*offset* są te zwrócone z ``f.tell()`` lub zero. Każda inna wartość *offset* " +"powoduje niezdefiniowane zachowanie." msgid "" -"File objects have some additional methods, such as :meth:`~file.isatty` and :" -"meth:`~file.truncate` which are less frequently used; consult the Library " -"Reference for a complete guide to file objects." +"File objects have some additional methods, such as :meth:`~io.IOBase.isatty` " +"and :meth:`~io.IOBase.truncate` which are less frequently used; consult the " +"Library Reference for a complete guide to file objects." msgstr "" +"Obiekty plikowe mają kilka dodatkowych metod, takich jak :meth:`~io.IOBase." +"isatty` i :meth:`~io.IOBase.truncate`, które są rzadziej używane; zapoznaj " +"się z Library Reference, aby uzyskać pełny przewodnik po obiektach plikowych." msgid "Saving structured data with :mod:`json`" -msgstr "" +msgstr "Zapisywanie struktur danych przy użyciu modułu :mod:`json`" msgid "" "Strings can easily be written to and read from a file. Numbers take a bit " -"more effort, since the :meth:`read` method only returns strings, which will " -"have to be passed to a function like :func:`int`, which takes a string like " -"``'123'`` and returns its numeric value 123. When you want to save more " -"complex data types like nested lists and dictionaries, parsing and " -"serializing by hand becomes complicated." +"more effort, since the :meth:`~io.TextIOBase.read` method only returns " +"strings, which will have to be passed to a function like :func:`int`, which " +"takes a string like ``'123'`` and returns its numeric value 123. When you " +"want to save more complex data types like nested lists and dictionaries, " +"parsing and serializing by hand becomes complicated." msgstr "" +"Ciągi znaków można łatwo zapisywać i odczytywać z pliku. Liczby wymagają " +"nieco więcej wysiłku, ponieważ metoda :meth:`~io.TextIOBase.read` zwraca " +"tylko ciągi znaków, które będą musiały zostać przekazane do funkcji takiej " +"jak :func:`int`, która pobiera ciąg znaków taki jak ``'123'`` i zwraca jego " +"wartość liczbową 123. W przypadku zapisywania bardziej złożonych typów " +"danych, takich jak zagnieżdżone listy i słowniki, ręczne parsowanie i " +"serializowanie staje się skomplikowane." msgid "" "Rather than having users constantly writing and debugging code to save " @@ -462,33 +582,58 @@ msgid "" "deserializing, the string representing the object may have been stored in a " "file or data, or sent over a network connection to some distant machine." msgstr "" +"Zamiast zmuszać użytkowników do ciągłego pisania i debugowania kodu w celu " +"zapisania skomplikowanych typów danych do plików, Python pozwala na użycie " +"popularnego formatu wymiany danych zwanego `JSON (JavaScript Object " +"Notation) `_. Standardowy moduł o nazwie :mod:`json` może " +"pobierać hierarchie danych Pythona i konwertować je na reprezentacje ciągów " +"znaków; proces ten nazywany jest :dfn:`serializacją`. Rekonstrukcja danych " +"z reprezentacji łańcuchowej nazywana jest :dfn:`deserializacją`. Pomiędzy " +"serializacją i deserializacją, ciąg znaków reprezentujący obiekt może być " +"przechowywany w pliku lub bazie danych, lub wysłany przez połączenie " +"sieciowe do odległej maszyny." msgid "" "The JSON format is commonly used by modern applications to allow for data " "exchange. Many programmers are already familiar with it, which makes it a " "good choice for interoperability." msgstr "" +"Format JSON jest powszechnie używany przez nowoczesne aplikacje w celu " +"umożliwienia wymiany danych. Wielu programistów jest już z nim " +"zaznajomionych, co czyni go dobrym wyborem dla interoperacyjności." msgid "" "If you have an object ``x``, you can view its JSON string representation " "with a simple line of code::" msgstr "" +"Jeśli masz obiekt ``x``, możesz wyświetlić jego reprezentację JSON za pomocą " +"prostej linii kodu::" msgid "" "Another variant of the :func:`~json.dumps` function, called :func:`~json." "dump`, simply serializes the object to a :term:`text file`. So if ``f`` is " "a :term:`text file` object opened for writing, we can do this::" msgstr "" +"Inny wariant funkcji :func:`~json.dumps`, zwany :func:`~json.dump`, po " +"prostu serializuje obiekt do :term:`pliku tekstowego `. Jeśli " +"więc ``f`` jest obiektem :term:`pliku tekstowego ` otwartym do " +"zapisu, możemy zrobić tak::" msgid "" "To decode the object again, if ``f`` is a :term:`binary file` or :term:`text " "file` object which has been opened for reading::" msgstr "" +"Aby ponownie zdekodować obiekt, jeśli ``f`` jest obiektem :term:`pliku " +"binarnego ` lub :term:`pliku tekstowego `, który " +"został otwarty do odczytu::" msgid "" "JSON files must be encoded in UTF-8. Use ``encoding=\"utf-8\"`` when opening " "JSON file as a :term:`text file` for both of reading and writing." msgstr "" +"Pliki JSON muszą być zakodowane w UTF-8. Użyj ``encoding=\"utf-8\"`` podczas " +"otwierania pliku JSON jako :term:`pliku tekstowego ` zarówno do " +"odczytu jak i zapisu." msgid "" "This simple serialization technique can handle lists and dictionaries, but " @@ -496,9 +641,13 @@ msgid "" "effort. The reference for the :mod:`json` module contains an explanation of " "this." msgstr "" +"Ta prosta technika serializacji może obsługiwać listy i słowniki, ale " +"serializacja dowolnych instancji klas w JSON wymaga nieco dodatkowego " +"wysiłku. Wyjaśnienie tej kwestii znajduje się w dokumentacji modułu :mod:" +"`json`." msgid ":mod:`pickle` - the pickle module" -msgstr "" +msgstr ":mod:`pickle` – moduł pickle" msgid "" "Contrary to :ref:`JSON `, *pickle* is a protocol which allows the " @@ -508,21 +657,28 @@ msgid "" "pickle data coming from an untrusted source can execute arbitrary code, if " "the data was crafted by a skilled attacker." msgstr "" +"W przeciwieństwie do :ref:`JSON `, *pickle* jest protokołem, który " +"pozwala na serializację dowolnie złożonych obiektów Pythona. Jako taki, " +"jest specyficzny dla Pythona i nie może być używany do komunikacji z " +"aplikacjami napisanymi w innych językach. Jest on również domyślnie " +"niezabezpieczony: deserializacja danych pickle pochodzących z niezaufanego " +"źródła może wykonać dowolny kod, jeśli dane zostały spreparowane przez " +"doświadczonego atakującego." msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "open" -msgstr "" +msgstr "otwórz" msgid "object" -msgstr "" +msgstr "obiekt" msgid "file" -msgstr "" +msgstr "plik" msgid "module" msgstr "moduł" msgid "json" -msgstr "" +msgstr "json" diff --git a/tutorial/interactive.po b/tutorial/interactive.po index 444852f5d8..832b4227c4 100644 --- a/tutorial/interactive.po +++ b/tutorial/interactive.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Achinger, 2022 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -51,8 +50,8 @@ msgid "" "expressions such as ``string.a``, it will evaluate the expression up to the " "final ``'.'`` and then suggest completions from the attributes of the " "resulting object. Note that this may execute application-defined code if an " -"object with a :meth:`__getattr__` method is part of the expression. The " -"default configuration also saves your history into a file named :file:`." +"object with a :meth:`~object.__getattr__` method is part of the expression. " +"The default configuration also saves your history into a file named :file:`." "python_history` in your user directory. The history will be available again " "during the next interactive interpreter session." msgstr "" @@ -63,9 +62,9 @@ msgstr "" "kropkowanych takich jak ``string.a``, ewaluuje wyrażenie do ostaniej " "``'.'``, a następnie sugeruje uzupełnienie z atrybutów obiektu wynikowego. " "Zauważ, że może to wykonać zdefiniowany w aplikacji kod, jeżeli obiekt z " -"metodą :meth:`__getattr__` jest częścią wyrażenia. Domyślna konfiguracja " -"zapisuje także twoją historię do pliku :file:`.python_history` w katalogu " -"użytkownika. Historia będzie ponownie dostępna podczas następnej " +"metodą :meth:`~object.__getattr__` jest częścią wyrażenia. Domyślna " +"konfiguracja zapisuje także twoją historię do pliku :file:`.python_history` " +"w katalogu użytkownika. Historia będzie ponownie dostępna podczas następnej " "interaktywnej sesji interpretera." msgid "Alternatives to the Interactive Interpreter" diff --git a/tutorial/interpreter.po b/tutorial/interpreter.po index 3b939cf83b..703bb13ec6 100644 --- a/tutorial/interpreter.po +++ b/tutorial/interpreter.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -35,10 +35,6 @@ msgid "" "local/bin` in your Unix shell's search path makes it possible to start it by " "typing the command:" msgstr "" -"Interpreter Pythona jest zazwyczaj zainstalowany jako :file:`/usr/local/bin/" -"python3.11` na maszynach, na których jest dostępny; wstawienie :file:`/usr/" -"local/bin` w ścieżkę wyszukiwania uniksowego shella umożliwia jego " -"uruchomienie przez wpisanie komendy:" msgid "" "to the shell. [#]_ Since the choice of the directory where the interpreter " @@ -58,10 +54,6 @@ msgid "" "file:`py` command. See :ref:`setting-envvars` for other ways to launch " "Python." msgstr "" -"Na maszynach Windows, gdzie instalowałeś Pythona z :ref:`Microsoft Store " -"`, będzie dostępna komenda :file:`python3.11`. Jeśli masz " -"zainstalowany :ref:`launcher py.exe `, możesz użyć komendy :file:" -"`py`. Inne sposoby uruchomienia Pythona znajdziesz w :ref:`setting-envvars`." msgid "" "Typing an end-of-file character (:kbd:`Control-D` on Unix, :kbd:`Control-Z` " diff --git a/tutorial/introduction.po b/tutorial/introduction.po index c3c59617ea..3ac5f77fde 100644 --- a/tutorial/introduction.po +++ b/tutorial/introduction.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,12 +62,12 @@ msgid "" "Since comments are to clarify code and are not interpreted by Python, they " "may be omitted when typing in examples." msgstr "" -"Wiele przykładów w tym manualu, także tych wpisywanych w interaktywnej " -"konsoli, zawiera komentarze. Komentarze w Pythonie zaczynają się znakiem " -"kratki ``#`` i ciągną się do końca fizycznej linii. Komentarz może pojawić " -"się na początku linii, po wiodących spacjach lub kodzie, lecz nie może być " -"zawarty w literale ciągu znaków. Znak kratki w ciągu znaków jest po prostu " -"znakiem kratki. Jako że komentarze mają wyjaśniać kod i nie są " +"Wiele przykładów w tej instrukcji, także tych wpisywanych w konsoli " +"interaktywnej, zawiera komentarze. Komentarze w Pythonie zaczynają się " +"znakiem hash ``#`` i ciągną się do końca fizycznej linii. Komentarz może " +"pojawić się na początku linii, po wiodących spacjach lub kodzie, lecz nie " +"może być zawarty w literale ciągu znaków. Znak hash w ciągu znaków jest po " +"prostu znakiem hash. Jako że komentarze mają wyjaśniać kod i nie są " "interpretowane przez Pythona, można je ominąć przy wpisywaniu przykładów." msgid "Some examples::" @@ -90,15 +90,13 @@ msgstr "Liczby" msgid "" "The interpreter acts as a simple calculator: you can type an expression at " "it and it will write the value. Expression syntax is straightforward: the " -"operators ``+``, ``-``, ``*`` and ``/`` work just like in most other " -"languages (for example, Pascal or C); parentheses (``()``) can be used for " -"grouping. For example::" +"operators ``+``, ``-``, ``*`` and ``/`` can be used to perform arithmetic; " +"parentheses (``()``) can be used for grouping. For example::" msgstr "" "Interpreter działa jak prosty kalkulator: można wpisać do niego wyrażenie, a " "on wypisze jego wartość. Składnia wyrażenia jest prosta: operatory ``+``, ``-" -"``, ``*`` i ``/`` działają jak w większości innych języków programowania (na " -"przykład Pascal lub C); nawiasów (``()``) można użyć do grupowania. Na " -"przykład::" +"``, ``*`` i ``/`` można użyć do arytmetyki; nawiasy (``()``) można użyć do " +"grupowania. Na przykład::" msgid "" "The integer numbers (e.g. ``2``, ``4``, ``20``) have type :class:`int`, the " @@ -121,7 +119,8 @@ msgstr "" msgid "" "With Python, it is possible to use the ``**`` operator to calculate powers " "[#]_::" -msgstr "W Pythonie możesz użyć operatora ``**``, aby obliczać potęgi [#]_::" +msgstr "" +"W Pythonie możesz użyć operatora ``**``, do obliczania potęgowania [#]_::" msgid "" "The equal sign (``=``) is used to assign a value to a variable. Afterwards, " @@ -173,41 +172,44 @@ msgid "" msgstr "" "Oprócz :class:`int` i :class:`float`, Python wspiera inne typy liczb, takie " "jak :class:`~decimal.Decimal` i :class:`~fractions.Fraction`. Python ma też " -"wbudowane wsparcie dla :ref:`liczb złożonych ` i używa " +"wbudowane wsparcie dla :ref:`liczb zespolonych ` i używa " "sufiksów ``j`` lub ``J`` do wskazania części urojonej (np. ``3+5j``)." -msgid "Strings" -msgstr "Ciągi znaków" +msgid "Text" +msgstr "Tekst" + +msgid "" +"Python can manipulate text (represented by type :class:`str`, so-called " +"\"strings\") as well as numbers. This includes characters \"``!``\", words " +"\"``rabbit``\", names \"``Paris``\", sentences \"``Got your back.``\", etc. " +"\"``Yay! :)``\". They can be enclosed in single quotes (``'...'``) or double " +"quotes (``\"...\"``) with the same result [#]_." +msgstr "" +"Python umożliwia manipulację tekstem (reprezentowanym przez typ :class:" +"`str`, tzw. „ciąg znaków” lub „string”) oraz liczbami. Obejmuje to znaki „``!" +"``”, słowa „``królik``”, nazwy „``Paryż``”, zdania „``Możesz na mnie liczyć." +"``”, itp. „``Hurra! :)``”. Mogą być one umieszczone w pojedynczych " +"cudzysłowach (``'...'``) lub podwójnych cudzysłowach (``\"...\"``) z takim " +"samym wynikiem [#]_." msgid "" -"Besides numbers, Python can also manipulate strings, which can be expressed " -"in several ways. They can be enclosed in single quotes (``'...'``) or " -"double quotes (``\"...\"``) with the same result [#]_. ``\\`` can be used " -"to escape quotes::" +"To quote a quote, we need to \"escape\" it, by preceding it with ``\\``. " +"Alternatively, we can use the other type of quotation marks::" msgstr "" -"Oprócz liczb Python może również manipulować ciągami znaków, które można " -"wyrazić na parę sposobów. Mogą one być objęte pojedynczym (``'…'``) lub " -"podwójnym cudzysłowem (``\"…\"``) z tym samym efektem [#]_. ``\\`` można " -"użyć, aby zapobiec domyślnej interpretacji znaku cudzysłowu::" +"Aby umieścić znak cudzysłowu, musimy go oznaczyć znakiem \"ucieczki\", " +"poprzedzając znakiem ``\\``. Alternatywnie, możemy użyć innego rodzaju " +"znaków do oznaczenia cudzysłowu::" msgid "" -"In the interactive interpreter, the output string is enclosed in quotes and " -"special characters are escaped with backslashes. While this might sometimes " -"look different from the input (the enclosing quotes could change), the two " -"strings are equivalent. The string is enclosed in double quotes if the " -"string contains a single quote and no double quotes, otherwise it is " -"enclosed in single quotes. The :func:`print` function produces a more " -"readable output, by omitting the enclosing quotes and by printing escaped " -"and special characters::" +"In the Python shell, the string definition and output string can look " +"different. The :func:`print` function produces a more readable output, by " +"omitting the enclosing quotes and by printing escaped and special " +"characters::" msgstr "" -"W interaktywnym interpreterze wyjściowy ciąg znaków jest otoczony " -"cudzysłowem a znaki specjalne są „uwolnione” ukośnikami wstecznymi. Mimo że " -"może czasem wyglądać inaczej niż wejściowy ciąg znaków (cudzysłów okalający " -"mógł się zmienić), te dwa ciągi znaków są równoważne. Ciąg znaków objęty " -"jest podwójnym cudzysłowem, jeśli zawiera tylko pojedyncze cudzysłowy i nie " -"zawiera podwójnych, w przeciwnym wypadku objęty jest pojedynczym. Funkcja :" -"func:`print` produkuje bardziej czytelne wyście, omijając okalający " -"cudzysłów i drukując „uwolnione” i specjalne znaki::" +"W interaktywnej powłoce Pythona definicja ciągu znaków i wyjściowy ciąg " +"znaków mogą wyglądać inaczej. Funkcja :func:`print` wytwarza czytelne " +"wyjście, poprzez pominięcie otaczających cudzysłowów, pominięcie znaków " +"ucieczki i wypisanie znaków specjalnych::" msgid "" "If you don't want characters prefaced by ``\\`` to be interpreted as special " @@ -215,8 +217,8 @@ msgid "" "quote::" msgstr "" "Jeśli nie chcesz, aby znaki poprzedzone ``\\`` były interpretowane jako " -"znaki specjalne, możesz użyć *surowych ciągów znaków* dodając ``r`` przed " -"pierwszym cudzysłowem::" +"znaki specjalne, możesz użyć *surowych ciągów znaków* (ang. *raw strings*) " +"dodając ``r`` przed pierwszym cudzysłowem::" msgid "" "There is one subtle aspect to raw strings: a raw string may not end in an " @@ -249,20 +251,19 @@ msgid "" "Strings can be concatenated (glued together) with the ``+`` operator, and " "repeated with ``*``::" msgstr "" -"Ciągi mogą być konkatenowane (sklejane) operatorem ``+`` i powtarzane przy " -"użyciu ``*``::" +"Ciągi mogą być łączone operatorem ``+`` i powtarzane przy użyciu ``*``::" msgid "" "Two or more *string literals* (i.e. the ones enclosed between quotes) next " "to each other are automatically concatenated. ::" msgstr "" -"Dwa lub więcej *literałów ciągów* (czyli te zawarte w cudzysłowach) obok " -"siebie są automatycznie konkatenowane. ::" +"Dwa lub więcej *literały ciągu znaków* (czyli te zawarte w cudzysłowach) " +"obok siebie są automatycznie łączone. ::" msgid "" "This feature is particularly useful when you want to break long strings::" msgstr "" -"To zachowanie jest szczególnie przydatne, gdy chcesz łamać długie ciągi::" +"To zachowanie jest szczególnie przydatne, gdy chcesz dzielić długie ciągi::" msgid "" "This only works with two literals though, not with variables or expressions::" @@ -270,14 +271,14 @@ msgstr "Jednak działa tylko dla literałów, nie dla zmiennych lub wyrażeń::" msgid "" "If you want to concatenate variables or a variable and a literal, use ``+``::" -msgstr "Jeśli chcesz skonkatenować zmienne lub zmienną i literał, użyj ``+``::" +msgstr "Jeśli chcesz połączyć zmienne lub zmienną i literał, użyj ``+``::" msgid "" "Strings can be *indexed* (subscripted), with the first character having " "index 0. There is no separate character type; a character is simply a string " "of size one::" msgstr "" -"Ciągi znaków mogą być indeksowane. Pierwszy znak ma indeks 0. Nie ma " +"Ciągi znaków mogą być *indeksowane*. Pierwszy znak ma indeks 0. Nie ma " "osobnego typu znakowego; znak jest po prostu ciągiem znaków o długości " "jeden::" @@ -295,17 +296,14 @@ msgid "" "used to obtain individual characters, *slicing* allows you to obtain " "substring::" msgstr "" -"Oprócz indeksowania, dostępne jest także *wykrawanie* (ang. *slicing*). " -"Indeksowania używamy, aby uzyskać pojedyncze znaki, *wykrawanie* pozwala " -"uzyskać podciąg (ang. substring)::" msgid "" "Slice indices have useful defaults; an omitted first index defaults to zero, " "an omitted second index defaults to the size of the string being sliced. ::" msgstr "" -"Indeksy wykrawania mają przydatne wartości domyślne; pominięty pierwszy " -"indeks domyślnie jest zerem, pominięty drugi indeks domyślnie ma wartość " -"długości wykrawanego ciągu. ::" +"Indeksy podzielonych fragmentów mają przydatne wartości domyślne; pominięty " +"pierwszy indeks domyślnie jest zerem, pominięty drugi indeks domyślnie ma " +"wartość długości dzielonego stringa. ::" msgid "" "Note how the start is always included, and the end always excluded. This " @@ -320,8 +318,8 @@ msgid "" "Then the right edge of the last character of a string of *n* characters has " "index *n*, for example::" msgstr "" -"Sposobem na zapamiętanie, jak działa wykrawanie, to myślenie o indeksach " -"wskazujących *pomiędzy* znakami, z lewą krawędzią pierwszego znaku " +"Jednym ze sposobów na zapamiętanie, jak działa podział, to myślenie o " +"indeksach wskazujących *pomiędzy* znakami, z lewą krawędzią pierwszego znaku " "numerowaną 0. Wtedy prawa krawędź ostatniego znaku ciągu o długości *n* ma " "indeks *n*, na przykład::" @@ -332,16 +330,16 @@ msgid "" "*j*, respectively." msgstr "" "W pierwszym wierszu liczb są pozycje indeksów od 0 do 6 w ciągu. W drugim " -"wierszu odpowiadające im indeksy ujemne. Slice od *i* do *j* składa się ze " -"wszystkich znaków pomiędzy krawędziami oznaczonymi kolejno *i* i *j*." +"wierszu odpowiadające im indeksy ujemne. Fragment od *i* do *j* składa się " +"ze wszystkich znaków pomiędzy krawędziami oznaczonymi kolejno *i* i *j*." msgid "" "For non-negative indices, the length of a slice is the difference of the " "indices, if both are within bounds. For example, the length of " "``word[1:3]`` is 2." msgstr "" -"Dla nieujemnych indeksów długość slice'a to różnica indeksów, jeśli oba " -"mieszczą się w zakresie. Na przykład długość ``word[1:3]`` to 2." +"Dla nieujemnych indeksów długość wydzielonego fragmentu to różnica indeksów, " +"jeśli oba mieszczą się w zakresie. Na przykład długość ``word[1:3]`` to 2." msgid "Attempting to use an index that is too large will result in an error::" msgstr "Próba użycia za dużego indeksu skończy się błędem::" @@ -350,8 +348,8 @@ msgid "" "However, out of range slice indexes are handled gracefully when used for " "slicing::" msgstr "" -"Jednak indeksy wykrawania poza zakresem są obsłużone bezpiecznie przy " -"wykrawaniu::" +"Jednak indeksy podzielonych fragmentów poza zakresem są obsłużone " +"bezpiecznie przy podziale::" msgid "" "Python strings cannot be changed --- they are :term:`immutable`. Therefore, " @@ -432,19 +430,10 @@ msgid "" msgstr "" "Tak jak ciągi znaków (i wszystkie inne wbudowane typy :term:`sekwencyjne " "`), do elementów list można odwoływać się przez indeksy oraz można " -"z nich „wykrawać”::" - -msgid "" -"All slice operations return a new list containing the requested elements. " -"This means that the following slice returns a :ref:`shallow copy " -"` of the list::" -msgstr "" -"Wszystkie operacje wykrawania zwracają nową listę zawierającą żądane " -"elementy. Następujący slice więc zwraca :ref:`płytką kopię " -"` listy::" +"z nich „wydzielać”::" msgid "Lists also support operations like concatenation::" -msgstr "Listy wspierają też operacje takie jak konkatenacja::" +msgstr "Listy wspierają też operacje takie jak łączenie::" msgid "" "Unlike strings, which are :term:`immutable`, lists are a :term:`mutable` " @@ -455,11 +444,31 @@ msgstr "" "można zmieniać ich treść::" msgid "" -"You can also add new items at the end of the list, by using the :meth:`~list." +"You can also add new items at the end of the list, by using the :meth:`!list." "append` *method* (we will see more about methods later)::" msgstr "" "Można również dodawać nowe elementy na końcu listy, przez użycie *metody* " -"(dowiemy się więcej o metodach później) :meth:`~list.append`::" +"(dowiemy się więcej o metodach później) :meth:`!list.append`::" + +msgid "" +"Simple assignment in Python never copies data. When you assign a list to a " +"variable, the variable refers to the *existing list*. Any changes you make " +"to the list through one variable will be seen through all other variables " +"that refer to it.::" +msgstr "" +"Proste przypisanie w Pythonie nigdy nie kopiuje danych. Kiedy przypisujesz " +"listę do zmiennej, zmienna odnosi się do *istniejącej listy*. Wszystkie " +"zmiany dokonane na liście przez jedną zmienną będą widoczne przez wszystkie " +"inne zmienne, które się do niej odwołują.::" + +msgid "" +"All slice operations return a new list containing the requested elements. " +"This means that the following slice returns a :ref:`shallow copy " +"` of the list::" +msgstr "" +"Wszystkie operacje wykrawania zwracają nową listę zawierającą żądane " +"elementy. Następujący slice więc zwraca :ref:`płytką kopię " +"` listy::" msgid "" "Assignment to slices is also possible, and this can even change the size of " @@ -483,7 +492,7 @@ msgstr "Pierwsze kroki do programowania" msgid "" "Of course, we can use Python for more complicated tasks than adding two and " "two together. For instance, we can write an initial sub-sequence of the " -"`Fibonacci series `_ as " +"`Fibonacci series `_ as " "follows::" msgstr "" "Oczywiście możemy używać Pythona do zadań bardziej skomplikowanych niż " @@ -591,11 +600,11 @@ msgstr "" "W przeciwieństwie do innych języków, znaki specjalne takie jak ``\\n`` mają " "to samo znaczenie zarówno z pojedynczym (``'…'``) jak i podwójnym (``\"…" "\"``) cudzysłowem. Jedyną różnicą między nimi jest to, że wewnątrz " -"pojedynczego cudzysłowu nie musisz escape'ować ``\"`` (lecz musisz " -"escape'ować ``\\'``) i vice versa." +"pojedynczego cudzysłowu nie musisz używać znaku ucieczki dla ``\"`` (lecz " +"musisz użyć znaku ucieczki ``\\'``) i vice versa." msgid "# (hash)" -msgstr "# (kratka)" +msgstr "# (hash)" msgid "comment" msgstr "komentarz" diff --git a/tutorial/modules.po b/tutorial/modules.po index 28b7afcaa2..78a8d555fd 100644 --- a/tutorial/modules.po +++ b/tutorial/modules.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Ciarbin , 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -251,13 +250,13 @@ msgid "The Module Search Path" msgstr "Ścieżka wyszukiwania modułów" msgid "" -"When a module named :mod:`spam` is imported, the interpreter first searches " +"When a module named :mod:`!spam` is imported, the interpreter first searches " "for a built-in module with that name. These module names are listed in :data:" "`sys.builtin_module_names`. If not found, it then searches for a file named :" "file:`spam.py` in a list of directories given by the variable :data:`sys." "path`. :data:`sys.path` is initialized from these locations:" msgstr "" -"Kiedy importowany jest moduł o nazwie :mod:`spam`, interpreter najpierw " +"Kiedy importowany jest moduł o nazwie :mod:`!spam`, interpreter najpierw " "szuka wbudowanego modułu o takiej nazwie. Te nazwy modułów znajdują się w :" "data:`sys.builtin_module_names`. Jeśli nie znajdzie, wtedy szuka pliku o " "nazwie :file:`spam.py` na liście katalogów danych w zmiennej :data:`sys." @@ -485,15 +484,15 @@ msgstr "Pakiety" msgid "" "Packages are a way of structuring Python's module namespace by using " -"\"dotted module names\". For example, the module name :mod:`A.B` designates " -"a submodule named ``B`` in a package named ``A``. Just like the use of " -"modules saves the authors of different modules from having to worry about " -"each other's global variable names, the use of dotted module names saves the " -"authors of multi-module packages like NumPy or Pillow from having to worry " -"about each other's module names." +"\"dotted module names\". For example, the module name :mod:`!A.B` " +"designates a submodule named ``B`` in a package named ``A``. Just like the " +"use of modules saves the authors of different modules from having to worry " +"about each other's global variable names, the use of dotted module names " +"saves the authors of multi-module packages like NumPy or Pillow from having " +"to worry about each other's module names." msgstr "" "Pakiety to sposób strukturyzacji przestrzeni nazw modułów Pythona za pomocą " -"„nazw modułów z kropkami”. Na przykład nazwa modułu :mod:`A.B` oznacza " +"„nazw modułów z kropkami”. Na przykład nazwa modułu :mod:`!A.B` oznacza " "podmoduł ``B`` nazwany w pakiecie o nazwie ``A``. Tak jak użycie modułów " "oszczędza autorom martwienia się o nazwy zmiennych globalnych w pozostałych " "modułach, użycie nazw modułów z kropkami oszczędza autorom pakietów " @@ -534,14 +533,16 @@ msgstr "" msgid "" "The :file:`__init__.py` files are required to make Python treat directories " -"containing the file as packages. This prevents directories with a common " -"name, such as ``string``, from unintentionally hiding valid modules that " -"occur later on the module search path. In the simplest case, :file:`__init__." -"py` can just be an empty file, but it can also execute initialization code " -"for the package or set the ``__all__`` variable, described later." +"containing the file as packages (unless using a :term:`namespace package`, a " +"relatively advanced feature). This prevents directories with a common name, " +"such as ``string``, from unintentionally hiding valid modules that occur " +"later on the module search path. In the simplest case, :file:`__init__.py` " +"can just be an empty file, but it can also execute initialization code for " +"the package or set the ``__all__`` variable, described later." msgstr "" "Pliki :file:`__init__.py` są wymagane, aby Python traktował katalogi " -"zawierające ten plik jako pakiety. Zapobiega to katalogom o często " +"zawierające ten plik jako pakiety (o ile nie używa się :term:`namespace " +"package`, dość zaawansowanej funkcji). Zapobiega to katalogom o często " "występującej nazwie, takiej jak ``string``, przed niezamierzonym ukrywaniem " "prawidłowych modułów, które pojawiają się później w ścieżce wyszukiwania " "modułów. W najprostszym przypadku :file:`__init__.py` może to być po prostu " @@ -556,20 +557,20 @@ msgstr "" "przykład::" msgid "" -"This loads the submodule :mod:`sound.effects.echo`. It must be referenced " +"This loads the submodule :mod:`!sound.effects.echo`. It must be referenced " "with its full name. ::" msgstr "" -"Spowoduje to załadowanie podmodułu :mod:`sound.effects.echo`. Musi on być " +"Spowoduje to załadowanie podmodułu :mod:`!sound.effects.echo`. Musi on być " "wywoływany używając jego pełnej nazwy. ::" msgid "An alternative way of importing the submodule is::" msgstr "Alternatywnym sposobem importowania podmodułu jest::" msgid "" -"This also loads the submodule :mod:`echo`, and makes it available without " +"This also loads the submodule :mod:`!echo`, and makes it available without " "its package prefix, so it can be used as follows::" msgstr "" -"To również spowoduje załadowanie podmodułu :mod:`echo` lecz udostępnia go " +"To również spowoduje załadowanie podmodułu :mod:`!echo` lecz udostępnia go " "bez prefiksu pakietu, dzięki czemu można go użyć w następujący sposób::" msgid "" @@ -579,11 +580,11 @@ msgstr "" "Jeszcze innym sposobem jest bezpośredni import żądanej funkcji lub zmiennej::" msgid "" -"Again, this loads the submodule :mod:`echo`, but this makes its function :" -"func:`echofilter` directly available::" +"Again, this loads the submodule :mod:`!echo`, but this makes its function :" +"func:`!echofilter` directly available::" msgstr "" -"Ponownie, ładuje to podmoduł :mod:`echo`, ale dzięki temu jego funkcja :func:" -"`echofilter` jest bezpośrednio dostępna::" +"Ponownie, ładuje to podmoduł :mod:`!echo`, ale dzięki temu jego funkcja :" +"func:`!echofilter` jest bezpośrednio dostępna::" msgid "" "Note that when using ``from package import item``, the item can be either a " @@ -651,26 +652,40 @@ msgstr "" msgid "" "This would mean that ``from sound.effects import *`` would import the three " -"named submodules of the :mod:`sound.effects` package." +"named submodules of the :mod:`!sound.effects` package." msgstr "" "To by znaczyło że ``from sound.effects import *`` zaimportuje trzy " -"wymienione podmoduły z pakietu :mod:`sound.effects`." +"wymienione podmoduły z pakietu :mod:`!sound.effects`." + +msgid "" +"Be aware that submodules might become shadowed by locally defined names. For " +"example, if you added a ``reverse`` function to the :file:`sound/effects/" +"__init__.py` file, the ``from sound.effects import *`` would only import the " +"two submodules ``echo`` and ``surround``, but *not* the ``reverse`` " +"submodule, because it is shadowed by the locally defined ``reverse`` " +"function::" +msgstr "" +"Wróć uwagę na to, że podmoduły mogą być przysłaniane lokalnie zdefiniowanymi " +"nazwami. Na przykład, jeśli dodasz funkcję ``reverse`` do pliku :file:`sound/" +"effects/__init__.py`, instrukcja ``from sound.effects import *`` zaimportuje " +"tylko dwa podmoduły ``echo`` i ``surround``, ale nie podmoduł ``reverse``, " +"ponieważ jest on przysłonięty lokalnie zdefiniowaną funkcją ``reverse``::" msgid "" "If ``__all__`` is not defined, the statement ``from sound.effects import *`` " -"does *not* import all submodules from the package :mod:`sound.effects` into " -"the current namespace; it only ensures that the package :mod:`sound.effects` " -"has been imported (possibly running any initialization code in :file:" -"`__init__.py`) and then imports whatever names are defined in the package. " -"This includes any names defined (and submodules explicitly loaded) by :file:" -"`__init__.py`. It also includes any submodules of the package that were " -"explicitly loaded by previous :keyword:`import` statements. Consider this " -"code::" +"does *not* import all submodules from the package :mod:`!sound.effects` into " +"the current namespace; it only ensures that the package :mod:`!sound." +"effects` has been imported (possibly running any initialization code in :" +"file:`__init__.py`) and then imports whatever names are defined in the " +"package. This includes any names defined (and submodules explicitly loaded) " +"by :file:`__init__.py`. It also includes any submodules of the package that " +"were explicitly loaded by previous :keyword:`import` statements. Consider " +"this code::" msgstr "" "Jeśli zmienna ``__all__`` nie jest zdefiniowana, instrukcja ``from sound." -"effects import *`` *nie* importuje wszystkich podmodułów z pakietu :mod:" -"`sound.effects` do bieżącej przestrzeni nazw; upewnia się tylko, że pakiet :" -"mod:`sound.effects` został zaimportowany (ewentualnie uruchamiając dowolny " +"effects import *`` *nie* importuje wszystkich podmodułów z pakietu :mod:`!" +"sound.effects` do bieżącej przestrzeni nazw; upewnia się tylko, że pakiet :" +"mod:`!sound.effects` został zaimportowany (ewentualnie uruchamiając dowolny " "kod inicjujący w :file:`__init__.py`), a następnie importuje dowolne nazwy " "zdefiniowane w pakiecie. Obejmuje to wszelkie nazwy zdefiniowane (i jawnie " "załadowane moduły podrzędne) przez :file:`__init__.py`. Obejmuje również " @@ -678,13 +693,13 @@ msgstr "" "instrukcje :keyword:`import`. Rozważ ten kod::" msgid "" -"In this example, the :mod:`echo` and :mod:`surround` modules are imported in " -"the current namespace because they are defined in the :mod:`sound.effects` " -"package when the ``from...import`` statement is executed. (This also works " -"when ``__all__`` is defined.)" +"In this example, the :mod:`!echo` and :mod:`!surround` modules are imported " +"in the current namespace because they are defined in the :mod:`!sound." +"effects` package when the ``from...import`` statement is executed. (This " +"also works when ``__all__`` is defined.)" msgstr "" -"W tym przykładzie moduły :mod:`echo` i :mod:`surround` są importowane do " -"bieżącej przestrzeni nazw, ponieważ są zdefiniowane w pakiecie :mod:`sound." +"W tym przykładzie moduły :mod:`!echo` i :mod:`!surround` są importowane do " +"bieżącej przestrzeni nazw, ponieważ są zdefiniowane w pakiecie :mod:`!sound." "effects` podczas wykonywania instrukcji ``from...import``. (Działa to " "również, gdy zmienna ``__all__`` jest zdefiniowana.)" @@ -712,28 +727,28 @@ msgid "Intra-package References" msgstr "Referencje wewnątrz-pakietowe" msgid "" -"When packages are structured into subpackages (as with the :mod:`sound` " +"When packages are structured into subpackages (as with the :mod:`!sound` " "package in the example), you can use absolute imports to refer to submodules " -"of siblings packages. For example, if the module :mod:`sound.filters." -"vocoder` needs to use the :mod:`echo` module in the :mod:`sound.effects` " +"of siblings packages. For example, if the module :mod:`!sound.filters." +"vocoder` needs to use the :mod:`!echo` module in the :mod:`!sound.effects` " "package, it can use ``from sound.effects import echo``." msgstr "" -"Gdy pakiety są podzielone na podpakiety (jak w przypadku pakietu :mod:" -"`sound` w przykładzie), możesz użyć importu bezwzględnego, aby odnieść się " -"do podmodułów siostrzanych pakietów. Na przykład, jeśli moduł :mod:`sound." -"filters.vocoder` musi użyć modułu :mod:`echo` w pakiecie :mod:`sound." +"Gdy pakiety są podzielone na podpakiety (jak w przypadku pakietu :mod:`!" +"sound` w przykładzie), możesz użyć importu bezwzględnego, aby odnieść się do " +"podmodułów siostrzanych pakietów. Na przykład, jeśli moduł :mod:`!sound." +"filters.vocoder` musi użyć modułu :mod:`!echo` w pakiecie :mod:`!sound." "effects`, może użyć ``from sound.effects import echo``." msgid "" "You can also write relative imports, with the ``from module import name`` " "form of import statement. These imports use leading dots to indicate the " "current and parent packages involved in the relative import. From the :mod:" -"`surround` module for example, you might use::" +"`!surround` module for example, you might use::" msgstr "" "Można również pisać importy względne w formie takiej: ``from module import " "name`` instrukcji importu. Te importy wykorzystują wiodące kropki do " "wskazania pakietów bieżących i nadrzędnych biorących udział w imporcie " -"względnym. Na przykład z modułu :mod:`surround` możesz użyć::" +"względnym. Na przykład z modułu :mod:`!surround` możesz użyć::" msgid "" "Note that relative imports are based on the name of the current module. " diff --git a/tutorial/stdlib.po b/tutorial/stdlib.po index 9159e69097..13252ae4b8 100644 --- a/tutorial/stdlib.po +++ b/tutorial/stdlib.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Ciarbin , 2022 -# Stefan Ocetkiewicz , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,11 +49,15 @@ msgid "" "The built-in :func:`dir` and :func:`help` functions are useful as " "interactive aids for working with large modules like :mod:`os`::" msgstr "" +"Wbudowane funkcje :func:`dir` i :func:`help`, są przydatne jako interaktywne " +"pomoce do pracy z dużymi modułami, takimi jak :mod:`os`::" msgid "" "For daily file and directory management tasks, the :mod:`shutil` module " "provides a higher level interface that is easier to use::" msgstr "" +"Do codziennego zarządzania plikami i katalogami, moduł :mod:`shutil` " +"zapewnia interfejs wyższego poziomu, który jest łatwiejszy w użyciu::" msgid "File Wildcards" msgstr "Symbole wieloznaczne plików" @@ -64,6 +66,8 @@ msgid "" "The :mod:`glob` module provides a function for making file lists from " "directory wildcard searches::" msgstr "" +"Moduł :mod:`glob` udostępnia funkcję do tworzenia list plików korzystając z " +"wyszukiwania na symbolach wieloznacznych::" msgid "Command Line Arguments" msgstr "Argumenty linii polecenia" @@ -80,38 +84,56 @@ msgid "" "process command line arguments. The following script extracts one or more " "filenames and an optional number of lines to be displayed::" msgstr "" +"Moduł :mod:`argparse` zapewnia bardziej wyrafinowane mechanizmy do " +"przetwarzania argumentów wiersza poleceń. Poniższy skrypt wyodrębnia jedną " +"lub więcej nazw plików i opcjonalną liczbę linii do wyświetlenia::" msgid "" "When run at the command line with ``python top.py --lines=5 alpha.txt beta." "txt``, the script sets ``args.lines`` to ``5`` and ``args.filenames`` to " "``['alpha.txt', 'beta.txt']``." msgstr "" +"Po uruchomieniu w wierszu poleceń ``python top.py --lines=5 alpha.txt beta." +"txt``, skrypt ustawia ``args.lines`` na ``5`` i ``args.filenames`` na " +"``['alpha.txt', 'beta.txt']``." msgid "Error Output Redirection and Program Termination" -msgstr "" +msgstr "Przekierowanie wyjścia błędu i zakończenie programu" msgid "" "The :mod:`sys` module also has attributes for *stdin*, *stdout*, and " "*stderr*. The latter is useful for emitting warnings and error messages to " "make them visible even when *stdout* has been redirected::" msgstr "" +"Moduł :mod:`sys` ma również atrybuty dla *stdin*, *stdout* i *stderr* " +"(standardowe wejście, standardowe wyjście i standardowe wyjście błędu). To " +"ostatnie jest przydatne do emitowania ostrzeżeń i komunikatów o błędach, aby " +"były widoczne nawet wtedy, gdy *stdout* został przekierowany::" msgid "The most direct way to terminate a script is to use ``sys.exit()``." msgstr "" +"Najbardziej bezpośrednim sposobem na zakończenie skryptu jest użycie ``sys." +"exit()``." msgid "String Pattern Matching" -msgstr "" +msgstr "Dopasowywanie wzorców w napisach" msgid "" "The :mod:`re` module provides regular expression tools for advanced string " "processing. For complex matching and manipulation, regular expressions offer " "succinct, optimized solutions::" msgstr "" +"Moduł :mod:`re` zapewnia narzędzia wyrażeń regularnych do zaawansowanego " +"przetwarzania napisów. W przypadku złożonych operacji dopasowywania i " +"manipulacji na ciągach znaków, wyrażenia regularne pozwalają na zwięzłe, " +"zoptymalizowane rozwiązania::" msgid "" "When only simple capabilities are needed, string methods are preferred " "because they are easier to read and debug::" msgstr "" +"Gdy potrzebne są tylko proste funkcje, preferowane są funkcje standardowe " +"napisów, ponieważ są łatwiejsze do odczytania i debugowania::" msgid "Mathematics" msgstr "Funkcje matematyczne" @@ -147,9 +169,14 @@ msgid "" "internet protocols. Two of the simplest are :mod:`urllib.request` for " "retrieving data from URLs and :mod:`smtplib` for sending mail::" msgstr "" +"Istnieje wiele modułów umożliwiających dostęp do Internetu i przetwarzanie " +"protokołów internetowych. Dwa z najprostszych to :mod:`urllib.request` do " +"pobierania danych z adresów URL i :mod:`smtplib` do wysyłania poczty::" msgid "(Note that the second example needs a mailserver running on localhost.)" msgstr "" +"(Zauważ, że drugi przykład wymaga serwera pocztowego działającego lokalnie " +"pod adresem `localhost`)." msgid "Dates and Times" msgstr "Daty i czas" @@ -161,6 +188,11 @@ msgid "" "for output formatting and manipulation. The module also supports objects " "that are timezone aware. ::" msgstr "" +"Moduł :mod:`datetime` dostarcza klasy do manipulowania datami i godzinami " +"zarówno w prosty, jak i złożony sposób. Podczas gdy obsługiwana jest " +"arytmetyka daty i czasu, implementacja koncentruje się na wydajnym " +"wyodrębnianiu danych w celu formatowania i manipulacji. Moduł obsługuje " +"również obiekty uwzględniające strefę czasową ::" msgid "Data Compression" msgstr "Kompresja Danych" @@ -170,6 +202,9 @@ msgid "" "modules including: :mod:`zlib`, :mod:`gzip`, :mod:`bz2`, :mod:`lzma`, :mod:" "`zipfile` and :mod:`tarfile`. ::" msgstr "" +"Popularne formaty archiwizacji i kompresji danych są bezpośrednio " +"obsługiwane przez moduły, w tym: :mod:`zlib`, :mod:`gzip`, :mod:`bz2`, :mod:" +"`lzma`, :mod:`zipfile` i :mod:`tarfile`:" msgid "Performance Measurement" msgstr "Mierzenie wydajności" @@ -179,18 +214,27 @@ msgid "" "performance of different approaches to the same problem. Python provides a " "measurement tool that answers those questions immediately." msgstr "" +"Niektórzy użytkownicy Python są głęboko zainteresowani poznaniem względnej " +"wydajności różnych podejść do tego samego problemu. Python zapewnia " +"narzędzie pomiarowe, które natychmiast odpowiada na te pytania." msgid "" "For example, it may be tempting to use the tuple packing and unpacking " "feature instead of the traditional approach to swapping arguments. The :mod:" "`timeit` module quickly demonstrates a modest performance advantage::" msgstr "" +"Na przykład kuszące może być użycie funkcji pakowania i rozpakowywania " +"krotka zamiast tradycyjnego podejścia do zamiany argument. Moduł :mod:" +"`timeit` szybko pokazuje skromną przewagę wydajności::" msgid "" "In contrast to :mod:`timeit`'s fine level of granularity, the :mod:`profile` " "and :mod:`pstats` modules provide tools for identifying time critical " "sections in larger blocks of code." msgstr "" +"W przeciwieństwie do dokładnego poziomu szczegółowości :mod:`timeit`, " +"moduły :mod:`profile` i :mod:`pstats` zapewniają narzędzia do identyfikacji " +"sekcji krytycznych czasowo w większych blok kodu." msgid "Quality Control" msgstr "Kontrola jakości" @@ -200,6 +244,9 @@ msgid "" "function as it is developed and to run those tests frequently during the " "development process." msgstr "" +"Jednym z podejść do tworzenia wysokiej jakości oprogramowania jest pisanie " +"testów dla każdej funkcj w trakcie jego tworzenia i częste uruchamianie tych " +"testów podczas rozwoju." msgid "" "The :mod:`doctest` module provides a tool for scanning a module and " @@ -209,12 +256,21 @@ msgid "" "example and it allows the doctest module to make sure the code remains true " "to the documentation::" msgstr "" +"Moduł :mod:`doctest` zapewnia narzędzie do skanowania strony moduł i " +"sprawdzania poprawności testów osadzonych w dokumentacji programu. " +"Konstrukcja testu jest tak prosta, jak wycięcie i wklejenie typowego " +"wywołania wraz z jego wynikami do docstring. Poprawia to dokumentację " +"poprzez dostarczenie użytkownikowi przykładu i pozwala doctestowi moduł " +"upewnić się, że kod pozostaje prawda zgodny z dokumentacją::" msgid "" "The :mod:`unittest` module is not as effortless as the :mod:`doctest` " "module, but it allows a more comprehensive set of tests to be maintained in " "a separate file::" msgstr "" +"Moduł :mod:`unittest` nie jest tak łatwy w użytku jak moduł :mod:`doctest` , " +"ale pozwala na przechowywanie bardziej kompleksowego zestawu testów w " +"osobnym pliku::" msgid "Batteries Included" msgstr "Dostarczone z bateriami" @@ -232,6 +288,10 @@ msgid "" "remote procedure calls into an almost trivial task. Despite the modules' " "names, no direct knowledge or handling of XML is needed." msgstr "" +"Moduły :mod:`xmlrpc.client` i :mod:`xmlrpc.server` sprawiają, że " +"implementacja zdalnych wywołań procedur staje się niemal trywialnym " +"zadaniem. Pomimo nazw moduł', nie jest wymagana bezpośrednia znajomość lub " +"obsługa XML." msgid "" "The :mod:`email` package is a library for managing email messages, including " @@ -241,6 +301,12 @@ msgid "" "structures (including attachments) and for implementing internet encoding " "and header protocols." msgstr "" +"Pakiet :mod:`email` jest biblioteką do zarządzania wiadomościami e-mail, w " +"tym MIME i innymi dokumentami wiadomości opartymi na :rfc:`2822`. W " +"przeciwieństwie do :mod:`smtplib` i :mod:`poplib`, które faktycznie wysyłają " +"i odbierają wiadomości, pakiet e-mail posiada kompletny zestaw narzędzi do " +"tworzenia lub dekodowania złożonych struktur wiadomości (w tym załączników) " +"oraz do implementacji internetowych protokołów kodowania i nagłówków." msgid "" "The :mod:`json` package provides robust support for parsing this popular " @@ -251,20 +317,33 @@ msgid "" "these modules and packages greatly simplify data interchange between Python " "applications and other tools." msgstr "" +"Pakiet :mod:`json` zapewnia solidne wsparcie dla analizowania tego " +"popularnego formatu wymiany danych. Pakiet :mod:`csv` moduł obsługuje " +"bezpośredni odczyt i zapis plików w formacie Comma-Separated Value (.csv), " +"powszechnie obsługiwanym przez bazy danych i arkusze kalkulacyjne. " +"Przetwarzanie XML jest obsługiwane przez pakiety :mod:`xml.etree." +"ElementTree`, :mod:`xml.dom` i :mod:`xml.sax`. Razem te moduły i pakiety " +"znacznie upraszczają wymianę danych między Python aplikacja i innymi " +"narzędziami." msgid "" "The :mod:`sqlite3` module is a wrapper for the SQLite database library, " "providing a persistent database that can be updated and accessed using " "slightly nonstandard SQL syntax." msgstr "" +"Moduł :mod:`sqlite3` jest opakowaniem dla biblioteki bazy danych SQLite, " +"zapewniając trwałą bazę danych, która może być aktualizowana i dostępna przy " +"użyciu nieco niestandardowej składni SQL." msgid "" "Internationalization is supported by a number of modules including :mod:" "`gettext`, :mod:`locale`, and the :mod:`codecs` package." msgstr "" +"Internacjonalizacja jest wspierana przez kilka moduł, w tym :mod:`gettext`, :" +"mod:`locale` i :mod:`codecs`." msgid "built-in function" -msgstr "" +msgstr "funkcja wbudowana" msgid "help" -msgstr "" +msgstr "pomoc" diff --git a/tutorial/stdlib2.po b/tutorial/stdlib2.po new file mode 100644 index 0000000000..b77da1d045 --- /dev/null +++ b/tutorial/stdlib2.po @@ -0,0 +1,397 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "Brief Tour of the Standard Library --- Part II" +msgstr "Krótka wycieczka po bibliotece standardowej --- Część II" + +msgid "" +"This second tour covers more advanced modules that support professional " +"programming needs. These modules rarely occur in small scripts." +msgstr "" +"Ta druga wycieczka obejmuje bardziej zaawansowane moduł, które wspierają " +"profesjonalne potrzeby programistyczne. Te moduł rzadko występują w małych " +"skryptach." + +msgid "Output Formatting" +msgstr "Formatowanie wyjścia" + +msgid "" +"The :mod:`reprlib` module provides a version of :func:`repr` customized for " +"abbreviated displays of large or deeply nested containers::" +msgstr "" +":mod:`reprlib` moduł zapewnia wersja z :func:`repr` dostosowany do " +"skróconego wyświetlania dużych lub głęboko zagnieżdżonych kontenerów::" + +msgid "" +"The :mod:`pprint` module offers more sophisticated control over printing " +"both built-in and user defined objects in a way that is readable by the " +"interpreter. When the result is longer than one line, the \"pretty printer\" " +"adds line breaks and indentation to more clearly reveal data structure::" +msgstr "" +"Moduł :mod:`pprint` oferuje bardziej wyrafinowaną kontrolę nad drukowaniem " +"zarówno wbudowanej, jak i obiektów zdefiniowanych przez użytkownika w sposób " +"czytelny dla interpretera. Gdy wynik jest dłuższy niż jedna linia, \"ładna " +"drukarka\" dodaje podziały linii i wcięcia, aby wyraźniej ujawnić strukturę " +"danych::" + +msgid "" +"The :mod:`textwrap` module formats paragraphs of text to fit a given screen " +"width::" +msgstr "" +"Moduł :mod:`textwrap` formatuje akapity tekstu tak, aby pasowały do danej " +"szerokości ekranu::" + +msgid "" +"The :mod:`locale` module accesses a database of culture specific data " +"formats. The grouping attribute of locale's format function provides a " +"direct way of formatting numbers with group separators::" +msgstr "" +":mod:`locale` moduł uzyskuje dostęp do bazy danych formatów danych " +"specyficznych dla danej kultury. Grupowanie atrybut formatu locale funkcja " +"zapewnia bezpośredni sposób formatowania liczb za pomocą separatorów grup::" + +msgid "Templating" +msgstr "Szablonowanie" + +msgid "" +"The :mod:`string` module includes a versatile :class:`~string.Template` " +"class with a simplified syntax suitable for editing by end-users. This " +"allows users to customize their applications without having to alter the " +"application." +msgstr "" +"Moduł :mod:`string` zawiera wszechstronną klasę :class:`~string.Template` z " +"uproszczoną składnią odpowiednią do edycji przez użytkowników końcowych. " +"Pozwala to użytkownikom na dostosowanie ich aplikacja bez konieczności " +"zmiany aplikacja." + +msgid "" +"The format uses placeholder names formed by ``$`` with valid Python " +"identifiers (alphanumeric characters and underscores). Surrounding the " +"placeholder with braces allows it to be followed by more alphanumeric " +"letters with no intervening spaces. Writing ``$$`` creates a single escaped " +"``$``::" +msgstr "" +"Format wykorzystuje nazwy placeholder utworzone przez ``$`` z ważnymi " +"identyfikatorami Python (alfanumeryczne znak i podkreślenia). Otoczenie " +"placeholder nawiasami klamrowymi pozwala na umieszczenie po nim kolejnych " +"liter alfanumerycznych bez spacji. Napisanie ``$$`` tworzy pojedynczy " +"``$``::" + +msgid "" +"The :meth:`~string.Template.substitute` method raises a :exc:`KeyError` when " +"a placeholder is not supplied in a dictionary or a keyword argument. For " +"mail-merge style applications, user supplied data may be incomplete and the :" +"meth:`~string.Template.safe_substitute` method may be more appropriate --- " +"it will leave placeholders unchanged if data is missing::" +msgstr "" +"Metoda :meth:`~string.Template.substitute` rzuci :exc:`KeyError`, gdy " +"placeholder nie jest podany w słowniku lub argument nazwany. W przypadku " +"mail-merge aplikacjach, dane dostarczone przez użytkownika mogą być " +"niekompletne, a metoda :meth:`~string.Template.safe_substitute` może być " +"bardziej odpowiednia --- pozostawi placeholder bez zmian, jeśli brakuje " +"danych::" + +msgid "" +"Template subclasses can specify a custom delimiter. For example, a batch " +"renaming utility for a photo browser may elect to use percent signs for " +"placeholders such as the current date, image sequence number, or file " +"format::" +msgstr "" +"Szablon podklas mogą określać niestandardowy separator. Na przykład, " +"narzędzie do wsadowej zmiany nazw dla przeglądarki zdjęć może zdecydować się " +"na użycie znaków procentowych jako placeholder, takich jak bieżące dane, " +"numer sekwencyjny obrazu lub format pliku::" + +msgid "" +"Another application for templating is separating program logic from the " +"details of multiple output formats. This makes it possible to substitute " +"custom templates for XML files, plain text reports, and HTML web reports." +msgstr "" +"Innym aplikacja dla szablonów jest oddzielenie logiki programu od szczegółów " +"wielu formatów wyjściowych. Umożliwia to zastąpienie niestandardowych " +"szablonów plikami XML, raportami tekstowymi i raportami internetowymi HTML." + +msgid "Working with Binary Data Record Layouts" +msgstr "Praca z układami rekordów danych binarnych" + +msgid "" +"The :mod:`struct` module provides :func:`~struct.pack` and :func:`~struct." +"unpack` functions for working with variable length binary record formats. " +"The following example shows how to loop through header information in a ZIP " +"file without using the :mod:`zipfile` module. Pack codes ``\"H\"`` and " +"``\"I\"`` represent two and four byte unsigned numbers respectively. The " +"``\"<\"`` indicates that they are standard size and in little-endian byte " +"order::" +msgstr "" +"Moduł :mod:`struct` udostępnia :func:`~struct.pack` i :func:`~struct.unpack` " +"funkcje do pracy z formatami rekordów binarnych o zmiennej długości. " +"Poniższy przykład pokazuje, jak zapętlić informacje nagłówka w pliku ZIP bez " +"użycia moduł :mod:`zipfile` . Kody pakietów ``\"H\"`` i ``\"I\"`` " +"reprezentują odpowiednio dwu- i czterobajtowe liczby bez znaku. Oznaczenie " +"``\"<\"`` wskazuje, że mają one standardowy rozmiar i kolejność bajtów " +"little-endian::" + +msgid "Multi-threading" +msgstr "Wielowątkowość" + +msgid "" +"Threading is a technique for decoupling tasks which are not sequentially " +"dependent. Threads can be used to improve the responsiveness of " +"applications that accept user input while other tasks run in the " +"background. A related use case is running I/O in parallel with computations " +"in another thread." +msgstr "" +"Wątkowanie jest techniką oddzielania zadań, które nie są sekwencyjnie " +"zależne. Wątek może być używany do poprawy szybkości reakcji aplikacji, " +"które akceptują dane wejściowe użytkownika, podczas gdy inne zadania " +"działają w tle. Powiązanym przypadkiem użycia jest równoległe wykonywanie " +"operacji wejścia/wyjścia z obliczeniami w innym wątku." + +msgid "" +"The following code shows how the high level :mod:`threading` module can run " +"tasks in background while the main program continues to run::" +msgstr "" +"Poniższy kod pokazuje, w jaki sposób wysokopoziomowy :mod:`threading` moduł " +"może uruchamiać zadania w tle, podczas gdy główny program nadal działa::" + +msgid "" +"The principal challenge of multi-threaded applications is coordinating " +"threads that share data or other resources. To that end, the threading " +"module provides a number of synchronization primitives including locks, " +"events, condition variables, and semaphores." +msgstr "" +"Głównym wyzwaniem wielowątkowej aplikacji jest koordynacja wątkow, które " +"współdzielą dane lub inne zasoby. W tym celu wątkowanie moduł zapewnia " +"szereg prymitywów synchronizacji, w tym blokady, zdarzenia, zmienne " +"warunkowe i semafory." + +msgid "" +"While those tools are powerful, minor design errors can result in problems " +"that are difficult to reproduce. So, the preferred approach to task " +"coordination is to concentrate all access to a resource in a single thread " +"and then use the :mod:`queue` module to feed that thread with requests from " +"other threads. Applications using :class:`~queue.Queue` objects for inter-" +"thread communication and coordination are easier to design, more readable, " +"and more reliable." +msgstr "" +"Chociaż narzędzia te są potężne, drobne błędy projektowe mogą skutkować " +"trudnymi do odtworzenia problemami. Dlatego preferowanym podejściem do " +"koordynacji zadań jest skoncentrowanie całego dostępu do zasobu w jednym " +"wąteku, a następnie wykorzystanie moduł :mod:`queue` do zasilania tego " +"wąteka żądaniami z innych wątekow. Aplikacja wykorzystuje obiekty :class:" +"`~queue.Queue` do komunikacji i koordynacji międzywątekowych są łatwiejsze " +"do zaprojektowania, bardziej czytelne i niezawodne." + +msgid "Logging" +msgstr "Logowanie" + +msgid "" +"The :mod:`logging` module offers a full featured and flexible logging " +"system. At its simplest, log messages are sent to a file or to ``sys." +"stderr``::" +msgstr "" +"Moduł :mod:`logging` oferuje w pełni funkcjonalny i elastyczny system " +"logowania. W najprostszym przypadku komunikaty dziennika są wysyłane do " +"pliku lub na adres ``sys.stderr``::" + +msgid "This produces the following output:" +msgstr "Daje to taki wyniki:" + +msgid "" +"By default, informational and debugging messages are suppressed and the " +"output is sent to standard error. Other output options include routing " +"messages through email, datagrams, sockets, or to an HTTP Server. New " +"filters can select different routing based on message priority: :const:" +"`~logging.DEBUG`, :const:`~logging.INFO`, :const:`~logging.WARNING`, :const:" +"`~logging.ERROR`, and :const:`~logging.CRITICAL`." +msgstr "" +"Domyślnie, komunikaty informacyjne i debugowanie są tłumione, a dane " +"wyjściowe są wysyłane do standardowego błędu. Inne opcje wyjściowe obejmują " +"kierowanie wiadomości przez e-mail, datagramy, gniazda lub do serwera HTTP. " +"Nowe filtry mogą wybierać różne trasy na podstawie priorytetu wiadomości: :" +"const:`~logging.DEBUG`, :const:`~logging.INFO`, :const:`~logging.WARNING`, :" +"const:`~logging.ERROR` i :const:`~logging.CRITICAL`." + +msgid "" +"The logging system can be configured directly from Python or can be loaded " +"from a user editable configuration file for customized logging without " +"altering the application." +msgstr "" +"System logowania może być skonfigurowany bezpośrednio z poziomu Pythona lub " +"może być załadowany z edytowalnego przez użytkownika pliku konfiguracyjnego " +"w celu dostosowania rejestrowania bez zmiany aplikacji." + +msgid "Weak References" +msgstr "Wsparcie słabych odniesień" + +msgid "" +"Python does automatic memory management (reference counting for most objects " +"and :term:`garbage collection` to eliminate cycles). The memory is freed " +"shortly after the last reference to it has been eliminated." +msgstr "" +"Python wykonuje automatyczne zarządzanie pamięcią (liczenie referencji dla " +"większości obiektów i :term:`garbage collection` w celu wyeliminowania " +"cykli). Pamięć jest zwalniana wkrótce po usunięciu ostatniego odniesienia " +"do niej." + +msgid "" +"This approach works fine for most applications but occasionally there is a " +"need to track objects only as long as they are being used by something else. " +"Unfortunately, just tracking them creates a reference that makes them " +"permanent. The :mod:`weakref` module provides tools for tracking objects " +"without creating a reference. When the object is no longer needed, it is " +"automatically removed from a weakref table and a callback is triggered for " +"weakref objects. Typical applications include caching objects that are " +"expensive to create::" +msgstr "" +"Takie podejście sprawdza się w większości przypadków aplikacji, ale czasami " +"istnieje potrzeba śledzenia obiektów tylko tak długo, jak są one używane " +"przez coś innego. Niestety, samo ich śledzenie tworzy odniesienie, które " +"czyni je trwałymi. :mod:`weakref` moduł zapewnia narzędzia do śledzenia " +"obiektów bez tworzenia odniesienia. Gdy obiekt nie jest już potrzebny, jest " +"automatycznie usuwany z tabeli weakref i uruchamiane jest wywołanie zwrotne " +"dla obiektów weakref. Typowe aplikacja obejmują buforowanie obiektów, " +"których utworzenie jest kosztowne::" + +msgid "Tools for Working with Lists" +msgstr "Narzędzia do pracy z listami" + +msgid "" +"Many data structure needs can be met with the built-in list type. However, " +"sometimes there is a need for alternative implementations with different " +"performance trade-offs." +msgstr "" +"Wiele potrzeb związanych ze strukturami danych można zaspokoić za pomocą " +"listy wbudowanej. Czasami jednak istnieje potrzeba alternatywnych " +"implementacji z różnymi kompromisami w zakresie wydajności." + +msgid "" +"The :mod:`array` module provides an :class:`~array.array()` object that is " +"like a list that stores only homogeneous data and stores it more compactly. " +"The following example shows an array of numbers stored as two byte unsigned " +"binary numbers (typecode ``\"H\"``) rather than the usual 16 bytes per entry " +"for regular lists of Python int objects::" +msgstr "" + +msgid "" +"The :mod:`collections` module provides a :class:`~collections.deque()` " +"object that is like a list with faster appends and pops from the left side " +"but slower lookups in the middle. These objects are well suited for " +"implementing queues and breadth first tree searches::" +msgstr "" + +msgid "" +"In addition to alternative list implementations, the library also offers " +"other tools such as the :mod:`bisect` module with functions for manipulating " +"sorted lists::" +msgstr "" +"Oprócz alternatywnych implementacji list, biblioteka oferuje również inne " +"narzędzia, takie jak :mod:`bisect` moduł z funkcja do manipulowania " +"posortowanymi listami::" + +msgid "" +"The :mod:`heapq` module provides functions for implementing heaps based on " +"regular lists. The lowest valued entry is always kept at position zero. " +"This is useful for applications which repeatedly access the smallest element " +"but do not want to run a full list sort::" +msgstr "" +"Moduł :mod:`heapq` udostępnia funkcje do implementacji stert opartych na " +"listach regularnych. Wpis o najniższej wartości jest zawsze przechowywany " +"na pozycji zero. Jest to przydatne dla aplikacji, które wielokrotnie " +"uzyskują dostęp do najmniejszego elementu, ale nie chcą uruchamiać pełnego " +"sortowania listy::" + +msgid "Decimal Floating Point Arithmetic" +msgstr "" + +msgid "" +"The :mod:`decimal` module offers a :class:`~decimal.Decimal` datatype for " +"decimal floating point arithmetic. Compared to the built-in :class:`float` " +"implementation of binary floating point, the class is especially helpful for" +msgstr "" + +msgid "" +"financial applications and other uses which require exact decimal " +"representation," +msgstr "" +"finansowe aplikacja i inne zastosowania wymagające dokładnej reprezentacji " +"dziesiętnej," + +msgid "control over precision," +msgstr "kontrola nad precyzją," + +msgid "control over rounding to meet legal or regulatory requirements," +msgstr "" +"kontrolę nad zaokrągleniami w celu spełnienia wymogów prawnych lub " +"regulacyjnych," + +msgid "tracking of significant decimal places, or" +msgstr "śledzenie znaczących miejsc po przecinku, lub" + +msgid "" +"applications where the user expects the results to match calculations done " +"by hand." +msgstr "" +"aplikacja gdzie użytkownik oczekuje, że wyniki będą zgodne z obliczeniami " +"wykonanymi ręcznie." + +msgid "" +"For example, calculating a 5% tax on a 70 cent phone charge gives different " +"results in decimal floating point and binary floating point. The difference " +"becomes significant if the results are rounded to the nearest cent::" +msgstr "" +"Na przykład, obliczenie 5% podatku od 70 centów opłaty telefonicznej daje " +"różne wyniki w dziesiętnej zmiennoprzecinkowej i binarnej " +"zmiennoprzecinkowej. Różnica staje się znacząca, jeśli wyniki zostaną " +"zaokrąglone do najbliższego centa::" + +msgid "" +"The :class:`~decimal.Decimal` result keeps a trailing zero, automatically " +"inferring four place significance from multiplicands with two place " +"significance. Decimal reproduces mathematics as done by hand and avoids " +"issues that can arise when binary floating point cannot exactly represent " +"decimal quantities." +msgstr "" +"Wynik :class:`~decimal.Decimal` zachowuje końcowe zero, automatycznie " +"wywnioskowując znaczenie czterech miejsc z mnożników o znaczeniu dwóch " +"miejsc. Decimal odtwarza matematykę wykonaną ręcznie i unika problemów, " +"które mogą powstać, gdy binarna liczba zmiennoprzecinkowa nie może dokładnie " +"reprezentować wielkości dziesiętnych." + +msgid "" +"Exact representation enables the :class:`~decimal.Decimal` class to perform " +"modulo calculations and equality tests that are unsuitable for binary " +"floating point::" +msgstr "" +"Dokładna reprezentacja umożliwia klasie :class:`~decimal.Decimal` " +"wykonywanie obliczeń modulo i testów równości, które nie są odpowiednie dla " +"binarnych liczb zmiennoprzecinkowych:" + +msgid "" +"The :mod:`decimal` module provides arithmetic with as much precision as " +"needed::" +msgstr "" +"Moduł :mod:`decimal` zapewnia arytmetykę z taką precyzją, jaka jest " +"potrzebna::" diff --git a/tutorial/venv.po b/tutorial/venv.po index 656c3c5aa6..974f8f0fc1 100644 --- a/tutorial/venv.po +++ b/tutorial/venv.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Ciarbin , 2022 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -170,6 +168,10 @@ msgid "" "Package Index `_. You can browse the Python Package Index " "by going to it in your web browser." msgstr "" +"Możesz instalować, aktualizować oraz usuwać pakiety korzystając z pragramu " +"nazywanego :program:`pip`. Domyślnie ``pip`` zainstaluje pakiety z `Python " +"Package Index `_. Możesz przeglądać dostępne tam pakiety " +"wchodząc na ich stronę internetową." msgid "" "``pip`` has a number of subcommands: \"install\", \"uninstall\", \"freeze\", " @@ -245,10 +247,10 @@ msgstr "" msgid "" "``pip`` has many more options. Consult the :ref:`installing-index` guide " "for complete documentation for ``pip``. When you've written a package and " -"want to make it available on the Python Package Index, consult the :ref:" -"`distributing-index` guide." +"want to make it available on the Python Package Index, consult the `Python " +"packaging user guide`_." msgstr "" "``pip`` ma o wiele więcej opcji. Zapoznaj się z przewodnikiem :ref:" "`installing-index`, aby uzyskać pełną dokumentację dotyczącą ``pip``. Kiedy " "napiszesz pakiet i będziesz chciał udostępnić go w indeksie pakietów " -"Pythona, zapoznaj się z przewodnikiem :ref:`distributing-index`." +"Pythona, zapoznaj się z `Python packaging user guide`_." diff --git a/tutorial/whatnow.po b/tutorial/whatnow.po index 18cffd4f0b..0dcf05f3a5 100644 --- a/tutorial/whatnow.po +++ b/tutorial/whatnow.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Ciarbin , 2021 -# Maciej Olko , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:50+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,6 +55,13 @@ msgid "" "other tasks. Skimming through the Library Reference will give you an idea of " "what's available." msgstr "" +"Powinieneś przejrzeć ten podręcznik, który zawiera kompletny (choć zwięzły) " +"materiał referencyjny na temat typów, funkcji i modułów w standardowej " +"bibliotece. Standardowa dystrybucja Pythona zawiera *dużo* dodatkowego kodu. " +"Istnieją moduły do ​​czytania skrzynek pocztowych Unix, pobierania dokumentów " +"przez HTTP, generowania liczb losowych, analizowania opcji wiersza poleceń, " +"pisania programów CGI, kompresji danych i wielu innych zadań. Przejrzenie " +"informacji o bibliotece da ci wyobrażenie o tym, co jest dostępne." msgid "" ":ref:`installing-index` explains how to install additional modules written " @@ -81,9 +86,12 @@ msgid "" "https://www.python.org: The major Python web site. It contains code, " "documentation, and pointers to Python-related pages around the web." msgstr "" +"https://www.python.org: Główna strona internetowa poświęcona językowi " +"Python. Zawiera kod, dokumentację oraz odnośniki do innych stron związanych " +"z Python-em." msgid "https://docs.python.org: Fast access to Python's documentation." -msgstr "https://docs.python.org: Szybki dostęp do dokumentacji Pythona." +msgstr "https://docs.python.org/pl: Szybki dostęp do dokumentacji Pythona." msgid "" "https://pypi.org: The Python Package Index, previously also nicknamed the " @@ -91,6 +99,10 @@ msgid "" "available for download. Once you begin releasing code, you can register it " "here so that others can find it." msgstr "" +"https://pypi.org: Indeks pakietów Pythona (Python Package Index), wcześniej " +"nazywany także Sklep z Serem (Cheese Shop) [#]_, to indeks utworzonych przez " +"użytkowników modułów Pythona, które można pobrać. Gdy zaczniesz udostępniać " +"kod, możesz go tutaj zarejestrować, aby inni mogli go znaleźć." msgid "" "https://code.activestate.com/recipes/langs/python/: The Python Cookbook is a " @@ -98,11 +110,18 @@ msgid "" "Particularly notable contributions are collected in a book also titled " "Python Cookbook (O'Reilly & Associates, ISBN 0-596-00797-3.)" msgstr "" +"https://code.activestate.com/recipes/langs/python/: The Python Cookbook to " +"pokaźny zbiór przykładów kodu, większych modułów i przydatnych skryptów po " +"angielsku. Szczególnie godne uwagi fragmenty zostały zebrane i " +"przetłumaczone w książce zatytułowanej „Python. Receptury” (Wydawnicto " +"Helion/O'Reilly, ISBN: 978-83-246-8180-8)." msgid "" "https://pyvideo.org collects links to Python-related videos from conferences " "and user-group meetings." msgstr "" +"https://pyvideo.org zbiera linki do filmów związanych z Pythonem z " +"konferencji oraz spotkań grup użytkowników." msgid "" "https://scipy.org: The Scientific Python project includes modules for fast " @@ -124,6 +143,14 @@ msgid "" "new features, and announcing new modules. Mailing list archives are " "available at https://mail.python.org/pipermail/." msgstr "" +"Pytania związane z Pythonem i raporty o problemach można przesyłać na grupę " +"dyskusyjną :newsgroup:`comp.lang.python` lub na listę mailingową python-" +"list@python.org. Grupa dyskusyjna i lista mailingowa są połączone, więc " +"wiadomości wysłane na jedną z nich będą automatycznie przekazywane na " +"drugą. Codziennie pojawiają się tam setki postów z pytaniami (i " +"odpowiedziami), sugestiami nowych funkcji i zapowiedziami nowych modułów. " +"Archiwa list mailingowych są dostępne pod adresem https://mail.python.org/" +"pipermail/." msgid "" "Before posting, be sure to check the list of :ref:`Frequently Asked " @@ -131,6 +158,9 @@ msgid "" "questions that come up again and again, and may already contain the solution " "for your problem." msgstr "" +"Przed wysłaniem zapytania, warto sprawdzić listę :ref:`Często zadawanych " +"pytań ` (zwaną również FAQ). FAQ odpowiada na wiele często " +"pojawiających się pytań i może już zawierać rozwiązanie twojego problemu." msgid "Footnotes" msgstr "Przypisy" @@ -139,3 +169,6 @@ msgid "" "\"Cheese Shop\" is a Monty Python's sketch: a customer enters a cheese shop, " "but whatever cheese he asks for, the clerk says it's missing." msgstr "" +"\"Sklep z Serami\" (Cheese Shop) to skecz Monty Pythona: klient wchodzi do " +"sklepu z serami, ale bez względu na to, o jaki ser prosi, sprzedawca mówi, " +"że go nie ma." diff --git a/update_switcher_chart.py b/update_switcher_chart.py deleted file mode 100644 index d4cb1d70cd..0000000000 --- a/update_switcher_chart.py +++ /dev/null @@ -1,32 +0,0 @@ -from datetime import datetime -from re import search - -from git import Repo, GitCommandError -from matplotlib import pyplot -from matplotlib.ticker import PercentFormatter - -repo = Repo('.') -progress, dates = [], [] -for commit in repo.iter_commits(): - try: - readme_content = repo.git.show('{}:{}'.format(commit.hexsha, 'README.md')) - except GitCommandError: - continue - found = search(r'!\[(\d\d.\d\d)% przełącznika języków]', readme_content) - if not found: - found = search(r'!\[(\d+.\d\d)% language switchera]', readme_content) - if not found: - found = search(r'!\[(\d+.\d\d)% do language switchera]', readme_content) - if not found: - print(readme_content) - continue - number = float(found.group(1)) - progress.append(number) - dates.append(datetime.fromtimestamp(commit.committed_date)) - -pyplot.plot_date(dates, progress) -pyplot.ylim(ymin=0) -pyplot.grid() -pyplot.gcf().autofmt_xdate() -pyplot.gca().yaxis.set_major_formatter(PercentFormatter()) -pyplot.savefig("language-switcher-progress.svg") diff --git a/using/index.po b/using/index.po index a419bc0400..88fd5489b8 100644 --- a/using/index.po +++ b/using/index.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/using/mac.po b/using/mac.po index 521567173c..130c333166 100644 --- a/using/mac.po +++ b/using/mac.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:51+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,50 +35,53 @@ msgstr "" msgid "" "Python on a Mac running macOS is in principle very similar to Python on any " "other Unix platform, but there are a number of additional features such as " -"the IDE and the Package Manager that are worth pointing out." +"the integrated development environment (IDE) and the Package Manager that " +"are worth pointing out." msgstr "" -msgid "Getting and Installing MacPython" +msgid "Getting and Installing Python" msgstr "" msgid "" "macOS used to come with Python 2.7 pre-installed between versions 10.8 and " "`12.3 `_. You are invited to install the most " -"recent version of Python 3 from the Python website (https://www.python." -"org). A current \"universal binary\" build of Python, which runs natively " -"on the Mac's new Intel and legacy PPC CPU's, is available there." +"recent version of Python 3 from the `Python website `__. A current \"universal2 binary\" build of Python, which " +"runs natively on the Mac's new Apple Silicon and legacy Intel processors, is " +"available there." msgstr "" msgid "What you get after installing is a number of things:" msgstr "" msgid "" -"A :file:`Python 3.12` folder in your :file:`Applications` folder. In here " -"you find IDLE, the development environment that is a standard part of " -"official Python distributions; and PythonLauncher, which handles double-" -"clicking Python scripts from the Finder." +"A |python_version_literal| folder in your :file:`Applications` folder. In " +"here you find IDLE, the development environment that is a standard part of " +"official Python distributions; and :program:`Python Launcher`, which handles " +"double-clicking Python scripts from the Finder." msgstr "" msgid "" "A framework :file:`/Library/Frameworks/Python.framework`, which includes the " "Python executable and libraries. The installer adds this location to your " -"shell path. To uninstall MacPython, you can simply remove these three " -"things. A symlink to the Python executable is placed in /usr/local/bin/." +"shell path. To uninstall Python, you can remove these three things. A " +"symlink to the Python executable is placed in :file:`/usr/local/bin/`." msgstr "" msgid "" -"The Apple-provided build of Python is installed in :file:`/System/Library/" -"Frameworks/Python.framework` and :file:`/usr/bin/python`, respectively. You " -"should never modify or delete these, as they are Apple-controlled and are " -"used by Apple- or third-party software. Remember that if you choose to " -"install a newer Python version from python.org, you will have two different " -"but functional Python installations on your computer, so it will be " -"important that your paths and usages are consistent with what you want to do." +"On macOS 10.8-12.3, the Apple-provided build of Python is installed in :file:" +"`/System/Library/Frameworks/Python.framework` and :file:`/usr/bin/python`, " +"respectively. You should never modify or delete these, as they are Apple-" +"controlled and are used by Apple- or third-party software. Remember that if " +"you choose to install a newer Python version from python.org, you will have " +"two different but functional Python installations on your computer, so it " +"will be important that your paths and usages are consistent with what you " +"want to do." msgstr "" msgid "" -"IDLE includes a help menu that allows you to access Python documentation. If " +"IDLE includes a Help menu that allows you to access Python documentation. If " "you are completely new to Python you should start reading the tutorial " "introduction in that document." msgstr "" @@ -93,20 +96,19 @@ msgstr "" msgid "" "Your best way to get started with Python on macOS is through the IDLE " -"integrated development environment, see section :ref:`ide` and use the Help " +"integrated development environment; see section :ref:`ide` and use the Help " "menu when the IDE is running." msgstr "" msgid "" "If you want to run Python scripts from the Terminal window command line or " "from the Finder you first need an editor to create your script. macOS comes " -"with a number of standard Unix command line editors, :program:`vim` and :" -"program:`emacs` among them. If you want a more Mac-like editor, :program:" -"`BBEdit` or :program:`TextWrangler` from Bare Bones Software (see http://www." -"barebones.com/products/bbedit/index.html) are good choices, as is :program:" -"`TextMate` (see https://macromates.com/). Other editors include :program:" -"`Gvim` (https://macvim.org/macvim/) and :program:`Aquamacs` (http://aquamacs." -"org/)." +"with a number of standard Unix command line editors, :program:`vim` :program:" +"`nano` among them. If you want a more Mac-like editor, :program:`BBEdit` " +"from Bare Bones Software (see https://www.barebones.com/products/bbedit/" +"index.html) are good choices, as is :program:`TextMate` (see https://" +"macromates.com). Other editors include :program:`MacVim` (https://macvim." +"org) and :program:`Aquamacs` (https://aquamacs.org)." msgstr "" msgid "" @@ -117,14 +119,14 @@ msgstr "" msgid "To run your script from the Finder you have two options:" msgstr "" -msgid "Drag it to :program:`PythonLauncher`" +msgid "Drag it to :program:`Python Launcher`." msgstr "" msgid "" -"Select :program:`PythonLauncher` as the default application to open your " -"script (or any .py script) through the finder Info window and double-click " -"it. :program:`PythonLauncher` has various preferences to control how your " -"script is launched. Option-dragging allows you to change these for one " +"Select :program:`Python Launcher` as the default application to open your " +"script (or any ``.py`` script) through the finder Info window and double-" +"click it. :program:`Python Launcher` has various preferences to control how " +"your script is launched. Option-dragging allows you to change these for one " "invocation, or use its Preferences menu to change things globally." msgstr "" @@ -143,47 +145,38 @@ msgid "" msgstr "" msgid "Configuration" -msgstr "" +msgstr "Konfiguracja" msgid "" "Python on macOS honors all standard Unix environment variables such as :" "envvar:`PYTHONPATH`, but setting these variables for programs started from " "the Finder is non-standard as the Finder does not read your :file:`.profile` " "or :file:`.cshrc` at startup. You need to create a file :file:`~/.MacOSX/" -"environment.plist`. See Apple's Technical Document QA1067 for details." +"environment.plist`. See Apple's `Technical Q&A QA1067 `__ for details." msgstr "" msgid "" -"For more information on installation Python packages in MacPython, see " -"section :ref:`mac-package-manager`." +"For more information on installation Python packages, see section :ref:`mac-" +"package-manager`." msgstr "" msgid "The IDE" msgstr "" msgid "" -"MacPython ships with the standard IDLE development environment. A good " -"introduction to using IDLE can be found at http://www.hashcollision.org/hkn/" +"Python ships with the standard IDLE development environment. A good " +"introduction to using IDLE can be found at https://www.hashcollision.org/hkn/" "python/idle_intro/index.html." msgstr "" msgid "Installing Additional Python Packages" msgstr "" -msgid "There are several methods to install additional Python packages:" -msgstr "" - -msgid "" -"Packages can be installed via the standard Python distutils mode (``python " -"setup.py install``)." -msgstr "" - -msgid "" -"Many packages can also be installed via the :program:`setuptools` extension " -"or :program:`pip` wrapper, see https://pip.pypa.io/." +msgid "This section has moved to the `Python Packaging User Guide`_." msgstr "" -msgid "GUI Programming on the Mac" +msgid "GUI Programming" msgstr "" msgid "" @@ -204,33 +197,65 @@ msgid "" "installed from https://www.activestate.com; it can also be built from source." msgstr "" +msgid "A number of alternative macOS GUI toolkits are available:" +msgstr "" + msgid "" -"*wxPython* is another popular cross-platform GUI toolkit that runs natively " -"on macOS. Packages and documentation are available from https://www.wxpython." -"org." +"`PySide `__: Official Python bindings to " +"the `Qt GUI toolkit `__." msgstr "" msgid "" -"*PyQt* is another popular cross-platform GUI toolkit that runs natively on " -"macOS. More information can be found at https://riverbankcomputing.com/" -"software/pyqt/intro." +"`PyQt `__: Alternative " +"Python bindings to Qt." msgstr "" -msgid "Distributing Python Applications on the Mac" +msgid "" +"`Kivy `__: A cross-platform GUI toolkit that supports " +"desktop and mobile platforms." +msgstr "" + +msgid "" +"`Toga `__: Part of the `BeeWare Project " +"`__; supports desktop, mobile, web and console apps." +msgstr "" + +msgid "" +"`wxPython `__: A cross-platform toolkit that " +"supports desktop operating systems." +msgstr "" + +msgid "Distributing Python Applications" +msgstr "" + +msgid "" +"A range of tools exist for converting your Python code into a standalone " +"distributable application:" +msgstr "" + +msgid "" +"`py2app `__: Supports creating macOS ``." +"app`` bundles from a Python project." +msgstr "" + +msgid "" +"`Briefcase `__: Part of the `BeeWare " +"Project `__; a cross-platform packaging tool that " +"supports creation of ``.app`` bundles on macOS, as well as managing signing " +"and notarization." msgstr "" msgid "" -"The standard tool for deploying standalone Python applications on the Mac " -"is :program:`py2app`. More information on installing and using py2app can be " -"found at https://pypi.org/project/py2app/." +"`PyInstaller `__: A cross-platform packaging tool " +"that creates a single file or folder as a distributable artifact." msgstr "" msgid "Other Resources" msgstr "" msgid "" -"The MacPython mailing list is an excellent support resource for Python users " -"and developers on the Mac:" +"The Pythonmac-SIG mailing list is an excellent support resource for Python " +"users and developers on the Mac:" msgstr "" msgid "https://www.python.org/community/sigs/current/pythonmac-sig/" diff --git a/using/unix.po b/using/unix.po index 2ca2300101..8ac075fc2f 100644 --- a/using/unix.po +++ b/using/unix.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-28 01:51+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,13 +24,13 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Using Python on Unix platforms" -msgstr "" +msgstr "Python na platformach Unix" msgid "Getting and installing the latest version of Python" -msgstr "" +msgstr "Pobieranie i instalacja najnowszej wersji Pythona" msgid "On Linux" -msgstr "" +msgstr "Na Linux" msgid "" "Python comes preinstalled on most Linux distributions, and is available as a " @@ -46,36 +46,38 @@ msgid "" msgstr "" msgid "https://www.debian.org/doc/manuals/maint-guide/first.en.html" -msgstr "" +msgstr "https://www.debian.org/doc/manuals/maint-guide/first.en.html" msgid "for Debian users" -msgstr "" +msgstr "dla użytkowników Debian" msgid "https://en.opensuse.org/Portal:Packaging" -msgstr "" +msgstr "https://en.opensuse.org/Portal:Packaging" msgid "for OpenSuse users" -msgstr "" +msgstr "dla użytkowników OpenSuse" msgid "" -"https://docs-old.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/" -"RPM_Guide/ch-creating-rpms.html" +"https://docs.fedoraproject.org/en-US/package-maintainers/" +"Packaging_Tutorial_GNU_Hello/" msgstr "" +"https://docs.fedoraproject.org/en-US/package-maintainers/" +"Packaging_Tutorial_GNU_Hello/" msgid "for Fedora users" -msgstr "" +msgstr "dla użytkowników Fedora" -msgid "http://www.slackbook.org/html/package-management-making-packages.html" -msgstr "" +msgid "https://slackbook.org/html/package-management-making-packages.html" +msgstr "https://slackbook.org/html/package-management-making-packages.html" msgid "for Slackware users" -msgstr "" +msgstr "dla użytkowników Slackware" msgid "On FreeBSD and OpenBSD" -msgstr "" +msgstr "Na FreeBSD i OpenBSD" msgid "FreeBSD users, to add the package use::" -msgstr "" +msgstr "Użytkownicy FreeBSD, aby dodać pakiet używają::" msgid "OpenBSD users, to add the package use::" msgstr "" @@ -139,7 +141,7 @@ msgid "Meaning" msgstr "Znaczenie" msgid ":file:`{exec_prefix}/bin/python3`" -msgstr "" +msgstr ":file:`{exec_prefix}/bin/python3`" msgid "Recommended location of the interpreter." msgstr "" diff --git a/using/windows.po b/using/windows.po index 80cb23b924..247dfd2c77 100644 --- a/using/windows.po +++ b/using/windows.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2022 -# Stefan Ocetkiewicz , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:51+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,12 +34,12 @@ msgstr "" msgid "" "Unlike most Unix systems and services, Windows does not include a system " "supported installation of Python. To make Python available, the CPython team " -"has compiled Windows installers (MSI packages) with every `release `_ for many years. These installers are " -"primarily intended to add a per-user installation of Python, with the core " -"interpreter and library being used by a single user. The installer is also " -"able to install for all users of a single machine, and a separate ZIP file " -"is available for application-local distributions." +"has compiled Windows installers with every `release `_ for many years. These installers are primarily intended to add " +"a per-user installation of Python, with the core interpreter and library " +"being used by a single user. The installer is also able to install for all " +"users of a single machine, and a separate ZIP file is available for " +"application-local distributions." msgstr "" msgid "" @@ -764,13 +762,13 @@ msgid "" msgstr "" msgid "`ActivePython `_" -msgstr "" +msgstr "`ActivePython `_" msgid "Installer with multi-platform compatibility, documentation, PyWin32" msgstr "" msgid "`Anaconda `_" -msgstr "" +msgstr "`Anaconda `_" msgid "" "Popular scientific modules (such as numpy, scipy and pandas) and the " @@ -1127,16 +1125,16 @@ msgid "" msgstr "" msgid "``/usr/bin/env``" -msgstr "" +msgstr "``/usr/bin/env``" msgid "``/usr/bin/python``" -msgstr "" +msgstr "``/usr/bin/python``" msgid "``/usr/local/bin/python``" -msgstr "" +msgstr "``/usr/local/bin/python``" msgid "``python``" -msgstr "" +msgstr "``python``" msgid "For example, if the first line of your script starts with" msgstr "" @@ -1165,8 +1163,8 @@ msgstr "" msgid "" "The \"-64\" suffix is deprecated, and now implies \"any architecture that is " -"not provably i386/32-bit\". To request a specific environment, use the new " -"``-V:`` argument with the complete tag." +"not provably i386/32-bit\". To request a specific environment, use the new :" +"samp:`-V:{TAG}` argument with the complete tag." msgstr "" msgid "" @@ -1284,7 +1282,7 @@ msgid "" msgstr "" msgid "Examples:" -msgstr "" +msgstr "Przykłady:" msgid "" "If no relevant options are set, the commands ``python`` and ``python2`` will " @@ -1584,20 +1582,20 @@ msgid "" msgstr "" msgid "" -"Adds ``._pth`` file support and removes ``applocal`` option from ``pyvenv." +"Add ``._pth`` file support and removes ``applocal`` option from ``pyvenv." "cfg``." msgstr "" msgid "" -"Adds ``pythonXX.zip`` as a potential landmark when directly adjacent to the " -"executable." +"Add :file:`python{XX}.zip` as a potential landmark when directly adjacent to " +"the executable." msgstr "" msgid "" "Modules specified in the registry under ``Modules`` (not ``PythonPath``) may " "be imported by :class:`importlib.machinery.WindowsRegistryFinder`. This " "finder is enabled on Windows in 3.6.0 and earlier, but may need to be " -"explicitly added to :attr:`sys.meta_path` in the future." +"explicitly added to :data:`sys.meta_path` in the future." msgstr "" msgid "Additional modules" @@ -1665,8 +1663,7 @@ msgid "cx_Freeze" msgstr "" msgid "" -"`cx_Freeze `_ is a :mod:" -"`distutils` extension (see :ref:`extending-distutils`) which wraps Python " +"`cx_Freeze `_ wraps Python " "scripts into executable Windows programs (:file:`{*}.exe` files). When you " "have done this, you can distribute your application without requiring your " "users to install Python." diff --git a/whatsnew/2.0.po b/whatsnew/2.0.po index 261bfe8f39..264b1e2a48 100644 --- a/whatsnew/2.0.po +++ b/whatsnew/2.0.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Maciej Olko , 2022 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:51+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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 +41,10 @@ msgid "" "useful changes, and points out a few incompatible changes that may require " "rewriting code." msgstr "" +"Nowa wersja Pythona, wersja 2.0, została wydana 16 października 2000 r. W " +"tym artykule omówiono ekscytujące nowe funkcje wersji 2.0, zwrócono uwagę na " +"kilka innych przydatnych zmian i wskazano kilka niekompatybilnych zmian, " +"które mogą wymagać przepisania kodu od nowa." msgid "" "Python's development never completely stops between releases, and a steady " @@ -67,6 +70,14 @@ msgid "" "received a few fixes to ensure that it's forward-compatible with Python " "2.0. 1.6 is therefore part of Python's evolution, and not a side branch." msgstr "" +"Python 1.6 można traktować jako wydanie Pythona zobowiązań umownych. Po tym, " +"jak główny zespół programistów opuścił CNRI w maju 2000 roku, CNRI poprosiło " +"o stworzenie wydania 1.6, zawierającego wszystkie prace nad Pythonem, które " +"zostały wykonane w CNRI. Python 1.6 reprezentuje zatem stan drzewa CVS w " +"maju 2000 roku, a najważniejszą nową funkcją jest obsługa Unicode. Rozwój " +"kontynuowano oczywiście po maju, więc drzewo 1.6 otrzymało kilka poprawek, " +"aby zapewnić jego zgodność z Pythonem 2.0. 1.6 jest zatem częścią ewolucji " +"Pythona, a nie poboczną gałęzią." msgid "" "So, should you take much interest in Python 1.6? Probably not. The " @@ -171,7 +182,7 @@ msgid "" "style, and format. PEPs are kept in the Python CVS tree on SourceForge, " "though they're not part of the Python 2.0 distribution, and are also " "available in HTML form from https://peps.python.org/. As of September 2000, " -"there are 25 PEPS, ranging from :pep:`201`, \"Lockstep Iteration\", to PEP " +"there are 25 PEPs, ranging from :pep:`201`, \"Lockstep Iteration\", to PEP " "225, \"Elementwise/Objectwise Operators\"." msgstr "" @@ -196,11 +207,11 @@ msgstr "" msgid "" "In Python source code, Unicode strings are written as ``u\"string\"``. " -"Arbitrary Unicode characters can be written using a new escape sequence, " -"``\\uHHHH``, where *HHHH* is a 4-digit hexadecimal number from 0000 to " -"FFFF. The existing ``\\xHHHH`` escape sequence can also be used, and octal " -"escapes can be used for characters up to U+01FF, which is represented by " -"``\\777``." +"Arbitrary Unicode characters can be written using a new escape sequence, :" +"samp:`\\\\u{HHHH}`, where *HHHH* is a 4-digit hexadecimal number from 0000 " +"to FFFF. The existing :samp:`\\\\x{HH}` escape sequence can also be used, " +"and octal escapes can be used for characters up to U+01FF, which is " +"represented by ``\\777``." msgstr "" msgid "" @@ -286,15 +297,15 @@ msgstr "" msgid "" "*stream_reader* is a class that supports decoding input from a stream. " -"*stream_reader(file_obj)* returns an object that supports the :meth:`read`, :" -"meth:`readline`, and :meth:`readlines` methods. These methods will all " -"translate from the given encoding and return Unicode strings." +"*stream_reader(file_obj)* returns an object that supports the :meth:`!" +"read`, :meth:`!readline`, and :meth:`!readlines` methods. These methods " +"will all translate from the given encoding and return Unicode strings." msgstr "" msgid "" "*stream_writer*, similarly, is a class that supports encoding output to a " "stream. *stream_writer(file_obj)* returns an object that supports the :meth:" -"`write` and :meth:`writelines` methods. These methods expect Unicode " +"`!write` and :meth:`!writelines` methods. These methods expect Unicode " "strings, translating them to the given encoding on output." msgstr "" @@ -403,13 +414,13 @@ msgid "" "The full list of supported assignment operators is ``+=``, ``-=``, ``*=``, " "``/=``, ``%=``, ``**=``, ``&=``, ``|=``, ``^=``, ``>>=``, and ``<<=``. " "Python classes can override the augmented assignment operators by defining " -"methods named :meth:`__iadd__`, :meth:`__isub__`, etc. For example, the " -"following :class:`Number` class stores a number and supports using += to " +"methods named :meth:`!__iadd__`, :meth:`!__isub__`, etc. For example, the " +"following :class:`!Number` class stores a number and supports using += to " "create a new instance with an incremented value." msgstr "" msgid "" -"The :meth:`__iadd__` special method is called with the value of the " +"The :meth:`!__iadd__` special method is called with the value of the " "increment, and should return a new instance with an appropriately modified " "value; this return value is bound as the new value of the variable on the " "left-hand side." @@ -427,12 +438,12 @@ msgstr "Metody ciągów" msgid "" "Until now string-manipulation functionality was in the :mod:`string` module, " -"which was usually a front-end for the :mod:`strop` module written in C. The " -"addition of Unicode posed a difficulty for the :mod:`strop` module, because " -"the functions would all need to be rewritten in order to accept either 8-bit " -"or Unicode strings. For functions such as :func:`string.replace`, which " -"takes 3 string arguments, that means eight possible permutations, and " -"correspondingly complicated code." +"which was usually a front-end for the :mod:`!strop` module written in C. " +"The addition of Unicode posed a difficulty for the :mod:`!strop` module, " +"because the functions would all need to be rewritten in order to accept " +"either 8-bit or Unicode strings. For functions such as :func:`!string." +"replace`, which takes 3 string arguments, that means eight possible " +"permutations, and correspondingly complicated code." msgstr "" msgid "" @@ -455,17 +466,17 @@ msgstr "" msgid "" "Two methods which have no parallel in pre-2.0 versions, although they did " -"exist in JPython for quite some time, are :meth:`startswith` and :meth:" -"`endswith`. ``s.startswith(t)`` is equivalent to ``s[:len(t)] == t``, while " +"exist in JPython for quite some time, are :meth:`!startswith` and :meth:`!" +"endswith`. ``s.startswith(t)`` is equivalent to ``s[:len(t)] == t``, while " "``s.endswith(t)`` is equivalent to ``s[-len(t):] == t``." msgstr "" msgid "" -"One other method which deserves special mention is :meth:`join`. The :meth:" -"`join` method of a string receives one parameter, a sequence of strings, and " -"is equivalent to the :func:`string.join` function from the old :mod:`string` " -"module, with the arguments reversed. In other words, ``s.join(seq)`` is " -"equivalent to the old ``string.join(seq, s)``." +"One other method which deserves special mention is :meth:`!join`. The :meth:" +"`!join` method of a string receives one parameter, a sequence of strings, " +"and is equivalent to the :func:`!string.join` function from the old :mod:" +"`string` module, with the arguments reversed. In other words, ``s." +"join(seq)`` is equivalent to the old ``string.join(seq, s)``." msgstr "" msgid "Garbage Collection of Cycles" @@ -557,9 +568,9 @@ msgstr "Drobne zmiany językowe" msgid "" "A new syntax makes it more convenient to call a given function with a tuple " "of arguments and/or a dictionary of keyword arguments. In Python 1.5 and " -"earlier, you'd use the :func:`apply` built-in function: ``apply(f, args, " -"kw)`` calls the function :func:`f` with the argument tuple *args* and the " -"keyword arguments in the dictionary *kw*. :func:`apply` is the same in " +"earlier, you'd use the :func:`!apply` built-in function: ``apply(f, args, " +"kw)`` calls the function :func:`!f` with the argument tuple *args* and the " +"keyword arguments in the dictionary *kw*. :func:`!apply` is the same in " "2.0, but thanks to a patch from Greg Ewing, ``f(*args, **kw)`` is a shorter " "and clearer way to achieve the same effect. This syntax is symmetrical with " "the syntax for defining functions::" @@ -569,7 +580,7 @@ msgid "" "The ``print`` statement can now have its output directed to a file-like " "object by following the ``print`` with ``>> file``, similar to the " "redirection operator in Unix shells. Previously you'd either have to use " -"the :meth:`write` method of the file-like object, which lacks the " +"the :meth:`!write` method of the file-like object, which lacks the " "convenience and simplicity of ``print``, or you could assign a new value to " "``sys.stdout`` and then restore the old value. For sending output to " "standard error, it's much easier to write this::" @@ -595,7 +606,7 @@ msgid "" "seq`` returns true if *obj* is present in the sequence *seq*; Python " "computes this by simply trying every index of the sequence until either " "*obj* is found or an :exc:`IndexError` is encountered. Moshe Zadka " -"contributed a patch which adds a :meth:`__contains__` magic method for " +"contributed a patch which adds a :meth:`!__contains__` magic method for " "providing a custom implementation for :keyword:`!in`. Additionally, new " "built-in objects written in C can define what :keyword:`!in` means for them " "via a new slot in the sequence protocol." @@ -617,7 +628,7 @@ msgid "" "to this implementation, and some useful relevant links. Note that " "comparisons can now also raise exceptions. In earlier versions of Python, a " "comparison operation such as ``cmp(a,b)`` would always produce an answer, " -"even if a user-defined :meth:`__cmp__` method encountered an error, since " +"even if a user-defined :meth:`!__cmp__` method encountered an error, since " "the resulting exception would simply be silently swallowed." msgstr "" @@ -667,7 +678,7 @@ msgid "" msgstr "" msgid "" -"The :func:`int` and :func:`long` functions now accept an optional \"base\" " +"The :func:`int` and :func:`!long` functions now accept an optional \"base\" " "parameter when the first argument is a string. ``int('123', 10)`` returns " "123, while ``int('123', 16)`` returns 291. ``int(123, 16)`` raises a :exc:" "`TypeError` exception with the message \"can't convert non-string with " @@ -684,9 +695,9 @@ msgstr "" msgid "" "Dictionaries have an odd new method, ``setdefault(key, default)``, which " -"behaves similarly to the existing :meth:`get` method. However, if the key " -"is missing, :meth:`setdefault` both returns the value of *default* as :meth:" -"`get` would do, and also inserts it into the dictionary as the value for " +"behaves similarly to the existing :meth:`!get` method. However, if the key " +"is missing, :meth:`!setdefault` both returns the value of *default* as :meth:" +"`!get` would do, and also inserts it into the dictionary as the value for " "*key*. Thus, the following lines of code::" msgstr "" @@ -720,7 +731,7 @@ msgid "" "The change which will probably break the most code is tightening up the " "arguments accepted by some methods. Some methods would take multiple " "arguments and treat them as a tuple, particularly various list methods such " -"as :meth:`append` and :meth:`insert`. In earlier versions of Python, if " +"as :meth:`!append` and :meth:`!insert`. In earlier versions of Python, if " "``L`` is a list, ``L.append( 1,2 )`` appends the tuple ``(1,2)`` to the " "list. In Python 2.0 this causes a :exc:`TypeError` exception to be raised, " "with the message: 'append requires exactly 1 argument; 2 given'. The fix is " @@ -731,7 +742,7 @@ msgstr "" msgid "" "The earlier versions of these methods were more forgiving because they used " "an old function in Python's C interface to parse their arguments; 2.0 " -"modernizes them to use :func:`PyArg_ParseTuple`, the current argument " +"modernizes them to use :c:func:`PyArg_ParseTuple`, the current argument " "parsing function, which provides more helpful error messages and treats " "multi-argument calls as errors. If you absolutely must use 2.0 but can't " "fix your code, you can edit :file:`Objects/listobject.c` and define the " @@ -741,16 +752,17 @@ msgstr "" msgid "" "Some of the functions in the :mod:`socket` module are still forgiving in " -"this way. For example, :func:`socket.connect( ('hostname', 25) )` is the " -"correct form, passing a tuple representing an IP address, but :func:`socket." -"connect( 'hostname', 25 )` also works. :func:`socket.connect_ex` and :func:" -"`socket.bind` are similarly easy-going. 2.0alpha1 tightened these functions " -"up, but because the documentation actually used the erroneous multiple " -"argument form, many people wrote code which would break with the stricter " -"checking. GvR backed out the changes in the face of public reaction, so for " -"the :mod:`socket` module, the documentation was fixed and the multiple " -"argument form is simply marked as deprecated; it *will* be tightened up " -"again in a future Python version." +"this way. For example, ``socket.connect( ('hostname', 25) )`` is the " +"correct form, passing a tuple representing an IP address, but ``socket." +"connect('hostname', 25)`` also works. :meth:`socket.connect_ex ` and :meth:`socket.bind ` are " +"similarly easy-going. 2.0alpha1 tightened these functions up, but because " +"the documentation actually used the erroneous multiple argument form, many " +"people wrote code which would break with the stricter checking. GvR backed " +"out the changes in the face of public reaction, so for the :mod:`socket` " +"module, the documentation was fixed and the multiple argument form is simply " +"marked as deprecated; it *will* be tightened up again in a future Python " +"version." msgstr "" msgid "" @@ -771,7 +783,7 @@ msgstr "" msgid "" "Some work has been done to make integers and long integers a bit more " "interchangeable. In 1.5.2, large-file support was added for Solaris, to " -"allow reading files larger than 2 GiB; this made the :meth:`tell` method of " +"allow reading files larger than 2 GiB; this made the :meth:`!tell` method of " "file objects return a long integer instead of a regular integer. Some code " "would subtract two file offsets and attempt to use the result to multiply a " "sequence or slice a string, but this raised a :exc:`TypeError`. In 2.0, " @@ -779,8 +791,8 @@ msgid "" "as you'd intuitively expect it to; ``3L * 'abc'`` produces 'abcabcabc', and " "``(0,1,2,3)[2L:4L]`` produces (2,3). Long integers can also be used in " "various contexts where previously only integers were accepted, such as in " -"the :meth:`seek` method of file objects, and in the formats supported by the " -"``%`` operator (``%d``, ``%i``, ``%x``, etc.). For example, ``\"%d\" % " +"the :meth:`!seek` method of file objects, and in the formats supported by " +"the ``%`` operator (``%d``, ``%i``, ``%x``, etc.). For example, ``\"%d\" % " "2L**64`` will produce the string ``18446744073709551616``." msgstr "" @@ -796,8 +808,8 @@ msgstr "" msgid "" "Taking the :func:`repr` of a float now uses a different formatting precision " -"than :func:`str`. :func:`repr` uses ``%.17g`` format string for C's :func:" -"`sprintf`, while :func:`str` uses ``%.12g`` as before. The effect is that :" +"than :func:`str`. :func:`repr` uses ``%.17g`` format string for C's :func:`!" +"sprintf`, while :func:`str` uses ``%.12g`` as before. The effect is that :" "func:`repr` may occasionally show more decimal places than :func:`str`, for " "certain numbers. For example, the number 8.1 can't be represented exactly " "in binary, so ``repr(8.1)`` is ``'8.0999999999999996'``, while str(8.1) is " @@ -807,9 +819,9 @@ msgstr "" msgid "" "The ``-X`` command-line option, which turned all standard exceptions into " "strings instead of classes, has been removed; the standard exceptions will " -"now always be classes. The :mod:`exceptions` module containing the standard " -"exceptions was translated from Python to a built-in C module, written by " -"Barry Warsaw and Fredrik Lundh." +"now always be classes. The :mod:`!exceptions` module containing the " +"standard exceptions was translated from Python to a built-in C module, " +"written by Barry Warsaw and Fredrik Lundh." msgstr "" msgid "Extending/Embedding Changes" @@ -851,7 +863,7 @@ msgstr "" msgid "" "Vladimir Marangozov's long-awaited malloc restructuring was completed, to " "make it easy to have the Python interpreter use a custom allocator instead " -"of C's standard :func:`malloc`. For documentation, read the comments in :" +"of C's standard :c:func:`malloc`. For documentation, read the comments in :" "file:`Include/pymem.h` and :file:`Include/objimpl.h`. For the lengthy " "discussions during which the interface was hammered out, see the web " "archives of the 'patches' and 'python-dev' lists at python.org." @@ -889,8 +901,8 @@ msgstr "" msgid "" "Three new convenience functions intended for adding constants to a module's " -"dictionary at module initialization time were added: :func:" -"`PyModule_AddObject`, :func:`PyModule_AddIntConstant`, and :func:" +"dictionary at module initialization time were added: :c:func:" +"`PyModule_AddObject`, :c:func:`PyModule_AddIntConstant`, and :c:func:" "`PyModule_AddStringConstant`. Each of these functions takes a module " "object, a null-terminated C string containing the name to be added, and a " "third argument for the value to be assigned to the name. This third " @@ -898,8 +910,9 @@ msgid "" msgstr "" msgid "" -"A wrapper API was added for Unix-style signal handlers. :func:`PyOS_getsig` " -"gets a signal handler and :func:`PyOS_setsig` will set a new handler." +"A wrapper API was added for Unix-style signal handlers. :c:func:" +"`PyOS_getsig` gets a signal handler and :c:func:`PyOS_setsig` will set a new " +"handler." msgstr "" msgid "Distutils: Making Modules Easy to Install" @@ -967,11 +980,11 @@ msgid "XML Modules" msgstr "Moduły XML" msgid "" -"Python 1.5.2 included a simple XML parser in the form of the :mod:`xmllib` " +"Python 1.5.2 included a simple XML parser in the form of the :mod:`!xmllib` " "module, contributed by Sjoerd Mullender. Since 1.5.2's release, two " "different interfaces for processing XML have become common: SAX2 (version 2 " "of the Simple API for XML) provides an event-driven interface with some " -"similarities to :mod:`xmllib`, and the DOM (Document Object Model) provides " +"similarities to :mod:`!xmllib`, and the DOM (Document Object Model) provides " "a tree-based interface, transforming an XML document into a tree of nodes " "that can be traversed and modified. Python 2.0 includes a SAX2 interface " "and a stripped-down DOM interface as part of the :mod:`xml` package. Here we " @@ -987,10 +1000,11 @@ msgid "" "SAX defines an event-driven interface for parsing XML. To use SAX, you must " "write a SAX handler class. Handler classes inherit from various classes " "provided by SAX, and override various methods that will then be called by " -"the XML parser. For example, the :meth:`startElement` and :meth:" -"`endElement` methods are called for every starting and end tag encountered " -"by the parser, the :meth:`characters` method is called for every chunk of " -"character data, and so forth." +"the XML parser. For example, the :meth:`~xml.sax.handler.ContentHandler." +"startElement` and :meth:`~xml.sax.handler.ContentHandler.endElement` methods " +"are called for every starting and end tag encountered by the parser, the :" +"meth:`~xml.sax.handler.ContentHandler.characters` method is called for every " +"chunk of character data, and so forth." msgstr "" msgid "" @@ -1017,13 +1031,13 @@ msgstr "" msgid "" "The Document Object Model is a tree-based representation for an XML " -"document. A top-level :class:`Document` instance is the root of the tree, " -"and has a single child which is the top-level :class:`Element` instance. " -"This :class:`Element` has children nodes representing character data and any " -"sub-elements, which may have further children of their own, and so forth. " -"Using the DOM you can traverse the resulting tree any way you like, access " -"element and attribute values, insert and delete nodes, and convert the tree " -"back into XML." +"document. A top-level :class:`!Document` instance is the root of the tree, " +"and has a single child which is the top-level :class:`!Element` instance. " +"This :class:`!Element` has children nodes representing character data and " +"any sub-elements, which may have further children of their own, and so " +"forth. Using the DOM you can traverse the resulting tree any way you like, " +"access element and attribute values, insert and delete nodes, and convert " +"the tree back into XML." msgstr "" msgid "" @@ -1038,19 +1052,19 @@ msgstr "" msgid "" "The DOM implementation included with Python lives in the :mod:`xml.dom." "minidom` module. It's a lightweight implementation of the Level 1 DOM with " -"support for XML namespaces. The :func:`parse` and :func:`parseString` " +"support for XML namespaces. The :func:`!parse` and :func:`!parseString` " "convenience functions are provided for generating a DOM tree::" msgstr "" msgid "" -"``doc`` is a :class:`Document` instance. :class:`Document`, like all the " -"other DOM classes such as :class:`Element` and :class:`Text`, is a subclass " -"of the :class:`Node` base class. All the nodes in a DOM tree therefore " -"support certain common methods, such as :meth:`toxml` which returns a string " -"containing the XML representation of the node and its children. Each class " -"also has special methods of its own; for example, :class:`Element` and :" -"class:`Document` instances have a method to find all child elements with a " -"given tag name. Continuing from the previous 2-line example::" +"``doc`` is a :class:`!Document` instance. :class:`!Document`, like all the " +"other DOM classes such as :class:`!Element` and :class:`Text`, is a subclass " +"of the :class:`!Node` base class. All the nodes in a DOM tree therefore " +"support certain common methods, such as :meth:`!toxml` which returns a " +"string containing the XML representation of the node and its children. Each " +"class also has special methods of its own; for example, :class:`!Element` " +"and :class:`!Document` instances have a method to find all child elements " +"with a given tag name. Continuing from the previous 2-line example::" msgstr "" msgid "For the *Hamlet* XML file, the above few lines output::" @@ -1064,7 +1078,7 @@ msgstr "" msgid "" "Again, I will refer you to the Python documentation for a complete listing " -"of the different :class:`Node` classes and their various methods." +"of the different :class:`!Node` classes and their various methods." msgstr "" msgid "Relationship to PyXML" @@ -1096,7 +1110,7 @@ msgstr "" msgid "The xmlproc validating parser, written by Lars Marius Garshol." msgstr "" -msgid "The :mod:`sgmlop` parser accelerator module, written by Fredrik Lundh." +msgid "The :mod:`!sgmlop` parser accelerator module, written by Fredrik Lundh." msgstr "" msgid "Module changes" @@ -1105,10 +1119,10 @@ msgstr "Zmiany modułów" msgid "" "Lots of improvements and bugfixes were made to Python's extensive standard " "library; some of the affected modules include :mod:`readline`, :mod:" -"`ConfigParser`, :mod:`cgi`, :mod:`calendar`, :mod:`posix`, :mod:`readline`, :" -"mod:`xmllib`, :mod:`aifc`, :mod:`chunk, wave`, :mod:`random`, :mod:`shelve`, " -"and :mod:`nntplib`. Consult the CVS logs for the exact patch-by-patch " -"details." +"`ConfigParser `, :mod:`cgi`, :mod:`calendar`, :mod:`posix`, :" +"mod:`readline`, :mod:`!xmllib`, :mod:`aifc`, :mod:`chunk`, :mod:`wave`, :mod:" +"`random`, :mod:`shelve`, and :mod:`nntplib`. Consult the CVS logs for the " +"exact patch-by-patch details." msgstr "" msgid "" @@ -1117,20 +1131,24 @@ msgid "" "data being sent over a socket. When compiling Python, you can edit :file:" "`Modules/Setup` to include SSL support, which adds an additional function to " "the :mod:`socket` module: ``socket.ssl(socket, keyfile, certfile)``, which " -"takes a socket object and returns an SSL socket. The :mod:`httplib` and :" -"mod:`urllib` modules were also changed to support ``https://`` URLs, though " -"no one has implemented FTP or SMTP over SSL." +"takes a socket object and returns an SSL socket. The :mod:`httplib ` " +"and :mod:`urllib` modules were also changed to support ``https://`` URLs, " +"though no one has implemented FTP or SMTP over SSL." msgstr "" msgid "" -"The :mod:`httplib` module has been rewritten by Greg Stein to support " -"HTTP/1.1. Backward compatibility with the 1.5 version of :mod:`httplib` is " -"provided, though using HTTP/1.1 features such as pipelining will require " -"rewriting code to use a different set of interfaces." +"The :mod:`httplib ` module has been rewritten by Greg Stein to support " +"HTTP/1.1." msgstr "" msgid "" -"The :mod:`Tkinter` module now supports Tcl/Tk version 8.1, 8.2, or 8.3, and " +"Backward compatibility with the 1.5 version of :mod:`!httplib` is provided, " +"though using HTTP/1.1 features such as pipelining will require rewriting " +"code to use a different set of interfaces." +msgstr "" + +msgid "" +"The :mod:`!Tkinter` module now supports Tcl/Tk version 8.1, 8.2, or 8.3, and " "support for the older 7.x versions has been dropped. The Tkinter module now " "supports displaying Unicode strings in Tk widgets. Also, Fredrik Lundh " "contributed an optimization which makes operations like ``create_line`` and " @@ -1172,13 +1190,13 @@ msgid "" msgstr "" msgid "" -":mod:`codecs`, :mod:`encodings`, :mod:`unicodedata`: Added as part of the " +":mod:`codecs`, :mod:`!encodings`, :mod:`unicodedata`: Added as part of the " "new Unicode support." msgstr "" msgid "" -":mod:`filecmp`: Supersedes the old :mod:`cmp`, :mod:`cmpcache` and :mod:" -"`dircmp` modules, which have now become deprecated. (Contributed by Gordon " +":mod:`filecmp`: Supersedes the old :mod:`!cmp`, :mod:`!cmpcache` and :mod:`!" +"dircmp` modules, which have now become deprecated. (Contributed by Gordon " "MacMillan and Moshe Zadka.)" msgstr "" @@ -1191,9 +1209,9 @@ msgid "" msgstr "" msgid "" -":mod:`linuxaudiodev`: Support for the :file:`/dev/audio` device on Linux, a " -"twin to the existing :mod:`sunaudiodev` module. (Contributed by Peter Bosch, " -"with fixes by Jeremy Hylton.)" +":mod:`!linuxaudiodev`: Support for the :file:`/dev/audio` device on Linux, a " +"twin to the existing :mod:`!sunaudiodev` module. (Contributed by Peter " +"Bosch, with fixes by Jeremy Hylton.)" msgstr "" msgid "" @@ -1206,16 +1224,16 @@ msgid "" msgstr "" msgid "" -":mod:`pyexpat`: An interface to the Expat XML parser. (Contributed by Paul " +":mod:`!pyexpat`: An interface to the Expat XML parser. (Contributed by Paul " "Prescod.)" msgstr "" msgid "" -":mod:`robotparser`: Parse a :file:`robots.txt` file, which is used for " -"writing web spiders that politely avoid certain areas of a web site. The " -"parser accepts the contents of a :file:`robots.txt` file, builds a set of " -"rules from it, and can then answer questions about the fetchability of a " -"given URL. (Contributed by Skip Montanaro.)" +":mod:`robotparser `: Parse a :file:`robots.txt` file, " +"which is used for writing web spiders that politely avoid certain areas of a " +"web site. The parser accepts the contents of a :file:`robots.txt` file, " +"builds a set of rules from it, and can then answer questions about the " +"fetchability of a given URL. (Contributed by Skip Montanaro.)" msgstr "" msgid "" @@ -1224,8 +1242,8 @@ msgid "" msgstr "" msgid "" -":mod:`UserString`: A base class useful for deriving objects that behave like " -"strings." +":mod:`!UserString`: A base class useful for deriving objects that behave " +"like strings." msgstr "" msgid "" @@ -1240,10 +1258,11 @@ msgid "" msgstr "" msgid "" -":mod:`_winreg`: An interface to the Windows registry. :mod:`_winreg` is an " -"adaptation of functions that have been part of PythonWin since 1995, but has " -"now been added to the core distribution, and enhanced to support Unicode. :" -"mod:`_winreg` was written by Bill Tutt and Mark Hammond." +":mod:`_winreg `: An interface to the Windows registry. :mod:`!" +"_winreg` is an adaptation of functions that have been part of PythonWin " +"since 1995, but has now been added to the core distribution, and enhanced " +"to support Unicode. :mod:`!_winreg` was written by Bill Tutt and Mark " +"Hammond." msgstr "" msgid "" @@ -1254,8 +1273,8 @@ msgid "" msgstr "" msgid "" -":mod:`imputil`: A module that provides a simpler way for writing customized " -"import hooks, in comparison to the existing :mod:`ihooks` module. " +":mod:`!imputil`: A module that provides a simpler way for writing customized " +"import hooks, in comparison to the existing :mod:`!ihooks` module. " "(Implemented by Greg Stein, with much discussion on python-dev along the " "way.)" msgstr "" @@ -1313,18 +1332,19 @@ msgstr "Usunięte i przestarzałe moduły" msgid "" "A few modules have been dropped because they're obsolete, or because there " -"are now better ways to do the same thing. The :mod:`stdwin` module is gone; " -"it was for a platform-independent windowing toolkit that's no longer " +"are now better ways to do the same thing. The :mod:`!stdwin` module is " +"gone; it was for a platform-independent windowing toolkit that's no longer " "developed." msgstr "" msgid "" "A number of modules have been moved to the :file:`lib-old` subdirectory: :" -"mod:`cmp`, :mod:`cmpcache`, :mod:`dircmp`, :mod:`dump`, :mod:`find`, :mod:" -"`grep`, :mod:`packmail`, :mod:`poly`, :mod:`util`, :mod:`whatsound`, :mod:" -"`zmod`. If you have code which relies on a module that's been moved to :" -"file:`lib-old`, you can simply add that directory to ``sys.path`` to get " -"them back, but you're encouraged to update any code that uses these modules." +"mod:`!cmp`, :mod:`!cmpcache`, :mod:`!dircmp`, :mod:`!dump`, :mod:`!find`, :" +"mod:`!grep`, :mod:`!packmail`, :mod:`!poly`, :mod:`!util`, :mod:`!" +"whatsound`, :mod:`!zmod`. If you have code which relies on a module that's " +"been moved to :file:`lib-old`, you can simply add that directory to ``sys." +"path`` to get them back, but you're encouraged to update any code that " +"uses these modules." msgstr "" msgid "Acknowledgements" diff --git a/whatsnew/2.1.po b/whatsnew/2.1.po index 0d6eead721..7ade247546 100644 --- a/whatsnew/2.1.po +++ b/whatsnew/2.1.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:51+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: 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,7 +70,7 @@ msgid "" msgstr "" msgid "" -"The function :func:`g` will always raise a :exc:`NameError` exception, " +"The function :func:`!g` will always raise a :exc:`NameError` exception, " "because the binding of the name ``g`` isn't in either its local namespace or " "in the module-level namespace. This isn't much of a problem in practice " "(how often do you recursively define interior functions like this?), but " @@ -125,7 +125,7 @@ msgstr "" msgid "" "Line 4 containing the ``exec`` statement is a syntax error, since ``exec`` " "would define a new local variable named ``x`` whose value should be accessed " -"by :func:`g`." +"by :func:`!g`." msgstr "" msgid "" @@ -188,7 +188,7 @@ msgstr "" msgid "" "In earlier versions, Python's support for implementing comparisons on user-" "defined classes and extension types was quite simple. Classes could " -"implement a :meth:`__cmp__` method that was given two instances of a class, " +"implement a :meth:`!__cmp__` method that was given two instances of a class, " "and could only return 0 if they were equal or +1 or -1 if they weren't; the " "method couldn't raise an exception or return anything other than a Boolean " "value. Users of Numeric Python often found this model too weak and " @@ -214,40 +214,40 @@ msgid "Method name" msgstr "" msgid "``<``" -msgstr "" +msgstr "``<``" -msgid ":meth:`__lt__`" -msgstr "" +msgid ":meth:`~object.__lt__`" +msgstr ":meth:`~object.__lt__`" msgid "``<=``" -msgstr "" +msgstr "``<=``" -msgid ":meth:`__le__`" -msgstr "" +msgid ":meth:`~object.__le__`" +msgstr ":meth:`~object.__le__`" msgid "``>``" -msgstr "" +msgstr "``>``" -msgid ":meth:`__gt__`" -msgstr "" +msgid ":meth:`~object.__gt__`" +msgstr ":meth:`~object.__gt__`" msgid "``>=``" -msgstr "" +msgstr "``>=``" -msgid ":meth:`__ge__`" -msgstr "" +msgid ":meth:`~object.__ge__`" +msgstr ":meth:`~object.__ge__`" msgid "``==``" -msgstr "" +msgstr "``==``" -msgid ":meth:`__eq__`" -msgstr "" +msgid ":meth:`~object.__eq__`" +msgstr ":meth:`~object.__eq__`" msgid "``!=``" -msgstr "" +msgstr "``!=``" -msgid ":meth:`__ne__`" -msgstr "" +msgid ":meth:`~object.__ne__`" +msgstr ":meth:`~object.__ne__`" msgid "" "(The magic methods are named after the corresponding Fortran operators ``.LT." @@ -274,7 +274,7 @@ msgid "" "and now accepts an optional argument specifying which comparison operation " "to use; this is given as one of the strings ``\"<\"``, ``\"<=\"``, " "``\">\"``, ``\">=\"``, ``\"==\"``, or ``\"!=\"``. If called without the " -"optional third argument, :func:`cmp` will only return -1, 0, or +1 as in " +"optional third argument, :func:`!cmp` will only return -1, 0, or +1 as in " "previous versions of Python; otherwise it will call the appropriate method " "and can return any Python object." msgstr "" @@ -319,7 +319,7 @@ msgid "" msgstr "" msgid "" -"For example, in Python 2.1 the :mod:`regex` module is deprecated, so " +"For example, in Python 2.1 the :mod:`!regex` module is deprecated, so " "importing it causes a warning to be printed::" msgstr "" @@ -335,14 +335,14 @@ msgid "" "Filters can be added to disable certain warnings; a regular expression " "pattern can be applied to the message or to the module name in order to " "suppress a warning. For example, you may have a program that uses the :mod:" -"`regex` module and not want to spare the time to convert it to use the :mod:" +"`!regex` module and not want to spare the time to convert it to use the :mod:" "`re` module right now. The warning can be suppressed by calling ::" msgstr "" msgid "" "This adds a filter that will apply only to warnings of the class :class:" "`DeprecationWarning` triggered in the :mod:`__main__` module, and applies a " -"regular expression to only match the message about the :mod:`regex` module " +"regular expression to only match the message about the :mod:`!regex` module " "being deprecated, and will cause such warnings to be ignored. Warnings can " "also be printed only once, printed every time the offending code is " "executed, or turned into exceptions that will cause the program to stop " @@ -442,8 +442,9 @@ msgid "" "This version works for simple things such as integers, but it has a side " "effect; the ``_cache`` dictionary holds a reference to the return values, so " "they'll never be deallocated until the Python process exits and cleans up. " -"This isn't very noticeable for integers, but if :func:`f` returns an object, " -"or a data structure that takes up a lot of memory, this can be a problem." +"This isn't very noticeable for integers, but if :func:`!f` returns an " +"object, or a data structure that takes up a lot of memory, this can be a " +"problem." msgstr "" msgid "" @@ -458,7 +459,7 @@ msgid "" msgstr "" msgid "" -"This makes it possible to write a :func:`memoize` function whose cache " +"This makes it possible to write a :func:`!memoize` function whose cache " "doesn't keep objects alive, by storing weak references in the cache. ::" msgstr "" @@ -468,7 +469,7 @@ msgid "" "deallocated -- but instead of requiring an explicit call to retrieve the " "object, the proxy transparently forwards all operations to the object as " "long as the object still exists. If the object is deallocated, attempting " -"to use a proxy will cause a :exc:`weakref.ReferenceError` exception to be " +"to use a proxy will cause a :exc:`!weakref.ReferenceError` exception to be " "raised. ::" msgstr "" @@ -484,14 +485,14 @@ msgstr "" msgid "" "In Python 2.1, functions can now have arbitrary information attached to " "them. People were often using docstrings to hold information about functions " -"and methods, because the ``__doc__`` attribute was the only way of attaching " -"any information to a function. For example, in the Zope web application " -"server, functions are marked as safe for public access by having a " -"docstring, and in John Aycock's SPARK parsing framework, docstrings hold " -"parts of the BNF grammar to be parsed. This overloading is unfortunate, " -"since docstrings are really intended to hold a function's documentation; for " -"example, it means you can't properly document functions intended for private " -"use in Zope." +"and methods, because the :attr:`~function.__doc__` attribute was the only " +"way of attaching any information to a function. For example, in the Zope " +"web application server, functions are marked as safe for public access by " +"having a docstring, and in John Aycock's SPARK parsing framework, docstrings " +"hold parts of the BNF grammar to be parsed. This overloading is " +"unfortunate, since docstrings are really intended to hold a function's " +"documentation; for example, it means you can't properly document functions " +"intended for private use in Zope." msgstr "" msgid "" @@ -504,7 +505,7 @@ msgid "" "`~object.__dict__`. Unlike the :attr:`~object.__dict__` attribute of class " "instances, in functions you can actually assign a new dictionary to :attr:" "`~object.__dict__`, though the new value is restricted to a regular Python " -"dictionary; you *can't* be tricky and set it to a :class:`UserDict` " +"dictionary; you *can't* be tricky and set it to a :class:`!UserDict` " "instance, or any other random object that behaves like a mapping." msgstr "" @@ -637,11 +638,11 @@ msgid "New and Improved Modules" msgstr "" msgid "" -"Ka-Ping Yee contributed two new modules: :mod:`inspect.py`, a module for " -"getting information about live Python code, and :mod:`pydoc.py`, a module " +"Ka-Ping Yee contributed two new modules: :mod:`!inspect.py`, a module for " +"getting information about live Python code, and :mod:`!pydoc.py`, a module " "for interactively converting docstrings to HTML or text. As a bonus, :file:" -"`Tools/scripts/pydoc`, which is now automatically installed, uses :mod:" -"`pydoc.py` to display documentation given a Python module, package, or class " +"`Tools/scripts/pydoc`, which is now automatically installed, uses :mod:`!" +"pydoc.py` to display documentation given a Python module, package, or class " "name. For example, ``pydoc xml.dom`` displays the following::" msgstr "" @@ -661,12 +662,12 @@ msgid "" msgstr "" msgid "" -"The :mod:`difflib` module contains a class, :class:`SequenceMatcher`, which " -"compares two sequences and computes the changes required to transform one " -"sequence into the other. For example, this module can be used to write a " -"tool similar to the Unix :program:`diff` program, and in fact the sample " -"program :file:`Tools/scripts/ndiff.py` demonstrates how to write such a " -"script." +"The :mod:`difflib` module contains a class, :class:`~difflib." +"SequenceMatcher`, which compares two sequences and computes the changes " +"required to transform one sequence into the other. For example, this module " +"can be used to write a tool similar to the Unix :program:`diff` program, and " +"in fact the sample program :file:`Tools/scripts/ndiff.py` demonstrates how " +"to write such a script." msgstr "" msgid "" @@ -682,7 +683,7 @@ msgid "" "Python 2.1 includes an updated version of the :mod:`xml` package. Some of " "the noteworthy changes include support for Expat 1.2 and later versions, the " "ability for Expat parsers to handle files in any encoding supported by " -"Python, and various bugfixes for SAX, DOM, and the :mod:`minidom` module." +"Python, and various bugfixes for SAX, DOM, and the :mod:`!minidom` module." msgstr "" msgid "" @@ -697,14 +698,15 @@ msgid "" msgstr "" msgid "" -"Various functions in the :mod:`time` module, such as :func:`asctime` and :" -"func:`localtime`, require a floating point argument containing the time in " -"seconds since the epoch. The most common use of these functions is to work " -"with the current time, so the floating point argument has been made " -"optional; when a value isn't provided, the current time will be used. For " -"example, log file entries usually need a string containing the current time; " -"in Python 2.1, ``time.asctime()`` can be used, instead of the lengthier " -"``time.asctime(time.localtime(time.time()))`` that was previously required." +"Various functions in the :mod:`time` module, such as :func:`~time.asctime` " +"and :func:`~time.localtime`, require a floating point argument containing " +"the time in seconds since the epoch. The most common use of these functions " +"is to work with the current time, so the floating point argument has been " +"made optional; when a value isn't provided, the current time will be used. " +"For example, log file entries usually need a string containing the current " +"time; in Python 2.1, ``time.asctime()`` can be used, instead of the " +"lengthier ``time.asctime(time.localtime(time.time()))`` that was previously " +"required." msgstr "" msgid "This change was proposed and implemented by Thomas Wouters." @@ -759,10 +761,10 @@ msgstr "" msgid "" "A specialized object allocator is now optionally available, that should be " -"faster than the system :func:`malloc` and have less memory overhead. The " -"allocator uses C's :func:`malloc` function to get large pools of memory, and " -"then fulfills smaller memory requests from these pools. It can be enabled " -"by providing the :option:`!--with-pymalloc` option to the :program:" +"faster than the system :c:func:`malloc` and have less memory overhead. The " +"allocator uses C's :c:func:`!malloc` function to get large pools of memory, " +"and then fulfills smaller memory requests from these pools. It can be " +"enabled by providing the :option:`!--with-pymalloc` option to the :program:" "`configure` script; see :file:`Objects/obmalloc.c` for the implementation " "details." msgstr "" @@ -771,15 +773,16 @@ msgid "" "Authors of C extension modules should test their code with the object " "allocator enabled, because some incorrect code may break, causing core dumps " "at runtime. There are a bunch of memory allocation functions in Python's C " -"API that have previously been just aliases for the C library's :func:" -"`malloc` and :func:`free`, meaning that if you accidentally called " +"API that have previously been just aliases for the C library's :c:func:" +"`malloc` and :c:func:`free`, meaning that if you accidentally called " "mismatched functions, the error wouldn't be noticeable. When the object " -"allocator is enabled, these functions aren't aliases of :func:`malloc` and :" -"func:`free` any more, and calling the wrong function to free memory will get " -"you a core dump. For example, if memory was allocated using :func:" -"`PyMem_New`, it has to be freed using :func:`PyMem_Del`, not :func:`free`. " -"A few modules included with Python fell afoul of this and had to be fixed; " -"doubtless there are more third-party modules that will have the same problem." +"allocator is enabled, these functions aren't aliases of :c:func:`!malloc` " +"and :c:func:`!free` any more, and calling the wrong function to free memory " +"will get you a core dump. For example, if memory was allocated using :c:" +"macro:`PyMem_New`, it has to be freed using :c:func:`PyMem_Del`, not :c:func:" +"`!free`. A few modules included with Python fell afoul of this and had to " +"be fixed; doubtless there are more third-party modules that will have the " +"same problem." msgstr "" msgid "The object allocator was contributed by Vladimir Marangozov." @@ -790,19 +793,19 @@ msgid "" "complain about its lack of speed, and because it's often been used as a " "naïve benchmark. The :meth:`readline` method of file objects has therefore " "been rewritten to be much faster. The exact amount of the speedup will vary " -"from platform to platform depending on how slow the C library's :func:`getc` " -"was, but is around 66%, and potentially much faster on some particular " +"from platform to platform depending on how slow the C library's :c:func:`!" +"getc` was, but is around 66%, and potentially much faster on some particular " "operating systems. Tim Peters did much of the benchmarking and coding for " "this change, motivated by a discussion in comp.lang.python." msgstr "" msgid "" "A new module and method for file objects was also added, contributed by Jeff " -"Epler. The new method, :meth:`xreadlines`, is similar to the existing :func:" -"`xrange` built-in. :func:`xreadlines` returns an opaque sequence object " +"Epler. The new method, :meth:`!xreadlines`, is similar to the existing :func:" +"`!xrange` built-in. :func:`!xreadlines` returns an opaque sequence object " "that only supports being iterated over, reading a line on every iteration " -"but not reading the entire file into memory as the existing :meth:" -"`readlines` method does. You'd use it like this::" +"but not reading the entire file into memory as the existing :meth:`!" +"readlines` method does. You'd use it like this::" msgstr "" msgid "" @@ -812,7 +815,7 @@ msgid "" msgstr "" msgid "" -"A new method, :meth:`popitem`, was added to dictionaries to enable " +"A new method, :meth:`~dict.popitem`, was added to dictionaries to enable " "destructively iterating through the contents of a dictionary; this can be " "faster for large dictionaries because there's no need to construct a list " "containing all the keys or values. ``D.popitem()`` removes a random ``(key, " @@ -852,7 +855,7 @@ msgid "" msgstr "" msgid "" -"C extensions which import other modules have been changed to use :func:" +"C extensions which import other modules have been changed to use :c:func:" "`PyImport_ImportModule`, which means that they will use any import hooks " "that have been installed. This is also encouraged for third-party " "extensions that need to import some other module from C code." diff --git a/whatsnew/2.2.po b/whatsnew/2.2.po index 12d5fbb14b..15ea598ea8 100644 --- a/whatsnew/2.2.po +++ b/whatsnew/2.2.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-08 19:31+0000\n" -"PO-Revision-Date: 2021-06-28 01:51+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 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" @@ -75,10 +75,10 @@ msgid "" "the most significant flaws was that it's impossible to subclass Python types " "implemented in C. In particular, it's not possible to subclass built-in " "types, so you can't just subclass, say, lists in order to add a single " -"useful method to them. The :mod:`UserList` module provides a class that " +"useful method to them. The :mod:`!UserList` module provides a class that " "supports all of the methods of lists and that can be subclassed further, but " "there's lots of C code that expects a regular Python list and won't accept " -"a :class:`UserList` instance." +"a :class:`~collections.UserList` instance." msgstr "" msgid "" @@ -99,9 +99,9 @@ msgstr "" msgid "" "It's also possible to automatically call methods on accessing or setting an " "instance attribute by using a new mechanism called :dfn:`properties`. Many " -"uses of :meth:`__getattr__` can be rewritten to use properties instead, " -"making the resulting code simpler and faster. As a small side benefit, " -"attributes can now have docstrings, too." +"uses of :meth:`~object.__getattr__` can be rewritten to use properties " +"instead, making the resulting code simpler and faster. As a small side " +"benefit, attributes can now have docstrings, too." msgstr "" msgid "" @@ -161,8 +161,8 @@ msgstr "" msgid "" "This means that :keyword:`class` statements that don't have any base classes " "are always classic classes in Python 2.2. (Actually you can also change " -"this by setting a module-level variable named :attr:`__metaclass__` --- see :" -"pep:`253` for the details --- but it's easier to just subclass :class:" +"this by setting a module-level variable named :attr:`!__metaclass__` --- " +"see :pep:`253` for the details --- but it's easier to just subclass :class:" "`object`.)" msgstr "" @@ -175,15 +175,15 @@ msgstr "" msgid "" "To make the set of types complete, new type objects such as :func:`dict` " -"and :func:`file` have been added. Here's a more interesting example, adding " -"a :meth:`lock` method to file objects::" +"and :func:`!file` have been added. Here's a more interesting example, " +"adding a :meth:`!lock` method to file objects::" msgstr "" msgid "" -"The now-obsolete :mod:`posixfile` module contained a class that emulated all " -"of a file object's methods and also added a :meth:`lock` method, but this " -"class couldn't be passed to internal functions that expected a built-in " -"file, something which is possible with our new :class:`LockableFile`." +"The now-obsolete :mod:`!posixfile` module contained a class that emulated " +"all of a file object's methods and also added a :meth:`!lock` method, but " +"this class couldn't be passed to internal functions that expected a built-in " +"file, something which is possible with our new :class:`!LockableFile`." msgstr "" msgid "Descriptors" @@ -192,11 +192,11 @@ msgstr "" msgid "" "In previous versions of Python, there was no consistent way to discover what " "attributes and methods were supported by an object. There were some informal " -"conventions, such as defining :attr:`__members__` and :attr:`__methods__` " +"conventions, such as defining :attr:`!__members__` and :attr:`!__methods__` " "attributes that were lists of names, but often the author of an extension " "type or a class wouldn't bother to define them. You could fall back on " "inspecting the :attr:`~object.__dict__` of an object, but when class " -"inheritance or an arbitrary :meth:`__getattr__` hook were in use this could " +"inheritance or an arbitrary :meth:`!__getattr__` hook were in use this could " "still be inaccurate." msgstr "" @@ -216,7 +216,7 @@ msgstr "" msgid ":attr:`~definition.__name__` is the attribute's name." msgstr "" -msgid ":attr:`__doc__` is the attribute's docstring." +msgid ":attr:`!__doc__` is the attribute's docstring." msgstr "" msgid "" @@ -237,7 +237,7 @@ msgid "" msgstr "" msgid "" -"For methods, :meth:`descriptor.__get__` returns a temporary object that's " +"For methods, :meth:`!descriptor.__get__` returns a temporary object that's " "callable, and wraps up the instance and the method to be called on it. This " "is also why static methods and class methods are now possible; they have " "descriptors that wrap up just the method, or the method and the class. As a " @@ -248,7 +248,7 @@ msgid "" msgstr "" msgid "" -"The :func:`staticmethod` function takes the function :func:`f`, and returns " +"The :func:`staticmethod` function takes the function :func:`!f`, and returns " "it wrapped up in a descriptor so it can be stored in the class object. You " "might expect there to be special syntax for creating such methods (``def " "static f``, ``defstatic f()``, or something like that) but no such syntax " @@ -265,10 +265,10 @@ msgid "" msgstr "" msgid "" -"Note that a person using the new :func:`eiffelmethod` doesn't have to " +"Note that a person using the new :func:`!eiffelmethod` doesn't have to " "understand anything about descriptors. This is why I think the new features " "don't increase the basic complexity of the language. There will be a few " -"wizards who need to know about it in order to write :func:`eiffelmethod` or " +"wizards who need to know about it in order to write :func:`!eiffelmethod` or " "the ZODB or whatever, but most users will just write code on top of the " "resulting libraries and ignore the implementation details." msgstr "" @@ -285,11 +285,11 @@ msgstr "" msgid "" "The lookup rule for classic classes is simple but not very smart; the base " "classes are searched depth-first, going from left to right. A reference to :" -"meth:`D.save` will search the classes :class:`D`, :class:`B`, and then :" -"class:`A`, where :meth:`save` would be found and returned. :meth:`C.save` " -"would never be found at all. This is bad, because if :class:`C`'s :meth:" -"`save` method is saving some internal state specific to :class:`C`, not " -"calling it will result in that state never getting saved." +"meth:`!D.save` will search the classes :class:`!D`, :class:`!B`, and then :" +"class:`!A`, where :meth:`!save` would be found and returned. :meth:`!C." +"save` would never be found at all. This is bad, because if :class:`!C`'s :" +"meth:`!save` method is saving some internal state specific to :class:`!C`, " +"not calling it will result in that state never getting saved." msgstr "" msgid "" @@ -303,26 +303,27 @@ msgstr "" msgid "" "List all the base classes, following the classic lookup rule and include a " "class multiple times if it's visited repeatedly. In the above example, the " -"list of visited classes is [:class:`D`, :class:`B`, :class:`A`, :class:`C`, :" -"class:`A`]." +"list of visited classes is [:class:`!D`, :class:`!B`, :class:`!A`, :class:`!" +"C`, :class:`!A`]." msgstr "" msgid "" "Scan the list for duplicated classes. If any are found, remove all but one " "occurrence, leaving the *last* one in the list. In the above example, the " -"list becomes [:class:`D`, :class:`B`, :class:`C`, :class:`A`] after dropping " -"duplicates." +"list becomes [:class:`!D`, :class:`!B`, :class:`!C`, :class:`!A`] after " +"dropping duplicates." msgstr "" msgid "" -"Following this rule, referring to :meth:`D.save` will return :meth:`C.save`, " -"which is the behaviour we're after. This lookup rule is the same as the one " -"followed by Common Lisp. A new built-in function, :func:`super`, provides a " -"way to get at a class's superclasses without having to reimplement Python's " -"algorithm. The most commonly used form will be ``super(class, obj)``, which " -"returns a bound superclass object (not the actual class object). This form " -"will be used in methods to call a method in the superclass; for example, :" -"class:`D`'s :meth:`save` method would look like this::" +"Following this rule, referring to :meth:`!D.save` will return :meth:`!C." +"save`, which is the behaviour we're after. This lookup rule is the same as " +"the one followed by Common Lisp. A new built-in function, :func:`super`, " +"provides a way to get at a class's superclasses without having to " +"reimplement Python's algorithm. The most commonly used form will be " +"``super(class, obj)``, which returns a bound superclass object (not the " +"actual class object). This form will be used in methods to call a method in " +"the superclass; for example, :class:`!D`'s :meth:`!save` method would look " +"like this::" msgstr "" msgid "" @@ -336,7 +337,7 @@ msgstr "" msgid "" "A fair number of sophisticated Python classes define hooks for attribute " -"access using :meth:`__getattr__`; most commonly this is done for " +"access using :meth:`~object.__getattr__`; most commonly this is done for " "convenience, to make code more readable by automatically mapping an " "attribute access such as ``obj.parent`` into a method call such as ``obj." "get_parent``. Python 2.2 adds some new ways of controlling attribute access." @@ -352,35 +353,35 @@ msgstr "" msgid "" "New-style classes also support a new method, " "``__getattribute__(attr_name)``. The difference between the two methods is " -"that :meth:`__getattribute__` is *always* called whenever any attribute is " -"accessed, while the old :meth:`__getattr__` is only called if ``foo`` isn't " -"found in the instance's dictionary." +"that :meth:`~object.__getattribute__` is *always* called whenever any " +"attribute is accessed, while the old :meth:`~object.__getattr__` is only " +"called if ``foo`` isn't found in the instance's dictionary." msgstr "" msgid "" "However, Python 2.2's support for :dfn:`properties` will often be a simpler " -"way to trap attribute references. Writing a :meth:`__getattr__` method is " +"way to trap attribute references. Writing a :meth:`!__getattr__` method is " "complicated because to avoid recursion you can't use regular attribute " "accesses inside them, and instead have to mess around with the contents of :" -"attr:`~object.__dict__`. :meth:`__getattr__` methods also end up being " -"called by Python when it checks for other methods such as :meth:`__repr__` " -"or :meth:`__coerce__`, and so have to be written with this in mind. Finally, " -"calling a function on every attribute access results in a sizable " -"performance loss." +"attr:`~object.__dict__`. :meth:`~object.__getattr__` methods also end up " +"being called by Python when it checks for other methods such as :meth:" +"`~object.__repr__` or :meth:`!__coerce__`, and so have to be written with " +"this in mind. Finally, calling a function on every attribute access results " +"in a sizable performance loss." msgstr "" msgid "" ":class:`property` is a new built-in type that packages up three functions " "that get, set, or delete an attribute, and a docstring. For example, if you " -"want to define a :attr:`size` attribute that's computed, but also settable, " +"want to define a :attr:`!size` attribute that's computed, but also settable, " "you could write::" msgstr "" msgid "" -"That is certainly clearer and easier to write than a pair of :meth:" -"`__getattr__`/:meth:`__setattr__` methods that check for the :attr:`size` " +"That is certainly clearer and easier to write than a pair of :meth:`!" +"__getattr__`/:meth:`!__setattr__` methods that check for the :attr:`!size` " "attribute and handle it specially while retrieving all other attributes from " -"the instance's :attr:`~object.__dict__`. Accesses to :attr:`size` are also " +"the instance's :attr:`~object.__dict__`. Accesses to :attr:`!size` are also " "the only ones which have to perform the work of calling a function, so " "references to other attributes run at their usual speed." msgstr "" @@ -446,33 +447,35 @@ msgstr "" msgid "" "In Python versions up to 2.1, the usual way to make ``for item in obj`` work " -"is to define a :meth:`__getitem__` method that looks something like this::" +"is to define a :meth:`~object.__getitem__` method that looks something like " +"this::" msgstr "" msgid "" -":meth:`__getitem__` is more properly used to define an indexing operation on " -"an object so that you can write ``obj[5]`` to retrieve the sixth element. " -"It's a bit misleading when you're using this only to support :keyword:`for` " -"loops. Consider some file-like object that wants to be looped over; the " -"*index* parameter is essentially meaningless, as the class probably assumes " -"that a series of :meth:`__getitem__` calls will be made with *index* " -"incrementing by one each time. In other words, the presence of the :meth:" -"`__getitem__` method doesn't mean that using ``file[5]`` to randomly access " -"the sixth element will work, though it really should." +":meth:`~object.__getitem__` is more properly used to define an indexing " +"operation on an object so that you can write ``obj[5]`` to retrieve the " +"sixth element. It's a bit misleading when you're using this only to " +"support :keyword:`for` loops. Consider some file-like object that wants to " +"be looped over; the *index* parameter is essentially meaningless, as the " +"class probably assumes that a series of :meth:`~object.__getitem__` calls " +"will be made with *index* incrementing by one each time. In other words, " +"the presence of the :meth:`~object.__getitem__` method doesn't mean that " +"using ``file[5]`` to randomly access the sixth element will work, though it " +"really should." msgstr "" msgid "" -"In Python 2.2, iteration can be implemented separately, and :meth:" -"`__getitem__` methods can be limited to classes that really do support " -"random access. The basic idea of iterators is simple. A new built-in " -"function, ``iter(obj)`` or ``iter(C, sentinel)``, is used to get an " -"iterator. ``iter(obj)`` returns an iterator for the object *obj*, while " -"``iter(C, sentinel)`` returns an iterator that will invoke the callable " -"object *C* until it returns *sentinel* to signal that the iterator is done." +"In Python 2.2, iteration can be implemented separately, and :meth:`~object." +"__getitem__` methods can be limited to classes that really do support random " +"access. The basic idea of iterators is simple. A new built-in function, " +"``iter(obj)`` or ``iter(C, sentinel)``, is used to get an iterator. " +"``iter(obj)`` returns an iterator for the object *obj*, while ``iter(C, " +"sentinel)`` returns an iterator that will invoke the callable object *C* " +"until it returns *sentinel* to signal that the iterator is done." msgstr "" msgid "" -"Python classes can define an :meth:`__iter__` method, which should create " +"Python classes can define an :meth:`!__iter__` method, which should create " "and return a new iterator for the object; if the object is its own iterator, " "this method can just return ``self``. In particular, iterators will usually " "be their own iterators. Extension types implemented in C can implement a :c:" @@ -492,7 +495,7 @@ msgid "" "In 2.2, Python's :keyword:`for` statement no longer expects a sequence; it " "expects something for which :func:`iter` will return an iterator. For " "backward compatibility and convenience, an iterator is automatically " -"constructed for sequences that don't implement :meth:`__iter__` or a :c:" +"constructed for sequences that don't implement :meth:`!__iter__` or a :c:" "member:`~PyTypeObject.tp_iter` slot, so ``for i in [1,2,3]`` will still " "work. Wherever the Python interpreter loops over a sequence, it's been " "changed to use the iterator protocol. This means you can do things like " @@ -507,8 +510,8 @@ msgstr "" msgid "" "That's just the default behaviour. If you want to iterate over keys, " -"values, or key/value pairs, you can explicitly call the :meth:`iterkeys`, :" -"meth:`itervalues`, or :meth:`iteritems` methods to get an appropriate " +"values, or key/value pairs, you can explicitly call the :meth:`!iterkeys`, :" +"meth:`!itervalues`, or :meth:`!iteritems` methods to get an appropriate " "iterator. In a minor related change, the :keyword:`in` operator now works on " "dictionaries, so ``key in dict`` is now equivalent to ``dict.has_key(key)``." msgstr "" @@ -582,7 +585,7 @@ msgid "" "explanation of the interaction between :keyword:`!yield` and exceptions.)" msgstr "" -msgid "Here's a sample usage of the :func:`generate_ints` generator::" +msgid "Here's a sample usage of the :func:`!generate_ints` generator::" msgstr "" msgid "" @@ -630,11 +633,12 @@ msgid "" msgstr "" msgid "" -"In Icon the :func:`find` function returns the indexes at which the substring " -"\"or\" is found: 3, 23, 33. In the :keyword:`if` statement, ``i`` is first " -"assigned a value of 3, but 3 is less than 5, so the comparison fails, and " -"Icon retries it with the second value of 23. 23 is greater than 5, so the " -"comparison now succeeds, and the code prints the value 23 to the screen." +"In Icon the :func:`!find` function returns the indexes at which the " +"substring \"or\" is found: 3, 23, 33. In the :keyword:`if` statement, ``i`` " +"is first assigned a value of 3, but 3 is less than 5, so the comparison " +"fails, and Icon retries it with the second value of 23. 23 is greater than " +"5, so the comparison now succeeds, and the code prints the value 23 to the " +"screen." msgstr "" msgid "" @@ -663,7 +667,7 @@ msgid "" "In recent versions, the distinction between regular integers, which are 32-" "bit values on most machines, and long integers, which can be of arbitrary " "size, was becoming an annoyance. For example, on platforms that support " -"files larger than ``2**32`` bytes, the :meth:`tell` method of file objects " +"files larger than ``2**32`` bytes, the :meth:`!tell` method of file objects " "has to return a long integer. However, there were various bits of Python " "that expected plain integers and would raise an error if a long integer was " "provided instead. For example, in Python 1.5, only regular integers could " @@ -759,10 +763,10 @@ msgid "" msgstr "" msgid "" -"Classes can define methods called :meth:`__truediv__` and :meth:" -"`__floordiv__` to overload the two division operators. At the C level, " -"there are also slots in the :c:type:`PyNumberMethods` structure so extension " -"types can define the two operators." +"Classes can define methods called :meth:`~object.__truediv__` and :meth:" +"`~object.__floordiv__` to overload the two division operators. At the C " +"level, there are also slots in the :c:type:`PyNumberMethods` structure so " +"extension types can define the two operators." msgstr "" msgid "" @@ -797,20 +801,20 @@ msgstr "" msgid "" "When built to use UCS-4 (a \"wide Python\"), the interpreter can natively " "handle Unicode characters from U+000000 to U+110000, so the range of legal " -"values for the :func:`unichr` function is expanded accordingly. Using an " +"values for the :func:`!unichr` function is expanded accordingly. Using an " "interpreter compiled to use UCS-2 (a \"narrow Python\"), values greater than " -"65535 will still cause :func:`unichr` to raise a :exc:`ValueError` " +"65535 will still cause :func:`!unichr` to raise a :exc:`ValueError` " "exception. This is all described in :pep:`261`, \"Support for 'wide' Unicode " "characters\"; consult it for further details." msgstr "" msgid "" "Another change is simpler to explain. Since their introduction, Unicode " -"strings have supported an :meth:`encode` method to convert the string to a " +"strings have supported an :meth:`!encode` method to convert the string to a " "selected encoding such as UTF-8 or Latin-1. A symmetric " "``decode([*encoding*])`` method has been added to 8-bit strings (though not " -"to Unicode strings) in 2.2. :meth:`decode` assumes that the string is in the " -"specified encoding and decodes it, returning whatever is returned by the " +"to Unicode strings) in 2.2. :meth:`!decode` assumes that the string is in " +"the specified encoding and decodes it, returning whatever is returned by the " "codec." msgstr "" @@ -821,13 +825,13 @@ msgid "" msgstr "" msgid "" -"To convert a class instance to Unicode, a :meth:`__unicode__` method can be " -"defined by a class, analogous to :meth:`__str__`." +"To convert a class instance to Unicode, a :meth:`!__unicode__` method can be " +"defined by a class, analogous to :meth:`!__str__`." msgstr "" msgid "" -":meth:`encode`, :meth:`decode`, and :meth:`__unicode__` were implemented by " -"Marc-André Lemburg. The changes to support using UCS-4 internally were " +":meth:`!encode`, :meth:`!decode`, and :meth:`!__unicode__` were implemented " +"by Marc-André Lemburg. The changes to support using UCS-4 internally were " "implemented by Fredrik Lundh and Martin von Löwis." msgstr "" @@ -859,7 +863,7 @@ msgid "" msgstr "" msgid "" -"The function :func:`g` will always raise a :exc:`NameError` exception, " +"The function :func:`!g` will always raise a :exc:`NameError` exception, " "because the binding of the name ``g`` isn't in either its local namespace or " "in the module-level namespace. This isn't much of a problem in practice " "(how often do you recursively define interior functions like this?), but " @@ -914,7 +918,7 @@ msgstr "" msgid "" "Line 4 containing the ``exec`` statement is a syntax error, since ``exec`` " "would define a new local variable named ``x`` whose value should be accessed " -"by :func:`g`." +"by :func:`!g`." msgstr "" msgid "" @@ -933,17 +937,18 @@ msgid "New and Improved Modules" msgstr "" msgid "" -"The :mod:`xmlrpclib` module was contributed to the standard library by " -"Fredrik Lundh, providing support for writing XML-RPC clients. XML-RPC is a " -"simple remote procedure call protocol built on top of HTTP and XML. For " -"example, the following snippet retrieves a list of RSS channels from the " -"O'Reilly Network, and then lists the recent headlines for one channel::" +"The :mod:`xmlrpclib ` module was contributed to the standard " +"library by Fredrik Lundh, providing support for writing XML-RPC clients. " +"XML-RPC is a simple remote procedure call protocol built on top of HTTP and " +"XML. For example, the following snippet retrieves a list of RSS channels " +"from the O'Reilly Network, and then lists the recent headlines for one " +"channel::" msgstr "" msgid "" -"The :mod:`SimpleXMLRPCServer` module makes it easy to create straightforward " -"XML-RPC servers. See http://xmlrpc.scripting.com/ for more information " -"about XML-RPC." +"The :mod:`SimpleXMLRPCServer ` module makes it easy to create " +"straightforward XML-RPC servers. See http://xmlrpc.scripting.com/ for more " +"information about XML-RPC." msgstr "" msgid "" @@ -954,10 +959,11 @@ msgstr "" msgid "" "Several functions that originally returned lengthy tuples now return pseudo-" "sequences that still behave like tuples but also have mnemonic attributes " -"such as memberst_mtime or :attr:`tm_year`. The enhanced functions include :" -"func:`stat`, :func:`fstat`, :func:`statvfs`, and :func:`fstatvfs` in the :" -"mod:`os` module, and :func:`localtime`, :func:`gmtime`, and :func:`strptime` " -"in the :mod:`time` module." +"such as :attr:`!memberst_mtime` or :attr:`~time.struct_time.tm_year`. The " +"enhanced functions include :func:`~os.stat`, :func:`~os.fstat`, :func:`~os." +"statvfs`, and :func:`~os.fstatvfs` in the :mod:`os` module, and :func:`~time." +"localtime`, :func:`~time.gmtime`, and :func:`~time.strptime` in the :mod:" +"`time` module." msgstr "" msgid "" @@ -1004,8 +1010,8 @@ msgid "" "engine underlying the :mod:`re` module. For example, the :func:`re.sub` " "and :func:`re.split` functions have been rewritten in C. Another " "contributed patch speeds up certain Unicode character ranges by a factor of " -"two, and a new :meth:`finditer` method that returns an iterator over all " -"the non-overlapping matches in a given string. (SRE is maintained by " +"two, and a new :meth:`~re.finditer` method that returns an iterator over " +"all the non-overlapping matches in a given string. (SRE is maintained by " "Fredrik Lundh. The BIGCHARSET patch was contributed by Martin von Löwis.)" msgstr "" @@ -1024,44 +1030,44 @@ msgid "" msgstr "" msgid "" -"The :mod:`rfc822` module's parsing of email addresses is now compliant with :" -"rfc:`2822`, an update to :rfc:`822`. (The module's name is *not* going to " -"be changed to ``rfc2822``.) A new package, :mod:`email`, has also been " -"added for parsing and generating e-mail messages. (Contributed by Barry " -"Warsaw, and arising out of his work on Mailman.)" +"The :mod:`!rfc822` module's parsing of email addresses is now compliant " +"with :rfc:`2822`, an update to :rfc:`822`. (The module's name is *not* " +"going to be changed to ``rfc2822``.) A new package, :mod:`email`, has also " +"been added for parsing and generating e-mail messages. (Contributed by " +"Barry Warsaw, and arising out of his work on Mailman.)" msgstr "" msgid "" -"The :mod:`difflib` module now contains a new :class:`Differ` class for " +"The :mod:`difflib` module now contains a new :class:`!Differ` class for " "producing human-readable lists of changes (a \"delta\") between two " -"sequences of lines of text. There are also two generator functions, :func:" -"`ndiff` and :func:`restore`, which respectively return a delta from two " +"sequences of lines of text. There are also two generator functions, :func:`!" +"ndiff` and :func:`!restore`, which respectively return a delta from two " "sequences, or one of the original sequences from a delta. (Grunt work " "contributed by David Goodger, from ndiff.py code by Tim Peters who then did " "the generatorization.)" msgstr "" msgid "" -"New constants :const:`ascii_letters`, :const:`ascii_lowercase`, and :const:" -"`ascii_uppercase` were added to the :mod:`string` module. There were " -"several modules in the standard library that used :const:`string.letters` to " -"mean the ranges A-Za-z, but that assumption is incorrect when locales are in " -"use, because :const:`string.letters` varies depending on the set of legal " -"characters defined by the current locale. The buggy modules have all been " -"fixed to use :const:`ascii_letters` instead. (Reported by an unknown person; " -"fixed by Fred L. Drake, Jr.)" +"New constants :const:`!ascii_letters`, :const:`!ascii_lowercase`, and :const:" +"`!ascii_uppercase` were added to the :mod:`string` module. There were " +"several modules in the standard library that used :const:`!string.letters` " +"to mean the ranges A-Za-z, but that assumption is incorrect when locales are " +"in use, because :const:`!string.letters` varies depending on the set of " +"legal characters defined by the current locale. The buggy modules have all " +"been fixed to use :const:`!ascii_letters` instead. (Reported by an unknown " +"person; fixed by Fred L. Drake, Jr.)" msgstr "" msgid "" "The :mod:`mimetypes` module now makes it easier to use alternative MIME-type " -"databases by the addition of a :class:`MimeTypes` class, which takes a list " -"of filenames to be parsed. (Contributed by Fred L. Drake, Jr.)" +"databases by the addition of a :class:`~mimetypes.MimeTypes` class, which " +"takes a list of filenames to be parsed. (Contributed by Fred L. Drake, Jr.)" msgstr "" msgid "" -"A :class:`Timer` class was added to the :mod:`threading` module that allows " -"scheduling an activity to happen at some future time. (Contributed by " -"Itamar Shtull-Trauring.)" +"A :class:`~threading.Timer` class was added to the :mod:`threading` module " +"that allows scheduling an activity to happen at some future time. " +"(Contributed by Itamar Shtull-Trauring.)" msgstr "" msgid "Interpreter Changes and Fixes" @@ -1110,7 +1116,7 @@ msgid "" "To upgrade an extension module to the new API, perform the following steps:" msgstr "" -msgid "Rename :c:func:`Py_TPFLAGS_GC` to :c:func:`PyTPFLAGS_HAVE_GC`." +msgid "Rename :c:macro:`!Py_TPFLAGS_GC` to :c:macro:`Py_TPFLAGS_HAVE_GC`." msgstr "" msgid "" @@ -1120,17 +1126,16 @@ msgstr "" msgid "objects, and :c:func:`PyObject_GC_Del` to deallocate them." msgstr "" -msgid "Rename :c:func:`PyObject_GC_Init` to :c:func:`PyObject_GC_Track` and" -msgstr "" - -msgid ":c:func:`PyObject_GC_Fini` to :c:func:`PyObject_GC_UnTrack`." +msgid "" +"Rename :c:func:`!PyObject_GC_Init` to :c:func:`PyObject_GC_Track` and :c:" +"func:`!PyObject_GC_Fini` to :c:func:`PyObject_GC_UnTrack`." msgstr "" -msgid "Remove :c:func:`PyGC_HEAD_SIZE` from object size calculations." +msgid "Remove :c:macro:`!PyGC_HEAD_SIZE` from object size calculations." msgstr "" msgid "" -"Remove calls to :c:func:`PyObject_AS_GC` and :c:func:`PyObject_FROM_GC`." +"Remove calls to :c:func:`!PyObject_AS_GC` and :c:func:`!PyObject_FROM_GC`." msgstr "" msgid "" @@ -1153,11 +1158,11 @@ msgid "" msgstr "" msgid "" -"Two new flags :const:`METH_NOARGS` and :const:`METH_O` are available in " +"Two new flags :c:macro:`METH_NOARGS` and :c:macro:`METH_O` are available in " "method definition tables to simplify implementation of methods with no " "arguments or a single untyped argument. Calling such methods is more " -"efficient than calling a corresponding method that uses :const:" -"`METH_VARARGS`. Also, the old :const:`METH_OLDARGS` style of writing C " +"efficient than calling a corresponding method that uses :c:macro:" +"`METH_VARARGS`. Also, the old :c:macro:`!METH_OLDARGS` style of writing C " "methods is now officially deprecated." msgstr "" @@ -1165,9 +1170,9 @@ msgid "" "Two new wrapper functions, :c:func:`PyOS_snprintf` and :c:func:" "`PyOS_vsnprintf` were added to provide cross-platform implementations for " "the relatively new :c:func:`snprintf` and :c:func:`vsnprintf` C lib APIs. In " -"contrast to the standard :c:func:`sprintf` and :c:func:`vsprintf` functions, " -"the Python versions check the bounds of the buffer used to protect against " -"buffer overruns. (Contributed by M.-A. Lemburg.)" +"contrast to the standard :c:func:`sprintf` and :c:func:`!vsprintf` " +"functions, the Python versions check the bounds of the buffer used to " +"protect against buffer overruns. (Contributed by M.-A. Lemburg.)" msgstr "" msgid "" @@ -1273,14 +1278,15 @@ msgid "" msgstr "" msgid "" -"Some features of the object returned by the :func:`xrange` function are now " +"Some features of the object returned by the :func:`!xrange` function are now " "deprecated, and trigger warnings when they're accessed; they'll disappear in " -"Python 2.3. :class:`xrange` objects tried to pretend they were full sequence " -"types by supporting slicing, sequence multiplication, and the :keyword:`in` " -"operator, but these features were rarely used and therefore buggy. The :" -"meth:`tolist` method and the :attr:`start`, :attr:`stop`, and :attr:`step` " -"attributes are also being deprecated. At the C level, the fourth argument " -"to the :c:func:`PyRange_New` function, ``repeat``, has also been deprecated." +"Python 2.3. :class:`!xrange` objects tried to pretend they were full " +"sequence types by supporting slicing, sequence multiplication, and the :" +"keyword:`in` operator, but these features were rarely used and therefore " +"buggy. The :meth:`!tolist` method and the :attr:`!start`, :attr:`!stop`, " +"and :attr:`!step` attributes are also being deprecated. At the C level, the " +"fourth argument to the :c:func:`!PyRange_New` function, ``repeat``, has also " +"been deprecated." msgstr "" msgid "" diff --git a/whatsnew/2.5.po b/whatsnew/2.5.po new file mode 100644 index 0000000000..90ab56c4c6 --- /dev/null +++ b/whatsnew/2.5.po @@ -0,0 +1,2375 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "What's New in Python 2.5" +msgstr "" + +msgid "Author" +msgstr "Autor" + +msgid "A.M. Kuchling" +msgstr "" + +msgid "" +"This article explains the new features in Python 2.5. The final release of " +"Python 2.5 is scheduled for August 2006; :pep:`356` describes the planned " +"release schedule. Python 2.5 was released on September 19, 2006." +msgstr "" + +msgid "" +"The changes in Python 2.5 are an interesting mix of language and library " +"improvements. The library enhancements will be more important to Python's " +"user community, I think, because several widely useful packages were added. " +"New modules include ElementTree for XML processing (:mod:`xml.etree`), the " +"SQLite database module (:mod:`sqlite`), and the :mod:`ctypes` module for " +"calling C functions." +msgstr "" + +msgid "" +"The language changes are of middling significance. Some pleasant new " +"features were added, but most of them aren't features that you'll use every " +"day. Conditional expressions were finally added to the language using a " +"novel syntax; see section :ref:`pep-308`. The new ':keyword:`with`' " +"statement will make writing cleanup code easier (section :ref:`pep-343`). " +"Values can now be passed into generators (section :ref:`pep-342`). Imports " +"are now visible as either absolute or relative (section :ref:`pep-328`). " +"Some corner cases of exception handling are handled better (section :ref:" +"`pep-341`). All these improvements are worthwhile, but they're improvements " +"to one specific language feature or another; none of them are broad " +"modifications to Python's semantics." +msgstr "" + +msgid "" +"As well as the language and library additions, other improvements and " +"bugfixes were made throughout the source tree. A search through the SVN " +"change logs finds there were 353 patches applied and 458 bugs fixed between " +"Python 2.4 and 2.5. (Both figures are likely to be underestimates.)" +msgstr "" + +msgid "" +"This article doesn't try to be a complete specification of the new features; " +"instead changes are briefly introduced using helpful examples. For full " +"details, you should always refer to the documentation for Python 2.5 at " +"https://docs.python.org. If you want to understand the complete " +"implementation and design rationale, refer to the PEP for a particular new " +"feature." +msgstr "" + +msgid "" +"Comments, suggestions, and error reports for this document are welcome; " +"please e-mail them to the author or open a bug in the Python bug tracker." +msgstr "" + +msgid "PEP 308: Conditional Expressions" +msgstr "" + +msgid "" +"For a long time, people have been requesting a way to write conditional " +"expressions, which are expressions that return value A or value B depending " +"on whether a Boolean value is true or false. A conditional expression lets " +"you write a single assignment statement that has the same effect as the " +"following::" +msgstr "" + +msgid "" +"There have been endless tedious discussions of syntax on both python-dev and " +"comp.lang.python. A vote was even held that found the majority of voters " +"wanted conditional expressions in some form, but there was no syntax that " +"was preferred by a clear majority. Candidates included C's ``cond ? true_v : " +"false_v``, ``if cond then true_v else false_v``, and 16 other variations." +msgstr "" + +msgid "Guido van Rossum eventually chose a surprising syntax::" +msgstr "" + +msgid "" +"Evaluation is still lazy as in existing Boolean expressions, so the order of " +"evaluation jumps around a bit. The *condition* expression in the middle is " +"evaluated first, and the *true_value* expression is evaluated only if the " +"condition was true. Similarly, the *false_value* expression is only " +"evaluated when the condition is false." +msgstr "" + +msgid "" +"This syntax may seem strange and backwards; why does the condition go in the " +"*middle* of the expression, and not in the front as in C's ``c ? x : y``? " +"The decision was checked by applying the new syntax to the modules in the " +"standard library and seeing how the resulting code read. In many cases " +"where a conditional expression is used, one value seems to be the 'common " +"case' and one value is an 'exceptional case', used only on rarer occasions " +"when the condition isn't met. The conditional syntax makes this pattern a " +"bit more obvious::" +msgstr "" + +msgid "" +"I read the above statement as meaning \"here *contents* is usually assigned " +"a value of ``doc+'\\n'``; sometimes *doc* is empty, in which special case " +"an empty string is returned.\" I doubt I will use conditional expressions " +"very often where there isn't a clear common and uncommon case." +msgstr "" + +msgid "" +"There was some discussion of whether the language should require surrounding " +"conditional expressions with parentheses. The decision was made to *not* " +"require parentheses in the Python language's grammar, but as a matter of " +"style I think you should always use them. Consider these two statements::" +msgstr "" + +msgid "" +"In the first version, I think a reader's eye might group the statement into " +"'level = 1', 'if logging', 'else 0', and think that the condition decides " +"whether the assignment to *level* is performed. The second version reads " +"better, in my opinion, because it makes it clear that the assignment is " +"always performed and the choice is being made between two values." +msgstr "" + +msgid "" +"Another reason for including the brackets: a few odd combinations of list " +"comprehensions and lambdas could look like incorrect conditional " +"expressions. See :pep:`308` for some examples. If you put parentheses " +"around your conditional expressions, you won't run into this case." +msgstr "" + +msgid ":pep:`308` - Conditional Expressions" +msgstr "" + +msgid "" +"PEP written by Guido van Rossum and Raymond D. Hettinger; implemented by " +"Thomas Wouters." +msgstr "" + +msgid "PEP 309: Partial Function Application" +msgstr "" + +msgid "" +"The :mod:`functools` module is intended to contain tools for functional-" +"style programming." +msgstr "" + +msgid "" +"One useful tool in this module is the :func:`partial` function. For programs " +"written in a functional style, you'll sometimes want to construct variants " +"of existing functions that have some of the parameters filled in. Consider " +"a Python function ``f(a, b, c)``; you could create a new function ``g(b, " +"c)`` that was equivalent to ``f(1, b, c)``. This is called \"partial " +"function application\"." +msgstr "" + +msgid "" +":func:`partial` takes the arguments ``(function, arg1, arg2, ... " +"kwarg1=value1, kwarg2=value2)``. The resulting object is callable, so you " +"can just call it to invoke *function* with the filled-in arguments." +msgstr "" + +msgid "Here's a small but realistic example::" +msgstr "" + +msgid "" +"Here's another example, from a program that uses PyGTK. Here a context-" +"sensitive pop-up menu is being constructed dynamically. The callback " +"provided for the menu option is a partially applied version of the :meth:" +"`open_item` method, where the first argument has been provided. ::" +msgstr "" + +msgid "" +"Another function in the :mod:`functools` module is the " +"``update_wrapper(wrapper, wrapped)`` function that helps you write well-" +"behaved decorators. :func:`update_wrapper` copies the name, module, and " +"docstring attribute to a wrapper function so that tracebacks inside the " +"wrapped function are easier to understand. For example, you might write::" +msgstr "" + +msgid "" +":func:`wraps` is a decorator that can be used inside your own decorators to " +"copy the wrapped function's information. An alternate version of the " +"previous example would be::" +msgstr "" + +msgid ":pep:`309` - Partial Function Application" +msgstr "" + +msgid "" +"PEP proposed and written by Peter Harris; implemented by Hye-Shik Chang and " +"Nick Coghlan, with adaptations by Raymond Hettinger." +msgstr "" + +msgid "PEP 314: Metadata for Python Software Packages v1.1" +msgstr "" + +msgid "" +"Some simple dependency support was added to Distutils. The :func:`setup` " +"function now has ``requires``, ``provides``, and ``obsoletes`` keyword " +"parameters. When you build a source distribution using the ``sdist`` " +"command, the dependency information will be recorded in the :file:`PKG-INFO` " +"file." +msgstr "" + +msgid "" +"Another new keyword parameter is ``download_url``, which should be set to a " +"URL for the package's source code. This means it's now possible to look up " +"an entry in the package index, determine the dependencies for a package, and " +"download the required packages. ::" +msgstr "" + +msgid "" +"Another new enhancement to the Python package index at https://pypi.org is " +"storing source and binary archives for a package. The new :command:`upload` " +"Distutils command will upload a package to the repository." +msgstr "" + +msgid "" +"Before a package can be uploaded, you must be able to build a distribution " +"using the :command:`sdist` Distutils command. Once that works, you can run " +"``python setup.py upload`` to add your package to the PyPI archive. " +"Optionally you can GPG-sign the package by supplying the :option:`!--sign` " +"and :option:`!--identity` options." +msgstr "" + +msgid "" +"Package uploading was implemented by Martin von Löwis and Richard Jones." +msgstr "" + +msgid ":pep:`314` - Metadata for Python Software Packages v1.1" +msgstr "" + +msgid "" +"PEP proposed and written by A.M. Kuchling, Richard Jones, and Fred Drake; " +"implemented by Richard Jones and Fred Drake." +msgstr "" + +msgid "PEP 328: Absolute and Relative Imports" +msgstr "" + +msgid "" +"The simpler part of :pep:`328` was implemented in Python 2.4: parentheses " +"could now be used to enclose the names imported from a module using the " +"``from ... import ...`` statement, making it easier to import many different " +"names." +msgstr "" + +msgid "" +"The more complicated part has been implemented in Python 2.5: importing a " +"module can be specified to use absolute or package-relative imports. The " +"plan is to move toward making absolute imports the default in future " +"versions of Python." +msgstr "" + +msgid "Let's say you have a package directory like this::" +msgstr "" + +msgid "" +"This defines a package named :mod:`pkg` containing the :mod:`pkg.main` and :" +"mod:`pkg.string` submodules." +msgstr "" + +msgid "" +"Consider the code in the :file:`main.py` module. What happens if it " +"executes the statement ``import string``? In Python 2.4 and earlier, it " +"will first look in the package's directory to perform a relative import, " +"finds :file:`pkg/string.py`, imports the contents of that file as the :mod:" +"`pkg.string` module, and that module is bound to the name ``string`` in the :" +"mod:`pkg.main` module's namespace." +msgstr "" + +msgid "" +"That's fine if :mod:`pkg.string` was what you wanted. But what if you " +"wanted Python's standard :mod:`string` module? There's no clean way to " +"ignore :mod:`pkg.string` and look for the standard module; generally you had " +"to look at the contents of ``sys.modules``, which is slightly unclean. " +"Holger Krekel's :mod:`py.std` package provides a tidier way to perform " +"imports from the standard library, ``import py; py.std.string.join()``, but " +"that package isn't available on all Python installations." +msgstr "" + +msgid "" +"Reading code which relies on relative imports is also less clear, because a " +"reader may be confused about which module, :mod:`string` or :mod:`pkg." +"string`, is intended to be used. Python users soon learned not to duplicate " +"the names of standard library modules in the names of their packages' " +"submodules, but you can't protect against having your submodule's name being " +"used for a new module added in a future version of Python." +msgstr "" + +msgid "" +"In Python 2.5, you can switch :keyword:`import`'s behaviour to absolute " +"imports using a ``from __future__ import absolute_import`` directive. This " +"absolute-import behaviour will become the default in a future version " +"(probably Python 2.7). Once absolute imports are the default, ``import " +"string`` will always find the standard library's version. It's suggested " +"that users should begin using absolute imports as much as possible, so it's " +"preferable to begin writing ``from pkg import string`` in your code." +msgstr "" + +msgid "" +"Relative imports are still possible by adding a leading period to the " +"module name when using the ``from ... import`` form::" +msgstr "" + +msgid "" +"This imports the :mod:`string` module relative to the current package, so " +"in :mod:`pkg.main` this will import *name1* and *name2* from :mod:`pkg." +"string`. Additional leading periods perform the relative import starting " +"from the parent of the current package. For example, code in the :mod:`A.B." +"C` module can do::" +msgstr "" + +msgid "" +"Leading periods cannot be used with the ``import modname`` form of the " +"import statement, only the ``from ... import`` form." +msgstr "" + +msgid ":pep:`328` - Imports: Multi-Line and Absolute/Relative" +msgstr "" + +msgid "PEP written by Aahz; implemented by Thomas Wouters." +msgstr "" + +msgid "https://pylib.readthedocs.io/" +msgstr "https://pylib.readthedocs.io/" + +msgid "" +"The py library by Holger Krekel, which contains the :mod:`py.std` package." +msgstr "" + +msgid "PEP 338: Executing Modules as Scripts" +msgstr "" + +msgid "" +"The :option:`-m` switch added in Python 2.4 to execute a module as a script " +"gained a few more abilities. Instead of being implemented in C code inside " +"the Python interpreter, the switch now uses an implementation in a new " +"module, :mod:`runpy`." +msgstr "" + +msgid "" +"The :mod:`runpy` module implements a more sophisticated import mechanism so " +"that it's now possible to run modules in a package such as :mod:`pychecker." +"checker`. The module also supports alternative import mechanisms such as " +"the :mod:`zipimport` module. This means you can add a .zip archive's path " +"to ``sys.path`` and then use the :option:`-m` switch to execute code from " +"the archive." +msgstr "" + +msgid ":pep:`338` - Executing modules as scripts" +msgstr "" + +msgid "PEP written and implemented by Nick Coghlan." +msgstr "" + +msgid "PEP 341: Unified try/except/finally" +msgstr "" + +msgid "" +"Until Python 2.5, the :keyword:`try` statement came in two flavours. You " +"could use a :keyword:`finally` block to ensure that code is always executed, " +"or one or more :keyword:`except` blocks to catch specific exceptions. You " +"couldn't combine both :keyword:`!except` blocks and a :keyword:`!finally` " +"block, because generating the right bytecode for the combined version was " +"complicated and it wasn't clear what the semantics of the combined statement " +"should be." +msgstr "" + +msgid "" +"Guido van Rossum spent some time working with Java, which does support the " +"equivalent of combining :keyword:`except` blocks and a :keyword:`finally` " +"block, and this clarified what the statement should mean. In Python 2.5, " +"you can now write::" +msgstr "" + +msgid "" +"The code in *block-1* is executed. If the code raises an exception, the " +"various :keyword:`except` blocks are tested: if the exception is of class :" +"class:`Exception1`, *handler-1* is executed; otherwise if it's of class :" +"class:`Exception2`, *handler-2* is executed, and so forth. If no exception " +"is raised, the *else-block* is executed." +msgstr "" + +msgid "" +"No matter what happened previously, the *final-block* is executed once the " +"code block is complete and any raised exceptions handled. Even if there's an " +"error in an exception handler or the *else-block* and a new exception is " +"raised, the code in the *final-block* is still run." +msgstr "" + +msgid ":pep:`341` - Unifying try-except and try-finally" +msgstr "" + +msgid "PEP written by Georg Brandl; implementation by Thomas Lee." +msgstr "" + +msgid "PEP 342: New Generator Features" +msgstr "" + +msgid "" +"Python 2.5 adds a simple way to pass values *into* a generator. As " +"introduced in Python 2.3, generators only produce output; once a generator's " +"code was invoked to create an iterator, there was no way to pass any new " +"information into the function when its execution is resumed. Sometimes the " +"ability to pass in some information would be useful. Hackish solutions to " +"this include making the generator's code look at a global variable and then " +"changing the global variable's value, or passing in some mutable object that " +"callers then modify." +msgstr "" + +msgid "To refresh your memory of basic generators, here's a simple example::" +msgstr "" + +msgid "" +"When you call ``counter(10)``, the result is an iterator that returns the " +"values from 0 up to 9. On encountering the :keyword:`yield` statement, the " +"iterator returns the provided value and suspends the function's execution, " +"preserving the local variables. Execution resumes on the following call to " +"the iterator's :meth:`next` method, picking up after the :keyword:`!yield` " +"statement." +msgstr "" + +msgid "" +"In Python 2.3, :keyword:`yield` was a statement; it didn't return any " +"value. In 2.5, :keyword:`!yield` is now an expression, returning a value " +"that can be assigned to a variable or otherwise operated on::" +msgstr "" + +msgid "" +"I recommend that you always put parentheses around a :keyword:`yield` " +"expression when you're doing something with the returned value, as in the " +"above example. The parentheses aren't always necessary, but it's easier to " +"always add them instead of having to remember when they're needed." +msgstr "" + +msgid "" +"(:pep:`342` explains the exact rules, which are that a :keyword:`yield`\\ -" +"expression must always be parenthesized except when it occurs at the top-" +"level expression on the right-hand side of an assignment. This means you " +"can write ``val = yield i`` but have to use parentheses when there's an " +"operation, as in ``val = (yield i) + 12``.)" +msgstr "" + +msgid "" +"Values are sent into a generator by calling its ``send(value)`` method. The " +"generator's code is then resumed and the :keyword:`yield` expression returns " +"the specified *value*. If the regular :meth:`next` method is called, the :" +"keyword:`!yield` returns :const:`None`." +msgstr "" + +msgid "" +"Here's the previous example, modified to allow changing the value of the " +"internal counter. ::" +msgstr "" + +msgid "And here's an example of changing the counter::" +msgstr "" + +msgid "" +":keyword:`yield` will usually return :const:`None`, so you should always " +"check for this case. Don't just use its value in expressions unless you're " +"sure that the :meth:`send` method will be the only method used to resume " +"your generator function." +msgstr "" + +msgid "" +"In addition to :meth:`send`, there are two other new methods on generators:" +msgstr "" + +msgid "" +"``throw(type, value=None, traceback=None)`` is used to raise an exception " +"inside the generator; the exception is raised by the :keyword:`yield` " +"expression where the generator's execution is paused." +msgstr "" + +msgid "" +":meth:`close` raises a new :exc:`GeneratorExit` exception inside the " +"generator to terminate the iteration. On receiving this exception, the " +"generator's code must either raise :exc:`GeneratorExit` or :exc:" +"`StopIteration`. Catching the :exc:`GeneratorExit` exception and returning " +"a value is illegal and will trigger a :exc:`RuntimeError`; if the function " +"raises some other exception, that exception is propagated to the caller. :" +"meth:`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`." +msgstr "" + +msgid "" +"The cumulative effect of these changes is to turn generators from one-way " +"producers of information into both producers and consumers." +msgstr "" + +msgid "" +"Generators also become *coroutines*, a more generalized form of subroutines. " +"Subroutines are entered at one point and exited at another point (the top of " +"the function, and a :keyword:`return` statement), but coroutines can be " +"entered, exited, and resumed at many different points (the :keyword:`yield` " +"statements). We'll have to figure out patterns for using coroutines " +"effectively in Python." +msgstr "" + +msgid "" +"The addition of the :meth:`close` method has one side effect that isn't " +"obvious. :meth:`close` is called when a generator is garbage-collected, so " +"this means the generator's code gets one last chance to run before the " +"generator is destroyed. This last chance means that ``try...finally`` " +"statements in generators can now be guaranteed to work; the :keyword:" +"`finally` clause will now always get a chance to run. The syntactic " +"restriction that you couldn't mix :keyword:`yield` statements with a ``try..." +"finally`` suite has therefore been removed. This seems like a minor bit of " +"language trivia, but using generators and ``try...finally`` is actually " +"necessary in order to implement the :keyword:`with` statement described by :" +"pep:`343`. I'll look at this new statement in the following section." +msgstr "" + +msgid "" +"Another even more esoteric effect of this change: previously, the :attr:" +"`gi_frame` attribute of a generator was always a frame object. It's now " +"possible for :attr:`gi_frame` to be ``None`` once the generator has been " +"exhausted." +msgstr "" + +msgid ":pep:`342` - Coroutines via Enhanced Generators" +msgstr "" + +msgid "" +"PEP written by Guido van Rossum and Phillip J. Eby; implemented by Phillip " +"J. Eby. Includes examples of some fancier uses of generators as coroutines." +msgstr "" + +msgid "" +"Earlier versions of these features were proposed in :pep:`288` by Raymond " +"Hettinger and :pep:`325` by Samuele Pedroni." +msgstr "" + +msgid "https://en.wikipedia.org/wiki/Coroutine" +msgstr "https://en.wikipedia.org/wiki/Coroutine" + +msgid "The Wikipedia entry for coroutines." +msgstr "" + +msgid "" +"https://web.archive.org/web/20160321211320/http://www.sidhe.org/~dan/blog/" +"archives/000178.html" +msgstr "" +"https://web.archive.org/web/20160321211320/http://www.sidhe.org/~dan/blog/" +"archives/000178.html" + +msgid "" +"An explanation of coroutines from a Perl point of view, written by Dan " +"Sugalski." +msgstr "" + +msgid "PEP 343: The 'with' statement" +msgstr "" + +msgid "" +"The ':keyword:`with`' statement clarifies code that previously would use " +"``try...finally`` blocks to ensure that clean-up code is executed. In this " +"section, I'll discuss the statement as it will commonly be used. In the " +"next section, I'll examine the implementation details and show how to write " +"objects for use with this statement." +msgstr "" + +msgid "" +"The ':keyword:`with`' statement is a new control-flow structure whose basic " +"structure is::" +msgstr "" + +msgid "" +"The expression is evaluated, and it should result in an object that supports " +"the context management protocol (that is, has :meth:`~object.__enter__` and :" +"meth:`~object.__exit__` methods." +msgstr "" + +msgid "" +"The object's :meth:`~object.__enter__` is called before *with-block* is " +"executed and therefore can run set-up code. It also may return a value that " +"is bound to the name *variable*, if given. (Note carefully that *variable* " +"is *not* assigned the result of *expression*.)" +msgstr "" + +msgid "" +"After execution of the *with-block* is finished, the object's :meth:`~object." +"__exit__` method is called, even if the block raised an exception, and can " +"therefore run clean-up code." +msgstr "" + +msgid "" +"To enable the statement in Python 2.5, you need to add the following " +"directive to your module::" +msgstr "" + +msgid "The statement will always be enabled in Python 2.6." +msgstr "" + +msgid "" +"Some standard Python objects now support the context management protocol and " +"can be used with the ':keyword:`with`' statement. File objects are one " +"example::" +msgstr "" + +msgid "" +"After this statement has executed, the file object in *f* will have been " +"automatically closed, even if the :keyword:`for` loop raised an exception " +"part-way through the block." +msgstr "" + +msgid "" +"In this case, *f* is the same object created by :func:`open`, because :meth:" +"`~object.__enter__` returns *self*." +msgstr "" + +msgid "" +"The :mod:`threading` module's locks and condition variables also support " +"the ':keyword:`with`' statement::" +msgstr "" + +msgid "" +"The lock is acquired before the block is executed and always released once " +"the block is complete." +msgstr "" + +msgid "" +"The new :func:`localcontext` function in the :mod:`decimal` module makes it " +"easy to save and restore the current decimal context, which encapsulates the " +"desired precision and rounding characteristics for computations::" +msgstr "" + +msgid "Writing Context Managers" +msgstr "" + +msgid "" +"Under the hood, the ':keyword:`with`' statement is fairly complicated. Most " +"people will only use ':keyword:`!with`' in company with existing objects and " +"don't need to know these details, so you can skip the rest of this section " +"if you like. Authors of new objects will need to understand the details of " +"the underlying implementation and should keep reading." +msgstr "" + +msgid "A high-level explanation of the context management protocol is:" +msgstr "" + +msgid "" +"The expression is evaluated and should result in an object called a " +"\"context manager\". The context manager must have :meth:`~object." +"__enter__` and :meth:`~object.__exit__` methods." +msgstr "" + +msgid "" +"The context manager's :meth:`~object.__enter__` method is called. The value " +"returned is assigned to *VAR*. If no ``'as VAR'`` clause is present, the " +"value is simply discarded." +msgstr "" + +msgid "The code in *BLOCK* is executed." +msgstr "" + +msgid "" +"If *BLOCK* raises an exception, the ``__exit__(type, value, traceback)`` is " +"called with the exception details, the same values returned by :func:`sys." +"exc_info`. The method's return value controls whether the exception is re-" +"raised: any false value re-raises the exception, and ``True`` will result in " +"suppressing it. You'll only rarely want to suppress the exception, because " +"if you do the author of the code containing the ':keyword:`with`' statement " +"will never realize anything went wrong." +msgstr "" + +msgid "" +"If *BLOCK* didn't raise an exception, the :meth:`~object.__exit__` method " +"is still called, but *type*, *value*, and *traceback* are all ``None``." +msgstr "" + +msgid "" +"Let's think through an example. I won't present detailed code but will only " +"sketch the methods necessary for a database that supports transactions." +msgstr "" + +msgid "" +"(For people unfamiliar with database terminology: a set of changes to the " +"database are grouped into a transaction. Transactions can be either " +"committed, meaning that all the changes are written into the database, or " +"rolled back, meaning that the changes are all discarded and the database is " +"unchanged. See any database textbook for more information.)" +msgstr "" + +msgid "" +"Let's assume there's an object representing a database connection. Our goal " +"will be to let the user write code like this::" +msgstr "" + +msgid "" +"The transaction should be committed if the code in the block runs flawlessly " +"or rolled back if there's an exception. Here's the basic interface for :" +"class:`DatabaseConnection` that I'll assume::" +msgstr "" + +msgid "" +"The :meth:`~object.__enter__` method is pretty easy, having only to start a " +"new transaction. For this application the resulting cursor object would be " +"a useful result, so the method will return it. The user can then add ``as " +"cursor`` to their ':keyword:`with`' statement to bind the cursor to a " +"variable name. ::" +msgstr "" + +msgid "" +"The :meth:`~object.__exit__` method is the most complicated because it's " +"where most of the work has to be done. The method has to check if an " +"exception occurred. If there was no exception, the transaction is " +"committed. The transaction is rolled back if there was an exception." +msgstr "" + +msgid "" +"In the code below, execution will just fall off the end of the function, " +"returning the default value of ``None``. ``None`` is false, so the " +"exception will be re-raised automatically. If you wished, you could be more " +"explicit and add a :keyword:`return` statement at the marked location. ::" +msgstr "" + +msgid "The contextlib module" +msgstr "" + +msgid "" +"The new :mod:`contextlib` module provides some functions and a decorator " +"that are useful for writing objects for use with the ':keyword:`with`' " +"statement." +msgstr "" + +msgid "" +"The decorator is called :func:`contextmanager`, and lets you write a single " +"generator function instead of defining a new class. The generator should " +"yield exactly one value. The code up to the :keyword:`yield` will be " +"executed as the :meth:`~object.__enter__` method, and the value yielded will " +"be the method's return value that will get bound to the variable in the ':" +"keyword:`with`' statement's :keyword:`!as` clause, if any. The code after " +"the :keyword:`yield` will be executed in the :meth:`~object.__exit__` " +"method. Any exception raised in the block will be raised by the :keyword:`!" +"yield` statement." +msgstr "" + +msgid "" +"Our database example from the previous section could be written using this " +"decorator as::" +msgstr "" + +msgid "" +"The :mod:`contextlib` module also has a ``nested(mgr1, mgr2, ...)`` function " +"that combines a number of context managers so you don't need to write nested " +"':keyword:`with`' statements. In this example, the single ':keyword:`!" +"with`' statement both starts a database transaction and acquires a thread " +"lock::" +msgstr "" + +msgid "" +"Finally, the ``closing(object)`` function returns *object* so that it can be " +"bound to a variable, and calls ``object.close`` at the end of the block. ::" +msgstr "" + +msgid ":pep:`343` - The \"with\" statement" +msgstr "" + +msgid "" +"PEP written by Guido van Rossum and Nick Coghlan; implemented by Mike Bland, " +"Guido van Rossum, and Neal Norwitz. The PEP shows the code generated for a " +"':keyword:`with`' statement, which can be helpful in learning how the " +"statement works." +msgstr "" + +msgid "The documentation for the :mod:`contextlib` module." +msgstr "" + +msgid "PEP 352: Exceptions as New-Style Classes" +msgstr "" + +msgid "" +"Exception classes can now be new-style classes, not just classic classes, " +"and the built-in :exc:`Exception` class and all the standard built-in " +"exceptions (:exc:`NameError`, :exc:`ValueError`, etc.) are now new-style " +"classes." +msgstr "" + +msgid "" +"The inheritance hierarchy for exceptions has been rearranged a bit. In 2.5, " +"the inheritance relationships are::" +msgstr "" + +msgid "" +"This rearrangement was done because people often want to catch all " +"exceptions that indicate program errors. :exc:`KeyboardInterrupt` and :exc:" +"`SystemExit` aren't errors, though, and usually represent an explicit action " +"such as the user hitting :kbd:`Control-C` or code calling :func:`sys.exit`. " +"A bare ``except:`` will catch all exceptions, so you commonly need to list :" +"exc:`KeyboardInterrupt` and :exc:`SystemExit` in order to re-raise them. " +"The usual pattern is::" +msgstr "" + +msgid "" +"In Python 2.5, you can now write ``except Exception`` to achieve the same " +"result, catching all the exceptions that usually indicate errors but " +"leaving :exc:`KeyboardInterrupt` and :exc:`SystemExit` alone. As in " +"previous versions, a bare ``except:`` still catches all exceptions." +msgstr "" + +msgid "" +"The goal for Python 3.0 is to require any class raised as an exception to " +"derive from :exc:`BaseException` or some descendant of :exc:`BaseException`, " +"and future releases in the Python 2.x series may begin to enforce this " +"constraint. Therefore, I suggest you begin making all your exception classes " +"derive from :exc:`Exception` now. It's been suggested that the bare " +"``except:`` form should be removed in Python 3.0, but Guido van Rossum " +"hasn't decided whether to do this or not." +msgstr "" + +msgid "" +"Raising of strings as exceptions, as in the statement ``raise \"Error " +"occurred\"``, is deprecated in Python 2.5 and will trigger a warning. The " +"aim is to be able to remove the string-exception feature in a few releases." +msgstr "" + +msgid ":pep:`352` - Required Superclass for Exceptions" +msgstr "" + +msgid "" +"PEP written by Brett Cannon and Guido van Rossum; implemented by Brett " +"Cannon." +msgstr "" + +msgid "PEP 353: Using ssize_t as the index type" +msgstr "" + +msgid "" +"A wide-ranging change to Python's C API, using a new :c:type:`Py_ssize_t` " +"type definition instead of :c:expr:`int`, will permit the interpreter to " +"handle more data on 64-bit platforms. This change doesn't affect Python's " +"capacity on 32-bit platforms." +msgstr "" + +msgid "" +"Various pieces of the Python interpreter used C's :c:expr:`int` type to " +"store sizes or counts; for example, the number of items in a list or tuple " +"were stored in an :c:expr:`int`. The C compilers for most 64-bit platforms " +"still define :c:expr:`int` as a 32-bit type, so that meant that lists could " +"only hold up to ``2**31 - 1`` = 2147483647 items. (There are actually a few " +"different programming models that 64-bit C compilers can use -- see https://" +"unix.org/version2/whatsnew/lp64_wp.html for a discussion -- but the most " +"commonly available model leaves :c:expr:`int` as 32 bits.)" +msgstr "" + +msgid "" +"A limit of 2147483647 items doesn't really matter on a 32-bit platform " +"because you'll run out of memory before hitting the length limit. Each list " +"item requires space for a pointer, which is 4 bytes, plus space for a :c:" +"type:`PyObject` representing the item. 2147483647\\*4 is already more bytes " +"than a 32-bit address space can contain." +msgstr "" + +msgid "" +"It's possible to address that much memory on a 64-bit platform, however. " +"The pointers for a list that size would only require 16 GiB of space, so " +"it's not unreasonable that Python programmers might construct lists that " +"large. Therefore, the Python interpreter had to be changed to use some type " +"other than :c:expr:`int`, and this will be a 64-bit type on 64-bit " +"platforms. The change will cause incompatibilities on 64-bit machines, so " +"it was deemed worth making the transition now, while the number of 64-bit " +"users is still relatively small. (In 5 or 10 years, we may *all* be on 64-" +"bit machines, and the transition would be more painful then.)" +msgstr "" + +msgid "" +"This change most strongly affects authors of C extension modules. Python " +"strings and container types such as lists and tuples now use :c:type:" +"`Py_ssize_t` to store their size. Functions such as :c:func:`PyList_Size` " +"now return :c:type:`Py_ssize_t`. Code in extension modules may therefore " +"need to have some variables changed to :c:type:`Py_ssize_t`." +msgstr "" + +msgid "" +"The :c:func:`PyArg_ParseTuple` and :c:func:`Py_BuildValue` functions have a " +"new conversion code, ``n``, for :c:type:`Py_ssize_t`. :c:func:" +"`PyArg_ParseTuple`'s ``s#`` and ``t#`` still output :c:expr:`int` by " +"default, but you can define the macro :c:macro:`PY_SSIZE_T_CLEAN` before " +"including :file:`Python.h` to make them return :c:type:`Py_ssize_t`." +msgstr "" + +msgid "" +":pep:`353` has a section on conversion guidelines that extension authors " +"should read to learn about supporting 64-bit platforms." +msgstr "" + +msgid ":pep:`353` - Using ssize_t as the index type" +msgstr "" + +msgid "PEP written and implemented by Martin von Löwis." +msgstr "" + +msgid "PEP 357: The '__index__' method" +msgstr "" + +msgid "" +"The NumPy developers had a problem that could only be solved by adding a new " +"special method, :meth:`__index__`. When using slice notation, as in " +"``[start:stop:step]``, the values of the *start*, *stop*, and *step* indexes " +"must all be either integers or long integers. NumPy defines a variety of " +"specialized integer types corresponding to unsigned and signed integers of " +"8, 16, 32, and 64 bits, but there was no way to signal that these types " +"could be used as slice indexes." +msgstr "" + +msgid "" +"Slicing can't just use the existing :meth:`__int__` method because that " +"method is also used to implement coercion to integers. If slicing used :" +"meth:`__int__`, floating-point numbers would also become legal slice indexes " +"and that's clearly an undesirable behaviour." +msgstr "" + +msgid "" +"Instead, a new special method called :meth:`__index__` was added. It takes " +"no arguments and returns an integer giving the slice index to use. For " +"example::" +msgstr "" + +msgid "" +"The return value must be either a Python integer or long integer. The " +"interpreter will check that the type returned is correct, and raises a :exc:" +"`TypeError` if this requirement isn't met." +msgstr "" + +msgid "" +"A corresponding :c:member:`~PyNumberMethods.nb_index` slot was added to the " +"C-level :c:type:`PyNumberMethods` structure to let C extensions implement " +"this protocol. ``PyNumber_Index(obj)`` can be used in extension code to call " +"the :meth:`__index__` function and retrieve its result." +msgstr "" + +msgid ":pep:`357` - Allowing Any Object to be Used for Slicing" +msgstr "" + +msgid "PEP written and implemented by Travis Oliphant." +msgstr "" + +msgid "Other Language Changes" +msgstr "" + +msgid "" +"Here are all of the changes that Python 2.5 makes to the core Python " +"language." +msgstr "" + +msgid "" +"The :class:`dict` type has a new hook for letting subclasses provide a " +"default value when a key isn't contained in the dictionary. When a key isn't " +"found, the dictionary's ``__missing__(key)`` method will be called. This " +"hook is used to implement the new :class:`defaultdict` class in the :mod:" +"`collections` module. The following example defines a dictionary that " +"returns zero for any missing key::" +msgstr "" + +msgid "" +"Both 8-bit and Unicode strings have new ``partition(sep)`` and " +"``rpartition(sep)`` methods that simplify a common use case." +msgstr "" + +msgid "" +"The ``find(S)`` method is often used to get an index which is then used to " +"slice the string and obtain the pieces that are before and after the " +"separator. ``partition(sep)`` condenses this pattern into a single method " +"call that returns a 3-tuple containing the substring before the separator, " +"the separator itself, and the substring after the separator. If the " +"separator isn't found, the first element of the tuple is the entire string " +"and the other two elements are empty. ``rpartition(sep)`` also returns a 3-" +"tuple but starts searching from the end of the string; the ``r`` stands for " +"'reverse'." +msgstr "" + +msgid "Some examples::" +msgstr "Trochę przykładów::" + +msgid "" +"(Implemented by Fredrik Lundh following a suggestion by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The :meth:`startswith` and :meth:`endswith` methods of string types now " +"accept tuples of strings to check for. ::" +msgstr "" + +msgid "(Implemented by Georg Brandl following a suggestion by Tom Lynn.)" +msgstr "" + +msgid "" +"The :func:`min` and :func:`max` built-in functions gained a ``key`` keyword " +"parameter analogous to the ``key`` argument for :meth:`sort`. This " +"parameter supplies a function that takes a single argument and is called for " +"every value in the list; :func:`min`/:func:`max` will return the element " +"with the smallest/largest return value from this function. For example, to " +"find the longest string in a list, you can do::" +msgstr "" + +msgid "(Contributed by Steven Bethard and Raymond Hettinger.)" +msgstr "" + +msgid "" +"Two new built-in functions, :func:`any` and :func:`all`, evaluate whether an " +"iterator contains any true or false values. :func:`any` returns :const:" +"`True` if any value returned by the iterator is true; otherwise it will " +"return :const:`False`. :func:`all` returns :const:`True` only if all of the " +"values returned by the iterator evaluate as true. (Suggested by Guido van " +"Rossum, and implemented by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The result of a class's :meth:`__hash__` method can now be either a long " +"integer or a regular integer. If a long integer is returned, the hash of " +"that value is taken. In earlier versions the hash value was required to be " +"a regular integer, but in 2.5 the :func:`id` built-in was changed to always " +"return non-negative numbers, and users often seem to use ``id(self)`` in :" +"meth:`__hash__` methods (though this is discouraged)." +msgstr "" + +msgid "" +"ASCII is now the default encoding for modules. It's now a syntax error if " +"a module contains string literals with 8-bit characters but doesn't have an " +"encoding declaration. In Python 2.4 this triggered a warning, not a syntax " +"error. See :pep:`263` for how to declare a module's encoding; for example, " +"you might add a line like this near the top of the source file::" +msgstr "" + +msgid "" +"A new warning, :class:`UnicodeWarning`, is triggered when you attempt to " +"compare a Unicode string and an 8-bit string that can't be converted to " +"Unicode using the default ASCII encoding. The result of the comparison is " +"false::" +msgstr "" + +msgid "" +"Previously this would raise a :class:`UnicodeDecodeError` exception, but in " +"2.5 this could result in puzzling problems when accessing a dictionary. If " +"you looked up ``unichr(128)`` and ``chr(128)`` was being used as a key, " +"you'd get a :class:`UnicodeDecodeError` exception. Other changes in 2.5 " +"resulted in this exception being raised instead of suppressed by the code " +"in :file:`dictobject.c` that implements dictionaries." +msgstr "" + +msgid "" +"Raising an exception for such a comparison is strictly correct, but the " +"change might have broken code, so instead :class:`UnicodeWarning` was " +"introduced." +msgstr "" + +msgid "(Implemented by Marc-André Lemburg.)" +msgstr "" + +msgid "" +"One error that Python programmers sometimes make is forgetting to include " +"an :file:`__init__.py` module in a package directory. Debugging this mistake " +"can be confusing, and usually requires running Python with the :option:`-v` " +"switch to log all the paths searched. In Python 2.5, a new :exc:" +"`ImportWarning` warning is triggered when an import would have picked up a " +"directory as a package but no :file:`__init__.py` was found. This warning " +"is silently ignored by default; provide the :option:`-Wd <-W>` option when " +"running the Python executable to display the warning message. (Implemented " +"by Thomas Wouters.)" +msgstr "" + +msgid "" +"The list of base classes in a class definition can now be empty. As an " +"example, this is now legal::" +msgstr "" + +msgid "(Implemented by Brett Cannon.)" +msgstr "" + +msgid "Interactive Interpreter Changes" +msgstr "" + +msgid "" +"In the interactive interpreter, ``quit`` and ``exit`` have long been " +"strings so that new users get a somewhat helpful message when they try to " +"quit::" +msgstr "" + +msgid "" +"In Python 2.5, ``quit`` and ``exit`` are now objects that still produce " +"string representations of themselves, but are also callable. Newbies who try " +"``quit()`` or ``exit()`` will now exit the interpreter as they expect. " +"(Implemented by Georg Brandl.)" +msgstr "" + +msgid "" +"The Python executable now accepts the standard long options :option:`--" +"help` and :option:`--version`; on Windows, it also accepts the :option:`/? " +"<-?>` option for displaying a help message. (Implemented by Georg Brandl.)" +msgstr "" + +msgid "Optimizations" +msgstr "" + +msgid "" +"Several of the optimizations were developed at the NeedForSpeed sprint, an " +"event held in Reykjavik, Iceland, from May 21--28 2006. The sprint focused " +"on speed enhancements to the CPython implementation and was funded by EWT " +"LLC with local support from CCP Games. Those optimizations added at this " +"sprint are specially marked in the following list." +msgstr "" + +msgid "" +"When they were introduced in Python 2.4, the built-in :class:`set` and :" +"class:`frozenset` types were built on top of Python's dictionary type. In " +"2.5 the internal data structure has been customized for implementing sets, " +"and as a result sets will use a third less memory and are somewhat faster. " +"(Implemented by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The speed of some Unicode operations, such as finding substrings, string " +"splitting, and character map encoding and decoding, has been improved. " +"(Substring search and splitting improvements were added by Fredrik Lundh and " +"Andrew Dalke at the NeedForSpeed sprint. Character maps were improved by " +"Walter Dörwald and Martin von Löwis.)" +msgstr "" + +msgid "" +"The ``long(str, base)`` function is now faster on long digit strings because " +"fewer intermediate results are calculated. The peak is for strings of " +"around 800--1000 digits where the function is 6 times faster. (Contributed " +"by Alan McIntyre and committed at the NeedForSpeed sprint.)" +msgstr "" + +msgid "" +"It's now illegal to mix iterating over a file with ``for line in file`` and " +"calling the file object's :meth:`read`/:meth:`readline`/:meth:`readlines` " +"methods. Iteration uses an internal buffer and the :meth:`!read\\*` " +"methods don't use that buffer. Instead they would return the data " +"following the buffer, causing the data to appear out of order. Mixing " +"iteration and these methods will now trigger a :exc:`ValueError` from the :" +"meth:`!read\\*` method. (Implemented by Thomas Wouters.)" +msgstr "" + +msgid "" +"The :mod:`struct` module now compiles structure format strings into an " +"internal representation and caches this representation, yielding a 20% " +"speedup. (Contributed by Bob Ippolito at the NeedForSpeed sprint.)" +msgstr "" + +msgid "" +"The :mod:`re` module got a 1 or 2% speedup by switching to Python's " +"allocator functions instead of the system's :c:func:`malloc` and :c:func:" +"`free`. (Contributed by Jack Diederich at the NeedForSpeed sprint.)" +msgstr "" + +msgid "" +"The code generator's peephole optimizer now performs simple constant folding " +"in expressions. If you write something like ``a = 2+3``, the code generator " +"will do the arithmetic and produce code corresponding to ``a = 5``. " +"(Proposed and implemented by Raymond Hettinger.)" +msgstr "" + +msgid "" +"Function calls are now faster because code objects now keep the most " +"recently finished frame (a \"zombie frame\") in an internal field of the " +"code object, reusing it the next time the code object is invoked. (Original " +"patch by Michael Hudson, modified by Armin Rigo and Richard Jones; committed " +"at the NeedForSpeed sprint.) Frame objects are also slightly smaller, which " +"may improve cache locality and reduce memory usage a bit. (Contributed by " +"Neal Norwitz.)" +msgstr "" + +msgid "" +"Python's built-in exceptions are now new-style classes, a change that speeds " +"up instantiation considerably. Exception handling in Python 2.5 is " +"therefore about 30% faster than in 2.4. (Contributed by Richard Jones, Georg " +"Brandl and Sean Reifschneider at the NeedForSpeed sprint.)" +msgstr "" + +msgid "" +"Importing now caches the paths tried, recording whether they exist or not " +"so that the interpreter makes fewer :c:func:`open` and :c:func:`stat` calls " +"on startup. (Contributed by Martin von Löwis and Georg Brandl.)" +msgstr "" + +msgid "New, Improved, and Removed Modules" +msgstr "" + +msgid "" +"The standard library received many enhancements and bug fixes in Python 2.5. " +"Here's a partial list of the most notable changes, sorted alphabetically by " +"module name. Consult the :file:`Misc/NEWS` file in the source tree for a " +"more complete list of changes, or look through the SVN logs for all the " +"details." +msgstr "" + +msgid "" +"The :mod:`audioop` module now supports the a-LAW encoding, and the code for " +"u-LAW encoding has been improved. (Contributed by Lars Immisch.)" +msgstr "" + +msgid "" +"The :mod:`codecs` module gained support for incremental codecs. The :func:" +"`codec.lookup` function now returns a :class:`CodecInfo` instance instead of " +"a tuple. :class:`CodecInfo` instances behave like a 4-tuple to preserve " +"backward compatibility but also have the attributes :attr:`encode`, :attr:" +"`decode`, :attr:`incrementalencoder`, :attr:`incrementaldecoder`, :attr:" +"`streamwriter`, and :attr:`streamreader`. Incremental codecs can receive " +"input and produce output in multiple chunks; the output is the same as if " +"the entire input was fed to the non-incremental codec. See the :mod:`codecs` " +"module documentation for details. (Designed and implemented by Walter " +"Dörwald.)" +msgstr "" + +msgid "" +"The :mod:`collections` module gained a new type, :class:`defaultdict`, that " +"subclasses the standard :class:`dict` type. The new type mostly behaves " +"like a dictionary but constructs a default value when a key isn't present, " +"automatically adding it to the dictionary for the requested key value." +msgstr "" + +msgid "" +"The first argument to :class:`defaultdict`'s constructor is a factory " +"function that gets called whenever a key is requested but not found. This " +"factory function receives no arguments, so you can use built-in type " +"constructors such as :func:`list` or :func:`int`. For example, you can " +"make an index of words based on their initial letter like this::" +msgstr "" + +msgid "Printing ``index`` results in the following output::" +msgstr "" + +msgid "(Contributed by Guido van Rossum.)" +msgstr "" + +msgid "" +"The :class:`deque` double-ended queue type supplied by the :mod:" +"`collections` module now has a ``remove(value)`` method that removes the " +"first occurrence of *value* in the queue, raising :exc:`ValueError` if the " +"value isn't found. (Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"New module: The :mod:`contextlib` module contains helper functions for use " +"with the new ':keyword:`with`' statement. See section :ref:`contextlibmod` " +"for more about this module." +msgstr "" + +msgid "" +"New module: The :mod:`cProfile` module is a C implementation of the " +"existing :mod:`profile` module that has much lower overhead. The module's " +"interface is the same as :mod:`profile`: you run ``cProfile.run('main()')`` " +"to profile a function, can save profile data to a file, etc. It's not yet " +"known if the Hotshot profiler, which is also written in C but doesn't match " +"the :mod:`profile` module's interface, will continue to be maintained in " +"future versions of Python. (Contributed by Armin Rigo.)" +msgstr "" + +msgid "" +"Also, the :mod:`pstats` module for analyzing the data measured by the " +"profiler now supports directing the output to any file object by supplying a " +"*stream* argument to the :class:`Stats` constructor. (Contributed by Skip " +"Montanaro.)" +msgstr "" + +msgid "" +"The :mod:`csv` module, which parses files in comma-separated value format, " +"received several enhancements and a number of bugfixes. You can now set the " +"maximum size in bytes of a field by calling the ``csv." +"field_size_limit(new_limit)`` function; omitting the *new_limit* argument " +"will return the currently set limit. The :class:`reader` class now has a :" +"attr:`line_num` attribute that counts the number of physical lines read from " +"the source; records can span multiple physical lines, so :attr:`line_num` is " +"not the same as the number of records read." +msgstr "" + +msgid "" +"The CSV parser is now stricter about multi-line quoted fields. Previously, " +"if a line ended within a quoted field without a terminating newline " +"character, a newline would be inserted into the returned field. This " +"behavior caused problems when reading files that contained carriage return " +"characters within fields, so the code was changed to return the field " +"without inserting newlines. As a consequence, if newlines embedded within " +"fields are important, the input should be split into lines in a manner that " +"preserves the newline characters." +msgstr "" + +msgid "(Contributed by Skip Montanaro and Andrew McNamara.)" +msgstr "" + +msgid "" +"The :class:`~datetime.datetime` class in the :mod:`datetime` module now has " +"a ``strptime(string, format)`` method for parsing date strings, contributed " +"by Josh Spoerri. It uses the same format characters as :func:`time.strptime` " +"and :func:`time.strftime`::" +msgstr "" + +msgid "" +"The :meth:`SequenceMatcher.get_matching_blocks` method in the :mod:`difflib` " +"module now guarantees to return a minimal list of blocks describing matching " +"subsequences. Previously, the algorithm would occasionally break a block of " +"matching elements into two list entries. (Enhancement by Tim Peters.)" +msgstr "" + +msgid "" +"The :mod:`doctest` module gained a ``SKIP`` option that keeps an example " +"from being executed at all. This is intended for code snippets that are " +"usage examples intended for the reader and aren't actually test cases." +msgstr "" + +msgid "" +"An *encoding* parameter was added to the :func:`testfile` function and the :" +"class:`DocFileSuite` class to specify the file's encoding. This makes it " +"easier to use non-ASCII characters in tests contained within a docstring. " +"(Contributed by Bjorn Tillenius.)" +msgstr "" + +msgid "" +"The :mod:`email` package has been updated to version 4.0. (Contributed by " +"Barry Warsaw.)" +msgstr "" + +msgid "" +"The :mod:`fileinput` module was made more flexible. Unicode filenames are " +"now supported, and a *mode* parameter that defaults to ``\"r\"`` was added " +"to the :func:`input` function to allow opening files in binary or :term:" +"`universal newlines` mode. Another new parameter, *openhook*, lets you use " +"a function other than :func:`open` to open the input files. Once you're " +"iterating over the set of files, the :class:`FileInput` object's new :meth:" +"`~fileinput.fileno` returns the file descriptor for the currently opened " +"file. (Contributed by Georg Brandl.)" +msgstr "" + +msgid "" +"In the :mod:`gc` module, the new :func:`get_count` function returns a 3-" +"tuple containing the current collection counts for the three GC " +"generations. This is accounting information for the garbage collector; when " +"these counts reach a specified threshold, a garbage collection sweep will be " +"made. The existing :func:`gc.collect` function now takes an optional " +"*generation* argument of 0, 1, or 2 to specify which generation to collect. " +"(Contributed by Barry Warsaw.)" +msgstr "" + +msgid "" +"The :func:`nsmallest` and :func:`nlargest` functions in the :mod:`heapq` " +"module now support a ``key`` keyword parameter similar to the one provided " +"by the :func:`min`/:func:`max` functions and the :meth:`sort` methods. For " +"example::" +msgstr "" + +msgid "(Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The :func:`itertools.islice` function now accepts ``None`` for the start and " +"step arguments. This makes it more compatible with the attributes of slice " +"objects, so that you can now write the following::" +msgstr "" + +msgid "" +"The :func:`format` function in the :mod:`locale` module has been modified " +"and two new functions were added, :func:`format_string` and :func:`currency`." +msgstr "" + +msgid "" +"The :func:`format` function's *val* parameter could previously be a string " +"as long as no more than one %char specifier appeared; now the parameter must " +"be exactly one %char specifier with no surrounding text. An optional " +"*monetary* parameter was also added which, if ``True``, will use the " +"locale's rules for formatting currency in placing a separator between groups " +"of three digits." +msgstr "" + +msgid "" +"To format strings with multiple %char specifiers, use the new :func:" +"`format_string` function that works like :func:`format` but also supports " +"mixing %char specifiers with arbitrary text." +msgstr "" + +msgid "" +"A new :func:`currency` function was also added that formats a number " +"according to the current locale's settings." +msgstr "" + +msgid "(Contributed by Georg Brandl.)" +msgstr "" + +msgid "" +"The :mod:`mailbox` module underwent a massive rewrite to add the capability " +"to modify mailboxes in addition to reading them. A new set of classes that " +"include :class:`mbox`, :class:`MH`, and :class:`Maildir` are used to read " +"mailboxes, and have an ``add(message)`` method to add messages, " +"``remove(key)`` to remove messages, and :meth:`lock`/:meth:`unlock` to lock/" +"unlock the mailbox. The following example converts a maildir-format mailbox " +"into an mbox-format one::" +msgstr "" + +msgid "" +"(Contributed by Gregory K. Johnson. Funding was provided by Google's 2005 " +"Summer of Code.)" +msgstr "" + +msgid "" +"New module: the :mod:`msilib` module allows creating Microsoft Installer :" +"file:`.msi` files and CAB files. Some support for reading the :file:`.msi` " +"database is also included. (Contributed by Martin von Löwis.)" +msgstr "" + +msgid "" +"The :mod:`nis` module now supports accessing domains other than the system " +"default domain by supplying a *domain* argument to the :func:`nis.match` " +"and :func:`nis.maps` functions. (Contributed by Ben Bell.)" +msgstr "" + +msgid "" +"The :mod:`operator` module's :func:`itemgetter` and :func:`attrgetter` " +"functions now support multiple fields. A call such as ``operator." +"attrgetter('a', 'b')`` will return a function that retrieves the :attr:`a` " +"and :attr:`b` attributes. Combining this new feature with the :meth:`sort` " +"method's ``key`` parameter lets you easily sort lists using multiple " +"fields. (Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The :mod:`optparse` module was updated to version 1.5.1 of the Optik " +"library. The :class:`OptionParser` class gained an :attr:`epilog` attribute, " +"a string that will be printed after the help message, and a :meth:`destroy` " +"method to break reference cycles created by the object. (Contributed by Greg " +"Ward.)" +msgstr "" + +msgid "" +"The :mod:`os` module underwent several changes. The :attr:" +"`stat_float_times` variable now defaults to true, meaning that :func:`os." +"stat` will now return time values as floats. (This doesn't necessarily mean " +"that :func:`os.stat` will return times that are precise to fractions of a " +"second; not all systems support such precision.)" +msgstr "" + +msgid "" +"Constants named :const:`os.SEEK_SET`, :const:`os.SEEK_CUR`, and :const:`os." +"SEEK_END` have been added; these are the parameters to the :func:`os.lseek` " +"function. Two new constants for locking are :const:`os.O_SHLOCK` and :const:" +"`os.O_EXLOCK`." +msgstr "" + +msgid "" +"Two new functions, :func:`wait3` and :func:`wait4`, were added. They're " +"similar the :func:`waitpid` function which waits for a child process to exit " +"and returns a tuple of the process ID and its exit status, but :func:`wait3` " +"and :func:`wait4` return additional information. :func:`wait3` doesn't take " +"a process ID as input, so it waits for any child process to exit and returns " +"a 3-tuple of *process-id*, *exit-status*, *resource-usage* as returned from " +"the :func:`resource.getrusage` function. ``wait4(pid)`` does take a process " +"ID. (Contributed by Chad J. Schroeder.)" +msgstr "" + +msgid "" +"On FreeBSD, the :func:`os.stat` function now returns times with nanosecond " +"resolution, and the returned object now has :attr:`st_gen` and :attr:" +"`st_birthtime`. The :attr:`st_flags` attribute is also available, if the " +"platform supports it. (Contributed by Antti Louko and Diego Pettenò.)" +msgstr "" + +msgid "" +"The Python debugger provided by the :mod:`pdb` module can now store lists of " +"commands to execute when a breakpoint is reached and execution stops. Once " +"breakpoint #1 has been created, enter ``commands 1`` and enter a series of " +"commands to be executed, finishing the list with ``end``. The command list " +"can include commands that resume execution, such as ``continue`` or " +"``next``. (Contributed by Grégoire Dooms.)" +msgstr "" + +msgid "" +"The :mod:`pickle` and :mod:`!cPickle` modules no longer accept a return " +"value of ``None`` from the :meth:`~object.__reduce__` method; the method " +"must return a tuple of arguments instead. The ability to return ``None`` " +"was deprecated in Python 2.4, so this completes the removal of the feature." +msgstr "" + +msgid "" +"The :mod:`pkgutil` module, containing various utility functions for finding " +"packages, was enhanced to support :pep:`302`'s import hooks and now also " +"works for packages stored in ZIP-format archives. (Contributed by Phillip J. " +"Eby.)" +msgstr "" + +msgid "" +"The pybench benchmark suite by Marc-André Lemburg is now included in the :" +"file:`Tools/pybench` directory. The pybench suite is an improvement on the " +"commonly used :file:`pystone.py` program because pybench provides a more " +"detailed measurement of the interpreter's speed. It times particular " +"operations such as function calls, tuple slicing, method lookups, and " +"numeric operations, instead of performing many different operations and " +"reducing the result to a single number as :file:`pystone.py` does." +msgstr "" + +msgid "" +"The :mod:`pyexpat` module now uses version 2.0 of the Expat parser. " +"(Contributed by Trent Mick.)" +msgstr "" + +msgid "" +"The :class:`~queue.Queue` class provided by the :mod:`Queue` module gained " +"two new methods. :meth:`join` blocks until all items in the queue have been " +"retrieved and all processing work on the items have been completed. Worker " +"threads call the other new method, :meth:`task_done`, to signal that " +"processing for an item has been completed. (Contributed by Raymond " +"Hettinger.)" +msgstr "" + +msgid "" +"The old :mod:`regex` and :mod:`regsub` modules, which have been deprecated " +"ever since Python 2.0, have finally been deleted. Other deleted modules: :" +"mod:`statcache`, :mod:`tzparse`, :mod:`whrandom`." +msgstr "" + +msgid "" +"Also deleted: the :file:`lib-old` directory, which includes ancient modules " +"such as :mod:`dircmp` and :mod:`ni`, was removed. :file:`lib-old` wasn't on " +"the default ``sys.path``, so unless your programs explicitly added the " +"directory to ``sys.path``, this removal shouldn't affect your code." +msgstr "" + +msgid "" +"The :mod:`rlcompleter` module is no longer dependent on importing the :mod:" +"`readline` module and therefore now works on non-Unix platforms. (Patch from " +"Robert Kiendl.)" +msgstr "" + +msgid "" +"The :mod:`SimpleXMLRPCServer ` and :mod:`DocXMLRPCServer " +"` classes now have a :attr:`rpc_paths` attribute that " +"constrains XML-RPC operations to a limited set of URL paths; the default is " +"to allow only ``'/'`` and ``'/RPC2'``. Setting :attr:`rpc_paths` to " +"``None`` or an empty tuple disables this path checking." +msgstr "" + +msgid "" +"The :mod:`socket` module now supports :const:`AF_NETLINK` sockets on Linux, " +"thanks to a patch from Philippe Biondi. Netlink sockets are a Linux-" +"specific mechanism for communications between a user-space process and " +"kernel code; an introductory article about them is at https://www." +"linuxjournal.com/article/7356. In Python code, netlink addresses are " +"represented as a tuple of 2 integers, ``(pid, group_mask)``." +msgstr "" + +msgid "" +"Two new methods on socket objects, ``recv_into(buffer)`` and " +"``recvfrom_into(buffer)``, store the received data in an object that " +"supports the buffer protocol instead of returning the data as a string. " +"This means you can put the data directly into an array or a memory-mapped " +"file." +msgstr "" + +msgid "" +"Socket objects also gained :meth:`getfamily`, :meth:`gettype`, and :meth:" +"`getproto` accessor methods to retrieve the family, type, and protocol " +"values for the socket." +msgstr "" + +msgid "" +"New module: the :mod:`spwd` module provides functions for accessing the " +"shadow password database on systems that support shadow passwords." +msgstr "" + +msgid "" +"The :mod:`struct` is now faster because it compiles format strings into :" +"class:`Struct` objects with :meth:`pack` and :meth:`unpack` methods. This " +"is similar to how the :mod:`re` module lets you create compiled regular " +"expression objects. You can still use the module-level :func:`pack` and :" +"func:`unpack` functions; they'll create :class:`Struct` objects and cache " +"them. Or you can use :class:`Struct` instances directly::" +msgstr "" + +msgid "" +"You can also pack and unpack data to and from buffer objects directly using " +"the ``pack_into(buffer, offset, v1, v2, ...)`` and ``unpack_from(buffer, " +"offset)`` methods. This lets you store data directly into an array or a " +"memory-mapped file." +msgstr "" + +msgid "" +"(:class:`Struct` objects were implemented by Bob Ippolito at the " +"NeedForSpeed sprint. Support for buffer objects was added by Martin Blais, " +"also at the NeedForSpeed sprint.)" +msgstr "" + +msgid "" +"The Python developers switched from CVS to Subversion during the 2.5 " +"development process. Information about the exact build version is available " +"as the ``sys.subversion`` variable, a 3-tuple of ``(interpreter-name, branch-" +"name, revision-range)``. For example, at the time of writing my copy of 2.5 " +"was reporting ``('CPython', 'trunk', '45313:45315')``." +msgstr "" + +msgid "" +"This information is also available to C extensions via the :c:func:" +"`Py_GetBuildInfo` function that returns a string of build information like " +"this: ``\"trunk:45355:45356M, Apr 13 2006, 07:42:19\"``. (Contributed by " +"Barry Warsaw.)" +msgstr "" + +msgid "" +"Another new function, :func:`sys._current_frames`, returns the current stack " +"frames for all running threads as a dictionary mapping thread identifiers to " +"the topmost stack frame currently active in that thread at the time the " +"function is called. (Contributed by Tim Peters.)" +msgstr "" + +msgid "" +"The :class:`TarFile` class in the :mod:`tarfile` module now has an :meth:" +"`extractall` method that extracts all members from the archive into the " +"current working directory. It's also possible to set a different directory " +"as the extraction target, and to unpack only a subset of the archive's " +"members." +msgstr "" + +msgid "" +"The compression used for a tarfile opened in stream mode can now be " +"autodetected using the mode ``'r|*'``. (Contributed by Lars Gustäbel.)" +msgstr "" + +msgid "" +"The :mod:`threading` module now lets you set the stack size used when new " +"threads are created. The ``stack_size([*size*])`` function returns the " +"currently configured stack size, and supplying the optional *size* parameter " +"sets a new value. Not all platforms support changing the stack size, but " +"Windows, POSIX threading, and OS/2 all do. (Contributed by Andrew MacIntyre.)" +msgstr "" + +msgid "" +"The :mod:`unicodedata` module has been updated to use version 4.1.0 of the " +"Unicode character database. Version 3.2.0 is required by some " +"specifications, so it's still available as :data:`unicodedata.ucd_3_2_0`." +msgstr "" + +msgid "" +"New module: the :mod:`uuid` module generates universally unique " +"identifiers (UUIDs) according to :rfc:`4122`. The RFC defines several " +"different UUID versions that are generated from a starting string, from " +"system properties, or purely randomly. This module contains a :class:`UUID` " +"class and functions named :func:`uuid1`, :func:`uuid3`, :func:`uuid4`, " +"and :func:`uuid5` to generate different versions of UUID. (Version 2 " +"UUIDs are not specified in :rfc:`4122` and are not supported by this " +"module.) ::" +msgstr "" + +msgid "(Contributed by Ka-Ping Yee.)" +msgstr "" + +msgid "" +"The :mod:`weakref` module's :class:`WeakKeyDictionary` and :class:" +"`WeakValueDictionary` types gained new methods for iterating over the weak " +"references contained in the dictionary. :meth:`iterkeyrefs` and :meth:" +"`keyrefs` methods were added to :class:`WeakKeyDictionary`, and :meth:" +"`itervaluerefs` and :meth:`valuerefs` were added to :class:" +"`WeakValueDictionary`. (Contributed by Fred L. Drake, Jr.)" +msgstr "" + +msgid "" +"The :mod:`webbrowser` module received a number of enhancements. It's now " +"usable as a script with ``python -m webbrowser``, taking a URL as the " +"argument; there are a number of switches to control the behaviour (:option:" +"`!-n` for a new browser window, :option:`!-t` for a new tab). New module-" +"level functions, :func:`open_new` and :func:`open_new_tab`, were added to " +"support this. The module's :func:`open` function supports an additional " +"feature, an *autoraise* parameter that signals whether to raise the open " +"window when possible. A number of additional browsers were added to the " +"supported list such as Firefox, Opera, Konqueror, and elinks. (Contributed " +"by Oleg Broytmann and Georg Brandl.)" +msgstr "" + +msgid "" +"The :mod:`xmlrpclib ` module now supports returning :class:" +"`~datetime.datetime` objects for the XML-RPC date type. Supply " +"``use_datetime=True`` to the :func:`~xmlrpc.client.loads` function or the :" +"class:`!Unmarshaller` class to enable this feature. (Contributed by Skip " +"Montanaro.)" +msgstr "" + +msgid "" +"The :mod:`zipfile` module now supports the ZIP64 version of the format, " +"meaning that a .zip archive can now be larger than 4 GiB and can contain " +"individual files larger than 4 GiB. (Contributed by Ronald Oussoren.)" +msgstr "" + +msgid "" +"The :mod:`zlib` module's :class:`Compress` and :class:`Decompress` objects " +"now support a :meth:`copy` method that makes a copy of the object's " +"internal state and returns a new :class:`Compress` or :class:`Decompress` " +"object. (Contributed by Chris AtLee.)" +msgstr "" + +msgid "The ctypes package" +msgstr "" + +msgid "" +"The :mod:`ctypes` package, written by Thomas Heller, has been added to the " +"standard library. :mod:`ctypes` lets you call arbitrary functions in " +"shared libraries or DLLs. Long-time users may remember the :mod:`!dl` " +"module, which provides functions for loading shared libraries and calling " +"functions in them. The :mod:`ctypes` package is much fancier." +msgstr "" + +msgid "" +"To load a shared library or DLL, you must create an instance of the :class:" +"`CDLL` class and provide the name or path of the shared library or DLL. Once " +"that's done, you can call arbitrary functions by accessing them as " +"attributes of the :class:`CDLL` object. ::" +msgstr "" + +msgid "" +"Type constructors for the various C types are provided: :func:`c_int`, :func:" +"`c_float`, :func:`c_double`, :func:`c_char_p` (equivalent to :c:expr:`char " +"\\*`), and so forth. Unlike Python's types, the C versions are all mutable; " +"you can assign to their :attr:`value` attribute to change the wrapped " +"value. Python integers and strings will be automatically converted to the " +"corresponding C types, but for other types you must call the correct type " +"constructor. (And I mean *must*; getting it wrong will often result in the " +"interpreter crashing with a segmentation fault.)" +msgstr "" + +msgid "" +"You shouldn't use :func:`c_char_p` with a Python string when the C function " +"will be modifying the memory area, because Python strings are supposed to " +"be immutable; breaking this rule will cause puzzling bugs. When you need a " +"modifiable memory area, use :func:`create_string_buffer`::" +msgstr "" + +msgid "" +"C functions are assumed to return integers, but you can set the :attr:" +"`restype` attribute of the function object to change this::" +msgstr "" + +msgid "" +":mod:`ctypes` also provides a wrapper for Python's C API as the ``ctypes." +"pythonapi`` object. This object does *not* release the global interpreter " +"lock before calling a function, because the lock must be held when calling " +"into the interpreter's code. There's a :class:`py_object()` type " +"constructor that will create a :c:expr:`PyObject *` pointer. A simple " +"usage::" +msgstr "" + +msgid "" +"Don't forget to use :class:`py_object()`; if it's omitted you end up with a " +"segmentation fault." +msgstr "" + +msgid "" +":mod:`ctypes` has been around for a while, but people still write and " +"distribution hand-coded extension modules because you can't rely on :mod:" +"`ctypes` being present. Perhaps developers will begin to write Python " +"wrappers atop a library accessed through :mod:`ctypes` instead of extension " +"modules, now that :mod:`ctypes` is included with core Python." +msgstr "" + +msgid "" +"https://web.archive.org/web/20180410025338/http://starship.python.net/crew/" +"theller/ctypes/" +msgstr "" +"https://web.archive.org/web/20180410025338/http://starship.python.net/crew/" +"theller/ctypes/" + +msgid "The pre-stdlib ctypes web page, with a tutorial, reference, and FAQ." +msgstr "" + +msgid "The documentation for the :mod:`ctypes` module." +msgstr "" + +msgid "The ElementTree package" +msgstr "" + +msgid "" +"A subset of Fredrik Lundh's ElementTree library for processing XML has been " +"added to the standard library as :mod:`xml.etree`. The available modules " +"are :mod:`ElementTree`, :mod:`ElementPath`, and :mod:`ElementInclude` from " +"ElementTree 1.2.6. The :mod:`cElementTree` accelerator module is also " +"included." +msgstr "" + +msgid "" +"The rest of this section will provide a brief overview of using ElementTree. " +"Full documentation for ElementTree is available at https://web.archive.org/" +"web/20201124024954/http://effbot.org/zone/element-index.htm." +msgstr "" + +msgid "" +"ElementTree represents an XML document as a tree of element nodes. The text " +"content of the document is stored as the :attr:`text` and :attr:`tail` " +"attributes of (This is one of the major differences between ElementTree and " +"the Document Object Model; in the DOM there are many different types of " +"node, including :class:`TextNode`.)" +msgstr "" + +msgid "" +"The most commonly used parsing function is :func:`parse`, that takes either " +"a string (assumed to contain a filename) or a file-like object and returns " +"an :class:`ElementTree` instance::" +msgstr "" + +msgid "" +"Once you have an :class:`ElementTree` instance, you can call its :meth:" +"`getroot` method to get the root :class:`Element` node." +msgstr "" + +msgid "" +"There's also an :func:`XML` function that takes a string literal and returns " +"an :class:`Element` node (not an :class:`ElementTree`). This function " +"provides a tidy way to incorporate XML fragments, approaching the " +"convenience of an XML literal::" +msgstr "" + +msgid "" +"Each XML element supports some dictionary-like and some list-like access " +"methods. Dictionary-like operations are used to access attribute values, " +"and list-like operations are used to access child nodes." +msgstr "" + +msgid "Operation" +msgstr "" + +msgid "Result" +msgstr "" + +msgid "``elem[n]``" +msgstr "``elem[n]``" + +msgid "Returns n'th child element." +msgstr "" + +msgid "``elem[m:n]``" +msgstr "``elem[m:n]``" + +msgid "Returns list of m'th through n'th child elements." +msgstr "" + +msgid "``len(elem)``" +msgstr "``len(elem)``" + +msgid "Returns number of child elements." +msgstr "" + +msgid "``list(elem)``" +msgstr "``list(elem)``" + +msgid "Returns list of child elements." +msgstr "" + +msgid "``elem.append(elem2)``" +msgstr "``elem.append(elem2)``" + +msgid "Adds *elem2* as a child." +msgstr "" + +msgid "``elem.insert(index, elem2)``" +msgstr "" + +msgid "Inserts *elem2* at the specified location." +msgstr "" + +msgid "``del elem[n]``" +msgstr "" + +msgid "Deletes n'th child element." +msgstr "" + +msgid "``elem.keys()``" +msgstr "``elem.keys()``" + +msgid "Returns list of attribute names." +msgstr "" + +msgid "``elem.get(name)``" +msgstr "``elem.get(name)``" + +msgid "Returns value of attribute *name*." +msgstr "" + +msgid "``elem.set(name, value)``" +msgstr "" + +msgid "Sets new value for attribute *name*." +msgstr "" + +msgid "``elem.attrib``" +msgstr "``elem.attrib``" + +msgid "Retrieves the dictionary containing attributes." +msgstr "" + +msgid "``del elem.attrib[name]``" +msgstr "" + +msgid "Deletes attribute *name*." +msgstr "" + +msgid "" +"Comments and processing instructions are also represented as :class:" +"`Element` nodes. To check if a node is a comment or processing " +"instructions::" +msgstr "" + +msgid "" +"To generate XML output, you should call the :meth:`ElementTree.write` " +"method. Like :func:`parse`, it can take either a string or a file-like " +"object::" +msgstr "" + +msgid "" +"(Caution: the default encoding used for output is ASCII. For general XML " +"work, where an element's name may contain arbitrary Unicode characters, " +"ASCII isn't a very useful encoding because it will raise an exception if an " +"element's name contains any characters with values greater than 127. " +"Therefore, it's best to specify a different encoding such as UTF-8 that can " +"handle any Unicode character.)" +msgstr "" + +msgid "" +"This section is only a partial description of the ElementTree interfaces. " +"Please read the package's official documentation for more details." +msgstr "" + +msgid "" +"https://web.archive.org/web/20201124024954/http://effbot.org/zone/element-" +"index.htm" +msgstr "" +"https://web.archive.org/web/20201124024954/http://effbot.org/zone/element-" +"index.htm" + +msgid "Official documentation for ElementTree." +msgstr "" + +msgid "The hashlib package" +msgstr "" + +msgid "" +"A new :mod:`hashlib` module, written by Gregory P. Smith, has been added to " +"replace the :mod:`!md5` and :mod:`!sha` modules. :mod:`hashlib` adds " +"support for additional secure hashes (SHA-224, SHA-256, SHA-384, and " +"SHA-512). When available, the module uses OpenSSL for fast platform " +"optimized implementations of algorithms." +msgstr "" + +msgid "" +"The old :mod:`!md5` and :mod:`!sha` modules still exist as wrappers around " +"hashlib to preserve backwards compatibility. The new module's interface is " +"very close to that of the old modules, but not identical. The most " +"significant difference is that the constructor functions for creating new " +"hashing objects are named differently. ::" +msgstr "" + +msgid "" +"Once a hash object has been created, its methods are the same as before: " +"``update(string)`` hashes the specified string into the current digest " +"state, :meth:`digest` and :meth:`hexdigest` return the digest value as a " +"binary string or a string of hex digits, and :meth:`copy` returns a new " +"hashing object with the same digest state." +msgstr "" + +msgid "The documentation for the :mod:`hashlib` module." +msgstr "" + +msgid "The sqlite3 package" +msgstr "" + +msgid "" +"The pysqlite module (https://www.pysqlite.org), a wrapper for the SQLite " +"embedded database, has been added to the standard library under the package " +"name :mod:`sqlite3`." +msgstr "" + +msgid "" +"SQLite is a C library that provides a lightweight disk-based database that " +"doesn't require a separate server process and allows accessing the database " +"using a nonstandard variant of the SQL query language. Some applications can " +"use SQLite for internal data storage. It's also possible to prototype an " +"application using SQLite and then port the code to a larger database such as " +"PostgreSQL or Oracle." +msgstr "" + +msgid "" +"pysqlite was written by Gerhard Häring and provides a SQL interface " +"compliant with the DB-API 2.0 specification described by :pep:`249`." +msgstr "" + +msgid "" +"If you're compiling the Python source yourself, note that the source tree " +"doesn't include the SQLite code, only the wrapper module. You'll need to " +"have the SQLite libraries and headers installed before compiling Python, and " +"the build process will compile the module when the necessary headers are " +"available." +msgstr "" + +msgid "" +"To use the module, you must first create a :class:`Connection` object that " +"represents the database. Here the data will be stored in the :file:`/tmp/" +"example` file::" +msgstr "" + +msgid "" +"You can also supply the special name ``:memory:`` to create a database in " +"RAM." +msgstr "" + +msgid "" +"Once you have a :class:`Connection`, you can create a :class:`Cursor` " +"object and call its :meth:`execute` method to perform SQL commands::" +msgstr "" + +msgid "" +"Usually your SQL operations will need to use values from Python variables. " +"You shouldn't assemble your query using Python's string operations because " +"doing so is insecure; it makes your program vulnerable to an SQL injection " +"attack." +msgstr "" + +msgid "" +"Instead, use the DB-API's parameter substitution. Put ``?`` as a " +"placeholder wherever you want to use a value, and then provide a tuple of " +"values as the second argument to the cursor's :meth:`execute` method. " +"(Other database modules may use a different placeholder, such as ``%s`` or " +"``:1``.) For example::" +msgstr "" + +msgid "" +"To retrieve data after executing a SELECT statement, you can either treat " +"the cursor as an iterator, call the cursor's :meth:`fetchone` method to " +"retrieve a single matching row, or call :meth:`fetchall` to get a list of " +"the matching rows." +msgstr "" + +msgid "This example uses the iterator form::" +msgstr "" + +msgid "" +"For more information about the SQL dialect supported by SQLite, see https://" +"www.sqlite.org." +msgstr "" + +msgid "https://www.pysqlite.org" +msgstr "https://www.pysqlite.org" + +msgid "The pysqlite web page." +msgstr "" + +msgid "https://www.sqlite.org" +msgstr "https://www.sqlite.org" + +msgid "" +"The SQLite web page; the documentation describes the syntax and the " +"available data types for the supported SQL dialect." +msgstr "" + +msgid "The documentation for the :mod:`sqlite3` module." +msgstr "" + +msgid ":pep:`249` - Database API Specification 2.0" +msgstr "" + +msgid "PEP written by Marc-André Lemburg." +msgstr "" + +msgid "The wsgiref package" +msgstr "" + +msgid "" +"The Web Server Gateway Interface (WSGI) v1.0 defines a standard interface " +"between web servers and Python web applications and is described in :pep:" +"`333`. The :mod:`wsgiref` package is a reference implementation of the WSGI " +"specification." +msgstr "" + +msgid "" +"The package includes a basic HTTP server that will run a WSGI application; " +"this server is useful for debugging but isn't intended for production use. " +"Setting up a server takes only a few lines of code::" +msgstr "" + +msgid "" +"https://web.archive.org/web/20160331090247/http://wsgi.readthedocs.org/en/" +"latest/" +msgstr "" +"https://web.archive.org/web/20160331090247/http://wsgi.readthedocs.org/en/" +"latest/" + +msgid "A central web site for WSGI-related resources." +msgstr "" + +msgid ":pep:`333` - Python Web Server Gateway Interface v1.0" +msgstr "" + +msgid "PEP written by Phillip J. Eby." +msgstr "" + +msgid "Build and C API Changes" +msgstr "" + +msgid "Changes to Python's build process and to the C API include:" +msgstr "" + +msgid "" +"The Python source tree was converted from CVS to Subversion, in a complex " +"migration procedure that was supervised and flawlessly carried out by Martin " +"von Löwis. The procedure was developed as :pep:`347`." +msgstr "" + +msgid "" +"Coverity, a company that markets a source code analysis tool called Prevent, " +"provided the results of their examination of the Python source code. The " +"analysis found about 60 bugs that were quickly fixed. Many of the bugs " +"were refcounting problems, often occurring in error-handling code. See " +"https://scan.coverity.com for the statistics." +msgstr "" + +msgid "" +"The largest change to the C API came from :pep:`353`, which modifies the " +"interpreter to use a :c:type:`Py_ssize_t` type definition instead of :c:expr:" +"`int`. See the earlier section :ref:`pep-353` for a discussion of this " +"change." +msgstr "" + +msgid "" +"The design of the bytecode compiler has changed a great deal, no longer " +"generating bytecode by traversing the parse tree. Instead the parse tree is " +"converted to an abstract syntax tree (or AST), and it is the abstract " +"syntax tree that's traversed to produce the bytecode." +msgstr "" + +msgid "" +"It's possible for Python code to obtain AST objects by using the :func:" +"`compile` built-in and specifying ``_ast.PyCF_ONLY_AST`` as the value of " +"the *flags* parameter::" +msgstr "" + +msgid "" +"No official documentation has been written for the AST code yet, but :pep:" +"`339` discusses the design. To start learning about the code, read the " +"definition of the various AST nodes in :file:`Parser/Python.asdl`. A Python " +"script reads this file and generates a set of C structure definitions in :" +"file:`Include/Python-ast.h`. The :c:func:`PyParser_ASTFromString` and :c:" +"func:`!PyParser_ASTFromFile`, defined in :file:`Include/pythonrun.h`, take " +"Python source as input and return the root of an AST representing the " +"contents. This AST can then be turned into a code object by :c:func:`!" +"PyAST_Compile`. For more information, read the source code, and then ask " +"questions on python-dev." +msgstr "" + +msgid "" +"The AST code was developed under Jeremy Hylton's management, and implemented " +"by (in alphabetical order) Brett Cannon, Nick Coghlan, Grant Edwards, John " +"Ehresman, Kurt Kaiser, Neal Norwitz, Tim Peters, Armin Rigo, and Neil " +"Schemenauer, plus the participants in a number of AST sprints at conferences " +"such as PyCon." +msgstr "" + +msgid "" +"Evan Jones's patch to obmalloc, first described in a talk at PyCon DC 2005, " +"was applied. Python 2.4 allocated small objects in 256K-sized arenas, but " +"never freed arenas. With this patch, Python will free arenas when they're " +"empty. The net effect is that on some platforms, when you allocate many " +"objects, Python's memory usage may actually drop when you delete them and " +"the memory may be returned to the operating system. (Implemented by Evan " +"Jones, and reworked by Tim Peters.)" +msgstr "" + +msgid "" +"Note that this change means extension modules must be more careful when " +"allocating memory. Python's API has many different functions for allocating " +"memory that are grouped into families. For example, :c:func:" +"`PyMem_Malloc`, :c:func:`PyMem_Realloc`, and :c:func:`PyMem_Free` are one " +"family that allocates raw memory, while :c:func:`PyObject_Malloc`, :c:func:" +"`PyObject_Realloc`, and :c:func:`PyObject_Free` are another family that's " +"supposed to be used for creating Python objects." +msgstr "" + +msgid "" +"Previously these different families all reduced to the platform's :c:func:" +"`malloc` and :c:func:`free` functions. This meant it didn't matter if you " +"got things wrong and allocated memory with the ``PyMem`` function but freed " +"it with the ``PyObject`` function. With 2.5's changes to obmalloc, these " +"families now do different things and mismatches will probably result in a " +"segfault. You should carefully test your C extension modules with Python " +"2.5." +msgstr "" + +msgid "" +"The built-in set types now have an official C API. Call :c:func:`PySet_New` " +"and :c:func:`PyFrozenSet_New` to create a new set, :c:func:`PySet_Add` and :" +"c:func:`PySet_Discard` to add and remove elements, and :c:func:" +"`PySet_Contains` and :c:func:`PySet_Size` to examine the set's state. " +"(Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"C code can now obtain information about the exact revision of the Python " +"interpreter by calling the :c:func:`Py_GetBuildInfo` function that returns " +"a string of build information like this: ``\"trunk:45355:45356M, Apr 13 " +"2006, 07:42:19\"``. (Contributed by Barry Warsaw.)" +msgstr "" + +msgid "" +"Two new macros can be used to indicate C functions that are local to the " +"current file so that a faster calling convention can be used. " +"``Py_LOCAL(type)`` declares the function as returning a value of the " +"specified *type* and uses a fast-calling qualifier. " +"``Py_LOCAL_INLINE(type)`` does the same thing and also requests the function " +"be inlined. If macro :c:macro:`!PY_LOCAL_AGGRESSIVE` is defined before :" +"file:`python.h` is included, a set of more aggressive optimizations are " +"enabled for the module; you should benchmark the results to find out if " +"these optimizations actually make the code faster. (Contributed by Fredrik " +"Lundh at the NeedForSpeed sprint.)" +msgstr "" + +msgid "" +"``PyErr_NewException(name, base, dict)`` can now accept a tuple of base " +"classes as its *base* argument. (Contributed by Georg Brandl.)" +msgstr "" + +msgid "" +"The :c:func:`!PyErr_Warn` function for issuing warnings is now deprecated in " +"favour of ``PyErr_WarnEx(category, message, stacklevel)`` which lets you " +"specify the number of stack frames separating this function and the caller. " +"A *stacklevel* of 1 is the function calling :c:func:`PyErr_WarnEx`, 2 is the " +"function above that, and so forth. (Added by Neal Norwitz.)" +msgstr "" + +msgid "" +"The CPython interpreter is still written in C, but the code can now be " +"compiled with a C++ compiler without errors. (Implemented by Anthony " +"Baxter, Martin von Löwis, Skip Montanaro.)" +msgstr "" + +msgid "" +"The :c:func:`!PyRange_New` function was removed. It was never documented, " +"never used in the core code, and had dangerously lax error checking. In the " +"unlikely case that your extensions were using it, you can replace it by " +"something like the following::" +msgstr "" + +msgid "Port-Specific Changes" +msgstr "" + +msgid "" +"MacOS X (10.3 and higher): dynamic loading of modules now uses the :c:func:" +"`dlopen` function instead of MacOS-specific functions." +msgstr "" + +msgid "" +"MacOS X: an :option:`!--enable-universalsdk` switch was added to the :" +"program:`configure` script that compiles the interpreter as a universal " +"binary able to run on both PowerPC and Intel processors. (Contributed by " +"Ronald Oussoren; :issue:`2573`.)" +msgstr "" + +msgid "" +"Windows: :file:`.dll` is no longer supported as a filename extension for " +"extension modules. :file:`.pyd` is now the only filename extension that " +"will be searched for." +msgstr "" + +msgid "Porting to Python 2.5" +msgstr "" + +msgid "" +"This section lists previously described changes that may require changes to " +"your code:" +msgstr "" + +msgid "" +"ASCII is now the default encoding for modules. It's now a syntax error if " +"a module contains string literals with 8-bit characters but doesn't have an " +"encoding declaration. In Python 2.4 this triggered a warning, not a syntax " +"error." +msgstr "" + +msgid "" +"Previously, the :attr:`gi_frame` attribute of a generator was always a frame " +"object. Because of the :pep:`342` changes described in section :ref:" +"`pep-342`, it's now possible for :attr:`gi_frame` to be ``None``." +msgstr "" + +msgid "" +"A new warning, :class:`UnicodeWarning`, is triggered when you attempt to " +"compare a Unicode string and an 8-bit string that can't be converted to " +"Unicode using the default ASCII encoding. Previously such comparisons would " +"raise a :class:`UnicodeDecodeError` exception." +msgstr "" + +msgid "" +"Library: the :mod:`csv` module is now stricter about multi-line quoted " +"fields. If your files contain newlines embedded within fields, the input " +"should be split into lines in a manner which preserves the newline " +"characters." +msgstr "" + +msgid "" +"Library: the :mod:`locale` module's :func:`format` function's would " +"previously accept any string as long as no more than one %char specifier " +"appeared. In Python 2.5, the argument must be exactly one %char specifier " +"with no surrounding text." +msgstr "" + +msgid "" +"Library: The :mod:`pickle` and :mod:`!cPickle` modules no longer accept a " +"return value of ``None`` from the :meth:`~object.__reduce__` method; the " +"method must return a tuple of arguments instead. The modules also no longer " +"accept the deprecated *bin* keyword parameter." +msgstr "" + +msgid "" +"Library: The :mod:`SimpleXMLRPCServer ` and :mod:" +"`DocXMLRPCServer ` classes now have a :attr:`rpc_paths` " +"attribute that constrains XML-RPC operations to a limited set of URL paths; " +"the default is to allow only ``'/'`` and ``'/RPC2'``. Setting :attr:" +"`rpc_paths` to ``None`` or an empty tuple disables this path checking." +msgstr "" + +msgid "" +"C API: Many functions now use :c:type:`Py_ssize_t` instead of :c:expr:`int` " +"to allow processing more data on 64-bit machines. Extension code may need " +"to make the same change to avoid warnings and to support 64-bit machines. " +"See the earlier section :ref:`pep-353` for a discussion of this change." +msgstr "" + +msgid "" +"C API: The obmalloc changes mean that you must be careful to not mix usage " +"of the ``PyMem_*`` and ``PyObject_*`` families of functions. Memory " +"allocated with one family's ``*_Malloc`` must be freed with the " +"corresponding family's ``*_Free`` function." +msgstr "" + +msgid "Acknowledgements" +msgstr "" + +msgid "" +"The author would like to thank the following people for offering " +"suggestions, corrections and assistance with various drafts of this article: " +"Georg Brandl, Nick Coghlan, Phillip J. Eby, Lars Gustäbel, Raymond " +"Hettinger, Ralf W. Grosse-Kunstleve, Kent Johnson, Iain Lowe, Martin von " +"Löwis, Fredrik Lundh, Andrew McNamara, Skip Montanaro, Gustavo Niemeyer, " +"Paul Prescod, James Pryor, Mike Rovner, Scott Weikart, Barry Warsaw, Thomas " +"Wouters." +msgstr "" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "What's new" +msgstr "" diff --git a/whatsnew/2.6.po b/whatsnew/2.6.po new file mode 100644 index 0000000000..c99032cdbe --- /dev/null +++ b/whatsnew/2.6.po @@ -0,0 +1,3223 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "What's New in Python 2.6" +msgstr "" + +msgid "Author" +msgstr "Autor" + +msgid "A.M. Kuchling (amk at amk.ca)" +msgstr "" + +msgid "" +"This article explains the new features in Python 2.6, released on October 1, " +"2008. The release schedule is described in :pep:`361`." +msgstr "" + +msgid "" +"The major theme of Python 2.6 is preparing the migration path to Python 3.0, " +"a major redesign of the language. Whenever possible, Python 2.6 " +"incorporates new features and syntax from 3.0 while remaining compatible " +"with existing code by not removing older features or syntax. When it's not " +"possible to do that, Python 2.6 tries to do what it can, adding " +"compatibility functions in a :mod:`future_builtins` module and a :option:" +"`!-3` switch to warn about usages that will become unsupported in 3.0." +msgstr "" + +msgid "" +"Some significant new packages have been added to the standard library, such " +"as the :mod:`multiprocessing` and :mod:`json` modules, but there aren't many " +"new features that aren't related to Python 3.0 in some way." +msgstr "" + +msgid "" +"Python 2.6 also sees a number of improvements and bugfixes throughout the " +"source. A search through the change logs finds there were 259 patches " +"applied and 612 bugs fixed between Python 2.5 and 2.6. Both figures are " +"likely to be underestimates." +msgstr "" + +msgid "" +"This article doesn't attempt to provide a complete specification of the new " +"features, but instead provides a convenient overview. For full details, you " +"should refer to the documentation for Python 2.6. If you want to understand " +"the rationale for the design and implementation, refer to the PEP for a " +"particular new feature. Whenever possible, \"What's New in Python\" links to " +"the bug/patch item for each change." +msgstr "" + +msgid "Python 3.0" +msgstr "" + +msgid "" +"The development cycle for Python versions 2.6 and 3.0 was synchronized, with " +"the alpha and beta releases for both versions being made on the same days. " +"The development of 3.0 has influenced many features in 2.6." +msgstr "" + +msgid "" +"Python 3.0 is a far-ranging redesign of Python that breaks compatibility " +"with the 2.x series. This means that existing Python code will need some " +"conversion in order to run on Python 3.0. However, not all the changes in " +"3.0 necessarily break compatibility. In cases where new features won't " +"cause existing code to break, they've been backported to 2.6 and are " +"described in this document in the appropriate place. Some of the 3.0-" +"derived features are:" +msgstr "" + +msgid "" +"A :meth:`__complex__` method for converting objects to a complex number." +msgstr "" + +msgid "Alternate syntax for catching exceptions: ``except TypeError as exc``." +msgstr "" + +msgid "" +"The addition of :func:`functools.reduce` as a synonym for the built-in :func:" +"`reduce` function." +msgstr "" + +msgid "" +"Python 3.0 adds several new built-in functions and changes the semantics of " +"some existing builtins. Functions that are new in 3.0 such as :func:`bin` " +"have simply been added to Python 2.6, but existing builtins haven't been " +"changed; instead, the :mod:`future_builtins` module has versions with the " +"new 3.0 semantics. Code written to be compatible with 3.0 can do ``from " +"future_builtins import hex, map`` as necessary." +msgstr "" + +msgid "" +"A new command-line switch, :option:`!-3`, enables warnings about features " +"that will be removed in Python 3.0. You can run code with this switch to " +"see how much work will be necessary to port code to 3.0. The value of this " +"switch is available to Python code as the boolean variable :data:`sys." +"py3kwarning`, and to C extension code as :c:data:`Py_Py3kWarningFlag`." +msgstr "" + +msgid "" +"The 3\\ *xxx* series of PEPs, which contains proposals for Python 3.0. :pep:" +"`3000` describes the development process for Python 3.0. Start with :pep:" +"`3100` that describes the general goals for Python 3.0, and then explore the " +"higher-numbered PEPs that propose specific features." +msgstr "" + +msgid "Changes to the Development Process" +msgstr "" + +msgid "" +"While 2.6 was being developed, the Python development process underwent two " +"significant changes: we switched from SourceForge's issue tracker to a " +"customized Roundup installation, and the documentation was converted from " +"LaTeX to reStructuredText." +msgstr "" + +msgid "New Issue Tracker: Roundup" +msgstr "" + +msgid "" +"For a long time, the Python developers had been growing increasingly annoyed " +"by SourceForge's bug tracker. SourceForge's hosted solution doesn't permit " +"much customization; for example, it wasn't possible to customize the life " +"cycle of issues." +msgstr "" + +msgid "" +"The infrastructure committee of the Python Software Foundation therefore " +"posted a call for issue trackers, asking volunteers to set up different " +"products and import some of the bugs and patches from SourceForge. Four " +"different trackers were examined: `Jira `__, `Launchpad `__, `Roundup `__, and `Trac `__. The " +"committee eventually settled on Jira and Roundup as the two candidates. " +"Jira is a commercial product that offers no-cost hosted instances to free-" +"software projects; Roundup is an open-source project that requires " +"volunteers to administer it and a server to host it." +msgstr "" + +msgid "" +"After posting a call for volunteers, a new Roundup installation was set up " +"at https://bugs.python.org. One installation of Roundup can host multiple " +"trackers, and this server now also hosts issue trackers for Jython and for " +"the Python web site. It will surely find other uses in the future. Where " +"possible, this edition of \"What's New in Python\" links to the bug/patch " +"item for each change." +msgstr "" + +msgid "" +"Hosting of the Python bug tracker is kindly provided by `Upfront Systems " +"`__ of Stellenbosch, South Africa. Martin " +"von Löwis put a lot of effort into importing existing bugs and patches from " +"SourceForge; his scripts for this import operation are at ``https://svn." +"python.org/view/tracker/importer/`` and may be useful to other projects " +"wishing to move from SourceForge to Roundup." +msgstr "" + +msgid "https://bugs.python.org" +msgstr "https://bugs.python.org" + +msgid "The Python bug tracker." +msgstr "" + +msgid "https://bugs.jython.org:" +msgstr "https://bugs.jython.org:" + +msgid "The Jython bug tracker." +msgstr "" + +msgid "https://roundup.sourceforge.io/" +msgstr "https://roundup.sourceforge.io/" + +msgid "Roundup downloads and documentation." +msgstr "" + +msgid "https://svn.python.org/view/tracker/importer/" +msgstr "https://svn.python.org/view/tracker/importer/" + +msgid "Martin von Löwis's conversion scripts." +msgstr "" + +msgid "New Documentation Format: reStructuredText Using Sphinx" +msgstr "" + +msgid "" +"The Python documentation was written using LaTeX since the project started " +"around 1989. In the 1980s and early 1990s, most documentation was printed " +"out for later study, not viewed online. LaTeX was widely used because it " +"provided attractive printed output while remaining straightforward to write " +"once the basic rules of the markup were learned." +msgstr "" + +msgid "" +"Today LaTeX is still used for writing publications destined for printing, " +"but the landscape for programming tools has shifted. We no longer print out " +"reams of documentation; instead, we browse through it online and HTML has " +"become the most important format to support. Unfortunately, converting LaTeX " +"to HTML is fairly complicated and Fred L. Drake Jr., the long-time Python " +"documentation editor, spent a lot of time maintaining the conversion " +"process. Occasionally people would suggest converting the documentation " +"into SGML and later XML, but performing a good conversion is a major task " +"and no one ever committed the time required to finish the job." +msgstr "" + +msgid "" +"During the 2.6 development cycle, Georg Brandl put a lot of effort into " +"building a new toolchain for processing the documentation. The resulting " +"package is called Sphinx, and is available from https://www.sphinx-doc.org/." +msgstr "" + +msgid "" +"Sphinx concentrates on HTML output, producing attractively styled and modern " +"HTML; printed output is still supported through conversion to LaTeX. The " +"input format is reStructuredText, a markup syntax supporting custom " +"extensions and directives that is commonly used in the Python community." +msgstr "" + +msgid "" +"Sphinx is a standalone package that can be used for writing, and almost two " +"dozen other projects (`listed on the Sphinx web site `__) have adopted Sphinx as their documentation " +"tool." +msgstr "" + +msgid "`Documenting Python `__" +msgstr "" + +msgid "Describes how to write for Python's documentation." +msgstr "" + +msgid "`Sphinx `__" +msgstr "`Sphinx `__" + +msgid "Documentation and code for the Sphinx toolchain." +msgstr "" + +msgid "`Docutils `__" +msgstr "" + +msgid "The underlying reStructuredText parser and toolset." +msgstr "" + +msgid "PEP 343: The 'with' statement" +msgstr "" + +msgid "" +"The previous version, Python 2.5, added the ':keyword:`with`' statement as " +"an optional feature, to be enabled by a ``from __future__ import " +"with_statement`` directive. In 2.6 the statement no longer needs to be " +"specially enabled; this means that :keyword:`!with` is now always a " +"keyword. The rest of this section is a copy of the corresponding section " +"from the \"What's New in Python 2.5\" document; if you're familiar with the " +"':keyword:`!with`' statement from Python 2.5, you can skip this section." +msgstr "" + +msgid "" +"The ':keyword:`with`' statement clarifies code that previously would use " +"``try...finally`` blocks to ensure that clean-up code is executed. In this " +"section, I'll discuss the statement as it will commonly be used. In the " +"next section, I'll examine the implementation details and show how to write " +"objects for use with this statement." +msgstr "" + +msgid "" +"The ':keyword:`with`' statement is a control-flow structure whose basic " +"structure is::" +msgstr "" + +msgid "" +"The expression is evaluated, and it should result in an object that supports " +"the context management protocol (that is, has :meth:`~object.__enter__` and :" +"meth:`~object.__exit__` methods)." +msgstr "" + +msgid "" +"The object's :meth:`~object.__enter__` is called before *with-block* is " +"executed and therefore can run set-up code. It also may return a value that " +"is bound to the name *variable*, if given. (Note carefully that *variable* " +"is *not* assigned the result of *expression*.)" +msgstr "" + +msgid "" +"After execution of the *with-block* is finished, the object's :meth:`~object." +"__exit__` method is called, even if the block raised an exception, and can " +"therefore run clean-up code." +msgstr "" + +msgid "" +"Some standard Python objects now support the context management protocol and " +"can be used with the ':keyword:`with`' statement. File objects are one " +"example::" +msgstr "" + +msgid "" +"After this statement has executed, the file object in *f* will have been " +"automatically closed, even if the :keyword:`for` loop raised an exception " +"part-way through the block." +msgstr "" + +msgid "" +"In this case, *f* is the same object created by :func:`open`, because :meth:" +"`~object.__enter__` returns *self*." +msgstr "" + +msgid "" +"The :mod:`threading` module's locks and condition variables also support " +"the ':keyword:`with`' statement::" +msgstr "" + +msgid "" +"The lock is acquired before the block is executed and always released once " +"the block is complete." +msgstr "" + +msgid "" +"The :func:`localcontext` function in the :mod:`decimal` module makes it easy " +"to save and restore the current decimal context, which encapsulates the " +"desired precision and rounding characteristics for computations::" +msgstr "" + +msgid "Writing Context Managers" +msgstr "" + +msgid "" +"Under the hood, the ':keyword:`with`' statement is fairly complicated. Most " +"people will only use ':keyword:`!with`' in company with existing objects and " +"don't need to know these details, so you can skip the rest of this section " +"if you like. Authors of new objects will need to understand the details of " +"the underlying implementation and should keep reading." +msgstr "" + +msgid "A high-level explanation of the context management protocol is:" +msgstr "" + +msgid "" +"The expression is evaluated and should result in an object called a " +"\"context manager\". The context manager must have :meth:`~object." +"__enter__` and :meth:`~object.__exit__` methods." +msgstr "" + +msgid "" +"The context manager's :meth:`~object.__enter__` method is called. The value " +"returned is assigned to *VAR*. If no ``as VAR`` clause is present, the " +"value is simply discarded." +msgstr "" + +msgid "The code in *BLOCK* is executed." +msgstr "" + +msgid "" +"If *BLOCK* raises an exception, the context manager's :meth:`~object." +"__exit__` method is called with three arguments, the exception details " +"(``type, value, traceback``, the same values returned by :func:`sys." +"exc_info`, which can also be ``None`` if no exception occurred). The " +"method's return value controls whether an exception is re-raised: any false " +"value re-raises the exception, and ``True`` will result in suppressing it. " +"You'll only rarely want to suppress the exception, because if you do the " +"author of the code containing the ':keyword:`with`' statement will never " +"realize anything went wrong." +msgstr "" + +msgid "" +"If *BLOCK* didn't raise an exception, the :meth:`~object.__exit__` method " +"is still called, but *type*, *value*, and *traceback* are all ``None``." +msgstr "" + +msgid "" +"Let's think through an example. I won't present detailed code but will only " +"sketch the methods necessary for a database that supports transactions." +msgstr "" + +msgid "" +"(For people unfamiliar with database terminology: a set of changes to the " +"database are grouped into a transaction. Transactions can be either " +"committed, meaning that all the changes are written into the database, or " +"rolled back, meaning that the changes are all discarded and the database is " +"unchanged. See any database textbook for more information.)" +msgstr "" + +msgid "" +"Let's assume there's an object representing a database connection. Our goal " +"will be to let the user write code like this::" +msgstr "" + +msgid "" +"The transaction should be committed if the code in the block runs flawlessly " +"or rolled back if there's an exception. Here's the basic interface for :" +"class:`DatabaseConnection` that I'll assume::" +msgstr "" + +msgid "" +"The :meth:`~object.__enter__` method is pretty easy, having only to start a " +"new transaction. For this application the resulting cursor object would be " +"a useful result, so the method will return it. The user can then add ``as " +"cursor`` to their ':keyword:`with`' statement to bind the cursor to a " +"variable name. ::" +msgstr "" + +msgid "" +"The :meth:`~object.__exit__` method is the most complicated because it's " +"where most of the work has to be done. The method has to check if an " +"exception occurred. If there was no exception, the transaction is " +"committed. The transaction is rolled back if there was an exception." +msgstr "" + +msgid "" +"In the code below, execution will just fall off the end of the function, " +"returning the default value of ``None``. ``None`` is false, so the " +"exception will be re-raised automatically. If you wished, you could be more " +"explicit and add a :keyword:`return` statement at the marked location. ::" +msgstr "" + +msgid "The contextlib module" +msgstr "" + +msgid "" +"The :mod:`contextlib` module provides some functions and a decorator that " +"are useful when writing objects for use with the ':keyword:`with`' statement." +msgstr "" + +msgid "" +"The decorator is called :func:`contextmanager`, and lets you write a single " +"generator function instead of defining a new class. The generator should " +"yield exactly one value. The code up to the :keyword:`yield` will be " +"executed as the :meth:`~object.__enter__` method, and the value yielded will " +"be the method's return value that will get bound to the variable in the ':" +"keyword:`with`' statement's :keyword:`!as` clause, if any. The code after " +"the :keyword:`!yield` will be executed in the :meth:`~object.__exit__` " +"method. Any exception raised in the block will be raised by the :keyword:`!" +"yield` statement." +msgstr "" + +msgid "" +"Using this decorator, our database example from the previous section could " +"be written as::" +msgstr "" + +msgid "" +"The :mod:`contextlib` module also has a ``nested(mgr1, mgr2, ...)`` function " +"that combines a number of context managers so you don't need to write nested " +"':keyword:`with`' statements. In this example, the single ':keyword:`!" +"with`' statement both starts a database transaction and acquires a thread " +"lock::" +msgstr "" + +msgid "" +"Finally, the :func:`closing` function returns its argument so that it can be " +"bound to a variable, and calls the argument's ``.close()`` method at the end " +"of the block. ::" +msgstr "" + +msgid ":pep:`343` - The \"with\" statement" +msgstr "" + +msgid "" +"PEP written by Guido van Rossum and Nick Coghlan; implemented by Mike Bland, " +"Guido van Rossum, and Neal Norwitz. The PEP shows the code generated for a " +"':keyword:`with`' statement, which can be helpful in learning how the " +"statement works." +msgstr "" + +msgid "The documentation for the :mod:`contextlib` module." +msgstr "" + +msgid "PEP 366: Explicit Relative Imports From a Main Module" +msgstr "" + +msgid "" +"Python's :option:`-m` switch allows running a module as a script. When you " +"ran a module that was located inside a package, relative imports didn't work " +"correctly." +msgstr "" + +msgid "" +"The fix for Python 2.6 adds a :attr:`__package__` attribute to modules. " +"When this attribute is present, relative imports will be relative to the " +"value of this attribute instead of the :attr:`__name__` attribute." +msgstr "" + +msgid "" +"PEP 302-style importers can then set :attr:`__package__` as necessary. The :" +"mod:`runpy` module that implements the :option:`-m` switch now does this, so " +"relative imports will now work correctly in scripts running from inside a " +"package." +msgstr "" + +msgid "PEP 370: Per-user ``site-packages`` Directory" +msgstr "" + +msgid "" +"When you run Python, the module search path ``sys.path`` usually includes a " +"directory whose path ends in ``\"site-packages\"``. This directory is " +"intended to hold locally installed packages available to all users using a " +"machine or a particular site installation." +msgstr "" + +msgid "" +"Python 2.6 introduces a convention for user-specific site directories. The " +"directory varies depending on the platform:" +msgstr "" + +msgid "Unix and Mac OS X: :file:`~/.local/`" +msgstr "" + +msgid "Windows: :file:`%APPDATA%/Python`" +msgstr "Windows: :file:`%APPDATA%/Python`" + +msgid "" +"Within this directory, there will be version-specific subdirectories, such " +"as :file:`lib/python2.6/site-packages` on Unix/Mac OS and :file:`Python26/" +"site-packages` on Windows." +msgstr "" + +msgid "" +"If you don't like the default directory, it can be overridden by an " +"environment variable. :envvar:`PYTHONUSERBASE` sets the root directory used " +"for all Python versions supporting this feature. On Windows, the directory " +"for application-specific data can be changed by setting the :envvar:" +"`APPDATA` environment variable. You can also modify the :file:`site.py` " +"file for your Python installation." +msgstr "" + +msgid "" +"The feature can be disabled entirely by running Python with the :option:`-s` " +"option or setting the :envvar:`PYTHONNOUSERSITE` environment variable." +msgstr "" + +msgid ":pep:`370` - Per-user ``site-packages`` Directory" +msgstr "" + +msgid "PEP written and implemented by Christian Heimes." +msgstr "" + +msgid "PEP 371: The ``multiprocessing`` Package" +msgstr "" + +msgid "" +"The new :mod:`multiprocessing` package lets Python programs create new " +"processes that will perform a computation and return a result to the " +"parent. The parent and child processes can communicate using queues and " +"pipes, synchronize their operations using locks and semaphores, and can " +"share simple arrays of data." +msgstr "" + +msgid "" +"The :mod:`multiprocessing` module started out as an exact emulation of the :" +"mod:`threading` module using processes instead of threads. That goal was " +"discarded along the path to Python 2.6, but the general approach of the " +"module is still similar. The fundamental class is the :class:`Process`, " +"which is passed a callable object and a collection of arguments. The :meth:" +"`start` method sets the callable running in a subprocess, after which you " +"can call the :meth:`is_alive` method to check whether the subprocess is " +"still running and the :meth:`join` method to wait for the process to exit." +msgstr "" + +msgid "" +"Here's a simple example where the subprocess will calculate a factorial. " +"The function doing the calculation is written strangely so that it takes " +"significantly longer when the input argument is a multiple of 4." +msgstr "" + +msgid "" +"A :class:`~queue.Queue` is used to communicate the result of the factorial. " +"The :class:`~queue.Queue` object is stored in a global variable. The child " +"process will use the value of the variable when the child was created; " +"because it's a :class:`~queue.Queue`, parent and child can use the object to " +"communicate. (If the parent were to change the value of the global " +"variable, the child's value would be unaffected, and vice versa.)" +msgstr "" + +msgid "" +"Two other classes, :class:`Pool` and :class:`Manager`, provide higher-level " +"interfaces. :class:`Pool` will create a fixed number of worker processes, " +"and requests can then be distributed to the workers by calling :meth:`apply` " +"or :meth:`apply_async` to add a single request, and :meth:`map` or :meth:" +"`map_async` to add a number of requests. The following code uses a :class:" +"`Pool` to spread requests across 5 worker processes and retrieve a list of " +"results::" +msgstr "" + +msgid "This produces the following output::" +msgstr "" + +msgid "" +"The other high-level interface, the :class:`Manager` class, creates a " +"separate server process that can hold master copies of Python data " +"structures. Other processes can then access and modify these data " +"structures using proxy objects. The following example creates a shared " +"dictionary by calling the :meth:`dict` method; the worker processes then " +"insert values into the dictionary. (Locking is not done for you " +"automatically, which doesn't matter in this example. :class:`Manager`'s " +"methods also include :meth:`Lock`, :meth:`RLock`, and :meth:`Semaphore` to " +"create shared locks.)" +msgstr "" + +msgid "This will produce the output::" +msgstr "" + +msgid "The documentation for the :mod:`multiprocessing` module." +msgstr "" + +msgid ":pep:`371` - Addition of the multiprocessing package" +msgstr "" + +msgid "" +"PEP written by Jesse Noller and Richard Oudkerk; implemented by Richard " +"Oudkerk and Jesse Noller." +msgstr "" + +msgid "PEP 3101: Advanced String Formatting" +msgstr "" + +msgid "" +"In Python 3.0, the ``%`` operator is supplemented by a more powerful string " +"formatting method, :meth:`format`. Support for the :meth:`str.format` " +"method has been backported to Python 2.6." +msgstr "" + +msgid "" +"In 2.6, both 8-bit and Unicode strings have a ``.format()`` method that " +"treats the string as a template and takes the arguments to be formatted. The " +"formatting template uses curly brackets (``{``, ``}``) as special " +"characters::" +msgstr "" + +msgid "Curly brackets can be escaped by doubling them::" +msgstr "" + +msgid "" +"Field names can be integers indicating positional arguments, such as ``{0}" +"``, ``{1}``, etc. or names of keyword arguments. You can also supply " +"compound field names that read attributes or access dictionary keys::" +msgstr "" + +msgid "" +"Note that when using dictionary-style notation such as ``[.mp4]``, you don't " +"need to put any quotation marks around the string; it will look up the value " +"using ``.mp4`` as the key. Strings beginning with a number will be " +"converted to an integer. You can't write more complicated expressions " +"inside a format string." +msgstr "" + +msgid "" +"So far we've shown how to specify which field to substitute into the " +"resulting string. The precise formatting used is also controllable by " +"adding a colon followed by a format specifier. For example::" +msgstr "" + +msgid "Format specifiers can reference other fields through nesting::" +msgstr "" + +msgid "The alignment of a field within the desired width can be specified:" +msgstr "" + +msgid "Character" +msgstr "Znak" + +msgid "Effect" +msgstr "" + +msgid "< (default)" +msgstr "" + +msgid "Left-align" +msgstr "" + +msgid ">" +msgstr "" + +msgid "Right-align" +msgstr "" + +msgid "^" +msgstr "" + +msgid "Center" +msgstr "" + +msgid "=" +msgstr "" + +msgid "(For numeric types only) Pad after the sign." +msgstr "" + +msgid "" +"Format specifiers can also include a presentation type, which controls how " +"the value is formatted. For example, floating-point numbers can be " +"formatted as a general number or in exponential notation::" +msgstr "" + +msgid "" +"A variety of presentation types are available. Consult the 2.6 " +"documentation for a :ref:`complete list `; here's a sample:" +msgstr "" + +msgid "``b``" +msgstr "``b``" + +msgid "Binary. Outputs the number in base 2." +msgstr "" + +msgid "``c``" +msgstr "``c``" + +msgid "" +"Character. Converts the integer to the corresponding Unicode character " +"before printing." +msgstr "" + +msgid "``d``" +msgstr "``d``" + +msgid "Decimal Integer. Outputs the number in base 10." +msgstr "" + +msgid "``o``" +msgstr "``o``" + +msgid "Octal format. Outputs the number in base 8." +msgstr "" + +msgid "``x``" +msgstr "``x``" + +msgid "" +"Hex format. Outputs the number in base 16, using lower-case letters for the " +"digits above 9." +msgstr "" + +msgid "``e``" +msgstr "``e``" + +msgid "" +"Exponent notation. Prints the number in scientific notation using the letter " +"'e' to indicate the exponent." +msgstr "" + +msgid "``g``" +msgstr "``g``" + +msgid "" +"General format. This prints the number as a fixed-point number, unless the " +"number is too large, in which case it switches to 'e' exponent notation." +msgstr "" + +msgid "``n``" +msgstr "``n``" + +msgid "" +"Number. This is the same as 'g' (for floats) or 'd' (for integers), except " +"that it uses the current locale setting to insert the appropriate number " +"separator characters." +msgstr "" + +msgid "``%``" +msgstr "``%``" + +msgid "" +"Percentage. Multiplies the number by 100 and displays in fixed ('f') format, " +"followed by a percent sign." +msgstr "" + +msgid "" +"Classes and types can define a :meth:`__format__` method to control how " +"they're formatted. It receives a single argument, the format specifier::" +msgstr "" + +msgid "" +"There's also a :func:`format` builtin that will format a single value. It " +"calls the type's :meth:`__format__` method with the provided specifier::" +msgstr "" + +msgid ":ref:`formatstrings`" +msgstr ":ref:`formatstrings`" + +msgid "The reference documentation for format fields." +msgstr "" + +msgid ":pep:`3101` - Advanced String Formatting" +msgstr "" + +msgid "PEP written by Talin. Implemented by Eric Smith." +msgstr "" + +msgid "PEP 3105: ``print`` As a Function" +msgstr "" + +msgid "" +"The ``print`` statement becomes the :func:`print` function in Python 3.0. " +"Making :func:`print` a function makes it possible to replace the function by " +"doing ``def print(...)`` or importing a new function from somewhere else." +msgstr "" + +msgid "" +"Python 2.6 has a ``__future__`` import that removes ``print`` as language " +"syntax, letting you use the functional form instead. For example::" +msgstr "" + +msgid "The signature of the new function is::" +msgstr "" + +msgid "The parameters are:" +msgstr "" + +msgid "*args*: positional arguments whose values will be printed out." +msgstr "" + +msgid "*sep*: the separator, which will be printed between arguments." +msgstr "" + +msgid "" +"*end*: the ending text, which will be printed after all of the arguments " +"have been output." +msgstr "" + +msgid "*file*: the file object to which the output will be sent." +msgstr "" + +msgid ":pep:`3105` - Make print a function" +msgstr "" + +msgid "PEP written by Georg Brandl." +msgstr "" + +msgid "PEP 3110: Exception-Handling Changes" +msgstr "" + +msgid "" +"One error that Python programmers occasionally make is writing the following " +"code::" +msgstr "" + +msgid "" +"The author is probably trying to catch both :exc:`TypeError` and :exc:" +"`ValueError` exceptions, but this code actually does something different: it " +"will catch :exc:`TypeError` and bind the resulting exception object to the " +"local name ``\"ValueError\"``. The :exc:`ValueError` exception will not be " +"caught at all. The correct code specifies a tuple of exceptions::" +msgstr "" + +msgid "" +"This error happens because the use of the comma here is ambiguous: does it " +"indicate two different nodes in the parse tree, or a single node that's a " +"tuple?" +msgstr "" + +msgid "" +"Python 3.0 makes this unambiguous by replacing the comma with the word " +"\"as\". To catch an exception and store the exception object in the " +"variable ``exc``, you must write::" +msgstr "" + +msgid "" +"Python 3.0 will only support the use of \"as\", and therefore interprets the " +"first example as catching two different exceptions. Python 2.6 supports " +"both the comma and \"as\", so existing code will continue to work. We " +"therefore suggest using \"as\" when writing new Python code that will only " +"be executed with 2.6." +msgstr "" + +msgid ":pep:`3110` - Catching Exceptions in Python 3000" +msgstr "" + +msgid "PEP written and implemented by Collin Winter." +msgstr "" + +msgid "PEP 3112: Byte Literals" +msgstr "" + +msgid "" +"Python 3.0 adopts Unicode as the language's fundamental string type and " +"denotes 8-bit literals differently, either as ``b'string'`` or using a :" +"class:`bytes` constructor. For future compatibility, Python 2.6 adds :class:" +"`bytes` as a synonym for the :class:`str` type, and it also supports the " +"``b''`` notation." +msgstr "" + +msgid "" +"The 2.6 :class:`str` differs from 3.0's :class:`bytes` type in various ways; " +"most notably, the constructor is completely different. In 3.0, ``bytes([65, " +"66, 67])`` is 3 elements long, containing the bytes representing ``ABC``; in " +"2.6, ``bytes([65, 66, 67])`` returns the 12-byte string representing the :" +"func:`str` of the list." +msgstr "" + +msgid "" +"The primary use of :class:`bytes` in 2.6 will be to write tests of object " +"type such as ``isinstance(x, bytes)``. This will help the 2to3 converter, " +"which can't tell whether 2.x code intends strings to contain either " +"characters or 8-bit bytes; you can now use either :class:`bytes` or :class:" +"`str` to represent your intention exactly, and the resulting code will also " +"be correct in Python 3.0." +msgstr "" + +msgid "" +"There's also a ``__future__`` import that causes all string literals to " +"become Unicode strings. This means that ``\\u`` escape sequences can be " +"used to include Unicode characters::" +msgstr "" + +msgid "" +"At the C level, Python 3.0 will rename the existing 8-bit string type, " +"called :c:type:`!PyStringObject` in Python 2.x, to :c:type:`PyBytesObject`. " +"Python 2.6 uses ``#define`` to support using the names :c:func:" +"`PyBytesObject`, :c:func:`PyBytes_Check`, :c:func:" +"`PyBytes_FromStringAndSize`, and all the other functions and macros used " +"with strings." +msgstr "" + +msgid "" +"Instances of the :class:`bytes` type are immutable just as strings are. A " +"new :class:`bytearray` type stores a mutable sequence of bytes::" +msgstr "" + +msgid "" +"Byte arrays support most of the methods of string types, such as :meth:" +"`startswith`/:meth:`endswith`, :meth:`find`/:meth:`rfind`, and some of the " +"methods of lists, such as :meth:`append`, :meth:`pop`, and :meth:`reverse`." +msgstr "" + +msgid "" +"There's also a corresponding C API, with :c:func:`PyByteArray_FromObject`, :" +"c:func:`PyByteArray_FromStringAndSize`, and various other functions." +msgstr "" + +msgid ":pep:`3112` - Bytes literals in Python 3000" +msgstr "" + +msgid "PEP written by Jason Orendorff; backported to 2.6 by Christian Heimes." +msgstr "" + +msgid "PEP 3116: New I/O Library" +msgstr "" + +msgid "" +"Python's built-in file objects support a number of methods, but file-like " +"objects don't necessarily support all of them. Objects that imitate files " +"usually support :meth:`read` and :meth:`write`, but they may not support :" +"meth:`readline`, for example. Python 3.0 introduces a layered I/O library " +"in the :mod:`io` module that separates buffering and text-handling features " +"from the fundamental read and write operations." +msgstr "" + +msgid "" +"There are three levels of abstract base classes provided by the :mod:`io` " +"module:" +msgstr "" + +msgid "" +":class:`RawIOBase` defines raw I/O operations: :meth:`read`, :meth:" +"`readinto`, :meth:`write`, :meth:`seek`, :meth:`tell`, :meth:`truncate`, " +"and :meth:`close`. Most of the methods of this class will often map to a " +"single system call. There are also :meth:`readable`, :meth:`writable`, and :" +"meth:`seekable` methods for determining what operations a given object will " +"allow." +msgstr "" + +msgid "" +"Python 3.0 has concrete implementations of this class for files and sockets, " +"but Python 2.6 hasn't restructured its file and socket objects in this way." +msgstr "" + +msgid "" +":class:`BufferedIOBase` is an abstract base class that buffers data in " +"memory to reduce the number of system calls used, making I/O processing more " +"efficient. It supports all of the methods of :class:`RawIOBase`, and adds a :" +"attr:`raw` attribute holding the underlying raw object." +msgstr "" + +msgid "" +"There are five concrete classes implementing this ABC. :class:" +"`BufferedWriter` and :class:`BufferedReader` are for objects that support " +"write-only or read-only usage that have a :meth:`seek` method for random " +"access. :class:`BufferedRandom` objects support read and write access upon " +"the same underlying stream, and :class:`BufferedRWPair` is for objects such " +"as TTYs that have both read and write operations acting upon unconnected " +"streams of data. The :class:`BytesIO` class supports reading, writing, and " +"seeking over an in-memory buffer." +msgstr "" + +msgid "" +":class:`TextIOBase`: Provides functions for reading and writing strings " +"(remember, strings will be Unicode in Python 3.0), and supporting :term:" +"`universal newlines`. :class:`TextIOBase` defines the :meth:`readline` " +"method and supports iteration upon objects." +msgstr "" + +msgid "" +"There are two concrete implementations. :class:`TextIOWrapper` wraps a " +"buffered I/O object, supporting all of the methods for text I/O and adding " +"a :attr:`buffer` attribute for access to the underlying object. :class:" +"`StringIO` simply buffers everything in memory without ever writing anything " +"to disk." +msgstr "" + +msgid "" +"(In Python 2.6, :class:`io.StringIO` is implemented in pure Python, so it's " +"pretty slow. You should therefore stick with the existing :mod:`!StringIO` " +"module or :mod:`!cStringIO` for now. At some point Python 3.0's :mod:`io` " +"module will be rewritten into C for speed, and perhaps the C implementation " +"will be backported to the 2.x releases.)" +msgstr "" + +msgid "" +"In Python 2.6, the underlying implementations haven't been restructured to " +"build on top of the :mod:`io` module's classes. The module is being " +"provided to make it easier to write code that's forward-compatible with 3.0, " +"and to save developers the effort of writing their own implementations of " +"buffering and text I/O." +msgstr "" + +msgid ":pep:`3116` - New I/O" +msgstr "" + +msgid "" +"PEP written by Daniel Stutzbach, Mike Verdone, and Guido van Rossum. Code by " +"Guido van Rossum, Georg Brandl, Walter Doerwald, Jeremy Hylton, Martin von " +"Löwis, Tony Lownds, and others." +msgstr "" + +msgid "PEP 3118: Revised Buffer Protocol" +msgstr "" + +msgid "" +"The buffer protocol is a C-level API that lets Python types exchange " +"pointers into their internal representations. A memory-mapped file can be " +"viewed as a buffer of characters, for example, and this lets another module " +"such as :mod:`re` treat memory-mapped files as a string of characters to be " +"searched." +msgstr "" + +msgid "" +"The primary users of the buffer protocol are numeric-processing packages " +"such as NumPy, which expose the internal representation of arrays so that " +"callers can write data directly into an array instead of going through a " +"slower API. This PEP updates the buffer protocol in light of experience " +"from NumPy development, adding a number of new features such as indicating " +"the shape of an array or locking a memory region." +msgstr "" + +msgid "" +"The most important new C API function is ``PyObject_GetBuffer(PyObject *obj, " +"Py_buffer *view, int flags)``, which takes an object and a set of flags, and " +"fills in the ``Py_buffer`` structure with information about the object's " +"memory representation. Objects can use this operation to lock memory in " +"place while an external caller could be modifying the contents, so there's a " +"corresponding ``PyBuffer_Release(Py_buffer *view)`` to indicate that the " +"external caller is done." +msgstr "" + +msgid "" +"The *flags* argument to :c:func:`PyObject_GetBuffer` specifies constraints " +"upon the memory returned. Some examples are:" +msgstr "" + +msgid ":c:macro:`PyBUF_WRITABLE` indicates that the memory must be writable." +msgstr "" + +msgid "" +":c:macro:`PyBUF_LOCK` requests a read-only or exclusive lock on the memory." +msgstr "" + +msgid "" +":c:macro:`PyBUF_C_CONTIGUOUS` and :c:macro:`PyBUF_F_CONTIGUOUS` requests a C-" +"contiguous (last dimension varies the fastest) or Fortran-contiguous (first " +"dimension varies the fastest) array layout." +msgstr "" + +msgid "" +"Two new argument codes for :c:func:`PyArg_ParseTuple`, ``s*`` and ``z*``, " +"return locked buffer objects for a parameter." +msgstr "" + +msgid ":pep:`3118` - Revising the buffer protocol" +msgstr "" + +msgid "" +"PEP written by Travis Oliphant and Carl Banks; implemented by Travis " +"Oliphant." +msgstr "" + +msgid "PEP 3119: Abstract Base Classes" +msgstr "" + +msgid "" +"Some object-oriented languages such as Java support interfaces, declaring " +"that a class has a given set of methods or supports a given access " +"protocol. Abstract Base Classes (or ABCs) are an equivalent feature for " +"Python. The ABC support consists of an :mod:`abc` module containing a " +"metaclass called :class:`ABCMeta`, special handling of this metaclass by " +"the :func:`isinstance` and :func:`issubclass` builtins, and a collection of " +"basic ABCs that the Python developers think will be widely useful. Future " +"versions of Python will probably add more ABCs." +msgstr "" + +msgid "" +"Let's say you have a particular class and wish to know whether it supports " +"dictionary-style access. The phrase \"dictionary-style\" is vague, however. " +"It probably means that accessing items with ``obj[1]`` works. Does it imply " +"that setting items with ``obj[2] = value`` works? Or that the object will " +"have :meth:`keys`, :meth:`values`, and :meth:`items` methods? What about " +"the iterative variants such as :meth:`iterkeys`? :meth:`copy` and :meth:" +"`update`? Iterating over the object with :func:`iter`?" +msgstr "" + +msgid "" +"The Python 2.6 :mod:`collections` module includes a number of different ABCs " +"that represent these distinctions. :class:`Iterable` indicates that a class " +"defines :meth:`__iter__`, and :class:`Container` means the class defines a :" +"meth:`__contains__` method and therefore supports ``x in y`` expressions. " +"The basic dictionary interface of getting items, setting items, and :meth:" +"`keys`, :meth:`values`, and :meth:`items`, is defined by the :class:" +"`MutableMapping` ABC." +msgstr "" + +msgid "" +"You can derive your own classes from a particular ABC to indicate they " +"support that ABC's interface::" +msgstr "" + +msgid "" +"Alternatively, you could write the class without deriving from the desired " +"ABC and instead register the class by calling the ABC's :meth:`register` " +"method::" +msgstr "" + +msgid "" +"For classes that you write, deriving from the ABC is probably clearer. The :" +"meth:`register` method is useful when you've written a new ABC that can " +"describe an existing type or class, or if you want to declare that some " +"third-party class implements an ABC. For example, if you defined a :class:" +"`PrintableType` ABC, it's legal to do::" +msgstr "" + +msgid "" +"Classes should obey the semantics specified by an ABC, but Python can't " +"check this; it's up to the class author to understand the ABC's requirements " +"and to implement the code accordingly." +msgstr "" + +msgid "" +"To check whether an object supports a particular interface, you can now " +"write::" +msgstr "" + +msgid "" +"Don't feel that you must now begin writing lots of checks as in the above " +"example. Python has a strong tradition of duck-typing, where explicit type-" +"checking is never done and code simply calls methods on an object, trusting " +"that those methods will be there and raising an exception if they aren't. " +"Be judicious in checking for ABCs and only do it where it's absolutely " +"necessary." +msgstr "" + +msgid "" +"You can write your own ABCs by using ``abc.ABCMeta`` as the metaclass in a " +"class definition::" +msgstr "" + +msgid "" +"In the :class:`Drawable` ABC above, the :meth:`draw_doubled` method renders " +"the object at twice its size and can be implemented in terms of other " +"methods described in :class:`Drawable`. Classes implementing this ABC " +"therefore don't need to provide their own implementation of :meth:" +"`draw_doubled`, though they can do so. An implementation of :meth:`draw` is " +"necessary, though; the ABC can't provide a useful generic implementation." +msgstr "" + +msgid "" +"You can apply the ``@abstractmethod`` decorator to methods such as :meth:" +"`draw` that must be implemented; Python will then raise an exception for " +"classes that don't define the method. Note that the exception is only raised " +"when you actually try to create an instance of a subclass lacking the " +"method::" +msgstr "" + +msgid "" +"Abstract data attributes can be declared using the ``@abstractproperty`` " +"decorator::" +msgstr "" + +msgid "Subclasses must then define a :meth:`readonly` property." +msgstr "" + +msgid ":pep:`3119` - Introducing Abstract Base Classes" +msgstr "" + +msgid "" +"PEP written by Guido van Rossum and Talin. Implemented by Guido van Rossum. " +"Backported to 2.6 by Benjamin Aranguren, with Alex Martelli." +msgstr "" + +msgid "PEP 3127: Integer Literal Support and Syntax" +msgstr "" + +msgid "" +"Python 3.0 changes the syntax for octal (base-8) integer literals, prefixing " +"them with \"0o\" or \"0O\" instead of a leading zero, and adds support for " +"binary (base-2) integer literals, signalled by a \"0b\" or \"0B\" prefix." +msgstr "" + +msgid "" +"Python 2.6 doesn't drop support for a leading 0 signalling an octal number, " +"but it does add support for \"0o\" and \"0b\"::" +msgstr "" + +msgid "" +"The :func:`oct` builtin still returns numbers prefixed with a leading zero, " +"and a new :func:`bin` builtin returns the binary representation for a " +"number::" +msgstr "" + +msgid "" +"The :func:`int` and :func:`long` builtins will now accept the \"0o\" and " +"\"0b\" prefixes when base-8 or base-2 are requested, or when the *base* " +"argument is zero (signalling that the base used should be determined from " +"the string)::" +msgstr "" + +msgid ":pep:`3127` - Integer Literal Support and Syntax" +msgstr "" + +msgid "PEP written by Patrick Maupin; backported to 2.6 by Eric Smith." +msgstr "" + +msgid "PEP 3129: Class Decorators" +msgstr "" + +msgid "" +"Decorators have been extended from functions to classes. It's now legal to " +"write::" +msgstr "" + +msgid "This is equivalent to::" +msgstr "" + +msgid ":pep:`3129` - Class Decorators" +msgstr "" + +msgid "PEP written by Collin Winter." +msgstr "" + +msgid "PEP 3141: A Type Hierarchy for Numbers" +msgstr "" + +msgid "" +"Python 3.0 adds several abstract base classes for numeric types inspired by " +"Scheme's numeric tower. These classes were backported to 2.6 as the :mod:" +"`numbers` module." +msgstr "" + +msgid "" +"The most general ABC is :class:`Number`. It defines no operations at all, " +"and only exists to allow checking if an object is a number by doing " +"``isinstance(obj, Number)``." +msgstr "" + +msgid "" +":class:`Complex` is a subclass of :class:`Number`. Complex numbers can " +"undergo the basic operations of addition, subtraction, multiplication, " +"division, and exponentiation, and you can retrieve the real and imaginary " +"parts and obtain a number's conjugate. Python's built-in complex type is an " +"implementation of :class:`Complex`." +msgstr "" + +msgid "" +":class:`Real` further derives from :class:`Complex`, and adds operations " +"that only work on real numbers: :func:`floor`, :func:`trunc`, rounding, " +"taking the remainder mod N, floor division, and comparisons." +msgstr "" + +msgid "" +":class:`Rational` numbers derive from :class:`Real`, have :attr:`numerator` " +"and :attr:`denominator` properties, and can be converted to floats. Python " +"2.6 adds a simple rational-number class, :class:`Fraction`, in the :mod:" +"`fractions` module. (It's called :class:`Fraction` instead of :class:" +"`Rational` to avoid a name clash with :class:`numbers.Rational`.)" +msgstr "" + +msgid "" +":class:`Integral` numbers derive from :class:`Rational`, and can be shifted " +"left and right with ``<<`` and ``>>``, combined using bitwise operations " +"such as ``&`` and ``|``, and can be used as array indexes and slice " +"boundaries." +msgstr "" + +msgid "" +"In Python 3.0, the PEP slightly redefines the existing builtins :func:" +"`round`, :func:`math.floor`, :func:`math.ceil`, and adds a new one, :func:" +"`math.trunc`, that's been backported to Python 2.6. :func:`math.trunc` " +"rounds toward zero, returning the closest :class:`Integral` that's between " +"the function's argument and zero." +msgstr "" + +msgid ":pep:`3141` - A Type Hierarchy for Numbers" +msgstr "" + +msgid "PEP written by Jeffrey Yasskin." +msgstr "" + +msgid "" +"`Scheme's numerical tower `__, from the Guile manual." +msgstr "" + +msgid "" +"`Scheme's number datatypes `__ from the R5RS " +"Scheme specification." +msgstr "" + +msgid "The :mod:`fractions` Module" +msgstr "" + +msgid "" +"To fill out the hierarchy of numeric types, the :mod:`fractions` module " +"provides a rational-number class. Rational numbers store their values as a " +"numerator and denominator forming a fraction, and can exactly represent " +"numbers such as ``2/3`` that floating-point numbers can only approximate." +msgstr "" + +msgid "" +"The :class:`Fraction` constructor takes two :class:`Integral` values that " +"will be the numerator and denominator of the resulting fraction. ::" +msgstr "" + +msgid "" +"For converting floating-point numbers to rationals, the float type now has " +"an :meth:`as_integer_ratio()` method that returns the numerator and " +"denominator for a fraction that evaluates to the same floating-point value::" +msgstr "" + +msgid "" +"Note that values that can only be approximated by floating-point numbers, " +"such as 1./3, are not simplified to the number being approximated; the " +"fraction attempts to match the floating-point value **exactly**." +msgstr "" + +msgid "" +"The :mod:`fractions` module is based upon an implementation by Sjoerd " +"Mullender that was in Python's :file:`Demo/classes/` directory for a long " +"time. This implementation was significantly updated by Jeffrey Yasskin." +msgstr "" + +msgid "Other Language Changes" +msgstr "" + +msgid "Some smaller changes made to the core Python language are:" +msgstr "" + +msgid "" +"Directories and zip archives containing a :file:`__main__.py` file can now " +"be executed directly by passing their name to the interpreter. The directory " +"or zip archive is automatically inserted as the first entry in sys.path. " +"(Suggestion and initial patch by Andy Chu, subsequently revised by Phillip " +"J. Eby and Nick Coghlan; :issue:`1739468`.)" +msgstr "" + +msgid "" +"The :func:`hasattr` function was catching and ignoring all errors, under the " +"assumption that they meant a :meth:`__getattr__` method was failing somehow " +"and the return value of :func:`hasattr` would therefore be ``False``. This " +"logic shouldn't be applied to :exc:`KeyboardInterrupt` and :exc:" +"`SystemExit`, however; Python 2.6 will no longer discard such exceptions " +"when :func:`hasattr` encounters them. (Fixed by Benjamin Peterson; :issue:" +"`2196`.)" +msgstr "" + +msgid "" +"When calling a function using the ``**`` syntax to provide keyword " +"arguments, you are no longer required to use a Python dictionary; any " +"mapping will now work::" +msgstr "" + +msgid "(Contributed by Alexander Belopolsky; :issue:`1686487`.)" +msgstr "" + +msgid "" +"It's also become legal to provide keyword arguments after a ``*args`` " +"argument to a function call. ::" +msgstr "" + +msgid "" +"Previously this would have been a syntax error. (Contributed by Amaury " +"Forgeot d'Arc; :issue:`3473`.)" +msgstr "" + +msgid "" +"A new builtin, ``next(iterator, [default])`` returns the next item from the " +"specified iterator. If the *default* argument is supplied, it will be " +"returned if *iterator* has been exhausted; otherwise, the :exc:" +"`StopIteration` exception will be raised. (Backported in :issue:`2719`.)" +msgstr "" + +msgid "" +"Tuples now have :meth:`index` and :meth:`count` methods matching the list " +"type's :meth:`index` and :meth:`count` methods::" +msgstr "" + +msgid "(Contributed by Raymond Hettinger)" +msgstr "" + +msgid "" +"The built-in types now have improved support for extended slicing syntax, " +"accepting various combinations of ``(start, stop, step)``. Previously, the " +"support was partial and certain corner cases wouldn't work. (Implemented by " +"Thomas Wouters.)" +msgstr "" + +msgid "" +"Properties now have three attributes, :attr:`getter`, :attr:`setter` and :" +"attr:`deleter`, that are decorators providing useful shortcuts for adding a " +"getter, setter or deleter function to an existing property. You would use " +"them like this::" +msgstr "" + +msgid "" +"Several methods of the built-in set types now accept multiple iterables: :" +"meth:`intersection`, :meth:`intersection_update`, :meth:`union`, :meth:" +"`update`, :meth:`difference` and :meth:`difference_update`." +msgstr "" + +msgid "(Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"Many floating-point features were added. The :func:`float` function will " +"now turn the string ``nan`` into an IEEE 754 Not A Number value, and " +"``+inf`` and ``-inf`` into positive or negative infinity. This works on any " +"platform with IEEE 754 semantics. (Contributed by Christian Heimes; :issue:" +"`1635`.)" +msgstr "" + +msgid "" +"Other functions in the :mod:`math` module, :func:`isinf` and :func:`isnan`, " +"return true if their floating-point argument is infinite or Not A Number. (:" +"issue:`1640`)" +msgstr "" + +msgid "" +"Conversion functions were added to convert floating-point numbers into " +"hexadecimal strings (:issue:`3008`). These functions convert floats to and " +"from a string representation without introducing rounding errors from the " +"conversion between decimal and binary. Floats have a :meth:`hex` method " +"that returns a string representation, and the ``float.fromhex()`` method " +"converts a string back into a number::" +msgstr "" + +msgid "" +"A numerical nicety: when creating a complex number from two floats on " +"systems that support signed zeros (-0 and +0), the :func:`complex` " +"constructor will now preserve the sign of the zero. (Fixed by Mark T. " +"Dickinson; :issue:`1507`.)" +msgstr "" + +msgid "" +"Classes that inherit a :meth:`__hash__` method from a parent class can set " +"``__hash__ = None`` to indicate that the class isn't hashable. This will " +"make ``hash(obj)`` raise a :exc:`TypeError` and the class will not be " +"indicated as implementing the :class:`Hashable` ABC." +msgstr "" + +msgid "" +"You should do this when you've defined a :meth:`__cmp__` or :meth:`__eq__` " +"method that compares objects by their value rather than by identity. All " +"objects have a default hash method that uses ``id(obj)`` as the hash value. " +"There's no tidy way to remove the :meth:`__hash__` method inherited from a " +"parent class, so assigning ``None`` was implemented as an override. At the " +"C level, extensions can set ``tp_hash`` to :c:func:" +"`PyObject_HashNotImplemented`. (Fixed by Nick Coghlan and Amaury Forgeot " +"d'Arc; :issue:`2235`.)" +msgstr "" + +msgid "" +"The :exc:`GeneratorExit` exception now subclasses :exc:`BaseException` " +"instead of :exc:`Exception`. This means that an exception handler that does " +"``except Exception:`` will not inadvertently catch :exc:`GeneratorExit`. " +"(Contributed by Chad Austin; :issue:`1537`.)" +msgstr "" + +msgid "" +"Generator objects now have a :attr:`gi_code` attribute that refers to the " +"original code object backing the generator. (Contributed by Collin Winter; :" +"issue:`1473257`.)" +msgstr "" + +msgid "" +"The :func:`compile` built-in function now accepts keyword arguments as well " +"as positional parameters. (Contributed by Thomas Wouters; :issue:`1444529`.)" +msgstr "" + +msgid "" +"The :func:`complex` constructor now accepts strings containing parenthesized " +"complex numbers, meaning that ``complex(repr(cplx))`` will now round-trip " +"values. For example, ``complex('(3+4j)')`` now returns the value (3+4j). (:" +"issue:`1491866`)" +msgstr "" + +msgid "" +"The string :meth:`translate` method now accepts ``None`` as the translation " +"table parameter, which is treated as the identity transformation. This " +"makes it easier to carry out operations that only delete characters. " +"(Contributed by Bengt Richter and implemented by Raymond Hettinger; :issue:" +"`1193128`.)" +msgstr "" + +msgid "" +"The built-in :func:`dir` function now checks for a :meth:`__dir__` method on " +"the objects it receives. This method must return a list of strings " +"containing the names of valid attributes for the object, and lets the object " +"control the value that :func:`dir` produces. Objects that have :meth:" +"`__getattr__` or :meth:`__getattribute__` methods can use this to advertise " +"pseudo-attributes they will honor. (:issue:`1591665`)" +msgstr "" + +msgid "" +"Instance method objects have new attributes for the object and function " +"comprising the method; the new synonym for :attr:`!im_self` is :attr:" +"`~method.__self__`, and :attr:`!im_func` is also available as :attr:`~method." +"__func__`. The old names are still supported in Python 2.6, but are gone in " +"3.0." +msgstr "" + +msgid "" +"An obscure change: when you use the :func:`locals` function inside a :" +"keyword:`class` statement, the resulting dictionary no longer returns free " +"variables. (Free variables, in this case, are variables referenced in the :" +"keyword:`!class` statement that aren't attributes of the class.)" +msgstr "" + +msgid "Optimizations" +msgstr "" + +msgid "" +"The :mod:`warnings` module has been rewritten in C. This makes it possible " +"to invoke warnings from the parser, and may also make the interpreter's " +"startup faster. (Contributed by Neal Norwitz and Brett Cannon; :issue:" +"`1631171`.)" +msgstr "" + +msgid "" +"Type objects now have a cache of methods that can reduce the work required " +"to find the correct method implementation for a particular class; once " +"cached, the interpreter doesn't need to traverse base classes to figure out " +"the right method to call. The cache is cleared if a base class or the class " +"itself is modified, so the cache should remain correct even in the face of " +"Python's dynamic nature. (Original optimization implemented by Armin Rigo, " +"updated for Python 2.6 by Kevin Jacobs; :issue:`1700288`.)" +msgstr "" + +msgid "" +"By default, this change is only applied to types that are included with the " +"Python core. Extension modules may not necessarily be compatible with this " +"cache, so they must explicitly add :c:macro:`Py_TPFLAGS_HAVE_VERSION_TAG` to " +"the module's ``tp_flags`` field to enable the method cache. (To be " +"compatible with the method cache, the extension module's code must not " +"directly access and modify the ``tp_dict`` member of any of the types it " +"implements. Most modules don't do this, but it's impossible for the Python " +"interpreter to determine that. See :issue:`1878` for some discussion.)" +msgstr "" + +msgid "" +"Function calls that use keyword arguments are significantly faster by doing " +"a quick pointer comparison, usually saving the time of a full string " +"comparison. (Contributed by Raymond Hettinger, after an initial " +"implementation by Antoine Pitrou; :issue:`1819`.)" +msgstr "" + +msgid "" +"All of the functions in the :mod:`struct` module have been rewritten in C, " +"thanks to work at the Need For Speed sprint. (Contributed by Raymond " +"Hettinger.)" +msgstr "" + +msgid "" +"Some of the standard built-in types now set a bit in their type objects. " +"This speeds up checking whether an object is a subclass of one of these " +"types. (Contributed by Neal Norwitz.)" +msgstr "" + +msgid "" +"Unicode strings now use faster code for detecting whitespace and line " +"breaks; this speeds up the :meth:`split` method by about 25% and :meth:" +"`splitlines` by 35%. (Contributed by Antoine Pitrou.) Memory usage is " +"reduced by using pymalloc for the Unicode string's data." +msgstr "" + +msgid "" +"The ``with`` statement now stores the :meth:`~object.__exit__` method on the " +"stack, producing a small speedup. (Implemented by Jeffrey Yasskin.)" +msgstr "" + +msgid "" +"To reduce memory usage, the garbage collector will now clear internal free " +"lists when garbage-collecting the highest generation of objects. This may " +"return memory to the operating system sooner." +msgstr "" + +msgid "Interpreter Changes" +msgstr "" + +msgid "" +"Two command-line options have been reserved for use by other Python " +"implementations. The :option:`-J` switch has been reserved for use by " +"Jython for Jython-specific options, such as switches that are passed to the " +"underlying JVM. :option:`-X` has been reserved for options specific to a " +"particular implementation of Python such as CPython, Jython, or IronPython. " +"If either option is used with Python 2.6, the interpreter will report that " +"the option isn't currently used." +msgstr "" + +msgid "" +"Python can now be prevented from writing :file:`.pyc` or :file:`.pyo` files " +"by supplying the :option:`-B` switch to the Python interpreter, or by " +"setting the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable before " +"running the interpreter. This setting is available to Python programs as " +"the ``sys.dont_write_bytecode`` variable, and Python code can change the " +"value to modify the interpreter's behaviour. (Contributed by Neal Norwitz " +"and Georg Brandl.)" +msgstr "" + +msgid "" +"The encoding used for standard input, output, and standard error can be " +"specified by setting the :envvar:`PYTHONIOENCODING` environment variable " +"before running the interpreter. The value should be a string in the form " +"```` or ``:``. The *encoding* part " +"specifies the encoding's name, e.g. ``utf-8`` or ``latin-1``; the optional " +"*errorhandler* part specifies what to do with characters that can't be " +"handled by the encoding, and should be one of \"error\", \"ignore\", or " +"\"replace\". (Contributed by Martin von Löwis.)" +msgstr "" + +msgid "New and Improved Modules" +msgstr "" + +msgid "" +"As in every release, Python's standard library received a number of " +"enhancements and bug fixes. Here's a partial list of the most notable " +"changes, sorted alphabetically by module name. Consult the :file:`Misc/NEWS` " +"file in the source tree for a more complete list of changes, or look through " +"the Subversion logs for all the details." +msgstr "" + +msgid "" +"The :mod:`asyncore` and :mod:`asynchat` modules are being actively " +"maintained again, and a number of patches and bugfixes were applied. " +"(Maintained by Josiah Carlson; see :issue:`1736190` for one patch.)" +msgstr "" + +msgid "" +"The :mod:`bsddb` module also has a new maintainer, Jesús Cea Avión, and the " +"package is now available as a standalone package. The web page for the " +"package is `www.jcea.es/programacion/pybsddb.htm `__. The plan is to remove the package from the " +"standard library in Python 3.0, because its pace of releases is much more " +"frequent than Python's." +msgstr "" + +msgid "" +"The :mod:`bsddb.dbshelve` module now uses the highest pickling protocol " +"available, instead of restricting itself to protocol 1. (Contributed by W. " +"Barnes.)" +msgstr "" + +msgid "" +"The :mod:`cgi` module will now read variables from the query string of an " +"HTTP POST request. This makes it possible to use form actions with URLs " +"that include query strings such as \"/cgi-bin/add.py?category=1\". " +"(Contributed by Alexandre Fiori and Nubis; :issue:`1817`.)" +msgstr "" + +msgid "" +"The :func:`parse_qs` and :func:`parse_qsl` functions have been relocated " +"from the :mod:`cgi` module to the :mod:`urlparse ` module. The " +"versions still available in the :mod:`!cgi` module will trigger :exc:" +"`PendingDeprecationWarning` messages in 2.6 (:issue:`600362`)." +msgstr "" + +msgid "" +"The :mod:`cmath` module underwent extensive revision, contributed by Mark " +"Dickinson and Christian Heimes. Five new functions were added:" +msgstr "" + +msgid "" +":func:`polar` converts a complex number to polar form, returning the modulus " +"and argument of the complex number." +msgstr "" + +msgid "" +":func:`rect` does the opposite, turning a modulus, argument pair back into " +"the corresponding complex number." +msgstr "" + +msgid "" +":func:`phase` returns the argument (also called the angle) of a complex " +"number." +msgstr "" + +msgid "" +":func:`isnan` returns True if either the real or imaginary part of its " +"argument is a NaN." +msgstr "" + +msgid "" +":func:`isinf` returns True if either the real or imaginary part of its " +"argument is infinite." +msgstr "" + +msgid "" +"The revisions also improved the numerical soundness of the :mod:`cmath` " +"module. For all functions, the real and imaginary parts of the results are " +"accurate to within a few units of least precision (ulps) whenever possible. " +"See :issue:`1381` for the details. The branch cuts for :func:`asinh`, :func:" +"`atanh`: and :func:`atan` have also been corrected." +msgstr "" + +msgid "" +"The tests for the module have been greatly expanded; nearly 2000 new test " +"cases exercise the algebraic functions." +msgstr "" + +msgid "" +"On IEEE 754 platforms, the :mod:`cmath` module now handles IEEE 754 special " +"values and floating-point exceptions in a manner consistent with Annex 'G' " +"of the C99 standard." +msgstr "" + +msgid "" +"A new data type in the :mod:`collections` module: ``namedtuple(typename, " +"fieldnames)`` is a factory function that creates subclasses of the standard " +"tuple whose fields are accessible by name as well as index. For example::" +msgstr "" + +msgid "" +"Several places in the standard library that returned tuples have been " +"modified to return :func:`namedtuple` instances. For example, the :meth:" +"`Decimal.as_tuple` method now returns a named tuple with :attr:`sign`, :attr:" +"`digits`, and :attr:`exponent` fields." +msgstr "" + +msgid "" +"Another change to the :mod:`collections` module is that the :class:`deque` " +"type now supports an optional *maxlen* parameter; if supplied, the deque's " +"size will be restricted to no more than *maxlen* items. Adding more items " +"to a full deque causes old items to be discarded." +msgstr "" + +msgid "" +"The :mod:`Cookie ` module's :class:`~http.cookies.Morsel` " +"objects now support an :attr:`~http.cookies.Morsel.httponly` attribute. In " +"some browsers. cookies with this attribute set cannot be accessed or " +"manipulated by JavaScript code. (Contributed by Arvin Schnell; :issue:" +"`1638033`.)" +msgstr "" + +msgid "" +"A new window method in the :mod:`curses` module, :meth:`chgat`, changes the " +"display attributes for a certain number of characters on a single line. " +"(Contributed by Fabian Kreutz.)" +msgstr "" + +msgid "" +"The :class:`Textbox` class in the :mod:`curses.textpad` module now supports " +"editing in insert mode as well as overwrite mode. Insert mode is enabled by " +"supplying a true value for the *insert_mode* parameter when creating the :" +"class:`Textbox` instance." +msgstr "" + +msgid "" +"The :mod:`datetime` module's :meth:`strftime` methods now support a ``%f`` " +"format code that expands to the number of microseconds in the object, zero-" +"padded on the left to six places. (Contributed by Skip Montanaro; :issue:" +"`1158`.)" +msgstr "" + +msgid "" +"The :mod:`decimal` module was updated to version 1.66 of `the General " +"Decimal Specification `__. " +"New features include some methods for some basic mathematical functions such " +"as :meth:`exp` and :meth:`log10`::" +msgstr "" + +msgid "" +"The :meth:`as_tuple` method of :class:`Decimal` objects now returns a named " +"tuple with :attr:`sign`, :attr:`digits`, and :attr:`exponent` fields." +msgstr "" + +msgid "" +"(Implemented by Facundo Batista and Mark Dickinson. Named tuple support " +"added by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The :mod:`difflib` module's :class:`SequenceMatcher` class now returns named " +"tuples representing matches, with :attr:`a`, :attr:`b`, and :attr:`size` " +"attributes. (Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"An optional ``timeout`` parameter, specifying a timeout measured in seconds, " +"was added to the :class:`ftplib.FTP` class constructor as well as the :meth:" +"`connect` method. (Added by Facundo Batista.) Also, the :class:`FTP` " +"class's :meth:`storbinary` and :meth:`storlines` now take an optional " +"*callback* parameter that will be called with each block of data after the " +"data has been sent. (Contributed by Phil Schwartz; :issue:`1221598`.)" +msgstr "" + +msgid "" +"The :func:`reduce` built-in function is also available in the :mod:" +"`functools` module. In Python 3.0, the builtin has been dropped and :func:" +"`reduce` is only available from :mod:`functools`; currently there are no " +"plans to drop the builtin in the 2.x series. (Patched by Christian Heimes; :" +"issue:`1739906`.)" +msgstr "" + +msgid "" +"When possible, the :mod:`getpass` module will now use :file:`/dev/tty` to " +"print a prompt message and read the password, falling back to standard error " +"and standard input. If the password may be echoed to the terminal, a " +"warning is printed before the prompt is displayed. (Contributed by Gregory " +"P. Smith.)" +msgstr "" + +msgid "" +"The :func:`glob.glob` function can now return Unicode filenames if a Unicode " +"path was used and Unicode filenames are matched within the directory. (:" +"issue:`1001604`)" +msgstr "" + +msgid "" +"A new function in the :mod:`heapq` module, ``merge(iter1, iter2, ...)``, " +"takes any number of iterables returning data in sorted order, and returns a " +"new generator that returns the contents of all the iterators, also in sorted " +"order. For example::" +msgstr "" + +msgid "" +"Another new function, ``heappushpop(heap, item)``, pushes *item* onto " +"*heap*, then pops off and returns the smallest item. This is more efficient " +"than making a call to :func:`heappush` and then :func:`heappop`." +msgstr "" + +msgid "" +":mod:`heapq` is now implemented to only use less-than comparison, instead of " +"the less-than-or-equal comparison it previously used. This makes :mod:" +"`heapq`'s usage of a type match the :meth:`list.sort` method. (Contributed " +"by Raymond Hettinger.)" +msgstr "" + +msgid "" +"An optional ``timeout`` parameter, specifying a timeout measured in seconds, " +"was added to the :class:`httplib.HTTPConnection ` and :class:`HTTPSConnection ` " +"class constructors. (Added by Facundo Batista.)" +msgstr "" + +msgid "" +"Most of the :mod:`inspect` module's functions, such as :func:`getmoduleinfo` " +"and :func:`getargs`, now return named tuples. In addition to behaving like " +"tuples, the elements of the return value can also be accessed as " +"attributes. (Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"Some new functions in the module include :func:`isgenerator`, :func:" +"`isgeneratorfunction`, and :func:`isabstract`." +msgstr "" + +msgid "The :mod:`itertools` module gained several new functions." +msgstr "" + +msgid "" +"``izip_longest(iter1, iter2, ...[, fillvalue])`` makes tuples from each of " +"the elements; if some of the iterables are shorter than others, the missing " +"values are set to *fillvalue*. For example::" +msgstr "" + +msgid "" +"``product(iter1, iter2, ..., [repeat=N])`` returns the Cartesian product of " +"the supplied iterables, a set of tuples containing every possible " +"combination of the elements returned from each iterable. ::" +msgstr "" + +msgid "" +"The optional *repeat* keyword argument is used for taking the product of an " +"iterable or a set of iterables with themselves, repeated *N* times. With a " +"single iterable argument, *N*-tuples are returned::" +msgstr "" + +msgid "With two iterables, *2N*-tuples are returned. ::" +msgstr "" + +msgid "" +"``combinations(iterable, r)`` returns sub-sequences of length *r* from the " +"elements of *iterable*. ::" +msgstr "" + +msgid "" +"``permutations(iter[, r])`` returns all the permutations of length *r* of " +"the iterable's elements. If *r* is not specified, it will default to the " +"number of elements produced by the iterable. ::" +msgstr "" + +msgid "" +"``itertools.chain(*iterables)`` is an existing function in :mod:`itertools` " +"that gained a new constructor in Python 2.6. ``itertools.chain." +"from_iterable(iterable)`` takes a single iterable that should return other " +"iterables. :func:`chain` will then return all the elements of the first " +"iterable, then all the elements of the second, and so on. ::" +msgstr "" + +msgid "(All contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The :mod:`logging` module's :class:`FileHandler` class and its subclasses :" +"class:`WatchedFileHandler`, :class:`RotatingFileHandler`, and :class:" +"`TimedRotatingFileHandler` now have an optional *delay* parameter to their " +"constructors. If *delay* is true, opening of the log file is deferred until " +"the first :meth:`emit` call is made. (Contributed by Vinay Sajip.)" +msgstr "" + +msgid "" +":class:`TimedRotatingFileHandler` also has a *utc* constructor parameter. " +"If the argument is true, UTC time will be used in determining when midnight " +"occurs and in generating filenames; otherwise local time will be used." +msgstr "" + +msgid "Several new functions were added to the :mod:`math` module:" +msgstr "" + +msgid "" +":func:`~math.isinf` and :func:`~math.isnan` determine whether a given float " +"is a (positive or negative) infinity or a NaN (Not a Number), respectively." +msgstr "" + +msgid "" +":func:`~math.copysign` copies the sign bit of an IEEE 754 number, returning " +"the absolute value of *x* combined with the sign bit of *y*. For example, " +"``math.copysign(1, -0.0)`` returns -1.0. (Contributed by Christian Heimes.)" +msgstr "" + +msgid "" +":func:`~math.factorial` computes the factorial of a number. (Contributed by " +"Raymond Hettinger; :issue:`2138`.)" +msgstr "" + +msgid "" +":func:`~math.fsum` adds up the stream of numbers from an iterable, and is " +"careful to avoid loss of precision through using partial sums. (Contributed " +"by Jean Brouwers, Raymond Hettinger, and Mark Dickinson; :issue:`2819`.)" +msgstr "" + +msgid "" +":func:`~math.acosh`, :func:`~math.asinh` and :func:`~math.atanh` compute the " +"inverse hyperbolic functions." +msgstr "" + +msgid ":func:`~math.log1p` returns the natural logarithm of *1+x* (base *e*)." +msgstr "" + +msgid "" +":func:`trunc` rounds a number toward zero, returning the closest :class:" +"`Integral` that's between the function's argument and zero. Added as part of " +"the backport of `PEP 3141's type hierarchy for numbers <#pep-3141>`__." +msgstr "" + +msgid "" +"The :mod:`math` module has been improved to give more consistent behaviour " +"across platforms, especially with respect to handling of floating-point " +"exceptions and IEEE 754 special values." +msgstr "" + +msgid "" +"Whenever possible, the module follows the recommendations of the C99 " +"standard about 754's special values. For example, ``sqrt(-1.)`` should now " +"give a :exc:`ValueError` across almost all platforms, while " +"``sqrt(float('NaN'))`` should return a NaN on all IEEE 754 platforms. Where " +"Annex 'F' of the C99 standard recommends signaling 'divide-by-zero' or " +"'invalid', Python will raise :exc:`ValueError`. Where Annex 'F' of the C99 " +"standard recommends signaling 'overflow', Python will raise :exc:" +"`OverflowError`. (See :issue:`711019` and :issue:`1640`.)" +msgstr "" + +msgid "(Contributed by Christian Heimes and Mark Dickinson.)" +msgstr "" + +msgid "" +":class:`~mmap.mmap` objects now have a :meth:`rfind` method that searches " +"for a substring beginning at the end of the string and searching backwards. " +"The :meth:`find` method also gained an *end* parameter giving an index at " +"which to stop searching. (Contributed by John Lenton.)" +msgstr "" + +msgid "" +"The :mod:`operator` module gained a :func:`methodcaller` function that takes " +"a name and an optional set of arguments, returning a callable that will call " +"the named function on any arguments passed to it. For example::" +msgstr "" + +msgid "(Contributed by Georg Brandl, after a suggestion by Gregory Petrosyan.)" +msgstr "" + +msgid "" +"The :func:`attrgetter` function now accepts dotted names and performs the " +"corresponding attribute lookups::" +msgstr "" + +msgid "(Contributed by Georg Brandl, after a suggestion by Barry Warsaw.)" +msgstr "" + +msgid "" +"The :mod:`os` module now wraps several new system calls. ``fchmod(fd, " +"mode)`` and ``fchown(fd, uid, gid)`` change the mode and ownership of an " +"opened file, and ``lchmod(path, mode)`` changes the mode of a symlink. " +"(Contributed by Georg Brandl and Christian Heimes.)" +msgstr "" + +msgid "" +":func:`chflags` and :func:`lchflags` are wrappers for the corresponding " +"system calls (where they're available), changing the flags set on a file. " +"Constants for the flag values are defined in the :mod:`stat` module; some " +"possible values include :const:`UF_IMMUTABLE` to signal the file may not be " +"changed and :const:`UF_APPEND` to indicate that data can only be appended to " +"the file. (Contributed by M. Levinson.)" +msgstr "" + +msgid "" +"``os.closerange(low, high)`` efficiently closes all file descriptors from " +"*low* to *high*, ignoring any errors and not including *high* itself. This " +"function is now used by the :mod:`subprocess` module to make starting " +"processes faster. (Contributed by Georg Brandl; :issue:`1663329`.)" +msgstr "" + +msgid "" +"The ``os.environ`` object's :meth:`clear` method will now unset the " +"environment variables using :func:`os.unsetenv` in addition to clearing the " +"object's keys. (Contributed by Martin Horcicka; :issue:`1181`.)" +msgstr "" + +msgid "" +"The :func:`os.walk` function now has a ``followlinks`` parameter. If set to " +"True, it will follow symlinks pointing to directories and visit the " +"directory's contents. For backward compatibility, the parameter's default " +"value is false. Note that the function can fall into an infinite recursion " +"if there's a symlink that points to a parent directory. (:issue:`1273829`)" +msgstr "" + +msgid "" +"In the :mod:`os.path` module, the :func:`splitext` function has been changed " +"to not split on leading period characters. This produces better results when " +"operating on Unix's dot-files. For example, ``os.path.splitext('.ipython')`` " +"now returns ``('.ipython', '')`` instead of ``('', '.ipython')``. (:issue:" +"`1115886`)" +msgstr "" + +msgid "" +"A new function, ``os.path.relpath(path, start='.')``, returns a relative " +"path from the ``start`` path, if it's supplied, or from the current working " +"directory to the destination ``path``. (Contributed by Richard Barran; :" +"issue:`1339796`.)" +msgstr "" + +msgid "" +"On Windows, :func:`os.path.expandvars` will now expand environment variables " +"given in the form \"%var%\", and \"~user\" will be expanded into the user's " +"home directory path. (Contributed by Josiah Carlson; :issue:`957650`.)" +msgstr "" + +msgid "" +"The Python debugger provided by the :mod:`pdb` module gained a new command: " +"\"run\" restarts the Python program being debugged and can optionally take " +"new command-line arguments for the program. (Contributed by Rocky " +"Bernstein; :issue:`1393667`.)" +msgstr "" + +msgid "" +"The :func:`pdb.post_mortem` function, used to begin debugging a traceback, " +"will now use the traceback returned by :func:`sys.exc_info` if no traceback " +"is supplied. (Contributed by Facundo Batista; :issue:`1106316`.)" +msgstr "" + +msgid "" +"The :mod:`pickletools` module now has an :func:`optimize` function that " +"takes a string containing a pickle and removes some unused opcodes, " +"returning a shorter pickle that contains the same data structure. " +"(Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"A :func:`get_data` function was added to the :mod:`pkgutil` module that " +"returns the contents of resource files included with an installed Python " +"package. For example::" +msgstr "" + +msgid "(Contributed by Paul Moore; :issue:`2439`.)" +msgstr "" + +msgid "" +"The :mod:`pyexpat` module's :class:`Parser` objects now allow setting their :" +"attr:`buffer_size` attribute to change the size of the buffer used to hold " +"character data. (Contributed by Achim Gaedke; :issue:`1137`.)" +msgstr "" + +msgid "" +"The :mod:`Queue` module now provides queue variants that retrieve entries in " +"different orders. The :class:`PriorityQueue` class stores queued items in a " +"heap and retrieves them in priority order, and :class:`LifoQueue` retrieves " +"the most recently added entries first, meaning that it behaves like a stack. " +"(Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"The :mod:`random` module's :class:`Random` objects can now be pickled on a " +"32-bit system and unpickled on a 64-bit system, and vice versa. " +"Unfortunately, this change also means that Python 2.6's :class:`Random` " +"objects can't be unpickled correctly on earlier versions of Python. " +"(Contributed by Shawn Ligocki; :issue:`1727780`.)" +msgstr "" + +msgid "" +"The new ``triangular(low, high, mode)`` function returns random numbers " +"following a triangular distribution. The returned values are between *low* " +"and *high*, not including *high* itself, and with *mode* as the most " +"frequently occurring value in the distribution. (Contributed by Wladmir van " +"der Laan and Raymond Hettinger; :issue:`1681432`.)" +msgstr "" + +msgid "" +"Long regular expression searches carried out by the :mod:`re` module will " +"check for signals being delivered, so time-consuming searches can now be " +"interrupted. (Contributed by Josh Hoyt and Ralf Schmitt; :issue:`846388`.)" +msgstr "" + +msgid "" +"The regular expression module is implemented by compiling bytecodes for a " +"tiny regex-specific virtual machine. Untrusted code could create malicious " +"strings of bytecode directly and cause crashes, so Python 2.6 includes a " +"verifier for the regex bytecode. (Contributed by Guido van Rossum from work " +"for Google App Engine; :issue:`3487`.)" +msgstr "" + +msgid "" +"The :mod:`rlcompleter` module's :meth:`Completer.complete()` method will now " +"ignore exceptions triggered while evaluating a name. (Fixed by Lorenz " +"Quack; :issue:`2250`.)" +msgstr "" + +msgid "" +"The :mod:`sched` module's :class:`scheduler` instances now have a read-only :" +"attr:`queue` attribute that returns the contents of the scheduler's queue, " +"represented as a list of named tuples with the fields ``(time, priority, " +"action, argument)``. (Contributed by Raymond Hettinger; :issue:`1861`.)" +msgstr "" + +msgid "" +"The :mod:`select` module now has wrapper functions for the Linux :c:func:`!" +"epoll` and BSD :c:func:`!kqueue` system calls. :meth:`modify` method was " +"added to the existing :class:`poll` objects; ``pollobj.modify(fd, " +"eventmask)`` takes a file descriptor or file object and an event mask, " +"modifying the recorded event mask for that file. (Contributed by Christian " +"Heimes; :issue:`1657`.)" +msgstr "" + +msgid "" +"The :func:`shutil.copytree` function now has an optional *ignore* argument " +"that takes a callable object. This callable will receive each directory " +"path and a list of the directory's contents, and returns a list of names " +"that will be ignored, not copied." +msgstr "" + +msgid "" +"The :mod:`shutil` module also provides an :func:`ignore_patterns` function " +"for use with this new parameter. :func:`ignore_patterns` takes an arbitrary " +"number of glob-style patterns and returns a callable that will ignore any " +"files and directories that match any of these patterns. The following " +"example copies a directory tree, but skips both :file:`.svn` directories and " +"Emacs backup files, which have names ending with '~'::" +msgstr "" + +msgid "(Contributed by Tarek Ziadé; :issue:`2663`.)" +msgstr "" + +msgid "" +"Integrating signal handling with GUI handling event loops like those used by " +"Tkinter or GTk+ has long been a problem; most software ends up polling, " +"waking up every fraction of a second to check if any GUI events have " +"occurred. The :mod:`signal` module can now make this more efficient. Calling " +"``signal.set_wakeup_fd(fd)`` sets a file descriptor to be used; when a " +"signal is received, a byte is written to that file descriptor. There's also " +"a C-level function, :c:func:`PySignal_SetWakeupFd`, for setting the " +"descriptor." +msgstr "" + +msgid "" +"Event loops will use this by opening a pipe to create two descriptors, one " +"for reading and one for writing. The writable descriptor will be passed to :" +"func:`set_wakeup_fd`, and the readable descriptor will be added to the list " +"of descriptors monitored by the event loop via :c:func:`!select` or :c:func:" +"`!poll`. On receiving a signal, a byte will be written and the main event " +"loop will be woken up, avoiding the need to poll." +msgstr "" + +msgid "(Contributed by Adam Olsen; :issue:`1583`.)" +msgstr "" + +msgid "" +"The :func:`siginterrupt` function is now available from Python code, and " +"allows changing whether signals can interrupt system calls or not. " +"(Contributed by Ralf Schmitt.)" +msgstr "" + +msgid "" +"The :func:`setitimer` and :func:`getitimer` functions have also been added " +"(where they're available). :func:`setitimer` allows setting interval timers " +"that will cause a signal to be delivered to the process after a specified " +"time, measured in wall-clock time, consumed process time, or combined " +"process+system time. (Contributed by Guilherme Polo; :issue:`2240`.)" +msgstr "" + +msgid "" +"The :mod:`smtplib` module now supports SMTP over SSL thanks to the addition " +"of the :class:`SMTP_SSL` class. This class supports an interface identical " +"to the existing :class:`SMTP` class. (Contributed by Monty Taylor.) Both " +"class constructors also have an optional ``timeout`` parameter that " +"specifies a timeout for the initial connection attempt, measured in " +"seconds. (Contributed by Facundo Batista.)" +msgstr "" + +msgid "" +"An implementation of the LMTP protocol (:rfc:`2033`) was also added to the " +"module. LMTP is used in place of SMTP when transferring e-mail between " +"agents that don't manage a mail queue. (LMTP implemented by Leif Hedstrom; :" +"issue:`957003`.)" +msgstr "" + +msgid "" +":meth:`SMTP.starttls` now complies with :rfc:`3207` and forgets any " +"knowledge obtained from the server not obtained from the TLS negotiation " +"itself. (Patch contributed by Bill Fenner; :issue:`829951`.)" +msgstr "" + +msgid "" +"The :mod:`socket` module now supports TIPC (https://tipc.sourceforge.net/), " +"a high-performance non-IP-based protocol designed for use in clustered " +"environments. TIPC addresses are 4- or 5-tuples. (Contributed by Alberto " +"Bertogli; :issue:`1646`.)" +msgstr "" + +msgid "" +"A new function, :func:`create_connection`, takes an address and connects to " +"it using an optional timeout value, returning the connected socket object. " +"This function also looks up the address's type and connects to it using IPv4 " +"or IPv6 as appropriate. Changing your code to use :func:`create_connection` " +"instead of ``socket(socket.AF_INET, ...)`` may be all that's required to " +"make your code work with IPv6." +msgstr "" + +msgid "" +"The base classes in the :mod:`SocketServer ` module now " +"support calling a :meth:`~socketserver.BaseServer.handle_timeout` method " +"after a span of inactivity specified by the server's :attr:`~socketserver." +"BaseServer.timeout` attribute. (Contributed by Michael Pomraning.) The :" +"meth:`~socketserver.BaseServer.serve_forever` method now takes an optional " +"poll interval measured in seconds, controlling how often the server will " +"check for a shutdown request. (Contributed by Pedro Werneck and Jeffrey " +"Yasskin; :issue:`742598`, :issue:`1193577`.)" +msgstr "" + +msgid "" +"The :mod:`sqlite3` module, maintained by Gerhard Häring, has been updated " +"from version 2.3.2 in Python 2.5 to version 2.4.1." +msgstr "" + +msgid "" +"The :mod:`struct` module now supports the C99 :c:expr:`_Bool` type, using " +"the format character ``'?'``. (Contributed by David Remahl.)" +msgstr "" + +msgid "" +"The :class:`~subprocess.Popen` objects provided by the :mod:`subprocess` " +"module now have :meth:`~subprocess.Popen.terminate`, :meth:`~subprocess." +"Popen.kill`, and :meth:`~subprocess.Popen.send_signal` methods. On Windows, :" +"meth:`!send_signal` only supports the :py:const:`~signal.SIGTERM` signal, " +"and all these methods are aliases for the Win32 API function :c:func:`!" +"TerminateProcess`. (Contributed by Christian Heimes.)" +msgstr "" + +msgid "" +"A new variable in the :mod:`sys` module, :attr:`float_info`, is an object " +"containing information derived from the :file:`float.h` file about the " +"platform's floating-point support. Attributes of this object include :attr:" +"`mant_dig` (number of digits in the mantissa), :attr:`epsilon` (smallest " +"difference between 1.0 and the next largest value representable), and " +"several others. (Contributed by Christian Heimes; :issue:`1534`.)" +msgstr "" + +msgid "" +"Another new variable, :attr:`dont_write_bytecode`, controls whether Python " +"writes any :file:`.pyc` or :file:`.pyo` files on importing a module. If this " +"variable is true, the compiled files are not written. The variable is " +"initially set on start-up by supplying the :option:`-B` switch to the Python " +"interpreter, or by setting the :envvar:`PYTHONDONTWRITEBYTECODE` environment " +"variable before running the interpreter. Python code can subsequently " +"change the value of this variable to control whether bytecode files are " +"written or not. (Contributed by Neal Norwitz and Georg Brandl.)" +msgstr "" + +msgid "" +"Information about the command-line arguments supplied to the Python " +"interpreter is available by reading attributes of a named tuple available as " +"``sys.flags``. For example, the :attr:`verbose` attribute is true if Python " +"was executed in verbose mode, :attr:`debug` is true in debugging mode, etc. " +"These attributes are all read-only. (Contributed by Christian Heimes.)" +msgstr "" + +msgid "" +"A new function, :func:`getsizeof`, takes a Python object and returns the " +"amount of memory used by the object, measured in bytes. Built-in objects " +"return correct results; third-party extensions may not, but can define a :" +"meth:`__sizeof__` method to return the object's size. (Contributed by Robert " +"Schuppenies; :issue:`2898`.)" +msgstr "" + +msgid "" +"It's now possible to determine the current profiler and tracer functions by " +"calling :func:`sys.getprofile` and :func:`sys.gettrace`. (Contributed by " +"Georg Brandl; :issue:`1648`.)" +msgstr "" + +msgid "" +"The :mod:`tarfile` module now supports POSIX.1-2001 (pax) tarfiles in " +"addition to the POSIX.1-1988 (ustar) and GNU tar formats that were already " +"supported. The default format is GNU tar; specify the ``format`` parameter " +"to open a file using a different format::" +msgstr "" + +msgid "" +"The new ``encoding`` and ``errors`` parameters specify an encoding and an " +"error handling scheme for character conversions. ``'strict'``, " +"``'ignore'``, and ``'replace'`` are the three standard ways Python can " +"handle errors,; ``'utf-8'`` is a special value that replaces bad characters " +"with their UTF-8 representation. (Character conversions occur because the " +"PAX format supports Unicode filenames, defaulting to UTF-8 encoding.)" +msgstr "" + +msgid "" +"The :meth:`TarFile.add` method now accepts an ``exclude`` argument that's a " +"function that can be used to exclude certain filenames from an archive. The " +"function must take a filename and return true if the file should be excluded " +"or false if it should be archived. The function is applied to both the name " +"initially passed to :meth:`add` and to the names of files in recursively " +"added directories." +msgstr "" + +msgid "(All changes contributed by Lars Gustäbel)." +msgstr "" + +msgid "" +"An optional ``timeout`` parameter was added to the :class:`telnetlib.Telnet` " +"class constructor, specifying a timeout measured in seconds. (Added by " +"Facundo Batista.)" +msgstr "" + +msgid "" +"The :class:`tempfile.NamedTemporaryFile` class usually deletes the temporary " +"file it created when the file is closed. This behaviour can now be changed " +"by passing ``delete=False`` to the constructor. (Contributed by Damien " +"Miller; :issue:`1537850`.)" +msgstr "" + +msgid "" +"A new class, :class:`SpooledTemporaryFile`, behaves like a temporary file " +"but stores its data in memory until a maximum size is exceeded. On reaching " +"that limit, the contents will be written to an on-disk temporary file. " +"(Contributed by Dustin J. Mitchell.)" +msgstr "" + +msgid "" +"The :class:`NamedTemporaryFile` and :class:`SpooledTemporaryFile` classes " +"both work as context managers, so you can write ``with tempfile." +"NamedTemporaryFile() as tmp: ...``. (Contributed by Alexander Belopolsky; :" +"issue:`2021`.)" +msgstr "" + +msgid "" +"The :mod:`test.test_support ` module gained a number of " +"context managers useful for writing tests. :func:`~test.support.os_helper." +"EnvironmentVarGuard` is a context manager that temporarily changes " +"environment variables and automatically restores them to their old values." +msgstr "" + +msgid "" +"Another context manager, :class:`TransientResource`, can surround calls to " +"resources that may or may not be available; it will catch and ignore a " +"specified list of exceptions. For example, a network test may ignore " +"certain failures when connecting to an external web site::" +msgstr "" + +msgid "" +"Finally, :func:`check_warnings` resets the :mod:`warning` module's warning " +"filters and returns an object that will record all warning messages " +"triggered (:issue:`3781`)::" +msgstr "" + +msgid "(Contributed by Brett Cannon.)" +msgstr "" + +msgid "" +"The :mod:`textwrap` module can now preserve existing whitespace at the " +"beginnings and ends of the newly created lines by specifying " +"``drop_whitespace=False`` as an argument::" +msgstr "" + +msgid "(Contributed by Dwayne Bailey; :issue:`1581073`.)" +msgstr "" + +msgid "" +"The :mod:`threading` module API is being changed to use properties such as :" +"attr:`daemon` instead of :meth:`setDaemon` and :meth:`isDaemon` methods, and " +"some methods have been renamed to use underscores instead of camel-case; for " +"example, the :meth:`activeCount` method is renamed to :meth:`active_count`. " +"Both the 2.6 and 3.0 versions of the module support the same properties and " +"renamed methods, but don't remove the old methods. No date has been set for " +"the deprecation of the old APIs in Python 3.x; the old APIs won't be removed " +"in any 2.x version. (Carried out by several people, most notably Benjamin " +"Peterson.)" +msgstr "" + +msgid "" +"The :mod:`threading` module's :class:`Thread` objects gained an :attr:" +"`ident` property that returns the thread's identifier, a nonzero integer. " +"(Contributed by Gregory P. Smith; :issue:`2871`.)" +msgstr "" + +msgid "" +"The :mod:`timeit` module now accepts callables as well as strings for the " +"statement being timed and for the setup code. Two convenience functions were " +"added for creating :class:`Timer` instances: ``repeat(stmt, setup, time, " +"repeat, number)`` and ``timeit(stmt, setup, time, number)`` create an " +"instance and call the corresponding method. (Contributed by Erik Demaine; :" +"issue:`1533909`.)" +msgstr "" + +msgid "" +"The :mod:`Tkinter` module now accepts lists and tuples for options, " +"separating the elements by spaces before passing the resulting value to Tcl/" +"Tk. (Contributed by Guilherme Polo; :issue:`2906`.)" +msgstr "" + +msgid "" +"The :mod:`turtle` module for turtle graphics was greatly enhanced by Gregor " +"Lingl. New features in the module include:" +msgstr "" + +msgid "Better animation of turtle movement and rotation." +msgstr "" + +msgid "" +"Control over turtle movement using the new :meth:`delay`, :meth:`tracer`, " +"and :meth:`speed` methods." +msgstr "" + +msgid "" +"The ability to set new shapes for the turtle, and to define a new coordinate " +"system." +msgstr "" + +msgid "Turtles now have an :meth:`undo()` method that can roll back actions." +msgstr "" + +msgid "" +"Simple support for reacting to input events such as mouse and keyboard " +"activity, making it possible to write simple games." +msgstr "" + +msgid "" +"A :file:`turtle.cfg` file can be used to customize the starting appearance " +"of the turtle's screen." +msgstr "" + +msgid "" +"The module's docstrings can be replaced by new docstrings that have been " +"translated into another language." +msgstr "" + +msgid "(:issue:`1513695`)" +msgstr "(:issue:`1513695`)" + +msgid "" +"An optional ``timeout`` parameter was added to the :func:`urllib.urlopen " +"` function and the :class:`urllib.ftpwrapper` class " +"constructor, as well as the :func:`urllib2.urlopen ` " +"function. The parameter specifies a timeout measured in seconds. For " +"example::" +msgstr "" + +msgid "(Added by Facundo Batista.)" +msgstr "" + +msgid "" +"The Unicode database provided by the :mod:`unicodedata` module has been " +"updated to version 5.1.0. (Updated by Martin von Löwis; :issue:`3811`.)" +msgstr "" + +msgid "" +"The :mod:`warnings` module's :func:`formatwarning` and :func:`showwarning` " +"gained an optional *line* argument that can be used to supply the line of " +"source code. (Added as part of :issue:`1631171`, which re-implemented part " +"of the :mod:`warnings` module in C code.)" +msgstr "" + +msgid "" +"A new function, :func:`catch_warnings`, is a context manager intended for " +"testing purposes that lets you temporarily modify the warning filters and " +"then restore their original values (:issue:`3781`)." +msgstr "" + +msgid "" +"The XML-RPC :class:`SimpleXMLRPCServer ` and :class:" +"`DocXMLRPCServer ` classes can now be prevented from " +"immediately opening and binding to their socket by passing ``False`` as the " +"*bind_and_activate* constructor parameter. This can be used to modify the " +"instance's :attr:`allow_reuse_address` attribute before calling the :meth:" +"`server_bind` and :meth:`server_activate` methods to open the socket and " +"begin listening for connections. (Contributed by Peter Parente; :issue:" +"`1599845`.)" +msgstr "" + +msgid "" +":class:`SimpleXMLRPCServer` also has a :attr:`_send_traceback_header` " +"attribute; if true, the exception and formatted traceback are returned as " +"HTTP headers \"X-Exception\" and \"X-Traceback\". This feature is for " +"debugging purposes only and should not be used on production servers because " +"the tracebacks might reveal passwords or other sensitive information. " +"(Contributed by Alan McIntyre as part of his project for Google's Summer of " +"Code 2007.)" +msgstr "" + +msgid "" +"The :mod:`xmlrpclib ` module no longer automatically " +"converts :class:`datetime.date` and :class:`datetime.time` to the :class:" +"`xmlrpclib.DateTime ` type; the conversion semantics " +"were not necessarily correct for all applications. Code using :mod:`!" +"xmlrpclib` should convert :class:`date` and :class:`~datetime.time` " +"instances. (:issue:`1330538`) The code can also handle dates before 1900 " +"(contributed by Ralf Schmitt; :issue:`2014`) and 64-bit integers represented " +"by using ```` in XML-RPC responses (contributed by Riku Lindblad; :issue:" +"`2985`)." +msgstr "" + +msgid "" +"The :mod:`zipfile` module's :class:`ZipFile` class now has :meth:`extract` " +"and :meth:`extractall` methods that will unpack a single file or all the " +"files in the archive to the current directory, or to a specified directory::" +msgstr "" + +msgid "(Contributed by Alan McIntyre; :issue:`467924`.)" +msgstr "" + +msgid "" +"The :meth:`open`, :meth:`read` and :meth:`extract` methods can now take " +"either a filename or a :class:`ZipInfo` object. This is useful when an " +"archive accidentally contains a duplicated filename. (Contributed by Graham " +"Horler; :issue:`1775025`.)" +msgstr "" + +msgid "" +"Finally, :mod:`zipfile` now supports using Unicode filenames for archived " +"files. (Contributed by Alexey Borzenkov; :issue:`1734346`.)" +msgstr "" + +msgid "The :mod:`ast` module" +msgstr "" + +msgid "" +"The :mod:`ast` module provides an Abstract Syntax Tree representation of " +"Python code, and Armin Ronacher contributed a set of helper functions that " +"perform a variety of common tasks. These will be useful for HTML templating " +"packages, code analyzers, and similar tools that process Python code." +msgstr "" + +msgid "" +"The :func:`parse` function takes an expression and returns an AST. The :func:" +"`dump` function outputs a representation of a tree, suitable for debugging::" +msgstr "" + +msgid "This outputs a deeply nested tree::" +msgstr "" + +msgid "" +"The :func:`literal_eval` method takes a string or an AST representing a " +"literal expression, parses and evaluates it, and returns the resulting " +"value. A literal expression is a Python expression containing only strings, " +"numbers, dictionaries, etc. but no statements or function calls. If you " +"need to evaluate an expression but cannot accept the security risk of using " +"an :func:`eval` call, :func:`literal_eval` will handle it safely::" +msgstr "" + +msgid "" +"The module also includes :class:`NodeVisitor` and :class:`NodeTransformer` " +"classes for traversing and modifying an AST, and functions for common " +"transformations such as changing line numbers." +msgstr "" + +msgid "The :mod:`future_builtins` module" +msgstr "" + +msgid "" +"Python 3.0 makes many changes to the repertoire of built-in functions, and " +"most of the changes can't be introduced in the Python 2.x series because " +"they would break compatibility. The :mod:`future_builtins` module provides " +"versions of these built-in functions that can be imported when writing 3.0-" +"compatible code." +msgstr "" + +msgid "The functions in this module currently include:" +msgstr "" + +msgid "" +"``ascii(obj)``: equivalent to :func:`repr`. In Python 3.0, :func:`repr` " +"will return a Unicode string, while :func:`ascii` will return a pure ASCII " +"bytestring." +msgstr "" + +msgid "" +"``filter(predicate, iterable)``, ``map(func, iterable1, ...)``: the 3.0 " +"versions return iterators, unlike the 2.x builtins which return lists." +msgstr "" + +msgid "" +"``hex(value)``, ``oct(value)``: instead of calling the :meth:`__hex__` or :" +"meth:`__oct__` methods, these versions will call the :meth:`__index__` " +"method and convert the result to hexadecimal or octal. :func:`oct` will use " +"the new ``0o`` notation for its result." +msgstr "" + +msgid "The :mod:`json` module: JavaScript Object Notation" +msgstr "" + +msgid "" +"The new :mod:`json` module supports the encoding and decoding of Python " +"types in JSON (Javascript Object Notation). JSON is a lightweight " +"interchange format often used in web applications. For more information " +"about JSON, see http://www.json.org." +msgstr "" + +msgid "" +":mod:`json` comes with support for decoding and encoding most built-in " +"Python types. The following example encodes and decodes a dictionary::" +msgstr "" + +msgid "" +"It's also possible to write your own decoders and encoders to support more " +"types. Pretty-printing of the JSON strings is also supported." +msgstr "" + +msgid ":mod:`json` (originally called simplejson) was written by Bob Ippolito." +msgstr "" + +msgid "The :mod:`plistlib` module: A Property-List Parser" +msgstr "" + +msgid "" +"The ``.plist`` format is commonly used on Mac OS X to store basic data types " +"(numbers, strings, lists, and dictionaries) by serializing them into an XML-" +"based format. It resembles the XML-RPC serialization of data types." +msgstr "" + +msgid "" +"Despite being primarily used on Mac OS X, the format has nothing Mac-" +"specific about it and the Python implementation works on any platform that " +"Python supports, so the :mod:`plistlib` module has been promoted to the " +"standard library." +msgstr "" + +msgid "Using the module is simple::" +msgstr "" + +msgid "ctypes Enhancements" +msgstr "" + +msgid "" +"Thomas Heller continued to maintain and enhance the :mod:`ctypes` module." +msgstr "" + +msgid "" +":mod:`ctypes` now supports a :class:`c_bool` datatype that represents the " +"C99 ``bool`` type. (Contributed by David Remahl; :issue:`1649190`.)" +msgstr "" + +msgid "" +"The :mod:`ctypes` string, buffer and array types have improved support for " +"extended slicing syntax, where various combinations of ``(start, stop, " +"step)`` are supplied. (Implemented by Thomas Wouters.)" +msgstr "" + +msgid "" +"All :mod:`ctypes` data types now support :meth:`from_buffer` and :meth:" +"`from_buffer_copy` methods that create a ctypes instance based on a provided " +"buffer object. :meth:`from_buffer_copy` copies the contents of the object, " +"while :meth:`from_buffer` will share the same memory area." +msgstr "" + +msgid "" +"A new calling convention tells :mod:`ctypes` to clear the ``errno`` or Win32 " +"LastError variables at the outset of each wrapped call. (Implemented by " +"Thomas Heller; :issue:`1798`.)" +msgstr "" + +msgid "" +"You can now retrieve the Unix ``errno`` variable after a function call. " +"When creating a wrapped function, you can supply ``use_errno=True`` as a " +"keyword parameter to the :func:`DLL` function and then call the module-level " +"methods :meth:`set_errno` and :meth:`get_errno` to set and retrieve the " +"error value." +msgstr "" + +msgid "" +"The Win32 LastError variable is similarly supported by the :func:`DLL`, :" +"func:`OleDLL`, and :func:`WinDLL` functions. You supply " +"``use_last_error=True`` as a keyword parameter and then call the module-" +"level methods :meth:`set_last_error` and :meth:`get_last_error`." +msgstr "" + +msgid "" +"The :func:`byref` function, used to retrieve a pointer to a ctypes instance, " +"now has an optional *offset* parameter that is a byte count that will be " +"added to the returned pointer." +msgstr "" + +msgid "Improved SSL Support" +msgstr "" + +msgid "" +"Bill Janssen made extensive improvements to Python 2.6's support for the " +"Secure Sockets Layer by adding a new module, :mod:`ssl`, that's built atop " +"the `OpenSSL `__ library. This new module provides " +"more control over the protocol negotiated, the X.509 certificates used, and " +"has better support for writing SSL servers (as opposed to clients) in " +"Python. The existing SSL support in the :mod:`socket` module hasn't been " +"removed and continues to work, though it will be removed in Python 3.0." +msgstr "" + +msgid "" +"To use the new module, you must first create a TCP connection in the usual " +"way and then pass it to the :func:`ssl.wrap_socket` function. It's possible " +"to specify whether a certificate is required, and to obtain certificate info " +"by calling the :meth:`getpeercert` method." +msgstr "" + +msgid "The documentation for the :mod:`ssl` module." +msgstr "" + +msgid "Deprecations and Removals" +msgstr "" + +msgid "" +"String exceptions have been removed. Attempting to use them raises a :exc:" +"`TypeError`." +msgstr "" + +msgid "" +"Changes to the :class:`Exception` interface as dictated by :pep:`352` " +"continue to be made. For 2.6, the :attr:`!message` attribute is being " +"deprecated in favor of the :attr:`~BaseException.args` attribute." +msgstr "" + +msgid "" +"(3.0-warning mode) Python 3.0 will feature a reorganized standard library " +"that will drop many outdated modules and rename others. Python 2.6 running " +"in 3.0-warning mode will warn about these modules when they are imported." +msgstr "" + +msgid "" +"The list of deprecated modules is: :mod:`!audiodev`, :mod:`!bgenlocations`, :" +"mod:`!buildtools`, :mod:`!bundlebuilder`, :mod:`!Canvas`, :mod:`!compiler`, :" +"mod:`!dircache`, :mod:`!dl`, :mod:`!fpformat`, :mod:`!gensuitemodule`, :mod:" +"`!ihooks`, :mod:`!imageop`, :mod:`!imgfile`, :mod:`!linuxaudiodev`, :mod:`!" +"mhlib`, :mod:`!mimetools`, :mod:`!multifile`, :mod:`!new`, :mod:`!pure`, :" +"mod:`!statvfs`, :mod:`!sunaudiodev`, :mod:`!test.testall`, and :mod:`!" +"toaiff`." +msgstr "" + +msgid "The :mod:`!gopherlib` module has been removed." +msgstr "" + +msgid "" +"The :mod:`!MimeWriter` module and :mod:`!mimify` module have been " +"deprecated; use the :mod:`email` package instead." +msgstr "" + +msgid "" +"The :mod:`!md5` module has been deprecated; use the :mod:`hashlib` module " +"instead." +msgstr "" + +msgid "" +"The :mod:`!posixfile` module has been deprecated; :func:`fcntl.lockf` " +"provides better locking." +msgstr "" + +msgid "" +"The :mod:`!popen2` module has been deprecated; use the :mod:`subprocess` " +"module." +msgstr "" + +msgid "The :mod:`!rgbimg` module has been removed." +msgstr "" + +msgid "" +"The :mod:`!sets` module has been deprecated; it's better to use the built-" +"in :class:`set` and :class:`frozenset` types." +msgstr "" + +msgid "" +"The :mod:`!sha` module has been deprecated; use the :mod:`hashlib` module " +"instead." +msgstr "" + +msgid "Build and C API Changes" +msgstr "" + +msgid "Changes to Python's build process and to the C API include:" +msgstr "" + +msgid "" +"Python now must be compiled with C89 compilers (after 19 years!). This " +"means that the Python source tree has dropped its own implementations of :c:" +"func:`!memmove` and :c:func:`!strerror`, which are in the C89 standard " +"library." +msgstr "" + +msgid "" +"Python 2.6 can be built with Microsoft Visual Studio 2008 (version 9.0), and " +"this is the new default compiler. See the :file:`PCbuild` directory for the " +"build files. (Implemented by Christian Heimes.)" +msgstr "" + +msgid "" +"On Mac OS X, Python 2.6 can be compiled as a 4-way universal build. The :" +"program:`configure` script can take a :option:`!--with-universal-archs=[32-" +"bit|64-bit|all]` switch, controlling whether the binaries are built for 32-" +"bit architectures (x86, PowerPC), 64-bit (x86-64 and PPC-64), or both. " +"(Contributed by Ronald Oussoren.)" +msgstr "" + +msgid "" +"A new function added in Python 2.6.6, :c:func:`!PySys_SetArgvEx`, sets the " +"value of ``sys.argv`` and can optionally update ``sys.path`` to include the " +"directory containing the script named by ``sys.argv[0]`` depending on the " +"value of an *updatepath* parameter." +msgstr "" + +msgid "" +"This function was added to close a security hole for applications that embed " +"Python. The old function, :c:func:`!PySys_SetArgv`, would always update " +"``sys.path``, and sometimes it would add the current directory. This meant " +"that, if you ran an application embedding Python in a directory controlled " +"by someone else, attackers could put a Trojan-horse module in the directory " +"(say, a file named :file:`os.py`) that your application would then import " +"and run." +msgstr "" + +msgid "" +"If you maintain a C/C++ application that embeds Python, check whether you're " +"calling :c:func:`!PySys_SetArgv` and carefully consider whether the " +"application should be using :c:func:`!PySys_SetArgvEx` with *updatepath* set " +"to false. Note that using this function will break compatibility with " +"Python versions 2.6.5 and earlier; if you have to continue working with " +"earlier versions, you can leave the call to :c:func:`!PySys_SetArgv` alone " +"and call ``PyRun_SimpleString(\"sys.path.pop(0)\\n\")`` afterwards to " +"discard the first ``sys.path`` component." +msgstr "" + +msgid "" +"Security issue reported as `CVE-2008-5983 `_; discussed in :gh:`50003`, and fixed by " +"Antoine Pitrou." +msgstr "" + +msgid "" +"The BerkeleyDB module now has a C API object, available as ``bsddb.db." +"api``. This object can be used by other C extensions that wish to use the :" +"mod:`bsddb` module for their own purposes. (Contributed by Duncan Grisby.)" +msgstr "" + +msgid "" +"The new buffer interface, previously described in `the PEP 3118 section " +"<#pep-3118-revised-buffer-protocol>`__, adds :c:func:`PyObject_GetBuffer` " +"and :c:func:`PyBuffer_Release`, as well as a few other functions." +msgstr "" + +msgid "" +"Python's use of the C stdio library is now thread-safe, or at least as " +"thread-safe as the underlying library is. A long-standing potential bug " +"occurred if one thread closed a file object while another thread was reading " +"from or writing to the object. In 2.6 file objects have a reference count, " +"manipulated by the :c:func:`!PyFile_IncUseCount` and :c:func:`!" +"PyFile_DecUseCount` functions. File objects can't be closed unless the " +"reference count is zero. :c:func:`!PyFile_IncUseCount` should be called " +"while the GIL is still held, before carrying out an I/O operation using the " +"``FILE *`` pointer, and :c:func:`!PyFile_DecUseCount` should be called " +"immediately after the GIL is re-acquired. (Contributed by Antoine Pitrou and " +"Gregory P. Smith.)" +msgstr "" + +msgid "" +"Importing modules simultaneously in two different threads no longer " +"deadlocks; it will now raise an :exc:`ImportError`. A new API function, :c:" +"func:`PyImport_ImportModuleNoBlock`, will look for a module in ``sys." +"modules`` first, then try to import it after acquiring an import lock. If " +"the import lock is held by another thread, an :exc:`ImportError` is raised. " +"(Contributed by Christian Heimes.)" +msgstr "" + +msgid "" +"Several functions return information about the platform's floating-point " +"support. :c:func:`PyFloat_GetMax` returns the maximum representable " +"floating point value, and :c:func:`PyFloat_GetMin` returns the minimum " +"positive value. :c:func:`PyFloat_GetInfo` returns an object containing more " +"information from the :file:`float.h` file, such as ``\"mant_dig\"`` (number " +"of digits in the mantissa), ``\"epsilon\"`` (smallest difference between 1.0 " +"and the next largest value representable), and several others. (Contributed " +"by Christian Heimes; :issue:`1534`.)" +msgstr "" + +msgid "" +"C functions and methods that use :c:func:`PyComplex_AsCComplex` will now " +"accept arguments that have a :meth:`__complex__` method. In particular, the " +"functions in the :mod:`cmath` module will now accept objects with this " +"method. This is a backport of a Python 3.0 change. (Contributed by Mark " +"Dickinson; :issue:`1675423`.)" +msgstr "" + +msgid "" +"Python's C API now includes two functions for case-insensitive string " +"comparisons, ``PyOS_stricmp(char*, char*)`` and ``PyOS_strnicmp(char*, " +"char*, Py_ssize_t)``. (Contributed by Christian Heimes; :issue:`1635`.)" +msgstr "" + +msgid "" +"Many C extensions define their own little macro for adding integers and " +"strings to the module's dictionary in the ``init*`` function. Python 2.6 " +"finally defines standard macros for adding values to a module, :c:macro:" +"`PyModule_AddStringMacro` and :c:macro:`PyModule_AddIntMacro()`. " +"(Contributed by Christian Heimes.)" +msgstr "" + +msgid "" +"Some macros were renamed in both 3.0 and 2.6 to make it clearer that they " +"are macros, not functions. :c:macro:`!Py_Size()` became :c:macro:" +"`Py_SIZE()`, :c:macro:`!Py_Type()` became :c:macro:`Py_TYPE()`, and :c:macro:" +"`!Py_Refcnt()` became :c:macro:`Py_REFCNT()`. The mixed-case macros are " +"still available in Python 2.6 for backward compatibility. (:issue:`1629`)" +msgstr "" + +msgid "" +"Distutils now places C extensions it builds in a different directory when " +"running on a debug version of Python. (Contributed by Collin Winter; :issue:" +"`1530959`.)" +msgstr "" + +msgid "" +"Several basic data types, such as integers and strings, maintain internal " +"free lists of objects that can be re-used. The data structures for these " +"free lists now follow a naming convention: the variable is always named " +"``free_list``, the counter is always named ``numfree``, and a macro " +"``Py_MAXFREELIST`` is always defined." +msgstr "" + +msgid "" +"A new Makefile target, \"make patchcheck\", prepares the Python source tree " +"for making a patch: it fixes trailing whitespace in all modified ``.py`` " +"files, checks whether the documentation has been changed, and reports " +"whether the :file:`Misc/ACKS` and :file:`Misc/NEWS` files have been updated. " +"(Contributed by Brett Cannon.)" +msgstr "" + +msgid "" +"Another new target, \"make profile-opt\", compiles a Python binary using " +"GCC's profile-guided optimization. It compiles Python with profiling " +"enabled, runs the test suite to obtain a set of profiling results, and then " +"compiles using these results for optimization. (Contributed by Gregory P. " +"Smith.)" +msgstr "" + +msgid "Port-Specific Changes: Windows" +msgstr "" + +msgid "" +"The support for Windows 95, 98, ME and NT4 has been dropped. Python 2.6 " +"requires at least Windows 2000 SP4." +msgstr "" + +msgid "" +"The new default compiler on Windows is Visual Studio 2008 (version 9.0). The " +"build directories for Visual Studio 2003 (version 7.1) and 2005 (version " +"8.0) were moved into the PC/ directory. The new :file:`PCbuild` directory " +"supports cross compilation for X64, debug builds and Profile Guided " +"Optimization (PGO). PGO builds are roughly 10% faster than normal builds. " +"(Contributed by Christian Heimes with help from Amaury Forgeot d'Arc and " +"Martin von Löwis.)" +msgstr "" + +msgid "" +"The :mod:`msvcrt` module now supports both the normal and wide char variants " +"of the console I/O API. The :func:`~msvcrt.getwch` function reads a " +"keypress and returns a Unicode value, as does the :func:`~msvcrt.getwche` " +"function. The :func:`~msvcrt.putwch` function takes a Unicode character and " +"writes it to the console. (Contributed by Christian Heimes.)" +msgstr "" + +msgid "" +":func:`os.path.expandvars` will now expand environment variables in the form " +"\"%var%\", and \"~user\" will be expanded into the user's home directory " +"path. (Contributed by Josiah Carlson; :issue:`957650`.)" +msgstr "" + +msgid "" +"The :mod:`socket` module's socket objects now have an :meth:`~socket.socket." +"ioctl` method that provides a limited interface to the :c:func:`WSAIoctl` " +"system interface." +msgstr "" + +msgid "" +"The :mod:`_winreg ` module now has a function, :func:`~winreg." +"ExpandEnvironmentStrings`, that expands environment variable references such " +"as ``%NAME%`` in an input string. The handle objects provided by this " +"module now support the context protocol, so they can be used in :keyword:" +"`with` statements. (Contributed by Christian Heimes.)" +msgstr "" + +msgid "" +":mod:`_winreg ` also has better support for x64 systems, exposing " +"the :func:`~winreg.DisableReflectionKey`, :func:`~winreg." +"EnableReflectionKey`, and :func:`~winreg.QueryReflectionKey` functions, " +"which enable and disable registry reflection for 32-bit processes running on " +"64-bit systems. (:issue:`1753245`)" +msgstr "" + +msgid "" +"The :mod:`msilib` module's :class:`!Record` object gained :meth:`~msilib." +"Record.GetInteger` and :meth:`~msilib.Record.GetString` methods that return " +"field values as an integer or a string. (Contributed by Floris Bruynooghe; :" +"issue:`2125`.)" +msgstr "" + +msgid "Port-Specific Changes: Mac OS X" +msgstr "" + +msgid "" +"When compiling a framework build of Python, you can now specify the " +"framework name to be used by providing the :option:`!--with-framework-name=` " +"option to the :program:`configure` script." +msgstr "" + +msgid "" +"The :mod:`!macfs` module has been removed. This in turn required the :func:" +"`!macostools.touched` function to be removed because it depended on the :mod:" +"`!macfs` module. (:issue:`1490190`)" +msgstr "" + +msgid "" +"Many other Mac OS modules have been deprecated and will be removed in Python " +"3.0: :mod:`!_builtinSuites`, :mod:`!aepack`, :mod:`!aetools`, :mod:`!" +"aetypes`, :mod:`!applesingle`, :mod:`!appletrawmain`, :mod:`!appletrunner`, :" +"mod:`!argvemulator`, :mod:`!Audio_mac`, :mod:`!autoGIL`, :mod:`!Carbon`, :" +"mod:`!cfmfile`, :mod:`!CodeWarrior`, :mod:`!ColorPicker`, :mod:`!" +"EasyDialogs`, :mod:`!Explorer`, :mod:`!Finder`, :mod:`!FrameWork`, :mod:`!" +"findertools`, :mod:`!ic`, :mod:`!icglue`, :mod:`!icopen`, :mod:`!" +"macerrors`, :mod:`!MacOS`, :mod:`!macfs`, :mod:`!macostools`, :mod:`!" +"macresource`, :mod:`!MiniAEFrame`, :mod:`!Nav`, :mod:`!Netscape`, :mod:`!" +"OSATerminology`, :mod:`!pimp`, :mod:`!PixMapWrapper`, :mod:`!StdSuites`, :" +"mod:`!SystemEvents`, :mod:`!Terminal`, and :mod:`!terminalcommand`." +msgstr "" + +msgid "Port-Specific Changes: IRIX" +msgstr "" + +msgid "" +"A number of old IRIX-specific modules were deprecated and will be removed in " +"Python 3.0: :mod:`!al` and :mod:`!AL`, :mod:`!cd`, :mod:`!cddb`, :mod:`!" +"cdplayer`, :mod:`!CL` and :mod:`!cl`, :mod:`!DEVICE`, :mod:`!ERRNO`, :mod:`!" +"FILE`, :mod:`!FL` and :mod:`!fl`, :mod:`!flp`, :mod:`!fm`, :mod:`!GET`, :mod:" +"`!GLWS`, :mod:`!GL` and :mod:`!gl`, :mod:`!IN`, :mod:`!IOCTL`, :mod:`!" +"jpeg`, :mod:`!panelparser`, :mod:`!readcd`, :mod:`!SV` and :mod:`!sv`, :mod:" +"`!torgb`, :mod:`!videoreader`, and :mod:`!WAIT`." +msgstr "" + +msgid "Porting to Python 2.6" +msgstr "" + +msgid "" +"This section lists previously described changes and other bugfixes that may " +"require changes to your code:" +msgstr "" + +msgid "" +"Classes that aren't supposed to be hashable should set ``__hash__ = None`` " +"in their definitions to indicate the fact." +msgstr "" + +msgid "" +"The :meth:`__init__` method of :class:`collections.deque` now clears any " +"existing contents of the deque before adding elements from the iterable. " +"This change makes the behavior match ``list.__init__()``." +msgstr "" + +msgid "" +":meth:`object.__init__` previously accepted arbitrary arguments and keyword " +"arguments, ignoring them. In Python 2.6, this is no longer allowed and will " +"result in a :exc:`TypeError`. This will affect :meth:`__init__` methods " +"that end up calling the corresponding method on :class:`object` (perhaps " +"through using :func:`super`). See :issue:`1683368` for discussion." +msgstr "" + +msgid "" +"The :class:`Decimal` constructor now accepts leading and trailing whitespace " +"when passed a string. Previously it would raise an :exc:`InvalidOperation` " +"exception. On the other hand, the :meth:`create_decimal` method of :class:" +"`Context` objects now explicitly disallows extra whitespace, raising a :exc:" +"`ConversionSyntax` exception." +msgstr "" + +msgid "" +"Due to an implementation accident, if you passed a file path to the built-" +"in :func:`__import__` function, it would actually import the specified " +"file. This was never intended to work, however, and the implementation now " +"explicitly checks for this case and raises an :exc:`ImportError`." +msgstr "" + +msgid "" +"C API: the :c:func:`PyImport_Import` and :c:func:`PyImport_ImportModule` " +"functions now default to absolute imports, not relative imports. This will " +"affect C extensions that import other modules." +msgstr "" + +msgid "" +"C API: extension data types that shouldn't be hashable should define their " +"``tp_hash`` slot to :c:func:`PyObject_HashNotImplemented`." +msgstr "" + +msgid "" +"The :mod:`socket` module exception :exc:`socket.error` now inherits from :" +"exc:`IOError`. Previously it wasn't a subclass of :exc:`StandardError` but " +"now it is, through :exc:`IOError`. (Implemented by Gregory P. Smith; :issue:" +"`1706815`.)" +msgstr "" + +msgid "" +"The :mod:`xmlrpclib ` module no longer automatically " +"converts :class:`datetime.date` and :class:`datetime.time` to the :class:" +"`xmlrpclib.DateTime ` type; the conversion semantics " +"were not necessarily correct for all applications. Code using :mod:`!" +"xmlrpclib` should convert :class:`date` and :class:`~datetime.time` " +"instances. (:issue:`1330538`)" +msgstr "" + +msgid "" +"(3.0-warning mode) The :class:`Exception` class now warns when accessed " +"using slicing or index access; having :class:`Exception` behave like a tuple " +"is being phased out." +msgstr "" + +msgid "" +"(3.0-warning mode) inequality comparisons between two dictionaries or two " +"objects that don't implement comparison methods are reported as warnings. " +"``dict1 == dict2`` still works, but ``dict1 < dict2`` is being phased out." +msgstr "" + +msgid "" +"Comparisons between cells, which are an implementation detail of Python's " +"scoping rules, also cause warnings because such comparisons are forbidden " +"entirely in 3.0." +msgstr "" + +msgid "For applications that embed Python:" +msgstr "" + +msgid "" +"The :c:func:`!PySys_SetArgvEx` function was added in Python 2.6.6, letting " +"applications close a security hole when the existing :c:func:`!" +"PySys_SetArgv` function was used. Check whether you're calling :c:func:`!" +"PySys_SetArgv` and carefully consider whether the application should be " +"using :c:func:`!PySys_SetArgvEx` with *updatepath* set to false." +msgstr "" + +msgid "Acknowledgements" +msgstr "" + +msgid "" +"The author would like to thank the following people for offering " +"suggestions, corrections and assistance with various drafts of this article: " +"Georg Brandl, Steve Brown, Nick Coghlan, Ralph Corderoy, Jim Jewett, Kent " +"Johnson, Chris Lambacher, Martin Michlmayr, Antoine Pitrou, Brian Warner." +msgstr "" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "What's new" +msgstr "" diff --git a/whatsnew/3.0.po b/whatsnew/3.0.po index bc39419c46..46d748346a 100644 --- a/whatsnew/3.0.po +++ b/whatsnew/3.0.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2021, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.10\n" +"Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-06-29 12:56+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" -"Language-Team: Polish (https://www.transifex.com/python-doc/teams/5390/pl/)\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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" @@ -36,11 +35,12 @@ msgstr "" msgid "" "This article explains the new features in Python 3.0, compared to 2.6. " "Python 3.0, also known as \"Python 3000\" or \"Py3K\", is the first ever " -"*intentionally backwards incompatible* Python release. There are more " -"changes than in a typical release, and more that are important for all " -"Python users. Nevertheless, after digesting the changes, you'll find that " -"Python really hasn't changed all that much -- by and large, we're mostly " -"fixing well-known annoyances and warts, and removing a lot of old cruft." +"*intentionally backwards incompatible* Python release. Python 3.0 was " +"released on December 3, 2008. There are more changes than in a typical " +"release, and more that are important for all Python users. Nevertheless, " +"after digesting the changes, you'll find that Python really hasn't changed " +"all that much -- by and large, we're mostly fixing well-known annoyances and " +"warts, and removing a lot of old cruft." msgstr "" msgid "" @@ -84,7 +84,7 @@ msgid "which produces:" msgstr "" msgid "Note:" -msgstr "" +msgstr "Uwaga:" msgid "" "The :func:`print` function doesn't support the \"softspace\" feature of the " @@ -343,9 +343,9 @@ msgid "" msgstr "" msgid "" -"The :mod:`StringIO` and :mod:`cStringIO` modules are gone. Instead, import " -"the :mod:`io` module and use :class:`io.StringIO` or :class:`io.BytesIO` for " -"text and data respectively." +"The :mod:`!StringIO` and :mod:`!cStringIO` modules are gone. Instead, " +"import the :mod:`io` module and use :class:`io.StringIO` or :class:`io." +"BytesIO` for text and data respectively." msgstr "" msgid "See also the :ref:`unicode-howto`, which was updated for Python 3.0." @@ -544,10 +544,10 @@ msgid "" msgstr "" msgid ":ref:`pep-0370`." -msgstr "" +msgstr ":ref:`pep-0370`." msgid ":ref:`pep-0371`." -msgstr "" +msgstr ":ref:`pep-0371`." msgid "" ":ref:`pep-3101`. Note: the 2.6 description mentions the :meth:`format` " @@ -604,7 +604,7 @@ msgid "" msgstr "" msgid ":ref:`pep-3129`." -msgstr "" +msgstr ":ref:`pep-3129`." msgid "" ":ref:`pep-3141`. The :mod:`numbers` module is another new use of ABCs, " @@ -622,16 +622,16 @@ msgid "" msgstr "" msgid "" -"Many old modules were removed. Some, like :mod:`gopherlib` (no longer used) " -"and :mod:`md5` (replaced by :mod:`hashlib`), were already deprecated by :pep:" -"`4`. Others were removed as a result of the removal of support for various " -"platforms such as Irix, BeOS and Mac OS 9 (see :pep:`11`). Some modules " -"were also selected for removal in Python 3.0 due to lack of use or because a " -"better replacement exists. See :pep:`3108` for an exhaustive list." +"Many old modules were removed. Some, like :mod:`!gopherlib` (no longer " +"used) and :mod:`!md5` (replaced by :mod:`hashlib`), were already deprecated " +"by :pep:`4`. Others were removed as a result of the removal of support for " +"various platforms such as Irix, BeOS and Mac OS 9 (see :pep:`11`). Some " +"modules were also selected for removal in Python 3.0 due to lack of use or " +"because a better replacement exists. See :pep:`3108` for an exhaustive list." msgstr "" msgid "" -"The :mod:`bsddb3` package was removed because its presence in the core " +"The :mod:`!bsddb3` package was removed because its presence in the core " "standard library has proved over time to be a particular burden for the core " "developers due to testing instability and Berkeley DB's release schedule. " "However, the package is alive and well, externally maintained at https://www." @@ -700,14 +700,14 @@ msgstr "" msgid "" "A common pattern in Python 2.x is to have one version of a module " "implemented in pure Python, with an optional accelerated version implemented " -"as a C extension; for example, :mod:`pickle` and :mod:`cPickle`. This " +"as a C extension; for example, :mod:`pickle` and :mod:`!cPickle`. This " "places the burden of importing the accelerated version and falling back on " "the pure Python version on each user of these modules. In Python 3.0, the " "accelerated versions are considered implementation details of the pure " "Python versions. Users should always import the standard version, which " "attempts to import the accelerated version and falls back to the pure Python " -"version. The :mod:`pickle` / :mod:`cPickle` pair received this treatment. " -"The :mod:`profile` module is on the list for 3.1. The :mod:`StringIO` " +"version. The :mod:`pickle` / :mod:`!cPickle` pair received this treatment. " +"The :mod:`profile` module is on the list for 3.1. The :mod:`!StringIO` " "module has been turned into a class in the :mod:`io` module." msgstr "" @@ -717,16 +717,16 @@ msgid "" msgstr "" msgid "" -":mod:`dbm` (:mod:`anydbm`, :mod:`dbhash`, :mod:`dbm`, :mod:`dumbdbm`, :mod:" -"`gdbm`, :mod:`whichdb`)." +":mod:`dbm` (:mod:`!anydbm`, :mod:`!dbhash`, :mod:`!dbm`, :mod:`!dumbdbm`, :" +"mod:`!gdbm`, :mod:`!whichdb`)." msgstr "" -msgid ":mod:`html` (:mod:`HTMLParser`, :mod:`htmlentitydefs`)." +msgid ":mod:`html` (:mod:`!HTMLParser`, :mod:`!htmlentitydefs`)." msgstr "" msgid "" -":mod:`http` (:mod:`httplib`, :mod:`BaseHTTPServer`, :mod:`CGIHTTPServer`, :" -"mod:`SimpleHTTPServer`, :mod:`Cookie`, :mod:`cookielib`)." +":mod:`http` (:mod:`!httplib`, :mod:`!BaseHTTPServer`, :mod:`!" +"CGIHTTPServer`, :mod:`!SimpleHTTPServer`, :mod:`!Cookie`, :mod:`!cookielib`)." msgstr "" msgid "" @@ -737,20 +737,20 @@ msgid "" msgstr "" msgid "" -":mod:`urllib` (:mod:`urllib`, :mod:`urllib2`, :mod:`urlparse`, :mod:" -"`robotparse`)." +":mod:`urllib` (:mod:`!urllib`, :mod:`!urllib2`, :mod:`!urlparse`, :mod:`!" +"robotparse`)." msgstr "" msgid "" -":mod:`xmlrpc` (:mod:`xmlrpclib`, :mod:`DocXMLRPCServer`, :mod:" -"`SimpleXMLRPCServer`)." +":mod:`xmlrpc` (:mod:`!xmlrpclib`, :mod:`!DocXMLRPCServer`, :mod:`!" +"SimpleXMLRPCServer`)." msgstr "" msgid "" "Some other changes to standard library modules, not covered by :pep:`3108`:" msgstr "" -msgid "Killed :mod:`sets`. Use the built-in :func:`set` class." +msgid "Killed :mod:`!sets`. Use the built-in :func:`set` class." msgstr "" msgid "" @@ -772,14 +772,15 @@ msgid "" msgstr "" msgid "" -"Cleanup of the :mod:`thread` module: :func:`acquire_lock` and :func:" -"`release_lock` are gone; use :func:`acquire` and :func:`release` instead." +"Cleanup of the :mod:`!thread` module: :func:`!acquire_lock` and :func:`!" +"release_lock` are gone; use :meth:`~threading.Lock.acquire` and :meth:" +"`~threading.Lock.release` instead." msgstr "" msgid "Cleanup of the :mod:`random` module: removed the :func:`jumpahead` API." msgstr "" -msgid "The :mod:`new` module is gone." +msgid "The :mod:`!new` module is gone." msgstr "" msgid "" @@ -797,7 +798,7 @@ msgid "" "`string.uppercase`) are gone. Use :data:`string.ascii_letters` etc. " "instead. (The reason for the removal is that :data:`string.letters` and " "friends had locale-specific behavior, which is a bad idea for such " -"attractively-named global \"constants\".)" +"attractively named global \"constants\".)" msgstr "" msgid "" @@ -854,8 +855,8 @@ msgid "" ":pep:`3109`: Raising exceptions. You must now use :samp:`raise {Exception}" "({args})` instead of :samp:`raise {Exception}, {args}`. Additionally, you " "can no longer explicitly specify a traceback; instead, if you *have* to do " -"this, you can assign directly to the :attr:`__traceback__` attribute (see " -"below)." +"this, you can assign directly to the :attr:`~BaseException.__traceback__` " +"attribute (see below)." msgstr "" msgid "" @@ -871,26 +872,27 @@ msgid "" "an :keyword:`except` or :keyword:`finally` handler block. This usually " "happens due to a bug in the handler block; we call this a *secondary* " "exception. In this case, the original exception (that was being handled) is " -"saved as the :attr:`__context__` attribute of the secondary exception. " -"Explicit chaining is invoked with this syntax::" +"saved as the :attr:`~BaseException.__context__` attribute of the secondary " +"exception. Explicit chaining is invoked with this syntax::" msgstr "" msgid "" "(where *primary_exception* is any expression that produces an exception " "object, probably an exception that was previously caught). In this case, the " -"primary exception is stored on the :attr:`__cause__` attribute of the " -"secondary exception. The traceback printed when an unhandled exception " -"occurs walks the chain of :attr:`__cause__` and :attr:`__context__` " -"attributes and prints a separate traceback for each component of the chain, " -"with the primary exception at the top. (Java users may recognize this " -"behavior.)" +"primary exception is stored on the :attr:`~BaseException.__cause__` " +"attribute of the secondary exception. The traceback printed when an " +"unhandled exception occurs walks the chain of :attr:`!__cause__` and :attr:" +"`~BaseException.__context__` attributes and prints a separate traceback for " +"each component of the chain, with the primary exception at the top. (Java " +"users may recognize this behavior.)" msgstr "" msgid "" ":pep:`3134`: Exception objects now store their traceback as the :attr:" -"`__traceback__` attribute. This means that an exception object now contains " -"all the information pertaining to an exception, and there are fewer reasons " -"to use :func:`sys.exc_info` (though the latter is not removed)." +"`~BaseException.__traceback__` attribute. This means that an exception " +"object now contains all the information pertaining to an exception, and " +"there are fewer reasons to use :func:`sys.exc_info` (though the latter is " +"not removed)." msgstr "" msgid "" @@ -938,16 +940,17 @@ msgid "Removed support for :attr:`__members__` and :attr:`__methods__`." msgstr "" msgid "" -"The function attributes named :attr:`func_X` have been renamed to use the :" -"data:`__X__` form, freeing up these names in the function attribute " -"namespace for user-defined attributes. To wit, :attr:`func_closure`, :attr:" -"`func_code`, :attr:`func_defaults`, :attr:`func_dict`, :attr:`func_doc`, :" -"attr:`func_globals`, :attr:`func_name` were renamed to :attr:`__closure__`, :" -"attr:`__code__`, :attr:`__defaults__`, :attr:`~object.__dict__`, :attr:" -"`__doc__`, :attr:`__globals__`, :attr:`~definition.__name__`, respectively." +"The function attributes named :attr:`!func_X` have been renamed to use the :" +"attr:`!__X__` form, freeing up these names in the function attribute " +"namespace for user-defined attributes. To wit, :attr:`!func_closure`, :attr:" +"`!func_code`, :attr:`!func_defaults`, :attr:`!func_dict`, :attr:`!" +"func_doc`, :attr:`!func_globals`, :attr:`!func_name` were renamed to :attr:" +"`~function.__closure__`, :attr:`~function.__code__`, :attr:`~function." +"__defaults__`, :attr:`~function.__dict__`, :attr:`~function.__doc__`, :attr:" +"`~function.__globals__`, :attr:`~function.__name__`, respectively." msgstr "" -msgid ":meth:`__nonzero__` is now :meth:`__bool__`." +msgid ":meth:`!__nonzero__` is now :meth:`~object.__bool__`." msgstr "" msgid "Builtins" @@ -1051,8 +1054,8 @@ msgid "No more C API support for restricted execution." msgstr "" msgid "" -":c:func:`PyNumber_Coerce`, :c:func:`PyNumber_CoerceEx`, :c:func:" -"`PyMember_Get`, and :c:func:`PyMember_Set` C APIs are removed." +":c:func:`!PyNumber_Coerce`, :c:func:`!PyNumber_CoerceEx`, :c:func:`!" +"PyMember_Get`, and :c:func:`!PyMember_Set` C APIs are removed." msgstr "" msgid "" @@ -1067,7 +1070,8 @@ msgid "" msgstr "" msgid "" -"Removed :c:macro:`METH_OLDARGS` and :c:macro:`WITH_CYCLE_GC` from the C API." +"Removed :c:macro:`!METH_OLDARGS` and :c:macro:`!WITH_CYCLE_GC` from the C " +"API." msgstr "" msgid "Performance" diff --git a/whatsnew/3.1.po b/whatsnew/3.1.po index a471e2f219..31758ea362 100644 --- a/whatsnew/3.1.po +++ b/whatsnew/3.1.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -77,6 +76,17 @@ msgid "" "by Raymond Hettinger." msgstr "" +msgid "" +"Since an ordered dictionary remembers its insertion order, it can be used in " +"conjunction with sorting to make a sorted dictionary::" +msgstr "" + +msgid "" +"The new sorted dictionaries maintain their sort order when entries are " +"deleted. But when new keys are added, the keys are appended to the end and " +"the sort is not maintained." +msgstr "" + msgid "PEP 378: Format Specifier for Thousands Separator" msgstr "" @@ -144,7 +154,7 @@ msgid "(Contributed by Eric Smith; :issue:`5237`.)" msgstr "" msgid "" -"The :func:`string.maketrans` function is deprecated and is replaced by new " +"The :func:`!string.maketrans` function is deprecated and is replaced by new " "static methods, :meth:`bytes.maketrans` and :meth:`bytearray.maketrans`. " "This change solves the confusion around which types were supported by the :" "mod:`string` module. Now, :class:`str`, :class:`bytes`, and :class:" @@ -161,7 +171,7 @@ msgid "" msgstr "" msgid "" -"With the new syntax, the :func:`contextlib.nested` function is no longer " +"With the new syntax, the :func:`!contextlib.nested` function is no longer " "needed and is now deprecated." msgstr "" @@ -359,22 +369,24 @@ msgid "" msgstr "" msgid "" -"In addition, several new assertion methods were added including :func:" -"`assertSetEqual`, :func:`assertDictEqual`, :func:" -"`assertDictContainsSubset`, :func:`assertListEqual`, :func:" -"`assertTupleEqual`, :func:`assertSequenceEqual`, :func:" -"`assertRaisesRegexp`, :func:`assertIsNone`, and :func:`assertIsNotNone`." +"In addition, several new assertion methods were added including :meth:" +"`~unittest.TestCase.assertSetEqual`, :meth:`~unittest.TestCase." +"assertDictEqual`, :meth:`!assertDictContainsSubset`, :meth:`~unittest." +"TestCase.assertListEqual`, :meth:`~unittest.TestCase.assertTupleEqual`, :" +"meth:`~unittest.TestCase.assertSequenceEqual`, :meth:`assertRaisesRegexp() " +"`, :meth:`~unittest.TestCase." +"assertIsNone`, and :meth:`~unittest.TestCase.assertIsNotNone`." msgstr "" msgid "(Contributed by Benjamin Peterson and Antoine Pitrou.)" msgstr "" msgid "" -"The :mod:`io` module has three new constants for the :meth:`seek` method :" -"data:`SEEK_SET`, :data:`SEEK_CUR`, and :data:`SEEK_END`." +"The :mod:`io` module has three new constants for the :meth:`~io.IOBase.seek` " +"method: :data:`~os.SEEK_SET`, :data:`~os.SEEK_CUR`, and :data:`~os.SEEK_END`." msgstr "" -msgid "The :attr:`sys.version_info` tuple is now a named tuple::" +msgid "The :data:`sys.version_info` tuple is now a named tuple::" msgstr "" msgid "(Contributed by Ross Light; :issue:`4285`.)" @@ -490,7 +502,7 @@ msgid "(Contributed by Jake McGuire and Antoine Pitrou; :issue:`5084`.)" msgstr "" msgid "IDLE" -msgstr "" +msgstr "IDLE" msgid "" "IDLE's format menu now provides an option to strip trailing whitespace from " @@ -520,7 +532,7 @@ msgstr "" msgid "" "Apart from the performance improvements this change should be invisible to " "end users, with one exception: for testing and debugging purposes there's a " -"new :attr:`sys.int_info` that provides information about the internal " +"new :data:`sys.int_info` that provides information about the internal " "format, giving the number of bits per digit and the size in bytes of the C " "type used to store each digit::" msgstr "" @@ -537,7 +549,7 @@ msgid "(Contributed by Mark Dickinson and Lisandro Dalcrin; :issue:`5175`.)" msgstr "" msgid "" -"Deprecated :c:func:`PyNumber_Int`. Use :c:func:`PyNumber_Long` instead." +"Deprecated :c:func:`!PyNumber_Int`. Use :c:func:`PyNumber_Long` instead." msgstr "" msgid "(Contributed by Mark Dickinson; :issue:`4910`.)" @@ -545,15 +557,15 @@ msgstr "" msgid "" "Added a new :c:func:`PyOS_string_to_double` function to replace the " -"deprecated functions :c:func:`PyOS_ascii_strtod` and :c:func:" -"`PyOS_ascii_atof`." +"deprecated functions :c:func:`!PyOS_ascii_strtod` and :c:func:`!" +"PyOS_ascii_atof`." msgstr "" msgid "(Contributed by Mark Dickinson; :issue:`5914`.)" msgstr "" msgid "" -"Added :c:type:`PyCapsule` as a replacement for the :c:type:`PyCObject` API. " +"Added :c:type:`PyCapsule` as a replacement for the :c:type:`!PyCObject` API. " "The principal difference is that the new type has a well defined interface " "for passing typing safety information and a less complicated signature for " "calling a destructor. The old type had a problematic API and is now " diff --git a/whatsnew/3.10.po b/whatsnew/3.10.po index 950335ae4f..69f036de48 100644 --- a/whatsnew/3.10.po +++ b/whatsnew/3.10.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -302,14 +301,15 @@ msgid "" msgstr "" msgid "" -"The ``f_lineno`` attribute of frame objects will always contain the expected " -"line number." +"The :attr:`~frame.f_lineno` attribute of frame objects will always contain " +"the expected line number." msgstr "" msgid "" -"The ``co_lnotab`` attribute of code objects is deprecated and will be " -"removed in 3.12. Code that needs to convert from offset to line number " -"should use the new ``co_lines()`` method instead." +"The :attr:`~codeobject.co_lnotab` attribute of :ref:`code objects ` is deprecated and will be removed in 3.12. Code that needs to " +"convert from offset to line number should use the new :meth:`~codeobject." +"co_lines` method instead." msgstr "" msgid "PEP 634: Structural Pattern Matching" @@ -717,9 +717,9 @@ msgid "" msgstr "" msgid "" -"If :func:`object.__ipow__` returns :const:`NotImplemented`, the operator " -"will correctly fall back to :func:`object.__pow__` and :func:`object." -"__rpow__` as expected. (Contributed by Alex Shkop in :issue:`38302`.)" +"If :func:`object.__ipow__` returns :data:`NotImplemented`, the operator will " +"correctly fall back to :func:`object.__pow__` and :func:`object.__rpow__` as " +"expected. (Contributed by Alex Shkop in :issue:`38302`.)" msgstr "" msgid "" @@ -791,7 +791,7 @@ msgstr "" msgid "" "A :exc:`SyntaxError` (instead of a :exc:`NameError`) will be raised when " -"deleting the :const:`__debug__` constant. (Contributed by Dong-hee Na in :" +"deleting the :const:`__debug__` constant. (Contributed by Donghee Na in :" "issue:`45000`.)" msgstr "" @@ -804,11 +804,11 @@ msgstr "" msgid "New Modules" msgstr "" -msgid "None yet." +msgid "None." msgstr "" msgid "Improved Modules" -msgstr "" +msgstr "Ulepszone moduły" msgid "asyncio" msgstr "" @@ -937,7 +937,7 @@ msgid "dataclasses" msgstr "" msgid "__slots__" -msgstr "" +msgstr "__slots__" msgid "" "Added ``slots`` parameter in :func:`dataclasses.dataclass` decorator. " @@ -1234,9 +1234,9 @@ msgid "" msgstr "" msgid "" -"Add :data:`~os.O_EVTONLY`, :data:`~os.O_FSYNC`, :data:`~os.O_SYMLINK` and :" -"data:`~os.O_NOFOLLOW_ANY` for macOS. (Contributed by Dong-hee Na in :issue:" -"`43106`.)" +"Add :const:`~os.O_EVTONLY`, :const:`~os.O_FSYNC`, :const:`~os.O_SYMLINK` " +"and :const:`~os.O_NOFOLLOW_ANY` for macOS. (Contributed by Donghee Na in :" +"issue:`43106`.)" msgstr "" msgid "os.path" @@ -1311,8 +1311,8 @@ msgstr "" msgid "" "Add an ``end_lineno`` attribute to the ``Function`` and ``Class`` objects in " -"the tree returned by :func:`pyclbr.readline` and :func:`pyclbr." -"readline_ex`. It matches the existing (start) ``lineno``. (Contributed by " +"the tree returned by :func:`pyclbr.readmodule` and :func:`pyclbr." +"readmodule_ex`. It matches the existing (start) ``lineno``. (Contributed by " "Aviral Srivastava in :issue:`38307`.)" msgstr "" @@ -1320,9 +1320,9 @@ msgid "shelve" msgstr "" msgid "" -"The :mod:`shelve` module now uses :data:`pickle.DEFAULT_PROTOCOL` by default " -"instead of :mod:`pickle` protocol ``3`` when creating shelves. (Contributed " -"by Zackery Spytz in :issue:`34204`.)" +"The :mod:`shelve` module now uses :const:`pickle.DEFAULT_PROTOCOL` by " +"default instead of :mod:`pickle` protocol ``3`` when creating shelves. " +"(Contributed by Zackery Spytz in :issue:`34204`.)" msgstr "" msgid "statistics" @@ -1365,7 +1365,7 @@ msgstr "" msgid "" "The ssl module has preliminary support for OpenSSL 3.0.0 and new option :" -"data:`~ssl.OP_IGNORE_UNEXPECTED_EOF`. (Contributed by Christian Heimes in :" +"const:`~ssl.OP_IGNORE_UNEXPECTED_EOF`. (Contributed by Christian Heimes in :" "issue:`38820`, :issue:`43794`, :issue:`43788`, :issue:`43791`, :issue:" "`43799`, :issue:`43920`, :issue:`43789`, and :issue:`43811`.)" msgstr "" @@ -1406,7 +1406,7 @@ msgid "" msgstr "" msgid "" -"A new verify flag :data:`~ssl.VERIFY_X509_PARTIAL_CHAIN` has been added. " +"A new verify flag :const:`~ssl.VERIFY_X509_PARTIAL_CHAIN` has been added. " "(Contributed by l0x in :issue:`40849`.)" msgstr "" @@ -1438,7 +1438,7 @@ msgstr "" msgid "" ":func:`_thread.interrupt_main` now takes an optional signal number to " -"simulate (the default is still :data:`signal.SIGINT`). (Contributed by " +"simulate (the default is still :const:`signal.SIGINT`). (Contributed by " "Antoine Pitrou in :issue:`43356`.)" msgstr "" @@ -1559,6 +1559,15 @@ msgid "" "in :issue:`42967`.)" msgstr "" +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates :rfc:" +"`3986`, ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are " +"stripped from the URL by the parser in :mod:`urllib.parse` preventing such " +"attacks. The removal characters are controlled by a new module level " +"variable ``urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" + msgid "xml" msgstr "" @@ -1653,7 +1662,7 @@ msgstr "" msgid "" "The following built-in functions now support the faster :pep:`590` " "vectorcall calling convention: :func:`map`, :func:`filter`, :func:" -"`reversed`, :func:`bool` and :func:`float`. (Contributed by Dong-hee Na and " +"`reversed`, :func:`bool` and :func:`float`. (Contributed by Donghee Na and " "Jeroen Demeyer in :issue:`43575`, :issue:`43287`, :issue:`41922`, :issue:" "`41873` and :issue:`41870`.)" msgstr "" @@ -1812,29 +1821,30 @@ msgid "The following ``threading`` methods are now deprecated:" msgstr "" msgid "``threading.currentThread`` => :func:`threading.current_thread`" -msgstr "" +msgstr "``threading.currentThread`` => :func:`threading.current_thread`" msgid "``threading.activeCount`` => :func:`threading.active_count`" -msgstr "" +msgstr "``threading.activeCount`` => :func:`threading.active_count`" msgid "" "``threading.Condition.notifyAll`` => :meth:`threading.Condition.notify_all`" msgstr "" +"``threading.Condition.notifyAll`` => :meth:`threading.Condition.notify_all`" msgid "``threading.Event.isSet`` => :meth:`threading.Event.is_set`" -msgstr "" +msgstr "``threading.Event.isSet`` => :meth:`threading.Event.is_set`" msgid "``threading.Thread.setName`` => :attr:`threading.Thread.name`" -msgstr "" +msgstr "``threading.Thread.setName`` => :attr:`threading.Thread.name`" msgid "``threading.thread.getName`` => :attr:`threading.Thread.name`" -msgstr "" +msgstr "``threading.thread.getName`` => :attr:`threading.Thread.name`" msgid "``threading.Thread.isDaemon`` => :attr:`threading.Thread.daemon`" -msgstr "" +msgstr "``threading.Thread.isDaemon`` => :attr:`threading.Thread.daemon`" msgid "``threading.Thread.setDaemon`` => :attr:`threading.Thread.daemon`" -msgstr "" +msgstr "``threading.Thread.setDaemon`` => :attr:`threading.Thread.daemon`" msgid "(Contributed by Jelle Zijlstra in :gh:`87889`.)" msgstr "" @@ -1865,9 +1875,9 @@ msgstr "" msgid "" ":data:`~ssl.PROTOCOL_SSLv2`, :data:`~ssl.PROTOCOL_SSLv3`, :data:`~ssl." "PROTOCOL_SSLv23`, :data:`~ssl.PROTOCOL_TLSv1`, :data:`~ssl." -"PROTOCOL_TLSv1_1`, :data:`~ssl.PROTOCOL_TLSv1_2`, and :data:`~ssl." -"PROTOCOL_TLS` are deprecated in favor of :data:`~ssl.PROTOCOL_TLS_CLIENT` " -"and :data:`~ssl.PROTOCOL_TLS_SERVER`" +"PROTOCOL_TLSv1_1`, :data:`~ssl.PROTOCOL_TLSv1_2`, and :const:`~ssl." +"PROTOCOL_TLS` are deprecated in favor of :const:`~ssl.PROTOCOL_TLS_CLIENT` " +"and :const:`~ssl.PROTOCOL_TLS_SERVER`" msgstr "" msgid "" @@ -1944,14 +1954,13 @@ msgid "" "somewhat obsolete, little used, and not tested. It was originally scheduled " "to be removed in Python 3.6, but such removals were delayed until after " "Python 2.7 EOL. Existing users should copy whatever classes they use into " -"their code. (Contributed by Dong-hee Na and Terry J. Reedy in :issue:" -"`42299`.)" +"their code. (Contributed by Donghee Na and Terry J. Reedy in :issue:`42299`.)" msgstr "" msgid "" -"Removed the :c:func:`PyModule_GetWarningsModule` function that was useless " -"now due to the _warnings module was converted to a builtin module in 2.6. " -"(Contributed by Hai Shi in :issue:`42599`.)" +"Removed the :c:func:`!PyModule_GetWarningsModule` function that was useless " +"now due to the :mod:`!_warnings` module was converted to a builtin module in " +"2.6. (Contributed by Hai Shi in :issue:`42599`.)" msgstr "" msgid "" @@ -2092,7 +2101,7 @@ msgid "" msgstr "" msgid "Specifically:" -msgstr "" +msgstr "W szczególności:" msgid "" "A call to ``PyParser_SimpleParseStringFlags`` followed by ``PyNode_Compile`` " @@ -2114,12 +2123,13 @@ msgid "" msgstr "" msgid "" -"For ``FrameObject`` objects, the ``f_lasti`` member now represents a " -"wordcode offset instead of a simple offset into the bytecode string. This " -"means that this number needs to be multiplied by 2 to be used with APIs that " -"expect a byte offset instead (like :c:func:`PyCode_Addr2Line` for example). " -"Notice as well that the ``f_lasti`` member of ``FrameObject`` objects is not " -"considered stable: please use :c:func:`PyFrame_GetLineNumber` instead." +"For ``FrameObject`` objects, the :attr:`~frame.f_lasti` member now " +"represents a wordcode offset instead of a simple offset into the bytecode " +"string. This means that this number needs to be multiplied by 2 to be used " +"with APIs that expect a byte offset instead (like :c:func:`PyCode_Addr2Line` " +"for example). Notice as well that the :attr:`!f_lasti` member of " +"``FrameObject`` objects is not considered stable: please use :c:func:" +"`PyFrame_GetLineNumber` instead." msgstr "" msgid "CPython bytecode changes" @@ -2327,12 +2337,12 @@ msgid "" msgstr "" msgid "" -"Add a new :c:data:`Py_TPFLAGS_DISALLOW_INSTANTIATION` type flag to disallow " +"Add a new :c:macro:`Py_TPFLAGS_DISALLOW_INSTANTIATION` type flag to disallow " "creating type instances. (Contributed by Victor Stinner in :issue:`43916`.)" msgstr "" msgid "" -"Add a new :c:data:`Py_TPFLAGS_IMMUTABLETYPE` type flag for creating " +"Add a new :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` type flag for creating " "immutable type objects: type attributes cannot be set nor deleted. " "(Contributed by Victor Stinner and Erlend E. Aasland in :issue:`43908`.)" msgstr "" @@ -2403,9 +2413,9 @@ msgid "" msgstr "" msgid "" -"Use the :c:data:`Py_TPFLAGS_IMMUTABLETYPE` type flag to create immutable " -"type objects. Do not rely on :c:data:`Py_TPFLAGS_HEAPTYPE` to decide if a " -"type object is mutable or not; check if :c:data:`Py_TPFLAGS_IMMUTABLETYPE` " +"Use the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` type flag to create immutable " +"type objects. Do not rely on :c:macro:`Py_TPFLAGS_HEAPTYPE` to decide if a " +"type object is mutable or not; check if :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` " "is set instead. (Contributed by Victor Stinner and Erlend E. Aasland in :" "issue:`43908`.)" msgstr "" @@ -2499,22 +2509,22 @@ msgid "Remove the ``symtable.h`` header file and the undocumented functions:" msgstr "" msgid "``PyST_GetScope()``" -msgstr "" +msgstr "``PyST_GetScope()``" msgid "``PySymtable_Build()``" -msgstr "" +msgstr "``PySymtable_Build()``" msgid "``PySymtable_BuildObject()``" -msgstr "" +msgstr "``PySymtable_BuildObject()``" msgid "``PySymtable_Free()``" -msgstr "" +msgstr "``PySymtable_Free()``" msgid "``Py_SymtableString()``" -msgstr "" +msgstr "``Py_SymtableString()``" msgid "``Py_SymtableStringObject()``" -msgstr "" +msgstr "``Py_SymtableStringObject()``" msgid "" "The ``Py_SymtableString()`` function was part the stable ABI by mistake but " @@ -2550,34 +2560,34 @@ msgid "" msgstr "" msgid "``PyAST_Compile()``" -msgstr "" +msgstr "``PyAST_Compile()``" msgid "``PyAST_CompileEx()``" -msgstr "" +msgstr "``PyAST_CompileEx()``" msgid "``PyAST_CompileObject()``" -msgstr "" +msgstr "``PyAST_CompileObject()``" msgid "``PyFuture_FromAST()``" -msgstr "" +msgstr "``PyFuture_FromAST()``" msgid "``PyFuture_FromASTObject()``" -msgstr "" +msgstr "``PyFuture_FromASTObject()``" msgid "``PyParser_ASTFromFile()``" -msgstr "" +msgstr "``PyParser_ASTFromFile()``" msgid "``PyParser_ASTFromFileObject()``" -msgstr "" +msgstr "``PyParser_ASTFromFileObject()``" msgid "``PyParser_ASTFromFilename()``" -msgstr "" +msgstr "``PyParser_ASTFromFilename()``" msgid "``PyParser_ASTFromString()``" -msgstr "" +msgstr "``PyParser_ASTFromString()``" msgid "``PyParser_ASTFromStringObject()``" -msgstr "" +msgstr "``PyParser_ASTFromStringObject()``" msgid "" "These functions were undocumented and excluded from the limited C API. " @@ -2588,16 +2598,16 @@ msgid "Remove the ``pyarena.h`` header file with functions:" msgstr "" msgid "``PyArena_New()``" -msgstr "" +msgstr "``PyArena_New()``" msgid "``PyArena_Free()``" -msgstr "" +msgstr "``PyArena_Free()``" msgid "``PyArena_Malloc()``" -msgstr "" +msgstr "``PyArena_Malloc()``" msgid "``PyArena_AddPyObject()``" -msgstr "" +msgstr "``PyArena_AddPyObject()``" msgid "" "These functions were undocumented, excluded from the limited C API, and were " @@ -2609,3 +2619,46 @@ msgid "" "The ``PyThreadState.use_tracing`` member has been removed to optimize " "Python. (Contributed by Mark Shannon in :issue:`43760`.)" msgstr "" + +msgid "Notable security feature in 3.10.7" +msgstr "" + +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" + +msgid "Notable security feature in 3.10.8" +msgstr "" + +msgid "" +"The deprecated :mod:`!mailcap` module now refuses to inject unsafe text " +"(filenames, MIME types, parameters) into shell commands. Instead of using " +"such text, it will warn and act as if a match was not found (or for test " +"commands, as if the test failed). (Contributed by Petr Viktorin in :gh:" +"`98966`.)" +msgstr "" + +msgid "Notable changes in 3.10.12" +msgstr "" + +msgid "tarfile" +msgstr "" + +msgid "" +"The extraction methods in :mod:`tarfile`, and :func:`shutil.unpack_archive`, " +"have a new a *filter* argument that allows limiting tar features than may be " +"surprising or dangerous, such as creating files outside the destination " +"directory. See :ref:`tarfile-extraction-filter` for details. In Python 3.12, " +"use without the *filter* argument will show a :exc:`DeprecationWarning`. In " +"Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " +"Viktorin in :pep:`706`.)" +msgstr "" diff --git a/whatsnew/3.11.po b/whatsnew/3.11.po index cc367430b5..8082a52733 100644 --- a/whatsnew/3.11.po +++ b/whatsnew/3.11.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2022-11-05 19:49+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-06-06 16:13+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,18 +26,6 @@ msgstr "" msgid "What's New In Python 3.11" msgstr "Co nowego w Pythonie 3.11" -msgid "Release" -msgstr "wydanie" - -msgid "|release|" -msgstr "|release|" - -msgid "Date" -msgstr "data" - -msgid "|today|" -msgstr "|today|" - msgid "Editor" msgstr "redakcja" @@ -46,11 +33,10 @@ msgid "Pablo Galindo Salgado" msgstr "Pablo Galindo Salgado" msgid "" -"This article explains the new features in Python 3.11, compared to 3.10." -msgstr "Ten artykuł opisuje nowe funkcje Pythona 3.11 w porównaniu do 3.10." - -msgid "For full details, see the :ref:`changelog `." -msgstr "Pełne szczegóły znajdziesz w :ref:`changelogu `." +"This article explains the new features in Python 3.11, compared to 3.10. " +"Python 3.11 was released on October 24, 2022. For full details, see the :ref:" +"`changelog `." +msgstr "" msgid "Summary -- Release highlights" msgstr "Podsumowanie – najważniejsze nowości" @@ -241,9 +227,10 @@ msgstr "" msgid "" "The copy of the :ref:`launcher` included with Python 3.11 has been " "significantly updated. It now supports company/tag syntax as defined in :pep:" -"`514` using the ``-V:/`` argument instead of the limited ``-" -".``. This allows launching distributions other than " -"``PythonCore``, the one hosted on `python.org `_." +"`514` using the :samp:`-V:{}/{}` argument instead of the " +"limited :samp:`-{}.{}`. This allows launching distributions " +"other than ``PythonCore``, the one hosted on `python.org `_." msgstr "" msgid "" @@ -254,14 +241,14 @@ msgid "" msgstr "" msgid "" -"When using the legacy ``-``, ``-.``, ``--" -"`` or ``-.-`` arguments, all existing " -"behaviour should be preserved from past versions, and only releases from " -"``PythonCore`` will be selected. However, the ``-64`` suffix now implies " -"\"not 32-bit\" (not necessarily x86-64), as there are multiple supported 64-" -"bit platforms. 32-bit runtimes are detected by checking the runtime's tag " -"for a ``-32`` suffix. All releases of Python since 3.5 have included this in " -"their 32-bit builds." +"When using the legacy :samp:`-{}`, :samp:`-{}.{}`, :" +"samp:`-{}-{}` or :samp:`-{}.{}-{}` " +"arguments, all existing behaviour should be preserved from past versions, " +"and only releases from ``PythonCore`` will be selected. However, the ``-64`` " +"suffix now implies \"not 32-bit\" (not necessarily x86-64), as there are " +"multiple supported 64-bit platforms. 32-bit runtimes are detected by " +"checking the runtime's tag for a ``-32`` suffix. All releases of Python " +"since 3.5 have included this in their 32-bit builds." msgstr "" msgid "New Features Related to Type Hints" @@ -449,7 +436,10 @@ msgid "" "class:`frozenset`, :class:`collections.OrderedDict`, :class:`collections." "deque`, :class:`weakref.WeakSet`, and :class:`datetime.tzinfo` now copies " "and pickles instance attributes implemented as :term:`slots <__slots__>`. " -"(Contributed by Serhiy Storchaka in :issue:`26579`.)" +"This change has an unintended side effect: It trips up a small minority of " +"existing Python projects not expecting :meth:`object.__getstate__` to exist. " +"See the later comments on :gh:`70766` for discussions of what workarounds " +"such code may need. (Contributed by Serhiy Storchaka in :issue:`26579`.)" msgstr "" msgid "" @@ -485,7 +475,7 @@ msgid "" "The special methods :meth:`~object.__complex__` for :class:`complex` and :" "meth:`~object.__bytes__` for :class:`bytes` are implemented to support the :" "class:`typing.SupportsComplex` and :class:`typing.SupportsBytes` protocols. " -"(Contributed by Mark Dickinson and Dong-hee Na in :issue:`24234`.)" +"(Contributed by Mark Dickinson and Donghee Na in :issue:`24234`.)" msgstr "" msgid "" @@ -561,7 +551,7 @@ msgid "" msgstr "" msgid "Improved Modules" -msgstr "" +msgstr "Ulepszone moduły" msgid "asyncio" msgstr "" @@ -641,7 +631,7 @@ msgid "datetime" msgstr "" msgid "" -"Add :attr:`datetime.UTC`, a convenience alias for :attr:`datetime.timezone." +"Add :const:`datetime.UTC`, a convenience alias for :attr:`datetime.timezone." "utc`. (Contributed by Kabir Kwatra in :gh:`91973`.)" msgstr "" @@ -675,9 +665,9 @@ msgstr "" msgid "" "Changed :meth:`Enum.__format__() ` (the default for :" "func:`format`, :meth:`str.format` and :term:`f-string`\\s) to always produce " -"the same result as :meth:`Enum.__str__()`: for enums inheriting from :class:" -"`~enum.ReprEnum` it will be the member's value; for all other enums it will " -"be the enum and member name (e.g. ``Color.RED``)." +"the same result as :meth:`Enum.__str__() `: for enums " +"inheriting from :class:`~enum.ReprEnum` it will be the member's value; for " +"all other enums it will be the enum and member name (e.g. ``Color.RED``)." msgstr "" msgid "" @@ -707,7 +697,7 @@ msgid "" "Added the :func:`~enum.global_enum` enum decorator, which adjusts :meth:" "`~object.__repr__` and :meth:`~object.__str__` to show values as members of " "their module rather than the enum class. For example, ``'re.ASCII'`` for " -"the :data:`~re.ASCII` member of :class:`re.RegexFlag` rather than " +"the :const:`~re.ASCII` member of :class:`re.RegexFlag` rather than " "``'RegexFlag.ASCII'``." msgstr "" @@ -763,6 +753,20 @@ msgstr "" msgid "(Contributed by Yurii Karabas in :issue:`46014`.)" msgstr "" +msgid "gzip" +msgstr "" + +msgid "" +"The :func:`gzip.compress` function is now faster when used with the " +"**mtime=0** argument as it delegates the compression entirely to a single :" +"func:`zlib.compress` operation. There is one side effect of this change: The " +"gzip file header contains an \"OS\" byte in its header. That was " +"traditionally always set to a value of 255 representing \"unknown\" by the :" +"mod:`gzip` module. Now, when using :func:`~gzip.compress` with **mtime=0**, " +"it may be set to a different value by the underlying zlib C library Python " +"was linked against. (See :gh:`112346` for details on the side effect.)" +msgstr "" + msgid "hashlib" msgstr "" @@ -821,19 +825,19 @@ msgid "" msgstr "" msgid ":func:`inspect.getframeinfo`" -msgstr "" +msgstr ":func:`inspect.getframeinfo`" msgid ":func:`inspect.getouterframes`" -msgstr "" +msgstr ":func:`inspect.getouterframes`" msgid ":func:`inspect.getinnerframes`," -msgstr "" +msgstr ":func:`inspect.getinnerframes`," msgid ":func:`inspect.stack`" -msgstr "" +msgstr ":func:`inspect.stack`" msgid ":func:`inspect.trace`" -msgstr "" +msgstr ":func:`inspect.trace`" msgid "(Contributed by Pablo Galindo in :gh:`88116`.)" msgstr "" @@ -905,10 +909,18 @@ msgstr "" msgid "" "On Windows, :func:`os.urandom` now uses ``BCryptGenRandom()``, instead of " -"``CryptGenRandom()`` which is deprecated. (Contributed by Dong-hee Na in :" +"``CryptGenRandom()`` which is deprecated. (Contributed by Donghee Na in :" "issue:`44611`.)" msgstr "" +msgid "" +"As of 3.11.10, :func:`os.mkdir` and :func:`os.makedirs` on Windows now " +"support passing a *mode* value of ``0o700`` to apply access control to the " +"new directory. This implicitly affects :func:`tempfile.mkdtemp` and is a " +"mitigation for CVE-2024-4030. Other values for *mode* continue to be " +"ignored. (Contributed by Steve Dower in :gh:`118486`.)" +msgstr "" + msgid "pathlib" msgstr "" @@ -1019,7 +1031,7 @@ msgid "" msgstr "" msgid "string" -msgstr "" +msgstr "ciąg znaków" msgid "" "Add :meth:`~string.Template.get_identifiers` and :meth:`~string.Template." @@ -1077,14 +1089,21 @@ msgid "" "`70363`.)" msgstr "" +msgid "" +"As of 3.11.10 on Windows, the default mode ``0o700`` used by :func:`tempfile." +"mkdtemp` now limits access to the new directory due to changes to :func:`os." +"mkdir`. This is a mitigation for CVE-2024-4030. (Contributed by Steve Dower " +"in :gh:`118486`.)" +msgstr "" + msgid "threading" msgstr "" msgid "" "On Unix, if the ``sem_clockwait()`` function is available in the C library " "(glibc 2.30 and newer), the :meth:`threading.Lock.acquire` method now uses " -"the monotonic clock (:data:`time.CLOCK_MONOTONIC`) for the timeout, rather " -"than using the system clock (:data:`time.CLOCK_REALTIME`), to not be " +"the monotonic clock (:const:`time.CLOCK_MONOTONIC`) for the timeout, rather " +"than using the system clock (:const:`time.CLOCK_REALTIME`), to not be " "affected by system clock changes. (Contributed by Victor Stinner in :issue:" "`41710`.)" msgstr "" @@ -1105,8 +1124,9 @@ msgid "" "on `high-resolution timers `_ which has a resolution of " "100 nanoseconds (10\\ :sup:`-7` seconds). Previously, it had a resolution of " -"1 millisecond (10\\ :sup:`-3` seconds). (Contributed by Benjamin Szőke, Dong-" -"hee Na, Eryk Sun and Victor Stinner in :issue:`21302` and :issue:`45429`.)" +"1 millisecond (10\\ :sup:`-3` seconds). (Contributed by Benjamin Szőke, " +"Donghee Na, Eryk Sun and Victor Stinner in :issue:`21302` and :issue:" +"`45429`.)" msgstr "" msgid "tkinter" @@ -1353,7 +1373,7 @@ msgstr "" msgid "" ":func:`unicodedata.normalize` now normalizes pure-ASCII strings in constant " -"time. (Contributed by Dong-hee Na in :issue:`44987`.)" +"time. (Contributed by Donghee Na in :issue:`44987`.)" msgstr "" msgid "Faster CPython" @@ -1523,13 +1543,13 @@ msgid "Binary operations" msgstr "" msgid "``x + x``" -msgstr "" +msgstr "``x + x``" msgid "``x - x``" -msgstr "" +msgstr "``x - x``" msgid "``x * x``" -msgstr "" +msgstr "``x * x``" msgid "" "Binary add, multiply and subtract for common types such as :class:`int`, :" @@ -1538,16 +1558,16 @@ msgid "" msgstr "" msgid "10%" -msgstr "" +msgstr "10%" -msgid "Mark Shannon, Dong-hee Na, Brandt Bucher, Dennis Sweeney" +msgid "Mark Shannon, Donghee Na, Brandt Bucher, Dennis Sweeney" msgstr "" msgid "Subscript" msgstr "" msgid "``a[i]``" -msgstr "" +msgstr "``a[i]``" msgid "" "Subscripting container types such as :class:`list`, :class:`tuple` and :" @@ -1560,7 +1580,7 @@ msgid "" msgstr "" msgid "10-25%" -msgstr "" +msgstr "10-25%" msgid "Irit Katriel, Mark Shannon" msgstr "" @@ -1569,7 +1589,7 @@ msgid "Store subscript" msgstr "" msgid "``a[i] = z``" -msgstr "" +msgstr "``a[i] = z``" msgid "Similar to subscripting specialization above." msgstr "" @@ -1581,10 +1601,10 @@ msgid "Calls" msgstr "" msgid "``f(arg)``" -msgstr "" +msgstr "``f(arg)``" msgid "``C(arg)``" -msgstr "" +msgstr "``C(arg)``" msgid "" "Calls to common builtin (C) functions and types such as :func:`len` and :" @@ -1593,7 +1613,7 @@ msgid "" msgstr "" msgid "20%" -msgstr "" +msgstr "20%" msgid "Mark Shannon, Ken Jin" msgstr "" @@ -1602,10 +1622,10 @@ msgid "Load global variable" msgstr "" msgid "``print``" -msgstr "" +msgstr "``print``" msgid "``len``" -msgstr "" +msgstr "``len``" msgid "" "The object's index in the globals/builtins namespace is cached. Loading " @@ -1622,7 +1642,7 @@ msgid "Load attribute" msgstr "" msgid "``o.attr``" -msgstr "" +msgstr "``o.attr``" msgid "" "Similar to loading global variables. The attribute's index inside the class/" @@ -1637,7 +1657,7 @@ msgid "Load methods for call" msgstr "" msgid "``o.meth()``" -msgstr "" +msgstr "``o.meth()``" msgid "" "The actual address of the method is cached. Method loading now has no " @@ -1645,7 +1665,7 @@ msgid "" msgstr "" msgid "10-20%" -msgstr "" +msgstr "10-20%" msgid "Ken Jin, Mark Shannon" msgstr "" @@ -1654,7 +1674,7 @@ msgid "Store attribute" msgstr "" msgid "``o.attr = z``" -msgstr "" +msgstr "``o.attr = z``" msgid "Similar to load attribute optimization." msgstr "" @@ -1666,7 +1686,7 @@ msgid "Unpack Sequence" msgstr "" msgid "``*seq``" -msgstr "" +msgstr "``*seq``" msgid "" "Specialized for common containers such as :class:`list` and :class:`tuple`. " @@ -1674,7 +1694,7 @@ msgid "" msgstr "" msgid "8%" -msgstr "" +msgstr "8%" msgid "Brandt Bucher" msgstr "" @@ -1833,28 +1853,28 @@ msgid "Notes" msgstr "Notatki" msgid ":opcode:`!BINARY_*`" -msgstr "" +msgstr ":opcode:`!BINARY_*`" msgid ":opcode:`!INPLACE_*`" -msgstr "" +msgstr ":opcode:`!INPLACE_*`" msgid ":opcode:`BINARY_OP`" -msgstr "" +msgstr ":opcode:`BINARY_OP`" msgid "Replaced all numeric binary/in-place opcodes with a single opcode" msgstr "" msgid ":opcode:`!CALL_FUNCTION`" -msgstr "" +msgstr ":opcode:`!CALL_FUNCTION`" msgid ":opcode:`!CALL_FUNCTION_KW`" -msgstr "" +msgstr ":opcode:`!CALL_FUNCTION_KW`" msgid ":opcode:`!CALL_METHOD`" -msgstr "" +msgstr ":opcode:`!CALL_METHOD`" msgid ":opcode:`CALL`" -msgstr "" +msgstr ":opcode:`CALL`" msgid ":opcode:`KW_NAMES`" msgstr "" @@ -1863,7 +1883,7 @@ msgid ":opcode:`PRECALL`" msgstr "" msgid ":opcode:`PUSH_NULL`" -msgstr "" +msgstr ":opcode:`PUSH_NULL`" msgid "" "Decouples argument shifting for methods from handling of keyword arguments; " @@ -1871,52 +1891,52 @@ msgid "" msgstr "" msgid ":opcode:`!DUP_TOP`" -msgstr "" +msgstr ":opcode:`!DUP_TOP`" msgid ":opcode:`!DUP_TOP_TWO`" -msgstr "" +msgstr ":opcode:`!DUP_TOP_TWO`" msgid ":opcode:`!ROT_TWO`" -msgstr "" +msgstr ":opcode:`!ROT_TWO`" msgid ":opcode:`!ROT_THREE`" -msgstr "" +msgstr ":opcode:`!ROT_THREE`" msgid ":opcode:`!ROT_FOUR`" -msgstr "" +msgstr ":opcode:`!ROT_FOUR`" msgid ":opcode:`!ROT_N`" -msgstr "" +msgstr ":opcode:`!ROT_N`" msgid ":opcode:`COPY`" -msgstr "" +msgstr ":opcode:`COPY`" msgid ":opcode:`SWAP`" -msgstr "" +msgstr ":opcode:`SWAP`" msgid "Stack manipulation instructions" msgstr "" msgid ":opcode:`!JUMP_IF_NOT_EXC_MATCH`" -msgstr "" +msgstr ":opcode:`!JUMP_IF_NOT_EXC_MATCH`" msgid ":opcode:`CHECK_EXC_MATCH`" -msgstr "" +msgstr ":opcode:`CHECK_EXC_MATCH`" msgid "Now performs check but doesn't jump" msgstr "" msgid ":opcode:`!JUMP_ABSOLUTE`" -msgstr "" +msgstr ":opcode:`!JUMP_ABSOLUTE`" msgid ":opcode:`!POP_JUMP_IF_FALSE`" -msgstr "" +msgstr ":opcode:`!POP_JUMP_IF_FALSE`" msgid ":opcode:`!POP_JUMP_IF_TRUE`" -msgstr "" +msgstr ":opcode:`!POP_JUMP_IF_TRUE`" msgid ":opcode:`JUMP_BACKWARD`" -msgstr "" +msgstr ":opcode:`JUMP_BACKWARD`" msgid ":opcode:`POP_JUMP_BACKWARD_IF_* `" msgstr "" @@ -1930,13 +1950,13 @@ msgid "" msgstr "" msgid ":opcode:`!SETUP_WITH`" -msgstr "" +msgstr ":opcode:`!SETUP_WITH`" msgid ":opcode:`!SETUP_ASYNC_WITH`" -msgstr "" +msgstr ":opcode:`!SETUP_ASYNC_WITH`" msgid ":opcode:`BEFORE_WITH`" -msgstr "" +msgstr ":opcode:`BEFORE_WITH`" msgid ":keyword:`with` block setup" msgstr "" @@ -2110,7 +2130,7 @@ msgstr "" msgid "the :attr:`!configparser.ParsingError.filename` property" msgstr "" -msgid "the :meth:`configparser.RawConfigParser.readfp` method" +msgid "the :meth:`!configparser.RawConfigParser.readfp` method" msgstr "" msgid "(Contributed by Hugo van Kemenade in :issue:`45173`.)" @@ -2155,7 +2175,7 @@ msgstr "" msgid "" "The :func:`locale.getdefaultlocale` function is deprecated and will be " -"removed in Python 3.13. Use :func:`locale.setlocale`, :func:`locale." +"removed in Python 3.15. Use :func:`locale.setlocale`, :func:`locale." "getpreferredencoding(False) ` and :func:`locale." "getlocale` functions instead. (Contributed by Victor Stinner in :gh:`90817`.)" msgstr "" @@ -2178,7 +2198,7 @@ msgstr "" msgid "" "In the :mod:`re` module, the :func:`!re.template` function and the " -"corresponding :data:`!re.TEMPLATE` and :data:`!re.T` flags are deprecated, " +"corresponding :const:`!re.TEMPLATE` and :const:`!re.T` flags are deprecated, " "as they were undocumented and lacked an obvious purpose. They will be " "removed in Python 3.13. (Contributed by Serhiy Storchaka and Miro Hrončok " "in :gh:`92728`.)" @@ -2208,7 +2228,7 @@ msgstr "" msgid "" ":class:`!webbrowser.MacOSX` is deprecated and will be removed in Python " "3.13. It is untested, undocumented, and not used by :mod:`webbrowser` " -"itself. (Contributed by Dong-hee Na in :issue:`42255`.)" +"itself. (Contributed by Donghee Na in :issue:`42255`.)" msgstr "" msgid "" @@ -2223,29 +2243,34 @@ msgid "" msgstr "" msgid ":func:`!unittest.findTestCases`" -msgstr "" +msgstr ":func:`!unittest.findTestCases`" msgid ":func:`!unittest.makeSuite`" -msgstr "" +msgstr ":func:`!unittest.makeSuite`" msgid ":func:`!unittest.getTestCaseNames`" -msgstr "" +msgstr ":func:`!unittest.getTestCaseNames`" msgid "Use :class:`~unittest.TestLoader` methods instead:" msgstr "" msgid ":meth:`unittest.TestLoader.loadTestsFromModule`" -msgstr "" +msgstr ":meth:`unittest.TestLoader.loadTestsFromModule`" msgid ":meth:`unittest.TestLoader.loadTestsFromTestCase`" -msgstr "" +msgstr ":meth:`unittest.TestLoader.loadTestsFromTestCase`" msgid ":meth:`unittest.TestLoader.getTestCaseNames`" -msgstr "" +msgstr ":meth:`unittest.TestLoader.getTestCaseNames`" msgid "(Contributed by Erlend E. Aasland in :issue:`5846`.)" msgstr "" +msgid "" +":meth:`!unittest.TestProgram.usageExit` is marked deprecated, to be removed " +"in 3.13. (Contributed by Carlos Damázio in :gh:`67048`.)" +msgstr "" + msgid "Pending Removal in Python 3.12" msgstr "" @@ -2278,7 +2303,7 @@ msgid "The :class:`typing.re ` namespace" msgstr "" msgid ":func:`!cgi.log`" -msgstr "" +msgstr ":func:`!cgi.log`" msgid ":func:`importlib.find_loader`" msgstr "" @@ -2296,37 +2321,37 @@ msgid ":meth:`importlib.abc.PathEntryFinder.find_module`" msgstr "" msgid ":meth:`!importlib.machinery.BuiltinImporter.find_module`" -msgstr "" +msgstr ":meth:`!importlib.machinery.BuiltinImporter.find_module`" msgid ":meth:`!importlib.machinery.BuiltinLoader.module_repr`" -msgstr "" +msgstr ":meth:`!importlib.machinery.BuiltinLoader.module_repr`" msgid ":meth:`!importlib.machinery.FileFinder.find_loader`" -msgstr "" +msgstr ":meth:`!importlib.machinery.FileFinder.find_loader`" msgid ":meth:`!importlib.machinery.FileFinder.find_module`" -msgstr "" +msgstr ":meth:`!importlib.machinery.FileFinder.find_module`" msgid ":meth:`!importlib.machinery.FrozenImporter.find_module`" -msgstr "" +msgstr ":meth:`!importlib.machinery.FrozenImporter.find_module`" msgid ":meth:`!importlib.machinery.FrozenLoader.module_repr`" -msgstr "" +msgstr ":meth:`!importlib.machinery.FrozenLoader.module_repr`" msgid ":meth:`importlib.machinery.PathFinder.find_module`" msgstr "" msgid ":meth:`!importlib.machinery.WindowsRegistryFinder.find_module`" -msgstr "" +msgstr ":meth:`!importlib.machinery.WindowsRegistryFinder.find_module`" msgid ":func:`importlib.util.module_for_loader`" msgstr "" msgid ":func:`!importlib.util.set_loader_wrapper`" -msgstr "" +msgstr ":func:`!importlib.util.set_loader_wrapper`" msgid ":func:`!importlib.util.set_package_wrapper`" -msgstr "" +msgstr ":func:`!importlib.util.set_package_wrapper`" msgid ":class:`pkgutil.ImpImporter`" msgstr "" @@ -2338,10 +2363,10 @@ msgid ":meth:`pathlib.Path.link_to`" msgstr "" msgid ":func:`!sqlite3.enable_shared_cache`" -msgstr "" +msgstr ":func:`!sqlite3.enable_shared_cache`" msgid ":func:`!sqlite3.OptimizedUnicode`" -msgstr "" +msgstr ":func:`!sqlite3.OptimizedUnicode`" msgid ":envvar:`PYTHONTHREADDEBUG` environment variable" msgstr "" @@ -2359,85 +2384,85 @@ msgid "Deprecated in" msgstr "" msgid "``failUnless``" -msgstr "" +msgstr "``failUnless``" msgid ":meth:`.assertTrue`" -msgstr "" +msgstr ":meth:`.assertTrue`" msgid "3.1" msgstr "" msgid "``failIf``" -msgstr "" +msgstr "``failIf``" msgid ":meth:`.assertFalse`" -msgstr "" +msgstr ":meth:`.assertFalse`" msgid "``failUnlessEqual``" -msgstr "" +msgstr "``failUnlessEqual``" msgid ":meth:`.assertEqual`" -msgstr "" +msgstr ":meth:`.assertEqual`" msgid "``failIfEqual``" -msgstr "" +msgstr "``failIfEqual``" msgid ":meth:`.assertNotEqual`" -msgstr "" +msgstr ":meth:`.assertNotEqual`" msgid "``failUnlessAlmostEqual``" -msgstr "" +msgstr "``failUnlessAlmostEqual``" msgid ":meth:`.assertAlmostEqual`" -msgstr "" +msgstr ":meth:`.assertAlmostEqual`" msgid "``failIfAlmostEqual``" -msgstr "" +msgstr "``failIfAlmostEqual``" msgid ":meth:`.assertNotAlmostEqual`" -msgstr "" +msgstr ":meth:`.assertNotAlmostEqual`" msgid "``failUnlessRaises``" -msgstr "" +msgstr "``failUnlessRaises``" msgid ":meth:`.assertRaises`" -msgstr "" +msgstr ":meth:`.assertRaises`" msgid "``assert_``" -msgstr "" +msgstr "``assert_``" msgid "3.2" msgstr "" msgid "``assertEquals``" -msgstr "" +msgstr "``assertEquals``" msgid "``assertNotEquals``" -msgstr "" +msgstr "``assertNotEquals``" msgid "``assertAlmostEquals``" -msgstr "" +msgstr "``assertAlmostEquals``" msgid "``assertNotAlmostEquals``" -msgstr "" +msgstr "``assertNotAlmostEquals``" msgid "``assertRegexpMatches``" -msgstr "" +msgstr "``assertRegexpMatches``" msgid ":meth:`.assertRegex`" -msgstr "" +msgstr ":meth:`.assertRegex`" msgid "``assertRaisesRegexp``" -msgstr "" +msgstr "``assertRaisesRegexp``" msgid ":meth:`.assertRaisesRegex`" -msgstr "" +msgstr ":meth:`.assertRaisesRegex`" msgid "``assertNotRegexpMatches``" -msgstr "" +msgstr "``assertNotRegexpMatches``" msgid ":meth:`.assertNotRegex`" -msgstr "" +msgstr ":meth:`.assertNotRegex`" msgid "3.5" msgstr "" @@ -2480,16 +2505,16 @@ msgid "" msgstr "" msgid ":func:`!binascii.a2b_hqx`" -msgstr "" +msgstr ":func:`!binascii.a2b_hqx`" msgid ":func:`!binascii.b2a_hqx`" -msgstr "" +msgstr ":func:`!binascii.b2a_hqx`" msgid ":func:`!binascii.rlecode_hqx`" -msgstr "" +msgstr ":func:`!binascii.rlecode_hqx`" msgid ":func:`!binascii.rldecode_hqx`" -msgstr "" +msgstr ":func:`!binascii.rldecode_hqx`" msgid "The :func:`binascii.crc_hqx` function remains available." msgstr "" @@ -2517,7 +2542,7 @@ msgid "" "output_charset` and :meth:`!NullTranslations.set_output_charset` methods, " "and the *codeset* parameter of :func:`!translation` and :func:`!install`, " "since they are only used for the :func:`!l*gettext` functions. (Contributed " -"by Dong-hee Na and Serhiy Storchaka in :issue:`44235`.)" +"by Donghee Na and Serhiy Storchaka in :issue:`44235`.)" msgstr "" msgid "Removed from the :mod:`inspect` module:" @@ -2552,7 +2577,7 @@ msgstr "" msgid "" "Removed the :class:`!MailmanProxy` class in the :mod:`smtpd` module, as it " "is unusable without the external :mod:`!mailman` package. (Contributed by " -"Dong-hee Na in :issue:`35800`.)" +"Donghee Na in :issue:`35800`.)" msgstr "" msgid "" @@ -2727,7 +2752,7 @@ msgstr "" msgid "" "CPython can now be built with the `ThinLTO `_ option via passing ``thin`` to :option:`--with-lto`, i.e. " -"``--with-lto=thin``. (Contributed by Dong-hee Na and Brett Holman in :issue:" +"``--with-lto=thin``. (Contributed by Donghee Na and Brett Holman in :issue:" "`44340`.)" msgstr "" @@ -2803,40 +2828,40 @@ msgid "" msgstr "" msgid ":c:func:`PyObject_CheckBuffer`" -msgstr "" +msgstr ":c:func:`PyObject_CheckBuffer`" msgid ":c:func:`PyObject_GetBuffer`" -msgstr "" +msgstr ":c:func:`PyObject_GetBuffer`" msgid ":c:func:`PyBuffer_GetPointer`" -msgstr "" +msgstr ":c:func:`PyBuffer_GetPointer`" msgid ":c:func:`PyBuffer_SizeFromFormat`" -msgstr "" +msgstr ":c:func:`PyBuffer_SizeFromFormat`" msgid ":c:func:`PyBuffer_ToContiguous`" -msgstr "" +msgstr ":c:func:`PyBuffer_ToContiguous`" msgid ":c:func:`PyBuffer_FromContiguous`" -msgstr "" +msgstr ":c:func:`PyBuffer_FromContiguous`" -msgid ":c:func:`PyBuffer_CopyData`" -msgstr "" +msgid ":c:func:`PyObject_CopyData`" +msgstr ":c:func:`PyObject_CopyData`" msgid ":c:func:`PyBuffer_IsContiguous`" -msgstr "" +msgstr ":c:func:`PyBuffer_IsContiguous`" msgid ":c:func:`PyBuffer_FillContiguousStrides`" -msgstr "" +msgstr ":c:func:`PyBuffer_FillContiguousStrides`" msgid ":c:func:`PyBuffer_FillInfo`" -msgstr "" +msgstr ":c:func:`PyBuffer_FillInfo`" msgid ":c:func:`PyBuffer_Release`" -msgstr "" +msgstr ":c:func:`PyBuffer_Release`" msgid ":c:func:`PyMemoryView_FromBuffer`" -msgstr "" +msgstr ":c:func:`PyMemoryView_FromBuffer`" msgid "" ":c:member:`~PyBufferProcs.bf_getbuffer` and :c:member:`~PyBufferProcs." @@ -2847,7 +2872,7 @@ msgid "(Contributed by Christian Heimes in :issue:`45459`.)" msgstr "" msgid "" -"Added the :c:data:`PyType_GetModuleByDef` function, used to get the module " +"Added the :c:func:`PyType_GetModuleByDef` function, used to get the module " "in which a method was defined, in cases where this information is not " "available directly (via :c:type:`PyCMethod`). (Contributed by Petr Viktorin " "in :issue:`46613`.)" @@ -2958,13 +2983,13 @@ msgstr "" msgid "" "The :c:func:`PyType_Ready` function now raises an error if a type is defined " -"with the :const:`Py_TPFLAGS_HAVE_GC` flag set but has no traverse function (:" -"c:member:`PyTypeObject.tp_traverse`). (Contributed by Victor Stinner in :" +"with the :c:macro:`Py_TPFLAGS_HAVE_GC` flag set but has no traverse function " +"(:c:member:`PyTypeObject.tp_traverse`). (Contributed by Victor Stinner in :" "issue:`44263`.)" msgstr "" msgid "" -"Heap types with the :const:`Py_TPFLAGS_IMMUTABLETYPE` flag can now inherit " +"Heap types with the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` flag can now inherit " "the :pep:`590` vectorcall protocol. Previously, this was only possible for :" "ref:`static types `. (Contributed by Erlend E. Aasland in :" "issue:`43908`)" @@ -3019,28 +3044,28 @@ msgid "" msgstr "" msgid ":c:func:`PyFrame_Check`" -msgstr "" +msgstr ":c:func:`PyFrame_Check`" msgid ":c:func:`PyFrame_GetBack`" -msgstr "" +msgstr ":c:func:`PyFrame_GetBack`" msgid ":c:func:`PyFrame_GetBuiltins`" -msgstr "" +msgstr ":c:func:`PyFrame_GetBuiltins`" msgid ":c:func:`PyFrame_GetGenerator`" -msgstr "" +msgstr ":c:func:`PyFrame_GetGenerator`" msgid ":c:func:`PyFrame_GetGlobals`" -msgstr "" +msgstr ":c:func:`PyFrame_GetGlobals`" msgid ":c:func:`PyFrame_GetLasti`" -msgstr "" +msgstr ":c:func:`PyFrame_GetLasti`" msgid ":c:func:`PyFrame_GetLocals`" -msgstr "" +msgstr ":c:func:`PyFrame_GetLocals`" msgid ":c:type:`PyFrame_Type`" -msgstr "" +msgstr ":c:type:`PyFrame_Type`" msgid "(Contributed by Victor Stinner in :gh:`93937`.)" msgstr "" @@ -3124,16 +3149,16 @@ msgid "``f_valuestack``: removed." msgstr "" msgid "" -"The Python frame object is now created lazily. A side effect is that the " -"``f_back`` member must not be accessed directly, since its value is now also " -"computed lazily. The :c:func:`PyFrame_GetBack` function must be called " -"instead." +"The Python frame object is now created lazily. A side effect is that the :" +"attr:`~frame.f_back` member must not be accessed directly, since its value " +"is now also computed lazily. The :c:func:`PyFrame_GetBack` function must be " +"called instead." msgstr "" msgid "" -"Debuggers that accessed the ``f_locals`` directly *must* call :c:func:" -"`PyFrame_GetLocals` instead. They no longer need to call :c:func:" -"`PyFrame_FastToLocalsWithError` or :c:func:`PyFrame_LocalsToFast`, in fact " +"Debuggers that accessed the :attr:`~frame.f_locals` directly *must* call :c:" +"func:`PyFrame_GetLocals` instead. They no longer need to call :c:func:`!" +"PyFrame_FastToLocalsWithError` or :c:func:`!PyFrame_LocalsToFast`, in fact " "they should not call those functions. The necessary updating of the frame is " "now managed by the virtual machine." msgstr "" @@ -3209,41 +3234,41 @@ msgid "" "Deprecate the following functions to configure the Python initialization:" msgstr "" -msgid ":c:func:`PySys_AddWarnOptionUnicode`" -msgstr "" +msgid ":c:func:`!PySys_AddWarnOptionUnicode`" +msgstr ":c:func:`!PySys_AddWarnOptionUnicode`" -msgid ":c:func:`PySys_AddWarnOption`" -msgstr "" +msgid ":c:func:`!PySys_AddWarnOption`" +msgstr ":c:func:`!PySys_AddWarnOption`" -msgid ":c:func:`PySys_AddXOption`" -msgstr "" +msgid ":c:func:`!PySys_AddXOption`" +msgstr ":c:func:`!PySys_AddXOption`" -msgid ":c:func:`PySys_HasWarnOptions`" -msgstr "" +msgid ":c:func:`!PySys_HasWarnOptions`" +msgstr ":c:func:`!PySys_HasWarnOptions`" -msgid ":c:func:`PySys_SetArgvEx`" -msgstr "" +msgid ":c:func:`!PySys_SetArgvEx`" +msgstr ":c:func:`!PySys_SetArgvEx`" -msgid ":c:func:`PySys_SetArgv`" -msgstr "" +msgid ":c:func:`!PySys_SetArgv`" +msgstr ":c:func:`!PySys_SetArgv`" -msgid ":c:func:`PySys_SetPath`" -msgstr "" +msgid ":c:func:`!PySys_SetPath`" +msgstr ":c:func:`!PySys_SetPath`" -msgid ":c:func:`Py_SetPath`" -msgstr "" +msgid ":c:func:`!Py_SetPath`" +msgstr ":c:func:`!Py_SetPath`" -msgid ":c:func:`Py_SetProgramName`" -msgstr "" +msgid ":c:func:`!Py_SetProgramName`" +msgstr ":c:func:`!Py_SetProgramName`" -msgid ":c:func:`Py_SetPythonHome`" -msgstr "" +msgid ":c:func:`!Py_SetPythonHome`" +msgstr ":c:func:`!Py_SetPythonHome`" -msgid ":c:func:`Py_SetStandardStreamEncoding`" -msgstr "" +msgid ":c:func:`!Py_SetStandardStreamEncoding`" +msgstr ":c:func:`!Py_SetStandardStreamEncoding`" -msgid ":c:func:`_Py_SetProgramFullPath`" -msgstr "" +msgid ":c:func:`!_Py_SetProgramFullPath`" +msgstr ":c:func:`!_Py_SetProgramFullPath`" msgid "" "Use the new :c:type:`PyConfig` API of the :ref:`Python Initialization " @@ -3261,56 +3286,56 @@ msgid "" "will be removed in Python 3.12." msgstr "" -msgid ":c:func:`PyUnicode_AS_DATA`" -msgstr "" +msgid ":c:func:`!PyUnicode_AS_DATA`" +msgstr ":c:func:`!PyUnicode_AS_DATA`" -msgid ":c:func:`PyUnicode_AS_UNICODE`" -msgstr "" +msgid ":c:func:`!PyUnicode_AS_UNICODE`" +msgstr ":c:func:`!PyUnicode_AS_UNICODE`" -msgid ":c:func:`PyUnicode_AsUnicodeAndSize`" -msgstr "" +msgid ":c:func:`!PyUnicode_AsUnicodeAndSize`" +msgstr ":c:func:`!PyUnicode_AsUnicodeAndSize`" -msgid ":c:func:`PyUnicode_AsUnicode`" -msgstr "" +msgid ":c:func:`!PyUnicode_AsUnicode`" +msgstr ":c:func:`!PyUnicode_AsUnicode`" -msgid ":c:func:`PyUnicode_FromUnicode`" -msgstr "" +msgid ":c:func:`!PyUnicode_FromUnicode`" +msgstr ":c:func:`!PyUnicode_FromUnicode`" -msgid ":c:func:`PyUnicode_GET_DATA_SIZE`" -msgstr "" +msgid ":c:func:`!PyUnicode_GET_DATA_SIZE`" +msgstr ":c:func:`!PyUnicode_GET_DATA_SIZE`" -msgid ":c:func:`PyUnicode_GET_SIZE`" -msgstr "" +msgid ":c:func:`!PyUnicode_GET_SIZE`" +msgstr ":c:func:`!PyUnicode_GET_SIZE`" -msgid ":c:func:`PyUnicode_GetSize`" -msgstr "" +msgid ":c:func:`!PyUnicode_GetSize`" +msgstr ":c:func:`!PyUnicode_GetSize`" -msgid ":c:func:`PyUnicode_IS_COMPACT`" -msgstr "" +msgid ":c:func:`!PyUnicode_IS_COMPACT`" +msgstr ":c:func:`!PyUnicode_IS_COMPACT`" -msgid ":c:func:`PyUnicode_IS_READY`" -msgstr "" +msgid ":c:func:`!PyUnicode_IS_READY`" +msgstr ":c:func:`!PyUnicode_IS_READY`" msgid ":c:func:`PyUnicode_READY`" -msgstr "" +msgstr ":c:func:`PyUnicode_READY`" -msgid ":c:func:`Py_UNICODE_WSTR_LENGTH`" -msgstr "" +msgid ":c:func:`!PyUnicode_WSTR_LENGTH`" +msgstr ":c:func:`!PyUnicode_WSTR_LENGTH`" -msgid ":c:func:`_PyUnicode_AsUnicode`" -msgstr "" +msgid ":c:func:`!_PyUnicode_AsUnicode`" +msgstr ":c:func:`!_PyUnicode_AsUnicode`" -msgid ":c:macro:`PyUnicode_WCHAR_KIND`" -msgstr "" +msgid ":c:macro:`!PyUnicode_WCHAR_KIND`" +msgstr ":c:macro:`!PyUnicode_WCHAR_KIND`" msgid ":c:type:`PyUnicodeObject`" -msgstr "" +msgstr ":c:type:`PyUnicodeObject`" -msgid ":c:func:`PyUnicode_InternImmortal()`" -msgstr "" +msgid ":c:func:`!PyUnicode_InternImmortal`" +msgstr ":c:func:`!PyUnicode_InternImmortal`" msgid "" -":c:func:`PyFrame_BlockSetup` and :c:func:`PyFrame_BlockPop` have been " +":c:func:`!PyFrame_BlockSetup` and :c:func:`!PyFrame_BlockPop` have been " "removed. (Contributed by Mark Shannon in :issue:`40222`.)" msgstr "" @@ -3318,19 +3343,19 @@ msgid "Remove the following math macros using the ``errno`` variable:" msgstr "" msgid "``Py_ADJUST_ERANGE1()``" -msgstr "" +msgstr "``Py_ADJUST_ERANGE1()``" msgid "``Py_ADJUST_ERANGE2()``" -msgstr "" +msgstr "``Py_ADJUST_ERANGE2()``" msgid "``Py_OVERFLOWED()``" -msgstr "" +msgstr "``Py_OVERFLOWED()``" msgid "``Py_SET_ERANGE_IF_OVERFLOW()``" -msgstr "" +msgstr "``Py_SET_ERANGE_IF_OVERFLOW()``" msgid "``Py_SET_ERRNO_ON_MATH_ERROR()``" -msgstr "" +msgstr "``Py_SET_ERRNO_ON_MATH_ERROR()``" msgid "(Contributed by Victor Stinner in :issue:`45412`.)" msgstr "" @@ -3360,21 +3385,21 @@ msgid "" msgstr "" msgid ":c:func:`PyMarshal_WriteLongToFile`" -msgstr "" +msgstr ":c:func:`PyMarshal_WriteLongToFile`" msgid ":c:func:`PyMarshal_WriteObjectToFile`" -msgstr "" +msgstr ":c:func:`PyMarshal_WriteObjectToFile`" msgid ":c:func:`PyMarshal_ReadObjectFromString`" -msgstr "" +msgstr ":c:func:`PyMarshal_ReadObjectFromString`" msgid ":c:func:`PyMarshal_WriteObjectToString`" -msgstr "" +msgstr ":c:func:`PyMarshal_WriteObjectToString`" msgid "the ``Py_MARSHAL_VERSION`` macro" msgstr "" -msgid "These are not part of the :ref:`limited API `." +msgid "These are not part of the :ref:`limited API `." msgstr "" msgid "(Contributed by Victor Stinner in :issue:`45474`.)" @@ -3382,7 +3407,7 @@ msgstr "" msgid "" "Exclude :c:func:`PyWeakref_GET_OBJECT` from the limited C API. It never " -"worked since the :c:type:`PyWeakReference` structure is opaque in the " +"worked since the :c:type:`!PyWeakReference` structure is opaque in the " "limited C API. (Contributed by Victor Stinner in :issue:`35134`.)" msgstr "" @@ -3408,43 +3433,43 @@ msgid "The removed functions are:" msgstr "" msgid ":func:`!PyUnicode_Encode`" -msgstr "" +msgstr ":func:`!PyUnicode_Encode`" msgid ":func:`!PyUnicode_EncodeASCII`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeASCII`" msgid ":func:`!PyUnicode_EncodeLatin1`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeLatin1`" msgid ":func:`!PyUnicode_EncodeUTF7`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeUTF7`" msgid ":func:`!PyUnicode_EncodeUTF8`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeUTF8`" msgid ":func:`!PyUnicode_EncodeUTF16`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeUTF16`" msgid ":func:`!PyUnicode_EncodeUTF32`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeUTF32`" msgid ":func:`!PyUnicode_EncodeUnicodeEscape`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeUnicodeEscape`" msgid ":func:`!PyUnicode_EncodeRawUnicodeEscape`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeRawUnicodeEscape`" msgid ":func:`!PyUnicode_EncodeCharmap`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeCharmap`" msgid ":func:`!PyUnicode_TranslateCharmap`" -msgstr "" +msgstr ":func:`!PyUnicode_TranslateCharmap`" msgid ":func:`!PyUnicode_EncodeDecimal`" -msgstr "" +msgstr ":func:`!PyUnicode_EncodeDecimal`" msgid ":func:`!PyUnicode_TransformDecimalToASCII`" -msgstr "" +msgstr ":func:`!PyUnicode_TransformDecimalToASCII`" msgid "" "See :pep:`624` for details and :pep:`migration guidance <624#alternative-" @@ -3466,3 +3491,92 @@ msgid "" "Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " "Viktorin in :pep:`706`.)" msgstr "" + +msgid "Notable Changes in 3.11.5" +msgstr "" + +msgid "OpenSSL" +msgstr "OpenSSL" + +msgid "" +"Windows builds and macOS installers from python.org now use OpenSSL 3.0." +msgstr "" + +msgid "Notable changes in 3.11.10" +msgstr "" + +msgid "ipaddress" +msgstr "" + +msgid "" +"Fixed ``is_global`` and ``is_private`` behavior in ``IPv4Address``, " +"``IPv6Address``, ``IPv4Network`` and ``IPv6Network``." +msgstr "" + +msgid "email" +msgstr "" + +msgid "Headers with embedded newlines are now quoted on output." +msgstr "" + +msgid "" +"The :mod:`~email.generator` will now refuse to serialize (write) headers " +"that are improperly folded or delimited, such that they would be parsed as " +"multiple headers or joined with adjacent data. If you need to turn this " +"safety feature off, set :attr:`~email.policy.Policy." +"verify_generated_headers`. (Contributed by Bas Bloemsaat and Petr Viktorin " +"in :gh:`121650`.)" +msgstr "" + +msgid "" +":func:`email.utils.getaddresses` and :func:`email.utils.parseaddr` now " +"return ``('', '')`` 2-tuples in more situations where invalid email " +"addresses are encountered, instead of potentially inaccurate values. An " +"optional *strict* parameter was added to these two functions: use " +"``strict=False`` to get the old behavior, accepting malformed inputs. " +"``getattr(email.utils, 'supports_strict_parsing', False)`` can be used to " +"check if the *strict* paramater is available. (Contributed by Thomas Dwyer " +"and Victor Stinner for :gh:`102988` to improve the CVE-2023-27043 fix.)" +msgstr "" + +msgid "Notable changes in 3.11.13" +msgstr "" + +msgid "os.path" +msgstr "" + +msgid "" +"The *strict* parameter to :func:`os.path.realpath` accepts a new value, :" +"data:`os.path.ALLOW_MISSING`. If used, errors other than :exc:" +"`FileNotFoundError` will be re-raised; the resulting path can be missing but " +"it will be free of symlinks. (Contributed by Petr Viktorin for CVE " +"2025-4517.)" +msgstr "" + +msgid "" +":func:`~tarfile.data_filter` now normalizes symbolic link targets in order " +"to avoid path traversal attacks. (Contributed by Petr Viktorin in :gh:" +"`127987` and CVE 2025-4138.)" +msgstr "" + +msgid "" +":func:`~tarfile.TarFile.extractall` now skips fixing up directory attributes " +"when a directory was removed or replaced by another kind of file. " +"(Contributed by Petr Viktorin in :gh:`127987` and CVE 2024-12718.)" +msgstr "" + +msgid "" +":func:`~tarfile.TarFile.extract` and :func:`~tarfile.TarFile.extractall` now " +"(re-)apply the extraction filter when substituting a link (hard or symbolic) " +"with a copy of another archive member, and when fixing up directory " +"attributes. The former raises a new exception, :exc:`~tarfile." +"LinkFallbackError`. (Contributed by Petr Viktorin for CVE 2025-4330 and CVE " +"2024-12718.)" +msgstr "" + +msgid "" +":func:`~tarfile.TarFile.extract` and :func:`~tarfile.TarFile.extractall` no " +"longer extract rejected members when :func:`~tarfile.TarFile.errorlevel` is " +"zero. (Contributed by Matt Prodani and Petr Viktorin in :gh:`112887` and CVE " +"2025-4435.)" +msgstr "" diff --git a/whatsnew/3.2.po b/whatsnew/3.2.po new file mode 100644 index 0000000000..b9f20a6a70 --- /dev/null +++ b/whatsnew/3.2.po @@ -0,0 +1,2741 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2024 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" +"Language-Team: 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 "What's New In Python 3.2" +msgstr "" + +msgid "Author" +msgstr "Autor" + +msgid "Raymond Hettinger" +msgstr "Raymond Hettinger" + +msgid "" +"This article explains the new features in Python 3.2 as compared to 3.1. " +"Python 3.2 was released on February 20, 2011. It focuses on a few highlights " +"and gives a few examples. For full details, see the `Misc/NEWS `__ file." +msgstr "" + +msgid ":pep:`392` - Python 3.2 Release Schedule" +msgstr "" + +msgid "PEP 384: Defining a Stable ABI" +msgstr "" + +msgid "" +"In the past, extension modules built for one Python version were often not " +"usable with other Python versions. Particularly on Windows, every feature " +"release of Python required rebuilding all extension modules that one wanted " +"to use. This requirement was the result of the free access to Python " +"interpreter internals that extension modules could use." +msgstr "" + +msgid "" +"With Python 3.2, an alternative approach becomes available: extension " +"modules which restrict themselves to a limited API (by defining " +"Py_LIMITED_API) cannot use many of the internals, but are constrained to a " +"set of API functions that are promised to be stable for several releases. As " +"a consequence, extension modules built for 3.2 in that mode will also work " +"with 3.3, 3.4, and so on. Extension modules that make use of details of " +"memory structures can still be built, but will need to be recompiled for " +"every feature release." +msgstr "" + +msgid ":pep:`384` - Defining a Stable ABI" +msgstr "" + +msgid "PEP written by Martin von Löwis." +msgstr "" + +msgid "PEP 389: Argparse Command Line Parsing Module" +msgstr "" + +msgid "" +"A new module for command line parsing, :mod:`argparse`, was introduced to " +"overcome the limitations of :mod:`optparse` which did not provide support " +"for positional arguments (not just options), subcommands, required options " +"and other common patterns of specifying and validating options." +msgstr "" + +msgid "" +"This module has already had widespread success in the community as a third-" +"party module. Being more fully featured than its predecessor, the :mod:" +"`argparse` module is now the preferred module for command-line processing. " +"The older module is still being kept available because of the substantial " +"amount of legacy code that depends on it." +msgstr "" + +msgid "" +"Here's an annotated example parser showing features like limiting results to " +"a set of choices, specifying a *metavar* in the help screen, validating that " +"one or more positional arguments is present, and making a required option::" +msgstr "" + +msgid "Example of calling the parser on a command string::" +msgstr "" + +msgid "Example of the parser's automatically generated help::" +msgstr "" + +msgid "" +"An especially nice :mod:`argparse` feature is the ability to define " +"subparsers, each with their own argument patterns and help displays::" +msgstr "" + +msgid ":pep:`389` - New Command Line Parsing Module" +msgstr "" + +msgid "PEP written by Steven Bethard." +msgstr "" + +msgid "" +":ref:`upgrading-optparse-code` for details on the differences from :mod:" +"`optparse`." +msgstr "" + +msgid "PEP 391: Dictionary Based Configuration for Logging" +msgstr "" + +msgid "" +"The :mod:`logging` module provided two kinds of configuration, one style " +"with function calls for each option or another style driven by an external " +"file saved in a :mod:`configparser` format. Those options did not provide " +"the flexibility to create configurations from JSON or YAML files, nor did " +"they support incremental configuration, which is needed for specifying " +"logger options from a command line." +msgstr "" + +msgid "" +"To support a more flexible style, the module now offers :func:`logging." +"config.dictConfig` for specifying logging configuration with plain Python " +"dictionaries. The configuration options include formatters, handlers, " +"filters, and loggers. Here's a working example of a configuration " +"dictionary::" +msgstr "" + +msgid "" +"If that dictionary is stored in a file called :file:`conf.json`, it can be " +"loaded and called with code like this::" +msgstr "" + +msgid ":pep:`391` - Dictionary Based Configuration for Logging" +msgstr "" + +msgid "PEP written by Vinay Sajip." +msgstr "" + +msgid "PEP 3148: The ``concurrent.futures`` module" +msgstr "" + +msgid "" +"Code for creating and managing concurrency is being collected in a new top-" +"level namespace, *concurrent*. Its first member is a *futures* package " +"which provides a uniform high-level interface for managing threads and " +"processes." +msgstr "" + +msgid "" +"The design for :mod:`concurrent.futures` was inspired by the *java.util." +"concurrent* package. In that model, a running call and its result are " +"represented by a :class:`~concurrent.futures.Future` object that abstracts " +"features common to threads, processes, and remote procedure calls. That " +"object supports status checks (running or done), timeouts, cancellations, " +"adding callbacks, and access to results or exceptions." +msgstr "" + +msgid "" +"The primary offering of the new module is a pair of executor classes for " +"launching and managing calls. The goal of the executors is to make it " +"easier to use existing tools for making parallel calls. They save the effort " +"needed to setup a pool of resources, launch the calls, create a results " +"queue, add time-out handling, and limit the total number of threads, " +"processes, or remote procedure calls." +msgstr "" + +msgid "" +"Ideally, each application should share a single executor across multiple " +"components so that process and thread limits can be centrally managed. This " +"solves the design challenge that arises when each component has its own " +"competing strategy for resource management." +msgstr "" + +msgid "" +"Both classes share a common interface with three methods: :meth:`~concurrent." +"futures.Executor.submit` for scheduling a callable and returning a :class:" +"`~concurrent.futures.Future` object; :meth:`~concurrent.futures.Executor." +"map` for scheduling many asynchronous calls at a time, and :meth:" +"`~concurrent.futures.Executor.shutdown` for freeing resources. The class is " +"a :term:`context manager` and can be used in a :keyword:`with` statement to " +"assure that resources are automatically released when currently pending " +"futures are done executing." +msgstr "" + +msgid "" +"A simple of example of :class:`~concurrent.futures.ThreadPoolExecutor` is a " +"launch of four parallel threads for copying files::" +msgstr "" + +msgid ":pep:`3148` - Futures -- Execute Computations Asynchronously" +msgstr "" + +msgid "PEP written by Brian Quinlan." +msgstr "" + +msgid "" +":ref:`Code for Threaded Parallel URL reads`, an " +"example using threads to fetch multiple web pages in parallel." +msgstr "" + +msgid "" +":ref:`Code for computing prime numbers in parallel`, an example demonstrating :class:`~concurrent.futures." +"ProcessPoolExecutor`." +msgstr "" + +msgid "PEP 3147: PYC Repository Directories" +msgstr "" + +msgid "" +"Python's scheme for caching bytecode in *.pyc* files did not work well in " +"environments with multiple Python interpreters. If one interpreter " +"encountered a cached file created by another interpreter, it would recompile " +"the source and overwrite the cached file, thus losing the benefits of " +"caching." +msgstr "" + +msgid "" +"The issue of \"pyc fights\" has become more pronounced as it has become " +"commonplace for Linux distributions to ship with multiple versions of " +"Python. These conflicts also arise with CPython alternatives such as Unladen " +"Swallow." +msgstr "" + +msgid "" +"To solve this problem, Python's import machinery has been extended to use " +"distinct filenames for each interpreter. Instead of Python 3.2 and Python " +"3.3 and Unladen Swallow each competing for a file called \"mymodule.pyc\", " +"they will now look for \"mymodule.cpython-32.pyc\", \"mymodule.cpython-33." +"pyc\", and \"mymodule.unladen10.pyc\". And to prevent all of these new " +"files from cluttering source directories, the *pyc* files are now collected " +"in a \"__pycache__\" directory stored under the package directory." +msgstr "" + +msgid "" +"Aside from the filenames and target directories, the new scheme has a few " +"aspects that are visible to the programmer:" +msgstr "" + +msgid "" +"Imported modules now have a :attr:`__cached__` attribute which stores the " +"name of the actual file that was imported:" +msgstr "" + +msgid "" +"The tag that is unique to each interpreter is accessible from the :mod:`imp` " +"module:" +msgstr "" + +msgid "" +"Scripts that try to deduce source filename from the imported file now need " +"to be smarter. It is no longer sufficient to simply strip the \"c\" from a " +"\".pyc\" filename. Instead, use the new functions in the :mod:`imp` module:" +msgstr "" + +msgid "" +"The :mod:`py_compile` and :mod:`compileall` modules have been updated to " +"reflect the new naming convention and target directory. The command-line " +"invocation of *compileall* has new options: ``-i`` for specifying a list of " +"files and directories to compile and ``-b`` which causes bytecode files to " +"be written to their legacy location rather than *__pycache__*." +msgstr "" + +msgid "" +"The :mod:`importlib.abc` module has been updated with new :term:`abstract " +"base classes ` for loading bytecode files. The " +"obsolete ABCs, :class:`!PyLoader` and :class:`!PyPycLoader`, have been " +"deprecated (instructions on how to stay Python 3.1 compatible are included " +"with the documentation)." +msgstr "" + +msgid ":pep:`3147` - PYC Repository Directories" +msgstr "" + +msgid "PEP written by Barry Warsaw." +msgstr "" + +msgid "PEP 3149: ABI Version Tagged .so Files" +msgstr "" + +msgid "" +"The PYC repository directory allows multiple bytecode cache files to be co-" +"located. This PEP implements a similar mechanism for shared object files by " +"giving them a common directory and distinct names for each version." +msgstr "" + +msgid "" +"The common directory is \"pyshared\" and the file names are made distinct by " +"identifying the Python implementation (such as CPython, PyPy, Jython, etc.), " +"the major and minor version numbers, and optional build flags (such as \"d\" " +"for debug, \"m\" for pymalloc, \"u\" for wide-unicode). For an arbitrary " +"package \"foo\", you may see these files when the distribution package is " +"installed::" +msgstr "" + +msgid "" +"In Python itself, the tags are accessible from functions in the :mod:" +"`sysconfig` module::" +msgstr "" + +msgid ":pep:`3149` - ABI Version Tagged .so Files" +msgstr "" + +msgid "PEP 3333: Python Web Server Gateway Interface v1.0.1" +msgstr "" + +msgid "" +"This informational PEP clarifies how bytes/text issues are to be handled by " +"the WSGI protocol. The challenge is that string handling in Python 3 is " +"most conveniently handled with the :class:`str` type even though the HTTP " +"protocol is itself bytes oriented." +msgstr "" + +msgid "" +"The PEP differentiates so-called *native strings* that are used for request/" +"response headers and metadata versus *byte strings* which are used for the " +"bodies of requests and responses." +msgstr "" + +msgid "" +"The *native strings* are always of type :class:`str` but are restricted to " +"code points between *U+0000* through *U+00FF* which are translatable to " +"bytes using *Latin-1* encoding. These strings are used for the keys and " +"values in the environment dictionary and for response headers and statuses " +"in the :func:`!start_response` function. They must follow :rfc:`2616` with " +"respect to encoding. That is, they must either be *ISO-8859-1* characters or " +"use :rfc:`2047` MIME encoding." +msgstr "" + +msgid "" +"For developers porting WSGI applications from Python 2, here are the salient " +"points:" +msgstr "" + +msgid "" +"If the app already used strings for headers in Python 2, no change is needed." +msgstr "" + +msgid "" +"If instead, the app encoded output headers or decoded input headers, then " +"the headers will need to be re-encoded to Latin-1. For example, an output " +"header encoded in utf-8 was using ``h.encode('utf-8')`` now needs to convert " +"from bytes to native strings using ``h.encode('utf-8').decode('latin-1')``." +msgstr "" + +msgid "" +"Values yielded by an application or sent using the :meth:`!write` method " +"must be byte strings. The :func:`!start_response` function and environ must " +"use native strings. The two cannot be mixed." +msgstr "" + +msgid "" +"For server implementers writing CGI-to-WSGI pathways or other CGI-style " +"protocols, the users must to be able access the environment using native " +"strings even though the underlying platform may have a different " +"convention. To bridge this gap, the :mod:`wsgiref` module has a new " +"function, :func:`wsgiref.handlers.read_environ` for transcoding CGI " +"variables from :data:`os.environ` into native strings and returning a new " +"dictionary." +msgstr "" + +msgid ":pep:`3333` - Python Web Server Gateway Interface v1.0.1" +msgstr "" + +msgid "PEP written by Phillip Eby." +msgstr "" + +msgid "Other Language Changes" +msgstr "" + +msgid "Some smaller changes made to the core Python language are:" +msgstr "" + +msgid "" +"String formatting for :func:`format` and :meth:`str.format` gained new " +"capabilities for the format character **#**. Previously, for integers in " +"binary, octal, or hexadecimal, it caused the output to be prefixed with " +"'0b', '0o', or '0x' respectively. Now it can also handle floats, complex, " +"and Decimal, causing the output to always have a decimal point even when no " +"digits follow it." +msgstr "" + +msgid "" +"(Suggested by Mark Dickinson and implemented by Eric Smith in :issue:`7094`.)" +msgstr "" + +msgid "" +"There is also a new :meth:`str.format_map` method that extends the " +"capabilities of the existing :meth:`str.format` method by accepting " +"arbitrary :term:`mapping` objects. This new method makes it possible to use " +"string formatting with any of Python's many dictionary-like objects such as :" +"class:`~collections.defaultdict`, :class:`~shelve.Shelf`, :class:" +"`~configparser.ConfigParser`, or :mod:`dbm`. It is also useful with custom :" +"class:`dict` subclasses that normalize keys before look-up or that supply a :" +"meth:`__missing__` method for unknown keys::" +msgstr "" + +msgid "" +"(Suggested by Raymond Hettinger and implemented by Eric Smith in :issue:" +"`6081`.)" +msgstr "" + +msgid "" +"The interpreter can now be started with a quiet option, ``-q``, to prevent " +"the copyright and version information from being displayed in the " +"interactive mode. The option can be introspected using the :data:`sys." +"flags` attribute:" +msgstr "" + +msgid "(Contributed by Marcin Wojdyr in :issue:`1772833`)." +msgstr "" + +msgid "" +"The :func:`hasattr` function works by calling :func:`getattr` and detecting " +"whether an exception is raised. This technique allows it to detect methods " +"created dynamically by :meth:`~object.__getattr__` or :meth:`~object." +"__getattribute__` which would otherwise be absent from the class " +"dictionary. Formerly, *hasattr* would catch any exception, possibly masking " +"genuine errors. Now, *hasattr* has been tightened to only catch :exc:" +"`AttributeError` and let other exceptions pass through::" +msgstr "" + +msgid "" +"(Discovered by Yury Selivanov and fixed by Benjamin Peterson; :issue:`9666`.)" +msgstr "" + +msgid "" +"The :func:`str` of a float or complex number is now the same as its :func:" +"`repr`. Previously, the :func:`str` form was shorter but that just caused " +"confusion and is no longer needed now that the shortest possible :func:" +"`repr` is displayed by default:" +msgstr "" + +msgid "(Proposed and implemented by Mark Dickinson; :issue:`9337`.)" +msgstr "" + +msgid "" +":class:`memoryview` objects now have a :meth:`~memoryview.release()` method " +"and they also now support the context management protocol. This allows " +"timely release of any resources that were acquired when requesting a buffer " +"from the original object." +msgstr "" + +msgid "(Added by Antoine Pitrou; :issue:`9757`.)" +msgstr "" + +msgid "" +"Previously it was illegal to delete a name from the local namespace if it " +"occurs as a free variable in a nested block::" +msgstr "" + +msgid "" +"This is now allowed. Remember that the target of an :keyword:`except` " +"clause is cleared, so this code which used to work with Python 2.6, raised " +"a :exc:`SyntaxError` with Python 3.1 and now works again::" +msgstr "" + +msgid "(See :issue:`4617`.)" +msgstr "" + +msgid "" +":ref:`Struct sequence types ` are now subclasses of " +"tuple. This means that C structures like those returned by :func:`os.stat`, :" +"func:`time.gmtime`, and :data:`sys.version_info` now work like a :term:" +"`named tuple` and now work with functions and methods that expect a tuple as " +"an argument. This is a big step forward in making the C structures as " +"flexible as their pure Python counterparts:" +msgstr "" + +msgid "" +"(Suggested by Arfrever Frehtes Taifersar Arahesis and implemented by " +"Benjamin Peterson in :issue:`8413`.)" +msgstr "" + +msgid "" +"Warnings are now easier to control using the :envvar:`PYTHONWARNINGS` " +"environment variable as an alternative to using ``-W`` at the command line:" +msgstr "" + +msgid "" +"(Suggested by Barry Warsaw and implemented by Philip Jenvey in :issue:" +"`7301`.)" +msgstr "" + +msgid "" +"A new warning category, :exc:`ResourceWarning`, has been added. It is " +"emitted when potential issues with resource consumption or cleanup are " +"detected. It is silenced by default in normal release builds but can be " +"enabled through the means provided by the :mod:`warnings` module, or on the " +"command line." +msgstr "" + +msgid "" +"A :exc:`ResourceWarning` is issued at interpreter shutdown if the :data:`gc." +"garbage` list isn't empty, and if :const:`gc.DEBUG_UNCOLLECTABLE` is set, " +"all uncollectable objects are printed. This is meant to make the programmer " +"aware that their code contains object finalization issues." +msgstr "" + +msgid "" +"A :exc:`ResourceWarning` is also issued when a :term:`file object` is " +"destroyed without having been explicitly closed. While the deallocator for " +"such object ensures it closes the underlying operating system resource " +"(usually, a file descriptor), the delay in deallocating the object could " +"produce various issues, especially under Windows. Here is an example of " +"enabling the warning from the command line:" +msgstr "" + +msgid "" +"(Added by Antoine Pitrou and Georg Brandl in :issue:`10093` and :issue:" +"`477863`.)" +msgstr "" + +msgid "" +":class:`range` objects now support *index* and *count* methods. This is part " +"of an effort to make more objects fully implement the :class:`collections." +"Sequence ` :term:`abstract base class`. As a " +"result, the language will have a more uniform API. In addition, :class:" +"`range` objects now support slicing and negative indices, even with values " +"larger than :data:`sys.maxsize`. This makes *range* more interoperable with " +"lists::" +msgstr "" + +msgid "" +"(Contributed by Daniel Stutzbach in :issue:`9213`, by Alexander Belopolsky " +"in :issue:`2690`, and by Nick Coghlan in :issue:`10889`.)" +msgstr "" + +msgid "" +"The :func:`callable` builtin function from Py2.x was resurrected. It " +"provides a concise, readable alternative to using an :term:`abstract base " +"class` in an expression like ``isinstance(x, collections.Callable)``:" +msgstr "" + +msgid "(See :issue:`10518`.)" +msgstr "" + +msgid "" +"Python's import mechanism can now load modules installed in directories with " +"non-ASCII characters in the path name. This solved an aggravating problem " +"with home directories for users with non-ASCII characters in their usernames." +msgstr "" + +msgid "(Required extensive work by Victor Stinner in :issue:`9425`.)" +msgstr "" + +msgid "New, Improved, and Deprecated Modules" +msgstr "" + +msgid "" +"Python's standard library has undergone significant maintenance efforts and " +"quality improvements." +msgstr "" + +msgid "" +"The biggest news for Python 3.2 is that the :mod:`email` package, :mod:" +"`mailbox` module, and :mod:`nntplib` modules now work correctly with the " +"bytes/text model in Python 3. For the first time, there is correct handling " +"of messages with mixed encodings." +msgstr "" + +msgid "" +"Throughout the standard library, there has been more careful attention to " +"encodings and text versus bytes issues. In particular, interactions with " +"the operating system are now better able to exchange non-ASCII data using " +"the Windows MBCS encoding, locale-aware encodings, or UTF-8." +msgstr "" + +msgid "" +"Another significant win is the addition of substantially better support for " +"*SSL* connections and security certificates." +msgstr "" + +msgid "" +"In addition, more classes now implement a :term:`context manager` to support " +"convenient and reliable resource clean-up using a :keyword:`with` statement." +msgstr "" + +msgid "email" +msgstr "" + +msgid "" +"The usability of the :mod:`email` package in Python 3 has been mostly fixed " +"by the extensive efforts of R. David Murray. The problem was that emails " +"are typically read and stored in the form of :class:`bytes` rather than :" +"class:`str` text, and they may contain multiple encodings within a single " +"email. So, the email package had to be extended to parse and generate email " +"messages in bytes format." +msgstr "" + +msgid "" +"New functions :func:`~email.message_from_bytes` and :func:`~email." +"message_from_binary_file`, and new classes :class:`~email.parser." +"BytesFeedParser` and :class:`~email.parser.BytesParser` allow binary message " +"data to be parsed into model objects." +msgstr "" + +msgid "" +"Given bytes input to the model, :meth:`~email.message.Message.get_payload` " +"will by default decode a message body that has a :mailheader:`Content-" +"Transfer-Encoding` of *8bit* using the charset specified in the MIME headers " +"and return the resulting string." +msgstr "" + +msgid "" +"Given bytes input to the model, :class:`~email.generator.Generator` will " +"convert message bodies that have a :mailheader:`Content-Transfer-Encoding` " +"of *8bit* to instead have a *7bit* :mailheader:`Content-Transfer-Encoding`." +msgstr "" + +msgid "" +"Headers with unencoded non-ASCII bytes are deemed to be :rfc:`2047`\\ -" +"encoded using the *unknown-8bit* character set." +msgstr "" + +msgid "" +"A new class :class:`~email.generator.BytesGenerator` produces bytes as " +"output, preserving any unchanged non-ASCII data that was present in the " +"input used to build the model, including message bodies with a :mailheader:" +"`Content-Transfer-Encoding` of *8bit*." +msgstr "" + +msgid "" +"The :mod:`smtplib` :class:`~smtplib.SMTP` class now accepts a byte string " +"for the *msg* argument to the :meth:`~smtplib.SMTP.sendmail` method, and a " +"new method, :meth:`~smtplib.SMTP.send_message` accepts a :class:`~email." +"message.Message` object and can optionally obtain the *from_addr* and " +"*to_addrs* addresses directly from the object." +msgstr "" + +msgid "" +"(Proposed and implemented by R. David Murray, :issue:`4661` and :issue:" +"`10321`.)" +msgstr "" + +msgid "elementtree" +msgstr "" + +msgid "" +"The :mod:`xml.etree.ElementTree` package and its :mod:`!xml.etree." +"cElementTree` counterpart have been updated to version 1.3." +msgstr "" + +msgid "Several new and useful functions and methods have been added:" +msgstr "" + +msgid "" +":func:`xml.etree.ElementTree.fromstringlist` which builds an XML document " +"from a sequence of fragments" +msgstr "" + +msgid "" +":func:`xml.etree.ElementTree.register_namespace` for registering a global " +"namespace prefix" +msgstr "" + +msgid "" +":func:`xml.etree.ElementTree.tostringlist` for string representation " +"including all sublists" +msgstr "" + +msgid "" +":meth:`xml.etree.ElementTree.Element.extend` for appending a sequence of " +"zero or more elements" +msgstr "" + +msgid "" +":meth:`xml.etree.ElementTree.Element.iterfind` searches an element and " +"subelements" +msgstr "" + +msgid "" +":meth:`xml.etree.ElementTree.Element.itertext` creates a text iterator over " +"an element and its subelements" +msgstr "" + +msgid "" +":meth:`xml.etree.ElementTree.TreeBuilder.end` closes the current element" +msgstr "" + +msgid "" +":meth:`xml.etree.ElementTree.TreeBuilder.doctype` handles a doctype " +"declaration" +msgstr "" + +msgid "Two methods have been deprecated:" +msgstr "" + +msgid ":meth:`!xml.etree.ElementTree.getchildren` use ``list(elem)`` instead." +msgstr "" + +msgid "" +":meth:`!xml.etree.ElementTree.getiterator` use ``Element.iter`` instead." +msgstr "" + +msgid "" +"For details of the update, see `Introducing ElementTree `_ on " +"Fredrik Lundh's website." +msgstr "" + +msgid "(Contributed by Florent Xicluna and Fredrik Lundh, :issue:`6472`.)" +msgstr "" + +msgid "functools" +msgstr "" + +msgid "" +"The :mod:`functools` module includes a new decorator for caching function " +"calls. :func:`functools.lru_cache` can save repeated queries to an external " +"resource whenever the results are expected to be the same." +msgstr "" + +msgid "" +"For example, adding a caching decorator to a database query function can " +"save database accesses for popular searches:" +msgstr "" + +msgid "" +"To help with choosing an effective cache size, the wrapped function is " +"instrumented for tracking cache statistics:" +msgstr "" + +msgid "" +"If the phonelist table gets updated, the outdated contents of the cache can " +"be cleared with:" +msgstr "" + +msgid "" +"(Contributed by Raymond Hettinger and incorporating design ideas from Jim " +"Baker, Miki Tebeka, and Nick Coghlan; see `recipe 498245 `_\\, `recipe 577479 `_\\, :issue:`10586`, and :issue:`10593`.)" +msgstr "" + +msgid "" +"The :func:`functools.wraps` decorator now adds a :attr:`__wrapped__` " +"attribute pointing to the original callable function. This allows wrapped " +"functions to be introspected. It also copies :attr:`~function." +"__annotations__` if defined. And now it also gracefully skips over missing " +"attributes such as :attr:`~function.__doc__` which might not be defined for " +"the wrapped callable." +msgstr "" + +msgid "" +"In the above example, the cache can be removed by recovering the original " +"function:" +msgstr "" + +msgid "" +"(By Nick Coghlan and Terrence Cole; :issue:`9567`, :issue:`3445`, and :issue:" +"`8814`.)" +msgstr "" + +msgid "" +"To help write classes with rich comparison methods, a new decorator :func:" +"`functools.total_ordering` will use existing equality and inequality methods " +"to fill in the remaining methods." +msgstr "" + +msgid "" +"For example, supplying *__eq__* and *__lt__* will enable :func:`~functools." +"total_ordering` to fill-in *__le__*, *__gt__* and *__ge__*::" +msgstr "" + +msgid "" +"With the *total_ordering* decorator, the remaining comparison methods are " +"filled in automatically." +msgstr "" + +msgid "(Contributed by Raymond Hettinger.)" +msgstr "" + +msgid "" +"To aid in porting programs from Python 2, the :func:`functools.cmp_to_key` " +"function converts an old-style comparison function to modern :term:`key " +"function`:" +msgstr "" + +msgid "" +"For sorting examples and a brief sorting tutorial, see the `Sorting HowTo " +"`_ tutorial." +msgstr "" + +msgid "itertools" +msgstr "" + +msgid "" +"The :mod:`itertools` module has a new :func:`~itertools.accumulate` function " +"modeled on APL's *scan* operator and Numpy's *accumulate* function:" +msgstr "" + +msgid "" +"For an example using :func:`~itertools.accumulate`, see the :ref:`examples " +"for the random module `." +msgstr "" + +msgid "" +"(Contributed by Raymond Hettinger and incorporating design suggestions from " +"Mark Dickinson.)" +msgstr "" + +msgid "collections" +msgstr "" + +msgid "" +"The :class:`collections.Counter` class now has two forms of in-place " +"subtraction, the existing *-=* operator for `saturating subtraction `_ and the new :meth:" +"`~collections.Counter.subtract` method for regular subtraction. The former " +"is suitable for `multisets `_ which " +"only have positive counts, and the latter is more suitable for use cases " +"that allow negative counts:" +msgstr "" + +msgid "" +"The :class:`collections.OrderedDict` class has a new method :meth:" +"`~collections.OrderedDict.move_to_end` which takes an existing key and moves " +"it to either the first or last position in the ordered sequence." +msgstr "" + +msgid "" +"The default is to move an item to the last position. This is equivalent of " +"renewing an entry with ``od[k] = od.pop(k)``." +msgstr "" + +msgid "" +"A fast move-to-end operation is useful for resequencing entries. For " +"example, an ordered dictionary can be used to track order of access by aging " +"entries from the oldest to the most recently accessed." +msgstr "" + +msgid "" +"The :class:`collections.deque` class grew two new methods :meth:" +"`~collections.deque.count` and :meth:`~collections.deque.reverse` that make " +"them more substitutable for :class:`list` objects:" +msgstr "" + +msgid "threading" +msgstr "" + +msgid "" +"The :mod:`threading` module has a new :class:`~threading.Barrier` " +"synchronization class for making multiple threads wait until all of them " +"have reached a common barrier point. Barriers are useful for making sure " +"that a task with multiple preconditions does not run until all of the " +"predecessor tasks are complete." +msgstr "" + +msgid "" +"Barriers can work with an arbitrary number of threads. This is a " +"generalization of a `Rendezvous `_ which is defined for only two threads." +msgstr "" + +msgid "" +"Implemented as a two-phase cyclic barrier, :class:`~threading.Barrier` " +"objects are suitable for use in loops. The separate *filling* and " +"*draining* phases assure that all threads get released (drained) before any " +"one of them can loop back and re-enter the barrier. The barrier fully " +"resets after each cycle." +msgstr "" + +msgid "Example of using barriers::" +msgstr "" + +msgid "" +"In this example, the barrier enforces a rule that votes cannot be counted at " +"any polling site until all polls are closed. Notice how a solution with a " +"barrier is similar to one with :meth:`threading.Thread.join`, but the " +"threads stay alive and continue to do work (summarizing ballots) after the " +"barrier point is crossed." +msgstr "" + +msgid "" +"If any of the predecessor tasks can hang or be delayed, a barrier can be " +"created with an optional *timeout* parameter. Then if the timeout period " +"elapses before all the predecessor tasks reach the barrier point, all " +"waiting threads are released and a :exc:`~threading.BrokenBarrierError` " +"exception is raised::" +msgstr "" + +msgid "" +"In this example, the barrier enforces a more robust rule. If some election " +"sites do not finish before midnight, the barrier times-out and the ballots " +"are sealed and deposited in a queue for later handling." +msgstr "" + +msgid "" +"See `Barrier Synchronization Patterns `_ for more examples " +"of how barriers can be used in parallel computing. Also, there is a simple " +"but thorough explanation of barriers in `The Little Book of Semaphores " +"`_, " +"*section 3.6*." +msgstr "" + +msgid "" +"(Contributed by Kristján Valur Jónsson with an API review by Jeffrey Yasskin " +"in :issue:`8777`.)" +msgstr "" + +msgid "datetime and time" +msgstr "" + +msgid "" +"The :mod:`datetime` module has a new type :class:`~datetime.timezone` that " +"implements the :class:`~datetime.tzinfo` interface by returning a fixed UTC " +"offset and timezone name. This makes it easier to create timezone-aware " +"datetime objects::" +msgstr "" + +msgid "" +"Also, :class:`~datetime.timedelta` objects can now be multiplied by :class:" +"`float` and divided by :class:`float` and :class:`int` objects. And :class:" +"`~datetime.timedelta` objects can now divide one another." +msgstr "" + +msgid "" +"The :meth:`datetime.date.strftime` method is no longer restricted to years " +"after 1900. The new supported year range is from 1000 to 9999 inclusive." +msgstr "" + +msgid "" +"Whenever a two-digit year is used in a time tuple, the interpretation has " +"been governed by :data:`!time.accept2dyear`. The default is ``True`` which " +"means that for a two-digit year, the century is guessed according to the " +"POSIX rules governing the ``%y`` strptime format." +msgstr "" + +msgid "" +"Starting with Py3.2, use of the century guessing heuristic will emit a :exc:" +"`DeprecationWarning`. Instead, it is recommended that :data:`!time." +"accept2dyear` be set to ``False`` so that large date ranges can be used " +"without guesswork::" +msgstr "" + +msgid "" +"Several functions now have significantly expanded date ranges. When :data:`!" +"time.accept2dyear` is false, the :func:`time.asctime` function will accept " +"any year that fits in a C int, while the :func:`time.mktime` and :func:`time." +"strftime` functions will accept the full range supported by the " +"corresponding operating system functions." +msgstr "" + +msgid "" +"(Contributed by Alexander Belopolsky and Victor Stinner in :issue:" +"`1289118`, :issue:`5094`, :issue:`6641`, :issue:`2706`, :issue:`1777412`, :" +"issue:`8013`, and :issue:`10827`.)" +msgstr "" + +msgid "math" +msgstr "" + +msgid "" +"The :mod:`math` module has been updated with six new functions inspired by " +"the C99 standard." +msgstr "" + +msgid "" +"The :func:`~math.isfinite` function provides a reliable and fast way to " +"detect special values. It returns ``True`` for regular numbers and " +"``False`` for *Nan* or *Infinity*:" +msgstr "" + +msgid "" +"The :func:`~math.expm1` function computes ``e**x-1`` for small values of *x* " +"without incurring the loss of precision that usually accompanies the " +"subtraction of nearly equal quantities:" +msgstr "" + +msgid "" +"The :func:`~math.erf` function computes a probability integral or `Gaussian " +"error function `_. The " +"complementary error function, :func:`~math.erfc`, is ``1 - erf(x)``:" +msgstr "" + +msgid "" +"The :func:`~math.gamma` function is a continuous extension of the factorial " +"function. See https://en.wikipedia.org/wiki/Gamma_function for details. " +"Because the function is related to factorials, it grows large even for small " +"values of *x*, so there is also a :func:`~math.lgamma` function for " +"computing the natural logarithm of the gamma function:" +msgstr "" + +msgid "(Contributed by Mark Dickinson.)" +msgstr "" + +msgid "abc" +msgstr "" + +msgid "" +"The :mod:`abc` module now supports :func:`~abc.abstractclassmethod` and :" +"func:`~abc.abstractstaticmethod`." +msgstr "" + +msgid "" +"These tools make it possible to define an :term:`abstract base class` that " +"requires a particular :func:`classmethod` or :func:`staticmethod` to be " +"implemented::" +msgstr "" + +msgid "(Patch submitted by Daniel Urban; :issue:`5867`.)" +msgstr "" + +msgid "io" +msgstr "" + +msgid "" +"The :class:`io.BytesIO` has a new method, :meth:`~io.BytesIO.getbuffer`, " +"which provides functionality similar to :func:`memoryview`. It creates an " +"editable view of the data without making a copy. The buffer's random access " +"and support for slice notation are well-suited to in-place editing::" +msgstr "" + +msgid "(Contributed by Antoine Pitrou in :issue:`5506`.)" +msgstr "" + +msgid "reprlib" +msgstr "" + +msgid "" +"When writing a :meth:`~object.__repr__` method for a custom container, it is " +"easy to forget to handle the case where a member refers back to the " +"container itself. Python's builtin objects such as :class:`list` and :class:" +"`set` handle self-reference by displaying \"...\" in the recursive part of " +"the representation string." +msgstr "" + +msgid "" +"To help write such :meth:`~object.__repr__` methods, the :mod:`reprlib` " +"module has a new decorator, :func:`~reprlib.recursive_repr`, for detecting " +"recursive calls to :meth:`!__repr__` and substituting a placeholder string " +"instead::" +msgstr "" + +msgid "(Contributed by Raymond Hettinger in :issue:`9826` and :issue:`9840`.)" +msgstr "" + +msgid "logging" +msgstr "" + +msgid "" +"In addition to dictionary-based configuration described above, the :mod:" +"`logging` package has many other improvements." +msgstr "" + +msgid "" +"The logging documentation has been augmented by a :ref:`basic tutorial " +"`\\, an :ref:`advanced tutorial `\\, and a :ref:`cookbook ` of logging recipes. " +"These documents are the fastest way to learn about logging." +msgstr "" + +msgid "" +"The :func:`logging.basicConfig` set-up function gained a *style* argument to " +"support three different types of string formatting. It defaults to \"%\" " +"for traditional %-formatting, can be set to \"{\" for the new :meth:`str." +"format` style, or can be set to \"$\" for the shell-style formatting " +"provided by :class:`string.Template`. The following three configurations " +"are equivalent::" +msgstr "" + +msgid "" +"If no configuration is set-up before a logging event occurs, there is now a " +"default configuration using a :class:`~logging.StreamHandler` directed to :" +"data:`sys.stderr` for events of ``WARNING`` level or higher. Formerly, an " +"event occurring before a configuration was set-up would either raise an " +"exception or silently drop the event depending on the value of :data:" +"`logging.raiseExceptions`. The new default handler is stored in :data:" +"`logging.lastResort`." +msgstr "" + +msgid "" +"The use of filters has been simplified. Instead of creating a :class:" +"`~logging.Filter` object, the predicate can be any Python callable that " +"returns ``True`` or ``False``." +msgstr "" + +msgid "" +"There were a number of other improvements that add flexibility and simplify " +"configuration. See the module documentation for a full listing of changes " +"in Python 3.2." +msgstr "" + +msgid "csv" +msgstr "" + +msgid "" +"The :mod:`csv` module now supports a new dialect, :class:`~csv." +"unix_dialect`, which applies quoting for all fields and a traditional Unix " +"style with ``'\\n'`` as the line terminator. The registered dialect name is " +"``unix``." +msgstr "" + +msgid "" +"The :class:`csv.DictWriter` has a new method, :meth:`~csv.DictWriter." +"writeheader` for writing-out an initial row to document the field names::" +msgstr "" + +msgid "" +"(New dialect suggested by Jay Talbot in :issue:`5975`, and the new method " +"suggested by Ed Abraham in :issue:`1537721`.)" +msgstr "" + +msgid "contextlib" +msgstr "" + +msgid "" +"There is a new and slightly mind-blowing tool :class:`~contextlib." +"ContextDecorator` that is helpful for creating a :term:`context manager` " +"that does double duty as a function decorator." +msgstr "" + +msgid "" +"As a convenience, this new functionality is used by :func:`~contextlib." +"contextmanager` so that no extra effort is needed to support both roles." +msgstr "" + +msgid "" +"The basic idea is that both context managers and function decorators can be " +"used for pre-action and post-action wrappers. Context managers wrap a group " +"of statements using a :keyword:`with` statement, and function decorators " +"wrap a group of statements enclosed in a function. So, occasionally there " +"is a need to write a pre-action or post-action wrapper that can be used in " +"either role." +msgstr "" + +msgid "" +"For example, it is sometimes useful to wrap functions or groups of " +"statements with a logger that can track the time of entry and time of exit. " +"Rather than writing both a function decorator and a context manager for the " +"task, the :func:`~contextlib.contextmanager` provides both capabilities in a " +"single definition::" +msgstr "" + +msgid "Formerly, this would have only been usable as a context manager::" +msgstr "" + +msgid "Now, it can be used as a decorator as well::" +msgstr "" + +msgid "" +"Trying to fulfill two roles at once places some limitations on the " +"technique. Context managers normally have the flexibility to return an " +"argument usable by a :keyword:`with` statement, but there is no parallel for " +"function decorators." +msgstr "" + +msgid "" +"In the above example, there is not a clean way for the " +"*track_entry_and_exit* context manager to return a logging instance for use " +"in the body of enclosed statements." +msgstr "" + +msgid "(Contributed by Michael Foord in :issue:`9110`.)" +msgstr "" + +msgid "decimal and fractions" +msgstr "" + +msgid "" +"Mark Dickinson crafted an elegant and efficient scheme for assuring that " +"different numeric datatypes will have the same hash value whenever their " +"actual values are equal (:issue:`8188`)::" +msgstr "" + +msgid "" +"Some of the hashing details are exposed through a new attribute, :data:`sys." +"hash_info`, which describes the bit width of the hash value, the prime " +"modulus, the hash values for *infinity* and *nan*, and the multiplier used " +"for the imaginary part of a number:" +msgstr "" + +msgid "" +"An early decision to limit the interoperability of various numeric types has " +"been relaxed. It is still unsupported (and ill-advised) to have implicit " +"mixing in arithmetic expressions such as ``Decimal('1.1') + float('1.1')`` " +"because the latter loses information in the process of constructing the " +"binary float. However, since existing floating point value can be converted " +"losslessly to either a decimal or rational representation, it makes sense to " +"add them to the constructor and to support mixed-type comparisons." +msgstr "" + +msgid "" +"The :class:`decimal.Decimal` constructor now accepts :class:`float` objects " +"directly so there in no longer a need to use the :meth:`~decimal.Decimal." +"from_float` method (:issue:`8257`)." +msgstr "" + +msgid "" +"Mixed type comparisons are now fully supported so that :class:`~decimal." +"Decimal` objects can be directly compared with :class:`float` and :class:" +"`fractions.Fraction` (:issue:`2531` and :issue:`8188`)." +msgstr "" + +msgid "" +"Similar changes were made to :class:`fractions.Fraction` so that the :meth:" +"`~fractions.Fraction.from_float()` and :meth:`~fractions.Fraction." +"from_decimal` methods are no longer needed (:issue:`8294`):" +msgstr "" + +msgid "" +"Another useful change for the :mod:`decimal` module is that the :attr:" +"`Context.clamp ` attribute is now public. This is " +"useful in creating contexts that correspond to the decimal interchange " +"formats specified in IEEE 754 (see :issue:`8540`)." +msgstr "" + +msgid "(Contributed by Mark Dickinson and Raymond Hettinger.)" +msgstr "" + +msgid "ftp" +msgstr "" + +msgid "" +"The :class:`ftplib.FTP` class now supports the context management protocol " +"to unconditionally consume :exc:`socket.error` exceptions and to close the " +"FTP connection when done::" +msgstr "" + +msgid "" +"Other file-like objects such as :class:`mmap.mmap` and :func:`fileinput." +"input` also grew auto-closing context managers::" +msgstr "" + +msgid "" +"(Contributed by Tarek Ziadé and Giampaolo Rodolà in :issue:`4972`, and by " +"Georg Brandl in :issue:`8046` and :issue:`1286`.)" +msgstr "" + +msgid "" +"The :class:`~ftplib.FTP_TLS` class now accepts a *context* parameter, which " +"is a :class:`ssl.SSLContext` object allowing bundling SSL configuration " +"options, certificates and private keys into a single (potentially long-" +"lived) structure." +msgstr "" + +msgid "(Contributed by Giampaolo Rodolà; :issue:`8806`.)" +msgstr "" + +msgid "popen" +msgstr "" + +msgid "" +"The :func:`os.popen` and :func:`subprocess.Popen` functions now support :" +"keyword:`with` statements for auto-closing of the file descriptors." +msgstr "" + +msgid "" +"(Contributed by Antoine Pitrou and Brian Curtin in :issue:`7461` and :issue:" +"`10554`.)" +msgstr "" + +msgid "select" +msgstr "" + +msgid "" +"The :mod:`select` module now exposes a new, constant attribute, :const:" +"`~select.PIPE_BUF`, which gives the minimum number of bytes which are " +"guaranteed not to block when :func:`select.select` says a pipe is ready for " +"writing." +msgstr "" + +msgid "(Available on Unix systems. Patch by Sébastien Sablé in :issue:`9862`)" +msgstr "" + +msgid "gzip and zipfile" +msgstr "" + +msgid "" +":class:`gzip.GzipFile` now implements the :class:`io.BufferedIOBase` :term:" +"`abstract base class` (except for ``truncate()``). It also has a :meth:" +"`~gzip.GzipFile.peek` method and supports unseekable as well as zero-padded " +"file objects." +msgstr "" + +msgid "" +"The :mod:`gzip` module also gains the :func:`~gzip.compress` and :func:" +"`~gzip.decompress` functions for easier in-memory compression and " +"decompression. Keep in mind that text needs to be encoded as :class:`bytes` " +"before compressing and decompressing:" +msgstr "" + +msgid "" +"(Contributed by Anand B. Pillai in :issue:`3488`; and by Antoine Pitrou, Nir " +"Aides and Brian Curtin in :issue:`9962`, :issue:`1675951`, :issue:`7471` " +"and :issue:`2846`.)" +msgstr "" + +msgid "" +"Also, the :class:`zipfile.ZipExtFile ` class was " +"reworked internally to represent files stored inside an archive. The new " +"implementation is significantly faster and can be wrapped in an :class:`io." +"BufferedReader` object for more speedups. It also solves an issue where " +"interleaved calls to *read* and *readline* gave the wrong results." +msgstr "" + +msgid "(Patch submitted by Nir Aides in :issue:`7610`.)" +msgstr "" + +msgid "tarfile" +msgstr "" + +msgid "" +"The :class:`~tarfile.TarFile` class can now be used as a context manager. " +"In addition, its :meth:`~tarfile.TarFile.add` method has a new option, " +"*filter*, that controls which files are added to the archive and allows the " +"file metadata to be edited." +msgstr "" + +msgid "" +"The new *filter* option replaces the older, less flexible *exclude* " +"parameter which is now deprecated. If specified, the optional *filter* " +"parameter needs to be a :term:`keyword argument`. The user-supplied filter " +"function accepts a :class:`~tarfile.TarInfo` object and returns an updated :" +"class:`~tarfile.TarInfo` object, or if it wants the file to be excluded, the " +"function can return ``None``::" +msgstr "" + +msgid "" +"(Proposed by Tarek Ziadé and implemented by Lars Gustäbel in :issue:`6856`.)" +msgstr "" + +msgid "hashlib" +msgstr "" + +msgid "" +"The :mod:`hashlib` module has two new constant attributes listing the " +"hashing algorithms guaranteed to be present in all implementations and those " +"available on the current implementation::" +msgstr "" + +msgid "(Suggested by Carl Chenet in :issue:`7418`.)" +msgstr "" + +msgid "ast" +msgstr "" + +msgid "" +"The :mod:`ast` module has a wonderful a general-purpose tool for safely " +"evaluating expression strings using the Python literal syntax. The :func:" +"`ast.literal_eval` function serves as a secure alternative to the builtin :" +"func:`eval` function which is easily abused. Python 3.2 adds :class:`bytes` " +"and :class:`set` literals to the list of supported types: strings, bytes, " +"numbers, tuples, lists, dicts, sets, booleans, and ``None``." +msgstr "" + +msgid "(Implemented by Benjamin Peterson and Georg Brandl.)" +msgstr "" + +msgid "os" +msgstr "" + +msgid "" +"Different operating systems use various encodings for filenames and " +"environment variables. The :mod:`os` module provides two new functions, :" +"func:`~os.fsencode` and :func:`~os.fsdecode`, for encoding and decoding " +"filenames:" +msgstr "" + +msgid "" +"Some operating systems allow direct access to encoded bytes in the " +"environment. If so, the :const:`os.supports_bytes_environ` constant will be " +"true." +msgstr "" + +msgid "" +"For direct access to encoded environment variables (if available), use the " +"new :func:`os.getenvb` function or use :data:`os.environb` which is a bytes " +"version of :data:`os.environ`." +msgstr "" + +msgid "(Contributed by Victor Stinner.)" +msgstr "" + +msgid "shutil" +msgstr "" + +msgid "The :func:`shutil.copytree` function has two new options:" +msgstr "" + +msgid "" +"*ignore_dangling_symlinks*: when ``symlinks=False`` so that the function " +"copies a file pointed to by a symlink, not the symlink itself. This option " +"will silence the error raised if the file doesn't exist." +msgstr "" + +msgid "" +"*copy_function*: is a callable that will be used to copy files. :func:" +"`shutil.copy2` is used by default." +msgstr "" + +msgid "(Contributed by Tarek Ziadé.)" +msgstr "" + +msgid "" +"In addition, the :mod:`shutil` module now supports :ref:`archiving " +"operations ` for zipfiles, uncompressed tarfiles, " +"gzipped tarfiles, and bzipped tarfiles. And there are functions for " +"registering additional archiving file formats (such as xz compressed " +"tarfiles or custom formats)." +msgstr "" + +msgid "" +"The principal functions are :func:`~shutil.make_archive` and :func:`~shutil." +"unpack_archive`. By default, both operate on the current directory (which " +"can be set by :func:`os.chdir`) and on any sub-directories. The archive " +"filename needs to be specified with a full pathname. The archiving step is " +"non-destructive (the original files are left unchanged)." +msgstr "" + +msgid "sqlite3" +msgstr "" + +msgid "" +"The :mod:`sqlite3` module was updated to pysqlite version 2.6.0. It has two " +"new capabilities." +msgstr "" + +msgid "" +"The :attr:`!sqlite3.Connection.in_transit` attribute is true if there is an " +"active transaction for uncommitted changes." +msgstr "" + +msgid "" +"The :meth:`sqlite3.Connection.enable_load_extension` and :meth:`sqlite3." +"Connection.load_extension` methods allows you to load SQLite extensions from " +"\".so\" files. One well-known extension is the fulltext-search extension " +"distributed with SQLite." +msgstr "" + +msgid "(Contributed by R. David Murray and Shashwat Anand; :issue:`8845`.)" +msgstr "" + +msgid "html" +msgstr "" + +msgid "" +"A new :mod:`html` module was introduced with only a single function, :func:" +"`~html.escape`, which is used for escaping reserved characters from HTML " +"markup:" +msgstr "" + +msgid "socket" +msgstr "" + +msgid "The :mod:`socket` module has two new improvements." +msgstr "" + +msgid "" +"Socket objects now have a :meth:`~socket.socket.detach()` method which puts " +"the socket into closed state without actually closing the underlying file " +"descriptor. The latter can then be reused for other purposes. (Added by " +"Antoine Pitrou; :issue:`8524`.)" +msgstr "" + +msgid "" +":func:`socket.create_connection` now supports the context management " +"protocol to unconditionally consume :exc:`socket.error` exceptions and to " +"close the socket when done. (Contributed by Giampaolo Rodolà; :issue:`9794`.)" +msgstr "" + +msgid "ssl" +msgstr "" + +msgid "" +"The :mod:`ssl` module added a number of features to satisfy common " +"requirements for secure (encrypted, authenticated) internet connections:" +msgstr "" + +msgid "" +"A new class, :class:`~ssl.SSLContext`, serves as a container for persistent " +"SSL data, such as protocol settings, certificates, private keys, and various " +"other options. It includes a :meth:`~ssl.SSLContext.wrap_socket` for " +"creating an SSL socket from an SSL context." +msgstr "" + +msgid "" +"A new function, :func:`!ssl.match_hostname`, supports server identity " +"verification for higher-level protocols by implementing the rules of HTTPS " +"(from :rfc:`2818`) which are also suitable for other protocols." +msgstr "" + +msgid "" +"The :func:`ssl.wrap_socket() ` constructor " +"function now takes a *ciphers* argument. The *ciphers* string lists the " +"allowed encryption algorithms using the format described in the `OpenSSL " +"documentation `__." +msgstr "" + +msgid "" +"When linked against recent versions of OpenSSL, the :mod:`ssl` module now " +"supports the Server Name Indication extension to the TLS protocol, allowing " +"multiple \"virtual hosts\" using different certificates on a single IP port. " +"This extension is only supported in client mode, and is activated by passing " +"the *server_hostname* argument to :meth:`ssl.SSLContext.wrap_socket`." +msgstr "" + +msgid "" +"Various options have been added to the :mod:`ssl` module, such as :data:" +"`~ssl.OP_NO_SSLv2` which disables the insecure and obsolete SSLv2 protocol." +msgstr "" + +msgid "" +"The extension now loads all the OpenSSL ciphers and digest algorithms. If " +"some SSL certificates cannot be verified, they are reported as an \"unknown " +"algorithm\" error." +msgstr "" + +msgid "" +"The version of OpenSSL being used is now accessible using the module " +"attributes :const:`ssl.OPENSSL_VERSION` (a string), :const:`ssl." +"OPENSSL_VERSION_INFO` (a 5-tuple), and :const:`ssl.OPENSSL_VERSION_NUMBER` " +"(an integer)." +msgstr "" + +msgid "" +"(Contributed by Antoine Pitrou in :issue:`8850`, :issue:`1589`, :issue:" +"`8322`, :issue:`5639`, :issue:`4870`, :issue:`8484`, and :issue:`8321`.)" +msgstr "" + +msgid "nntp" +msgstr "" + +msgid "" +"The :mod:`nntplib` module has a revamped implementation with better bytes " +"and text semantics as well as more practical APIs. These improvements break " +"compatibility with the nntplib version in Python 3.1, which was partly " +"dysfunctional in itself." +msgstr "" + +msgid "" +"Support for secure connections through both implicit (using :class:`nntplib." +"NNTP_SSL`) and explicit (using :meth:`nntplib.NNTP.starttls`) TLS has also " +"been added." +msgstr "" + +msgid "" +"(Contributed by Antoine Pitrou in :issue:`9360` and Andrew Vant in :issue:" +"`1926`.)" +msgstr "" + +msgid "certificates" +msgstr "" + +msgid "" +":class:`http.client.HTTPSConnection`, :class:`urllib.request.HTTPSHandler` " +"and :func:`urllib.request.urlopen` now take optional arguments to allow for " +"server certificate checking against a set of Certificate Authorities, as " +"recommended in public uses of HTTPS." +msgstr "" + +msgid "(Added by Antoine Pitrou, :issue:`9003`.)" +msgstr "" + +msgid "imaplib" +msgstr "" + +msgid "" +"Support for explicit TLS on standard IMAP4 connections has been added " +"through the new :mod:`imaplib.IMAP4.starttls` method." +msgstr "" + +msgid "(Contributed by Lorenzo M. Catucci and Antoine Pitrou, :issue:`4471`.)" +msgstr "" + +msgid "http.client" +msgstr "" + +msgid "" +"There were a number of small API improvements in the :mod:`http.client` " +"module. The old-style HTTP 0.9 simple responses are no longer supported and " +"the *strict* parameter is deprecated in all classes." +msgstr "" + +msgid "" +"The :class:`~http.client.HTTPConnection` and :class:`~http.client." +"HTTPSConnection` classes now have a *source_address* parameter for a (host, " +"port) tuple indicating where the HTTP connection is made from." +msgstr "" + +msgid "" +"Support for certificate checking and HTTPS virtual hosts were added to :" +"class:`~http.client.HTTPSConnection`." +msgstr "" + +msgid "" +"The :meth:`~http.client.HTTPConnection.request` method on connection objects " +"allowed an optional *body* argument so that a :term:`file object` could be " +"used to supply the content of the request. Conveniently, the *body* " +"argument now also accepts an :term:`iterable` object so long as it includes " +"an explicit ``Content-Length`` header. This extended interface is much more " +"flexible than before." +msgstr "" + +msgid "" +"To establish an HTTPS connection through a proxy server, there is a new :" +"meth:`~http.client.HTTPConnection.set_tunnel` method that sets the host and " +"port for HTTP Connect tunneling." +msgstr "" + +msgid "" +"To match the behavior of :mod:`http.server`, the HTTP client library now " +"also encodes headers with ISO-8859-1 (Latin-1) encoding. It was already " +"doing that for incoming headers, so now the behavior is consistent for both " +"incoming and outgoing traffic. (See work by Armin Ronacher in :issue:" +"`10980`.)" +msgstr "" + +msgid "unittest" +msgstr "" + +msgid "" +"The unittest module has a number of improvements supporting test discovery " +"for packages, easier experimentation at the interactive prompt, new testcase " +"methods, improved diagnostic messages for test failures, and better method " +"names." +msgstr "" + +msgid "" +"The command-line call ``python -m unittest`` can now accept file paths " +"instead of module names for running specific tests (:issue:`10620`). The " +"new test discovery can find tests within packages, locating any test " +"importable from the top-level directory. The top-level directory can be " +"specified with the ``-t`` option, a pattern for matching files with ``-p``, " +"and a directory to start discovery with ``-s``:" +msgstr "" + +msgid "(Contributed by Michael Foord.)" +msgstr "" + +msgid "" +"Experimentation at the interactive prompt is now easier because the :class:" +"`unittest.TestCase` class can now be instantiated without arguments:" +msgstr "" + +msgid "" +"The :mod:`unittest` module has two new methods, :meth:`~unittest.TestCase." +"assertWarns` and :meth:`~unittest.TestCase.assertWarnsRegex` to verify that " +"a given warning type is triggered by the code under test::" +msgstr "" + +msgid "(Contributed by Antoine Pitrou, :issue:`9754`.)" +msgstr "" + +msgid "" +"Another new method, :meth:`~unittest.TestCase.assertCountEqual` is used to " +"compare two iterables to determine if their element counts are equal " +"(whether the same elements are present with the same number of occurrences " +"regardless of order)::" +msgstr "" + +msgid "" +"A principal feature of the unittest module is an effort to produce " +"meaningful diagnostics when a test fails. When possible, the failure is " +"recorded along with a diff of the output. This is especially helpful for " +"analyzing log files of failed test runs. However, since diffs can sometime " +"be voluminous, there is a new :attr:`~unittest.TestCase.maxDiff` attribute " +"that sets maximum length of diffs displayed." +msgstr "" + +msgid "" +"In addition, the method names in the module have undergone a number of clean-" +"ups." +msgstr "" + +msgid "" +"For example, :meth:`~unittest.TestCase.assertRegex` is the new name for :" +"meth:`!assertRegexpMatches` which was misnamed because the test uses :func:" +"`re.search`, not :func:`re.match`. Other methods using regular expressions " +"are now named using short form \"Regex\" in preference to \"Regexp\" -- this " +"matches the names used in other unittest implementations, matches Python's " +"old name for the :mod:`re` module, and it has unambiguous camel-casing." +msgstr "" + +msgid "(Contributed by Raymond Hettinger and implemented by Ezio Melotti.)" +msgstr "" + +msgid "" +"To improve consistency, some long-standing method aliases are being " +"deprecated in favor of the preferred names:" +msgstr "" + +msgid "Old Name" +msgstr "" + +msgid "Preferred Name" +msgstr "" + +msgid ":meth:`!assert_`" +msgstr ":meth:`!assert_`" + +msgid ":meth:`.assertTrue`" +msgstr ":meth:`.assertTrue`" + +msgid ":meth:`!assertEquals`" +msgstr ":meth:`!assertEquals`" + +msgid ":meth:`.assertEqual`" +msgstr ":meth:`.assertEqual`" + +msgid ":meth:`!assertNotEquals`" +msgstr ":meth:`!assertNotEquals`" + +msgid ":meth:`.assertNotEqual`" +msgstr ":meth:`.assertNotEqual`" + +msgid ":meth:`!assertAlmostEquals`" +msgstr ":meth:`!assertAlmostEquals`" + +msgid ":meth:`.assertAlmostEqual`" +msgstr ":meth:`.assertAlmostEqual`" + +msgid ":meth:`!assertNotAlmostEquals`" +msgstr ":meth:`!assertNotAlmostEquals`" + +msgid ":meth:`.assertNotAlmostEqual`" +msgstr ":meth:`.assertNotAlmostEqual`" + +msgid "" +"Likewise, the ``TestCase.fail*`` methods deprecated in Python 3.1 are " +"expected to be removed in Python 3.3. Also see the :ref:`deprecated-" +"aliases` section in the :mod:`unittest` documentation." +msgstr "" + +msgid "(Contributed by Ezio Melotti; :issue:`9424`.)" +msgstr "" + +msgid "" +"The :meth:`!assertDictContainsSubset` method was deprecated because it was " +"misimplemented with the arguments in the wrong order. This created hard-to-" +"debug optical illusions where tests like ``TestCase()." +"assertDictContainsSubset({'a':1, 'b':2}, {'a':1})`` would fail." +msgstr "" + +msgid "random" +msgstr "" + +msgid "" +"The integer methods in the :mod:`random` module now do a better job of " +"producing uniform distributions. Previously, they computed selections with " +"``int(n*random())`` which had a slight bias whenever *n* was not a power of " +"two. Now, multiple selections are made from a range up to the next power of " +"two and a selection is kept only when it falls within the range ``0 <= x < " +"n``. The functions and methods affected are :func:`~random.randrange`, :" +"func:`~random.randint`, :func:`~random.choice`, :func:`~random.shuffle` and :" +"func:`~random.sample`." +msgstr "" + +msgid "(Contributed by Raymond Hettinger; :issue:`9025`.)" +msgstr "" + +msgid "poplib" +msgstr "" + +msgid "" +":class:`~poplib.POP3_SSL` class now accepts a *context* parameter, which is " +"a :class:`ssl.SSLContext` object allowing bundling SSL configuration " +"options, certificates and private keys into a single (potentially long-" +"lived) structure." +msgstr "" + +msgid "(Contributed by Giampaolo Rodolà; :issue:`8807`.)" +msgstr "" + +msgid "asyncore" +msgstr "" + +msgid "" +":class:`asyncore.dispatcher` now provides a :meth:`~asyncore.dispatcher." +"handle_accepted()` method returning a ``(sock, addr)`` pair which is called " +"when a connection has actually been established with a new remote endpoint. " +"This is supposed to be used as a replacement for old :meth:`~asyncore." +"dispatcher.handle_accept()` and avoids the user to call :meth:`~asyncore." +"dispatcher.accept()` directly." +msgstr "" + +msgid "(Contributed by Giampaolo Rodolà; :issue:`6706`.)" +msgstr "" + +msgid "tempfile" +msgstr "" + +msgid "" +"The :mod:`tempfile` module has a new context manager, :class:`~tempfile." +"TemporaryDirectory` which provides easy deterministic cleanup of temporary " +"directories::" +msgstr "" + +msgid "(Contributed by Neil Schemenauer and Nick Coghlan; :issue:`5178`.)" +msgstr "" + +msgid "inspect" +msgstr "" + +msgid "" +"The :mod:`inspect` module has a new function :func:`~inspect." +"getgeneratorstate` to easily identify the current state of a generator-" +"iterator::" +msgstr "" + +msgid "(Contributed by Rodolpho Eckhardt and Nick Coghlan, :issue:`10220`.)" +msgstr "" + +msgid "" +"To support lookups without the possibility of activating a dynamic " +"attribute, the :mod:`inspect` module has a new function, :func:`~inspect." +"getattr_static`. Unlike :func:`hasattr`, this is a true read-only search, " +"guaranteed not to change state while it is searching::" +msgstr "" + +msgid "pydoc" +msgstr "" + +msgid "" +"The :mod:`pydoc` module now provides a much-improved web server interface, " +"as well as a new command-line option ``-b`` to automatically open a browser " +"window to display that server:" +msgstr "" + +msgid "(Contributed by Ron Adam; :issue:`2001`.)" +msgstr "" + +msgid "dis" +msgstr "" + +msgid "" +"The :mod:`dis` module gained two new functions for inspecting code, :func:" +"`~dis.code_info` and :func:`~dis.show_code`. Both provide detailed code " +"object information for the supplied function, method, source code string or " +"code object. The former returns a string and the latter prints it::" +msgstr "" + +msgid "" +"In addition, the :func:`~dis.dis` function now accepts string arguments so " +"that the common idiom ``dis(compile(s, '', 'eval'))`` can be shortened to " +"``dis(s)``::" +msgstr "" + +msgid "" +"Taken together, these improvements make it easier to explore how CPython is " +"implemented and to see for yourself what the language syntax does under-the-" +"hood." +msgstr "" + +msgid "(Contributed by Nick Coghlan in :issue:`9147`.)" +msgstr "" + +msgid "dbm" +msgstr "" + +msgid "" +"All database modules now support the :meth:`!get` and :meth:`!setdefault` " +"methods." +msgstr "" + +msgid "(Suggested by Ray Allen in :issue:`9523`.)" +msgstr "" + +msgid "ctypes" +msgstr "" + +msgid "" +"A new type, :class:`ctypes.c_ssize_t` represents the C :c:type:`ssize_t` " +"datatype." +msgstr "" + +msgid "site" +msgstr "" + +msgid "" +"The :mod:`site` module has three new functions useful for reporting on the " +"details of a given Python installation." +msgstr "" + +msgid "" +":func:`~site.getsitepackages` lists all global site-packages directories." +msgstr "" + +msgid "" +":func:`~site.getuserbase` reports on the user's base directory where data " +"can be stored." +msgstr "" + +msgid "" +":func:`~site.getusersitepackages` reveals the user-specific site-packages " +"directory path." +msgstr "" + +msgid "" +"Conveniently, some of site's functionality is accessible directly from the " +"command-line:" +msgstr "" + +msgid "(Contributed by Tarek Ziadé in :issue:`6693`.)" +msgstr "" + +msgid "sysconfig" +msgstr "" + +msgid "" +"The new :mod:`sysconfig` module makes it straightforward to discover " +"installation paths and configuration variables that vary across platforms " +"and installations." +msgstr "" + +msgid "" +"The module offers access simple access functions for platform and version " +"information:" +msgstr "" + +msgid "" +":func:`~sysconfig.get_platform` returning values like *linux-i586* or " +"*macosx-10.6-ppc*." +msgstr "" + +msgid "" +":func:`~sysconfig.get_python_version` returns a Python version string such " +"as \"3.2\"." +msgstr "" + +msgid "" +"It also provides access to the paths and variables corresponding to one of " +"seven named schemes used by :mod:`distutils`. Those include *posix_prefix*, " +"*posix_home*, *posix_user*, *nt*, *nt_user*, *os2*, *os2_home*:" +msgstr "" + +msgid "" +":func:`~sysconfig.get_paths` makes a dictionary containing installation " +"paths for the current installation scheme." +msgstr "" + +msgid "" +":func:`~sysconfig.get_config_vars` returns a dictionary of platform specific " +"variables." +msgstr "" + +msgid "There is also a convenient command-line interface:" +msgstr "" + +msgid "(Moved out of Distutils by Tarek Ziadé.)" +msgstr "" + +msgid "pdb" +msgstr "" + +msgid "" +"The :mod:`pdb` debugger module gained a number of usability improvements:" +msgstr "" + +msgid "" +":file:`pdb.py` now has a ``-c`` option that executes commands as given in a :" +"file:`.pdbrc` script file." +msgstr "" + +msgid "" +"A :file:`.pdbrc` script file can contain ``continue`` and ``next`` commands " +"that continue debugging." +msgstr "" + +msgid "" +"The :class:`~pdb.Pdb` class constructor now accepts a *nosigint* argument." +msgstr "" + +msgid "" +"New commands: ``l(list)``, ``ll(long list)`` and ``source`` for listing " +"source code." +msgstr "" + +msgid "" +"New commands: ``display`` and ``undisplay`` for showing or hiding the value " +"of an expression if it has changed." +msgstr "" + +msgid "" +"New command: ``interact`` for starting an interactive interpreter containing " +"the global and local names found in the current scope." +msgstr "" + +msgid "Breakpoints can be cleared by breakpoint number." +msgstr "" + +msgid "(Contributed by Georg Brandl, Antonio Cuni and Ilya Sandler.)" +msgstr "" + +msgid "configparser" +msgstr "" + +msgid "" +"The :mod:`configparser` module was modified to improve usability and " +"predictability of the default parser and its supported INI syntax. The old :" +"class:`!ConfigParser` class was removed in favor of :class:`!" +"SafeConfigParser` which has in turn been renamed to :class:`~configparser." +"ConfigParser`. Support for inline comments is now turned off by default and " +"section or option duplicates are not allowed in a single configuration " +"source." +msgstr "" + +msgid "Config parsers gained a new API based on the mapping protocol::" +msgstr "" + +msgid "" +"The new API is implemented on top of the classical API, so custom parser " +"subclasses should be able to use it without modifications." +msgstr "" + +msgid "" +"The INI file structure accepted by config parsers can now be customized. " +"Users can specify alternative option/value delimiters and comment prefixes, " +"change the name of the *DEFAULT* section or switch the interpolation syntax." +msgstr "" + +msgid "" +"There is support for pluggable interpolation including an additional " +"interpolation handler :class:`~configparser.ExtendedInterpolation`::" +msgstr "" + +msgid "" +"A number of smaller features were also introduced, like support for " +"specifying encoding in read operations, specifying fallback values for get-" +"functions, or reading directly from dictionaries and strings." +msgstr "" + +msgid "(All changes contributed by Łukasz Langa.)" +msgstr "" + +msgid "urllib.parse" +msgstr "" + +msgid "" +"A number of usability improvements were made for the :mod:`urllib.parse` " +"module." +msgstr "" + +msgid "" +"The :func:`~urllib.parse.urlparse` function now supports `IPv6 `_ addresses as described in :rfc:`2732`:" +msgstr "" + +msgid "" +"The :func:`~urllib.parse.urldefrag` function now returns a :term:`named " +"tuple`::" +msgstr "" + +msgid "" +"And, the :func:`~urllib.parse.urlencode` function is now much more flexible, " +"accepting either a string or bytes type for the *query* argument. If it is " +"a string, then the *safe*, *encoding*, and *error* parameters are sent to :" +"func:`~urllib.parse.quote_plus` for encoding::" +msgstr "" + +msgid "" +"As detailed in :ref:`parsing-ascii-encoded-bytes`, all the :mod:`urllib." +"parse` functions now accept ASCII-encoded byte strings as input, so long as " +"they are not mixed with regular strings. If ASCII-encoded byte strings are " +"given as parameters, the return types will also be an ASCII-encoded byte " +"strings:" +msgstr "" + +msgid "" +"(Work by Nick Coghlan, Dan Mahn, and Senthil Kumaran in :issue:`2987`, :" +"issue:`5468`, and :issue:`9873`.)" +msgstr "" + +msgid "mailbox" +msgstr "" + +msgid "" +"Thanks to a concerted effort by R. David Murray, the :mod:`mailbox` module " +"has been fixed for Python 3.2. The challenge was that mailbox had been " +"originally designed with a text interface, but email messages are best " +"represented with :class:`bytes` because various parts of a message may have " +"different encodings." +msgstr "" + +msgid "" +"The solution harnessed the :mod:`email` package's binary support for parsing " +"arbitrary email messages. In addition, the solution required a number of " +"API changes." +msgstr "" + +msgid "" +"As expected, the :meth:`~mailbox.Mailbox.add` method for :class:`mailbox." +"Mailbox` objects now accepts binary input." +msgstr "" + +msgid "" +":class:`~io.StringIO` and text file input are deprecated. Also, string " +"input will fail early if non-ASCII characters are used. Previously it would " +"fail when the email was processed in a later step." +msgstr "" + +msgid "" +"There is also support for binary output. The :meth:`~mailbox.Mailbox." +"get_file` method now returns a file in the binary mode (where it used to " +"incorrectly set the file to text-mode). There is also a new :meth:`~mailbox." +"Mailbox.get_bytes` method that returns a :class:`bytes` representation of a " +"message corresponding to a given *key*." +msgstr "" + +msgid "" +"It is still possible to get non-binary output using the old API's :meth:" +"`~mailbox.Mailbox.get_string` method, but that approach is not very useful. " +"Instead, it is best to extract messages from a :class:`~mailbox.Message` " +"object or to load them from binary input." +msgstr "" + +msgid "" +"(Contributed by R. David Murray, with efforts from Steffen Daode Nurpmeso " +"and an initial patch by Victor Stinner in :issue:`9124`.)" +msgstr "" + +msgid "turtledemo" +msgstr "" + +msgid "" +"The demonstration code for the :mod:`turtle` module was moved from the " +"*Demo* directory to main library. It includes over a dozen sample scripts " +"with lively displays. Being on :data:`sys.path`, it can now be run directly " +"from the command-line:" +msgstr "" + +msgid "" +"(Moved from the Demo directory by Alexander Belopolsky in :issue:`10199`.)" +msgstr "" + +msgid "Multi-threading" +msgstr "Wielowątkowość" + +msgid "" +"The mechanism for serializing execution of concurrently running Python " +"threads (generally known as the :term:`GIL` or Global Interpreter Lock) has " +"been rewritten. Among the objectives were more predictable switching " +"intervals and reduced overhead due to lock contention and the number of " +"ensuing system calls. The notion of a \"check interval\" to allow thread " +"switches has been abandoned and replaced by an absolute duration expressed " +"in seconds. This parameter is tunable through :func:`sys." +"setswitchinterval()`. It currently defaults to 5 milliseconds." +msgstr "" + +msgid "" +"Additional details about the implementation can be read from a `python-dev " +"mailing-list message `_ (however, \"priority requests\" as exposed in this " +"message have not been kept for inclusion)." +msgstr "" + +msgid "(Contributed by Antoine Pitrou.)" +msgstr "" + +msgid "" +"Regular and recursive locks now accept an optional *timeout* argument to " +"their :meth:`~threading.Lock.acquire` method. (Contributed by Antoine " +"Pitrou; :issue:`7316`.)" +msgstr "" + +msgid "" +"Similarly, :meth:`threading.Semaphore.acquire` also gained a *timeout* " +"argument. (Contributed by Torsten Landschoff; :issue:`850728`.)" +msgstr "" + +msgid "" +"Regular and recursive lock acquisitions can now be interrupted by signals on " +"platforms using Pthreads. This means that Python programs that deadlock " +"while acquiring locks can be successfully killed by repeatedly sending " +"SIGINT to the process (by pressing :kbd:`Ctrl+C` in most shells). " +"(Contributed by Reid Kleckner; :issue:`8844`.)" +msgstr "" + +msgid "Optimizations" +msgstr "" + +msgid "A number of small performance enhancements have been added:" +msgstr "" + +msgid "" +"Python's peephole optimizer now recognizes patterns such ``x in {1, 2, 3}`` " +"as being a test for membership in a set of constants. The optimizer recasts " +"the :class:`set` as a :class:`frozenset` and stores the pre-built constant." +msgstr "" + +msgid "" +"Now that the speed penalty is gone, it is practical to start writing " +"membership tests using set-notation. This style is both semantically clear " +"and operationally fast::" +msgstr "" + +msgid "" +"(Patch and additional tests contributed by Dave Malcolm; :issue:`6690`)." +msgstr "" + +msgid "" +"Serializing and unserializing data using the :mod:`pickle` module is now " +"several times faster." +msgstr "" + +msgid "" +"(Contributed by Alexandre Vassalotti, Antoine Pitrou and the Unladen Swallow " +"team in :issue:`9410` and :issue:`3873`.)" +msgstr "" + +msgid "" +"The `Timsort algorithm `_ used in :" +"meth:`list.sort` and :func:`sorted` now runs faster and uses less memory " +"when called with a :term:`key function`. Previously, every element of a " +"list was wrapped with a temporary object that remembered the key value " +"associated with each element. Now, two arrays of keys and values are sorted " +"in parallel. This saves the memory consumed by the sort wrappers, and it " +"saves time lost to delegating comparisons." +msgstr "" + +msgid "(Patch by Daniel Stutzbach in :issue:`9915`.)" +msgstr "" + +msgid "" +"JSON decoding performance is improved and memory consumption is reduced " +"whenever the same string is repeated for multiple keys. Also, JSON encoding " +"now uses the C speedups when the ``sort_keys`` argument is true." +msgstr "" + +msgid "" +"(Contributed by Antoine Pitrou in :issue:`7451` and by Raymond Hettinger and " +"Antoine Pitrou in :issue:`10314`.)" +msgstr "" + +msgid "" +"Recursive locks (created with the :func:`threading.RLock` API) now benefit " +"from a C implementation which makes them as fast as regular locks, and " +"between 10x and 15x faster than their previous pure Python implementation." +msgstr "" + +msgid "(Contributed by Antoine Pitrou; :issue:`3001`.)" +msgstr "" + +msgid "" +"The fast-search algorithm in stringlib is now used by the :meth:`~str." +"split`, :meth:`~str.rsplit`, :meth:`~str.splitlines` and :meth:`~str." +"replace` methods on :class:`bytes`, :class:`bytearray` and :class:`str` " +"objects. Likewise, the algorithm is also used by :meth:`~str.rfind`, :meth:" +"`~str.rindex`, :meth:`~str.rsplit` and :meth:`~str.rpartition`." +msgstr "" + +msgid "(Patch by Florent Xicluna in :issue:`7622` and :issue:`7462`.)" +msgstr "" + +msgid "" +"Integer to string conversions now work two \"digits\" at a time, reducing " +"the number of division and modulo operations." +msgstr "" + +msgid "(:issue:`6713` by Gawain Bolton, Mark Dickinson, and Victor Stinner.)" +msgstr "" + +msgid "" +"There were several other minor optimizations. Set differencing now runs " +"faster when one operand is much larger than the other (patch by Andress " +"Bennetts in :issue:`8685`). The :meth:`!array.repeat` method has a faster " +"implementation (:issue:`1569291` by Alexander Belopolsky). The :class:`~http." +"server.BaseHTTPRequestHandler` has more efficient buffering (:issue:`3709` " +"by Andrew Schaaf). The :func:`operator.attrgetter` function has been sped-" +"up (:issue:`10160` by Christos Georgiou). And :class:`~configparser." +"ConfigParser` loads multi-line arguments a bit faster (:issue:`7113` by " +"Łukasz Langa)." +msgstr "" + +msgid "Unicode" +msgstr "" + +msgid "" +"Python has been updated to `Unicode 6.0.0 `_. The update to the standard adds over 2,000 new characters " +"including `emoji `_ symbols which are " +"important for mobile phones." +msgstr "" + +msgid "" +"In addition, the updated standard has altered the character properties for " +"two Kannada characters (U+0CF1, U+0CF2) and one New Tai Lue numeric " +"character (U+19DA), making the former eligible for use in identifiers while " +"disqualifying the latter. For more information, see `Unicode Character " +"Database Changes `_." +msgstr "" + +msgid "Codecs" +msgstr "" + +msgid "Support was added for *cp720* Arabic DOS encoding (:issue:`1616979`)." +msgstr "" + +msgid "" +"MBCS encoding no longer ignores the error handler argument. In the default " +"strict mode, it raises an :exc:`UnicodeDecodeError` when it encounters an " +"undecodable byte sequence and an :exc:`UnicodeEncodeError` for an " +"unencodable character." +msgstr "" + +msgid "" +"The MBCS codec supports ``'strict'`` and ``'ignore'`` error handlers for " +"decoding, and ``'strict'`` and ``'replace'`` for encoding." +msgstr "" + +msgid "" +"To emulate Python3.1 MBCS encoding, select the ``'ignore'`` handler for " +"decoding and the ``'replace'`` handler for encoding." +msgstr "" + +msgid "" +"On Mac OS X, Python decodes command line arguments with ``'utf-8'`` rather " +"than the locale encoding." +msgstr "" + +msgid "" +"By default, :mod:`tarfile` uses ``'utf-8'`` encoding on Windows (instead of " +"``'mbcs'``) and the ``'surrogateescape'`` error handler on all operating " +"systems." +msgstr "" + +msgid "Documentation" +msgstr "" + +msgid "The documentation continues to be improved." +msgstr "" + +msgid "" +"A table of quick links has been added to the top of lengthy sections such " +"as :ref:`built-in-funcs`. In the case of :mod:`itertools`, the links are " +"accompanied by tables of cheatsheet-style summaries to provide an overview " +"and memory jog without having to read all of the docs." +msgstr "" + +msgid "" +"In some cases, the pure Python source code can be a helpful adjunct to the " +"documentation, so now many modules now feature quick links to the latest " +"version of the source code. For example, the :mod:`functools` module " +"documentation has a quick link at the top labeled:" +msgstr "" + +msgid "**Source code** :source:`Lib/functools.py`." +msgstr "" + +msgid "" +"(Contributed by Raymond Hettinger; see `rationale `_.)" +msgstr "" + +msgid "" +"The docs now contain more examples and recipes. In particular, :mod:`re` " +"module has an extensive section, :ref:`re-examples`. Likewise, the :mod:" +"`itertools` module continues to be updated with new :ref:`itertools-recipes`." +msgstr "" + +msgid "" +"The :mod:`datetime` module now has an auxiliary implementation in pure " +"Python. No functionality was changed. This just provides an easier-to-read " +"alternate implementation." +msgstr "" + +msgid "(Contributed by Alexander Belopolsky in :issue:`9528`.)" +msgstr "" + +msgid "" +"The unmaintained :file:`Demo` directory has been removed. Some demos were " +"integrated into the documentation, some were moved to the :file:`Tools/demo` " +"directory, and others were removed altogether." +msgstr "" + +msgid "(Contributed by Georg Brandl in :issue:`7962`.)" +msgstr "" + +msgid "IDLE" +msgstr "IDLE" + +msgid "" +"The format menu now has an option to clean source files by stripping " +"trailing whitespace." +msgstr "" + +msgid "(Contributed by Raymond Hettinger; :issue:`5150`.)" +msgstr "" + +msgid "IDLE on Mac OS X now works with both Carbon AquaTk and Cocoa AquaTk." +msgstr "" + +msgid "" +"(Contributed by Kevin Walzer, Ned Deily, and Ronald Oussoren; :issue:`6075`.)" +msgstr "" + +msgid "Code Repository" +msgstr "" + +msgid "" +"In addition to the existing Subversion code repository at https://svn.python." +"org there is now a `Mercurial `_ repository " +"at https://hg.python.org/\\ ." +msgstr "" + +msgid "" +"After the 3.2 release, there are plans to switch to Mercurial as the primary " +"repository. This distributed version control system should make it easier " +"for members of the community to create and share external changesets. See :" +"pep:`385` for details." +msgstr "" + +msgid "" +"To learn to use the new version control system, see the `Quick Start " +"`_ or the `Guide to Mercurial " +"Workflows `_." +msgstr "" + +msgid "Build and C API Changes" +msgstr "" + +msgid "Changes to Python's build process and to the C API include:" +msgstr "" + +msgid "" +"The *idle*, *pydoc* and *2to3* scripts are now installed with a version-" +"specific suffix on ``make altinstall`` (:issue:`10679`)." +msgstr "" + +msgid "" +"The C functions that access the Unicode Database now accept and return " +"characters from the full Unicode range, even on narrow unicode builds " +"(Py_UNICODE_TOLOWER, Py_UNICODE_ISDECIMAL, and others). A visible " +"difference in Python is that :func:`unicodedata.numeric` now returns the " +"correct value for large code points, and :func:`repr` may consider more " +"characters as printable." +msgstr "" + +msgid "" +"(Reported by Bupjoe Lee and fixed by Amaury Forgeot D'Arc; :issue:`5127`.)" +msgstr "" + +msgid "" +"Computed gotos are now enabled by default on supported compilers (which are " +"detected by the configure script). They can still be disabled selectively " +"by specifying ``--without-computed-gotos``." +msgstr "" + +msgid "(Contributed by Antoine Pitrou; :issue:`9203`.)" +msgstr "" + +msgid "" +"The option ``--with-wctype-functions`` was removed. The built-in unicode " +"database is now used for all functions." +msgstr "" + +msgid "(Contributed by Amaury Forgeot D'Arc; :issue:`9210`.)" +msgstr "" + +msgid "" +"Hash values are now values of a new type, :c:type:`Py_hash_t`, which is " +"defined to be the same size as a pointer. Previously they were of type " +"long, which on some 64-bit operating systems is still only 32 bits long. As " +"a result of this fix, :class:`set` and :class:`dict` can now hold more than " +"``2**32`` entries on builds with 64-bit pointers (previously, they could " +"grow to that size but their performance degraded catastrophically)." +msgstr "" + +msgid "" +"(Suggested by Raymond Hettinger and implemented by Benjamin Peterson; :issue:" +"`9778`.)" +msgstr "" + +msgid "" +"A new macro :c:macro:`!Py_VA_COPY` copies the state of the variable argument " +"list. It is equivalent to C99 *va_copy* but available on all Python " +"platforms (:issue:`2443`)." +msgstr "" + +msgid "" +"A new C API function :c:func:`!PySys_SetArgvEx` allows an embedded " +"interpreter to set :data:`sys.argv` without also modifying :data:`sys.path` " +"(:issue:`5753`)." +msgstr "" + +msgid "" +":c:func:`!PyEval_CallObject` is now only available in macro form. The " +"function declaration, which was kept for backwards compatibility reasons, is " +"now removed -- the macro was introduced in 1997 (:issue:`8276`)." +msgstr "" + +msgid "" +"There is a new function :c:func:`PyLong_AsLongLongAndOverflow` which is " +"analogous to :c:func:`PyLong_AsLongAndOverflow`. They both serve to convert " +"Python :class:`int` into a native fixed-width type while providing detection " +"of cases where the conversion won't fit (:issue:`7767`)." +msgstr "" + +msgid "" +"The :c:func:`PyUnicode_CompareWithASCIIString` function now returns *not " +"equal* if the Python string is *NUL* terminated." +msgstr "" + +msgid "" +"There is a new function :c:func:`PyErr_NewExceptionWithDoc` that is like :c:" +"func:`PyErr_NewException` but allows a docstring to be specified. This lets " +"C exceptions have the same self-documenting capabilities as their pure " +"Python counterparts (:issue:`7033`)." +msgstr "" + +msgid "" +"When compiled with the ``--with-valgrind`` option, the pymalloc allocator " +"will be automatically disabled when running under Valgrind. This gives " +"improved memory leak detection when running under Valgrind, while taking " +"advantage of pymalloc at other times (:issue:`2422`)." +msgstr "" + +msgid "" +"Removed the ``O?`` format from the *PyArg_Parse* functions. The format is " +"no longer used and it had never been documented (:issue:`8837`)." +msgstr "" + +msgid "" +"There were a number of other small changes to the C-API. See the `Misc/NEWS " +"`__ file for a " +"complete list." +msgstr "" + +msgid "" +"Also, there were a number of updates to the Mac OS X build, see `Mac/" +"BuildScript/README.txt `_ for details. For users running a 32/64-bit build, " +"there is a known problem with the default Tcl/Tk on Mac OS X 10.6. " +"Accordingly, we recommend installing an updated alternative such as " +"`ActiveState Tcl/Tk 8.5.9 `_\\. See https://www.python." +"org/download/mac/tcltk/ for additional details." +msgstr "" + +msgid "Porting to Python 3.2" +msgstr "" + +msgid "" +"This section lists previously described changes and other bugfixes that may " +"require changes to your code:" +msgstr "" + +msgid "" +"The :mod:`configparser` module has a number of clean-ups. The major change " +"is to replace the old :class:`!ConfigParser` class with long-standing " +"preferred alternative :class:`!SafeConfigParser`. In addition there are a " +"number of smaller incompatibilities:" +msgstr "" + +msgid "" +"The interpolation syntax is now validated on :meth:`~configparser." +"ConfigParser.get` and :meth:`~configparser.ConfigParser.set` operations. In " +"the default interpolation scheme, only two tokens with percent signs are " +"valid: ``%(name)s`` and ``%%``, the latter being an escaped percent sign." +msgstr "" + +msgid "" +"The :meth:`~configparser.ConfigParser.set` and :meth:`~configparser." +"ConfigParser.add_section` methods now verify that values are actual " +"strings. Formerly, unsupported types could be introduced unintentionally." +msgstr "" + +msgid "" +"Duplicate sections or options from a single source now raise either :exc:" +"`~configparser.DuplicateSectionError` or :exc:`~configparser." +"DuplicateOptionError`. Formerly, duplicates would silently overwrite a " +"previous entry." +msgstr "" + +msgid "" +"Inline comments are now disabled by default so now the **;** character can " +"be safely used in values." +msgstr "" + +msgid "" +"Comments now can be indented. Consequently, for **;** or **#** to appear at " +"the start of a line in multiline values, it has to be interpolated. This " +"keeps comment prefix characters in values from being mistaken as comments." +msgstr "" + +msgid "" +"``\"\"`` is now a valid value and is no longer automatically converted to an " +"empty string. For empty strings, use ``\"option =\"`` in a line." +msgstr "" + +msgid "" +"The :mod:`nntplib` module was reworked extensively, meaning that its APIs " +"are often incompatible with the 3.1 APIs." +msgstr "" + +msgid "" +":class:`bytearray` objects can no longer be used as filenames; instead, they " +"should be converted to :class:`bytes`." +msgstr "" + +msgid "" +"The :meth:`!array.tostring` and :meth:`!array.fromstring` have been renamed " +"to :meth:`array.tobytes() ` and :meth:`array." +"frombytes() ` for clarity. The old names have been " +"deprecated. (See :issue:`8990`.)" +msgstr "" + +msgid "``PyArg_Parse*()`` functions:" +msgstr "" + +msgid "\"t#\" format has been removed: use \"s#\" or \"s*\" instead" +msgstr "" + +msgid "\"w\" and \"w#\" formats has been removed: use \"w*\" instead" +msgstr "" + +msgid "" +"The :c:type:`!PyCObject` type, deprecated in 3.1, has been removed. To wrap " +"opaque C pointers in Python objects, the :c:type:`PyCapsule` API should be " +"used instead; the new type has a well-defined interface for passing typing " +"safety information and a less complicated signature for calling a destructor." +msgstr "" + +msgid "" +"The :func:`!sys.setfilesystemencoding` function was removed because it had a " +"flawed design." +msgstr "" + +msgid "" +"The :func:`random.seed` function and method now salt string seeds with an " +"sha512 hash function. To access the previous version of *seed* in order to " +"reproduce Python 3.1 sequences, set the *version* argument to *1*, ``random." +"seed(s, version=1)``." +msgstr "" + +msgid "" +"The previously deprecated :func:`!string.maketrans` function has been " +"removed in favor of the static methods :meth:`bytes.maketrans` and :meth:" +"`bytearray.maketrans`. This change solves the confusion around which types " +"were supported by the :mod:`string` module. Now, :class:`str`, :class:" +"`bytes`, and :class:`bytearray` each have their own **maketrans** and " +"**translate** methods with intermediate translation tables of the " +"appropriate type." +msgstr "" + +msgid "(Contributed by Georg Brandl; :issue:`5675`.)" +msgstr "" + +msgid "" +"The previously deprecated :func:`!contextlib.nested` function has been " +"removed in favor of a plain :keyword:`with` statement which can accept " +"multiple context managers. The latter technique is faster (because it is " +"built-in), and it does a better job finalizing multiple context managers " +"when one of them raises an exception::" +msgstr "" + +msgid "" +"(Contributed by Georg Brandl and Mattias Brändström; `appspot issue 53094 " +"`_.)" +msgstr "" + +msgid "" +":func:`struct.pack` now only allows bytes for the ``s`` string pack code. " +"Formerly, it would accept text arguments and implicitly encode them to bytes " +"using UTF-8. This was problematic because it made assumptions about the " +"correct encoding and because a variable-length encoding can fail when " +"writing to fixed length segment of a structure." +msgstr "" + +msgid "" +"Code such as ``struct.pack('<6sHHBBB', 'GIF87a', x, y)`` should be rewritten " +"with to use bytes instead of text, ``struct.pack('<6sHHBBB', b'GIF87a', x, " +"y)``." +msgstr "" + +msgid "" +"(Discovered by David Beazley and fixed by Victor Stinner; :issue:`10783`.)" +msgstr "" + +msgid "" +"The :class:`xml.etree.ElementTree` class now raises an :exc:`xml.etree." +"ElementTree.ParseError` when a parse fails. Previously it raised an :exc:" +"`xml.parsers.expat.ExpatError`." +msgstr "" + +msgid "" +"The new, longer :func:`str` value on floats may break doctests which rely on " +"the old output format." +msgstr "" + +msgid "" +"In :class:`subprocess.Popen`, the default value for *close_fds* is now " +"``True`` under Unix; under Windows, it is ``True`` if the three standard " +"streams are set to ``None``, ``False`` otherwise. Previously, *close_fds* " +"was always ``False`` by default, which produced difficult to solve bugs or " +"race conditions when open file descriptors would leak into the child process." +msgstr "" + +msgid "" +"Support for legacy HTTP 0.9 has been removed from :mod:`urllib.request` and :" +"mod:`http.client`. Such support is still present on the server side (in :" +"mod:`http.server`)." +msgstr "" + +msgid "(Contributed by Antoine Pitrou, :issue:`10711`.)" +msgstr "" + +msgid "" +"SSL sockets in timeout mode now raise :exc:`socket.timeout` when a timeout " +"occurs, rather than a generic :exc:`~ssl.SSLError`." +msgstr "" + +msgid "(Contributed by Antoine Pitrou, :issue:`10272`.)" +msgstr "" + +msgid "" +"The misleading functions :c:func:`!PyEval_AcquireLock` and :c:func:`!" +"PyEval_ReleaseLock` have been officially deprecated. The thread-state aware " +"APIs (such as :c:func:`PyEval_SaveThread` and :c:func:" +"`PyEval_RestoreThread`) should be used instead." +msgstr "" + +msgid "" +"Due to security risks, :func:`asyncore.handle_accept` has been deprecated, " +"and a new function, :func:`asyncore.handle_accepted`, was added to replace " +"it." +msgstr "" + +msgid "(Contributed by Giampaolo Rodola in :issue:`6706`.)" +msgstr "" + +msgid "" +"Due to the new :term:`GIL` implementation, :c:func:`!PyEval_InitThreads` " +"cannot be called before :c:func:`Py_Initialize` anymore." +msgstr "" diff --git a/whatsnew/3.3.po b/whatsnew/3.3.po new file mode 100644 index 0000000000..341d3eb5b9 --- /dev/null +++ b/whatsnew/3.3.po @@ -0,0 +1,3192 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "What's New In Python 3.3" +msgstr "" + +msgid "" +"This article explains the new features in Python 3.3, compared to 3.2. " +"Python 3.3 was released on September 29, 2012. For full details, see the " +"`changelog `_." +msgstr "" + +msgid ":pep:`398` - Python 3.3 Release Schedule" +msgstr "" + +msgid "Summary -- Release highlights" +msgstr "Podsumowanie – najważniejsze nowości" + +msgid "New syntax features:" +msgstr "Nowe cechy składni:" + +msgid "" +"New ``yield from`` expression for :ref:`generator delegation `." +msgstr "" + +msgid "The ``u'unicode'`` syntax is accepted again for :class:`str` objects." +msgstr "" + +msgid "New library modules:" +msgstr "Nowe moduły biblioteki:" + +msgid ":mod:`faulthandler` (helps debugging low-level crashes)" +msgstr "" + +msgid "" +":mod:`ipaddress` (high-level objects representing IP addresses and masks)" +msgstr "" + +msgid ":mod:`lzma` (compress data using the XZ / LZMA algorithm)" +msgstr "" + +msgid "" +":mod:`unittest.mock` (replace parts of your system under test with mock " +"objects)" +msgstr "" + +msgid "" +":mod:`venv` (Python :ref:`virtual environments `, as in the popular " +"``virtualenv`` package)" +msgstr "" + +msgid "New built-in features:" +msgstr "Nowe wbudowane funkcje:" + +msgid "Reworked :ref:`I/O exception hierarchy `." +msgstr "" + +msgid "Implementation improvements:" +msgstr "" + +msgid "" +"Rewritten :ref:`import machinery ` based on :mod:`importlib`." +msgstr "" + +msgid "More compact :ref:`unicode strings `." +msgstr "" + +msgid "More compact :ref:`attribute dictionaries `." +msgstr "" + +msgid "Significantly Improved Library Modules:" +msgstr "" + +msgid "C Accelerator for the :ref:`decimal ` module." +msgstr "" + +msgid "" +"Better unicode handling in the :ref:`email ` module (:term:" +"`provisional `)." +msgstr "" + +msgid "Security improvements:" +msgstr "" + +msgid "Hash randomization is switched on by default." +msgstr "" + +msgid "Please read on for a comprehensive list of user-facing changes." +msgstr "" + +msgid "PEP 405: Virtual Environments" +msgstr "" + +msgid "" +"Virtual environments help create separate Python setups while sharing a " +"system-wide base install, for ease of maintenance. Virtual environments " +"have their own set of private site packages (i.e. locally installed " +"libraries), and are optionally segregated from the system-wide site " +"packages. Their concept and implementation are inspired by the popular " +"``virtualenv`` third-party package, but benefit from tighter integration " +"with the interpreter core." +msgstr "" + +msgid "" +"This PEP adds the :mod:`venv` module for programmatic access, and the " +"``pyvenv`` script for command-line access and administration. The Python " +"interpreter checks for a ``pyvenv.cfg``, file whose existence signals the " +"base of a virtual environment's directory tree." +msgstr "" + +msgid ":pep:`405` - Python Virtual Environments" +msgstr "" + +msgid "PEP written by Carl Meyer; implementation by Carl Meyer and Vinay Sajip" +msgstr "" + +msgid "PEP 420: Implicit Namespace Packages" +msgstr "" + +msgid "" +"Native support for package directories that don't require ``__init__.py`` " +"marker files and can automatically span multiple path segments (inspired by " +"various third party approaches to namespace packages, as described in :pep:" +"`420`)" +msgstr "" + +msgid ":pep:`420` - Implicit Namespace Packages" +msgstr "" + +msgid "" +"PEP written by Eric V. Smith; implementation by Eric V. Smith and Barry " +"Warsaw" +msgstr "" + +msgid "" +"PEP 3118: New memoryview implementation and buffer protocol documentation" +msgstr "" + +msgid "The implementation of :pep:`3118` has been significantly improved." +msgstr "" + +msgid "" +"The new memoryview implementation comprehensively fixes all ownership and " +"lifetime issues of dynamically allocated fields in the Py_buffer struct that " +"led to multiple crash reports. Additionally, several functions that crashed " +"or returned incorrect results for non-contiguous or multi-dimensional input " +"have been fixed." +msgstr "" + +msgid "" +"The memoryview object now has a PEP-3118 compliant getbufferproc() that " +"checks the consumer's request type. Many new features have been added, most " +"of them work in full generality for non-contiguous arrays and arrays with " +"suboffsets." +msgstr "" + +msgid "" +"The documentation has been updated, clearly spelling out responsibilities " +"for both exporters and consumers. Buffer request flags are grouped into " +"basic and compound flags. The memory layout of non-contiguous and multi-" +"dimensional NumPy-style arrays is explained." +msgstr "" + +msgid "Features" +msgstr "" + +msgid "" +"All native single character format specifiers in struct module syntax " +"(optionally prefixed with '@') are now supported." +msgstr "" + +msgid "" +"With some restrictions, the cast() method allows changing of format and " +"shape of C-contiguous arrays." +msgstr "" + +msgid "" +"Multi-dimensional list representations are supported for any array type." +msgstr "" + +msgid "Multi-dimensional comparisons are supported for any array type." +msgstr "" + +msgid "" +"One-dimensional memoryviews of hashable (read-only) types with formats B, b " +"or c are now hashable. (Contributed by Antoine Pitrou in :issue:`13411`.)" +msgstr "" + +msgid "" +"Arbitrary slicing of any 1-D arrays type is supported. For example, it is " +"now possible to reverse a memoryview in *O*\\ (1) by using a negative step." +msgstr "" + +msgid "API changes" +msgstr "" + +msgid "The maximum number of dimensions is officially limited to 64." +msgstr "" + +msgid "" +"The representation of empty shape, strides and suboffsets is now an empty " +"tuple instead of ``None``." +msgstr "" + +msgid "" +"Accessing a memoryview element with format 'B' (unsigned bytes) now returns " +"an integer (in accordance with the struct module syntax). For returning a " +"bytes object the view must be cast to 'c' first." +msgstr "" + +msgid "" +"memoryview comparisons now use the logical structure of the operands and " +"compare all array elements by value. All format strings in struct module " +"syntax are supported. Views with unrecognised format strings are still " +"permitted, but will always compare as unequal, regardless of view contents." +msgstr "" + +msgid "" +"For further changes see `Build and C API Changes`_ and `Porting C code`_." +msgstr "" + +msgid "(Contributed by Stefan Krah in :issue:`10181`.)" +msgstr "" + +msgid ":pep:`3118` - Revising the Buffer Protocol" +msgstr "" + +msgid "PEP 393: Flexible String Representation" +msgstr "" + +msgid "" +"The Unicode string type is changed to support multiple internal " +"representations, depending on the character with the largest Unicode ordinal " +"(1, 2, or 4 bytes) in the represented string. This allows a space-efficient " +"representation in common cases, but gives access to full UCS-4 on all " +"systems. For compatibility with existing APIs, several representations may " +"exist in parallel; over time, this compatibility should be phased out." +msgstr "" + +msgid "On the Python side, there should be no downside to this change." +msgstr "" + +msgid "" +"On the C API side, :pep:`393` is fully backward compatible. The legacy API " +"should remain available at least five years. Applications using the legacy " +"API will not fully benefit of the memory reduction, or - worse - may use a " +"bit more memory, because Python may have to maintain two versions of each " +"string (in the legacy format and in the new efficient storage)." +msgstr "" + +msgid "Functionality" +msgstr "" + +msgid "Changes introduced by :pep:`393` are the following:" +msgstr "" + +msgid "" +"Python now always supports the full range of Unicode code points, including " +"non-BMP ones (i.e. from ``U+0000`` to ``U+10FFFF``). The distinction " +"between narrow and wide builds no longer exists and Python now behaves like " +"a wide build, even under Windows." +msgstr "" + +msgid "" +"With the death of narrow builds, the problems specific to narrow builds have " +"also been fixed, for example:" +msgstr "" + +msgid "" +":func:`len` now always returns 1 for non-BMP characters, so " +"``len('\\U0010FFFF') == 1``;" +msgstr "" + +msgid "" +"surrogate pairs are not recombined in string literals, so " +"``'\\uDBFF\\uDFFF' != '\\U0010FFFF'``;" +msgstr "" + +msgid "" +"indexing or slicing non-BMP characters returns the expected value, so " +"``'\\U0010FFFF'[0]`` now returns ``'\\U0010FFFF'`` and not ``'\\uDBFF'``;" +msgstr "" + +msgid "" +"all other functions in the standard library now correctly handle non-BMP " +"code points." +msgstr "" + +msgid "" +"The value of :data:`sys.maxunicode` is now always ``1114111`` (``0x10FFFF`` " +"in hexadecimal). The :c:func:`!PyUnicode_GetMax` function still returns " +"either ``0xFFFF`` or ``0x10FFFF`` for backward compatibility, and it should " +"not be used with the new Unicode API (see :issue:`13054`)." +msgstr "" + +msgid "The :file:`./configure` flag ``--with-wide-unicode`` has been removed." +msgstr "" + +msgid "Performance and resource usage" +msgstr "" + +msgid "" +"The storage of Unicode strings now depends on the highest code point in the " +"string:" +msgstr "" + +msgid "" +"pure ASCII and Latin1 strings (``U+0000-U+00FF``) use 1 byte per code point;" +msgstr "" + +msgid "BMP strings (``U+0000-U+FFFF``) use 2 bytes per code point;" +msgstr "" + +msgid "non-BMP strings (``U+10000-U+10FFFF``) use 4 bytes per code point." +msgstr "" + +msgid "" +"The net effect is that for most applications, memory usage of string storage " +"should decrease significantly - especially compared to former wide unicode " +"builds - as, in many cases, strings will be pure ASCII even in international " +"contexts (because many strings store non-human language data, such as XML " +"fragments, HTTP headers, JSON-encoded data, etc.). We also hope that it " +"will, for the same reasons, increase CPU cache efficiency on non-trivial " +"applications. The memory usage of Python 3.3 is two to three times smaller " +"than Python 3.2, and a little bit better than Python 2.7, on a Django " +"benchmark (see the PEP for details)." +msgstr "" + +msgid ":pep:`393` - Flexible String Representation" +msgstr "" + +msgid "" +"PEP written by Martin von Löwis; implementation by Torsten Becker and Martin " +"von Löwis." +msgstr "" + +msgid "PEP 397: Python Launcher for Windows" +msgstr "" + +msgid "" +"The Python 3.3 Windows installer now includes a ``py`` launcher application " +"that can be used to launch Python applications in a version independent " +"fashion." +msgstr "" + +msgid "" +"This launcher is invoked implicitly when double-clicking ``*.py`` files. If " +"only a single Python version is installed on the system, that version will " +"be used to run the file. If multiple versions are installed, the most recent " +"version is used by default, but this can be overridden by including a Unix-" +"style \"shebang line\" in the Python script." +msgstr "" + +msgid "" +"The launcher can also be used explicitly from the command line as the ``py`` " +"application. Running ``py`` follows the same version selection rules as " +"implicitly launching scripts, but a more specific version can be selected by " +"passing appropriate arguments (such as ``-3`` to request Python 3 when " +"Python 2 is also installed, or ``-2.6`` to specifically request an earlier " +"Python version when a more recent version is installed)." +msgstr "" + +msgid "" +"In addition to the launcher, the Windows installer now includes an option to " +"add the newly installed Python to the system PATH. (Contributed by Brian " +"Curtin in :issue:`3561`.)" +msgstr "" + +msgid ":pep:`397` - Python Launcher for Windows" +msgstr "" + +msgid "" +"PEP written by Mark Hammond and Martin v. Löwis; implementation by Vinay " +"Sajip." +msgstr "" + +msgid "Launcher documentation: :ref:`launcher`" +msgstr "" + +msgid "Installer PATH modification: :ref:`windows-path-mod`" +msgstr "" + +msgid "PEP 3151: Reworking the OS and IO exception hierarchy" +msgstr "" + +msgid "" +"The hierarchy of exceptions raised by operating system errors is now both " +"simplified and finer-grained." +msgstr "" + +msgid "" +"You don't have to worry anymore about choosing the appropriate exception " +"type between :exc:`OSError`, :exc:`IOError`, :exc:`EnvironmentError`, :exc:" +"`WindowsError`, :exc:`mmap.error`, :exc:`socket.error` or :exc:`select." +"error`. All these exception types are now only one: :exc:`OSError`. The " +"other names are kept as aliases for compatibility reasons." +msgstr "" + +msgid "" +"Also, it is now easier to catch a specific error condition. Instead of " +"inspecting the ``errno`` attribute (or ``args[0]``) for a particular " +"constant from the :mod:`errno` module, you can catch the adequate :exc:" +"`OSError` subclass. The available subclasses are the following:" +msgstr "" + +msgid ":exc:`BlockingIOError`" +msgstr ":exc:`BlockingIOError`" + +msgid ":exc:`ChildProcessError`" +msgstr ":exc:`ChildProcessError`" + +msgid ":exc:`ConnectionError`" +msgstr ":exc:`ConnectionError`" + +msgid ":exc:`FileExistsError`" +msgstr ":exc:`FileExistsError`" + +msgid ":exc:`FileNotFoundError`" +msgstr ":exc:`FileNotFoundError`" + +msgid ":exc:`InterruptedError`" +msgstr ":exc:`InterruptedError`" + +msgid ":exc:`IsADirectoryError`" +msgstr ":exc:`IsADirectoryError`" + +msgid ":exc:`NotADirectoryError`" +msgstr ":exc:`NotADirectoryError`" + +msgid ":exc:`PermissionError`" +msgstr ":exc:`PermissionError`" + +msgid ":exc:`ProcessLookupError`" +msgstr ":exc:`ProcessLookupError`" + +msgid ":exc:`TimeoutError`" +msgstr ":exc:`TimeoutError`" + +msgid "And the :exc:`ConnectionError` itself has finer-grained subclasses:" +msgstr "" + +msgid ":exc:`BrokenPipeError`" +msgstr ":exc:`BrokenPipeError`" + +msgid ":exc:`ConnectionAbortedError`" +msgstr ":exc:`ConnectionAbortedError`" + +msgid ":exc:`ConnectionRefusedError`" +msgstr ":exc:`ConnectionRefusedError`" + +msgid ":exc:`ConnectionResetError`" +msgstr ":exc:`ConnectionResetError`" + +msgid "" +"Thanks to the new exceptions, common usages of the :mod:`errno` can now be " +"avoided. For example, the following code written for Python 3.2::" +msgstr "" + +msgid "" +"can now be written without the :mod:`errno` import and without manual " +"inspection of exception attributes::" +msgstr "" + +msgid ":pep:`3151` - Reworking the OS and IO Exception Hierarchy" +msgstr "" + +msgid "PEP written and implemented by Antoine Pitrou" +msgstr "" + +msgid "PEP 380: Syntax for Delegating to a Subgenerator" +msgstr "" + +msgid "" +"PEP 380 adds the ``yield from`` expression, allowing a :term:`generator` to " +"delegate part of its operations to another generator. This allows a section " +"of code containing :keyword:`yield` to be factored out and placed in another " +"generator. Additionally, the subgenerator is allowed to return with a value, " +"and the value is made available to the delegating generator." +msgstr "" + +msgid "" +"While designed primarily for use in delegating to a subgenerator, the " +"``yield from`` expression actually allows delegation to arbitrary " +"subiterators." +msgstr "" + +msgid "" +"For simple iterators, ``yield from iterable`` is essentially just a " +"shortened form of ``for item in iterable: yield item``::" +msgstr "" + +msgid "" +"However, unlike an ordinary loop, ``yield from`` allows subgenerators to " +"receive sent and thrown values directly from the calling scope, and return a " +"final value to the outer generator::" +msgstr "" + +msgid "" +"The main principle driving this change is to allow even generators that are " +"designed to be used with the ``send`` and ``throw`` methods to be split into " +"multiple subgenerators as easily as a single large function can be split " +"into multiple subfunctions." +msgstr "" + +msgid ":pep:`380` - Syntax for Delegating to a Subgenerator" +msgstr "" + +msgid "" +"PEP written by Greg Ewing; implementation by Greg Ewing, integrated into 3.3 " +"by Renaud Blanch, Ryan Kelly and Nick Coghlan; documentation by Zbigniew " +"Jędrzejewski-Szmek and Nick Coghlan" +msgstr "" + +msgid "PEP 409: Suppressing exception context" +msgstr "" + +msgid "" +"PEP 409 introduces new syntax that allows the display of the chained " +"exception context to be disabled. This allows cleaner error messages in " +"applications that convert between exception types::" +msgstr "" + +msgid "" +"Without the ``from None`` suffix to suppress the cause, the original " +"exception would be displayed by default::" +msgstr "" + +msgid "" +"No debugging capability is lost, as the original exception context remains " +"available if needed (for example, if an intervening library has incorrectly " +"suppressed valuable underlying details)::" +msgstr "" + +msgid ":pep:`409` - Suppressing exception context" +msgstr "" + +msgid "" +"PEP written by Ethan Furman; implemented by Ethan Furman and Nick Coghlan." +msgstr "" + +msgid "PEP 414: Explicit Unicode literals" +msgstr "" + +msgid "" +"To ease the transition from Python 2 for Unicode aware Python applications " +"that make heavy use of Unicode literals, Python 3.3 once again supports the " +"\"``u``\" prefix for string literals. This prefix has no semantic " +"significance in Python 3, it is provided solely to reduce the number of " +"purely mechanical changes in migrating to Python 3, making it easier for " +"developers to focus on the more significant semantic changes (such as the " +"stricter default separation of binary and text data)." +msgstr "" + +msgid ":pep:`414` - Explicit Unicode literals" +msgstr "" + +msgid "PEP written by Armin Ronacher." +msgstr "" + +msgid "PEP 3155: Qualified name for classes and functions" +msgstr "" + +msgid "" +"Functions and class objects have a new ``__qualname__`` attribute " +"representing the \"path\" from the module top-level to their definition. " +"For global functions and classes, this is the same as ``__name__``. For " +"other functions and classes, it provides better information about where they " +"were actually defined, and how they might be accessible from the global " +"scope." +msgstr "" + +msgid "Example with (non-bound) methods::" +msgstr "" + +msgid "Example with nested classes::" +msgstr "" + +msgid "Example with nested functions::" +msgstr "" + +msgid "" +"The string representation of those objects is also changed to include the " +"new, more precise information::" +msgstr "" + +msgid ":pep:`3155` - Qualified name for classes and functions" +msgstr "" + +msgid "PEP written and implemented by Antoine Pitrou." +msgstr "" + +msgid "PEP 412: Key-Sharing Dictionary" +msgstr "" + +msgid "" +"Dictionaries used for the storage of objects' attributes are now able to " +"share part of their internal storage between each other (namely, the part " +"which stores the keys and their respective hashes). This reduces the memory " +"consumption of programs creating many instances of non-builtin types." +msgstr "" + +msgid ":pep:`412` - Key-Sharing Dictionary" +msgstr "" + +msgid "PEP written and implemented by Mark Shannon." +msgstr "" + +msgid "PEP 362: Function Signature Object" +msgstr "" + +msgid "" +"A new function :func:`inspect.signature` makes introspection of python " +"callables easy and straightforward. A broad range of callables is " +"supported: python functions, decorated or not, classes, and :func:`functools." +"partial` objects. New classes :class:`inspect.Signature`, :class:`inspect." +"Parameter` and :class:`inspect.BoundArguments` hold information about the " +"call signatures, such as, annotations, default values, parameters kinds, and " +"bound arguments, which considerably simplifies writing decorators and any " +"code that validates or amends calling signatures or arguments." +msgstr "" + +msgid ":pep:`362`: - Function Signature Object" +msgstr "" + +msgid "" +"PEP written by Brett Cannon, Yury Selivanov, Larry Hastings, Jiwon Seo; " +"implemented by Yury Selivanov." +msgstr "" + +msgid "PEP 421: Adding sys.implementation" +msgstr "" + +msgid "" +"A new attribute on the :mod:`sys` module exposes details specific to the " +"implementation of the currently running interpreter. The initial set of " +"attributes on :data:`sys.implementation` are ``name``, ``version``, " +"``hexversion``, and ``cache_tag``." +msgstr "" + +msgid "" +"The intention of ``sys.implementation`` is to consolidate into one namespace " +"the implementation-specific data used by the standard library. This allows " +"different Python implementations to share a single standard library code " +"base much more easily. In its initial state, ``sys.implementation`` holds " +"only a small portion of the implementation-specific data. Over time that " +"ratio will shift in order to make the standard library more portable." +msgstr "" + +msgid "" +"One example of improved standard library portability is ``cache_tag``. As " +"of Python 3.3, ``sys.implementation.cache_tag`` is used by :mod:`importlib` " +"to support :pep:`3147` compliance. Any Python implementation that uses " +"``importlib`` for its built-in import system may use ``cache_tag`` to " +"control the caching behavior for modules." +msgstr "" + +msgid "SimpleNamespace" +msgstr "" + +msgid "" +"The implementation of ``sys.implementation`` also introduces a new type to " +"Python: :class:`types.SimpleNamespace`. In contrast to a mapping-based " +"namespace, like :class:`dict`, ``SimpleNamespace`` is attribute-based, like :" +"class:`object`. However, unlike ``object``, ``SimpleNamespace`` instances " +"are writable. This means that you can add, remove, and modify the namespace " +"through normal attribute access." +msgstr "" + +msgid ":pep:`421` - Adding sys.implementation" +msgstr "" + +msgid "PEP written and implemented by Eric Snow." +msgstr "" + +msgid "Using importlib as the Implementation of Import" +msgstr "" + +msgid "" +":issue:`2377` - Replace __import__ w/ importlib.__import__ :issue:`13959` - " +"Re-implement parts of :mod:`imp` in pure Python :issue:`14605` - Make import " +"machinery explicit :issue:`14646` - Require loaders set __loader__ and " +"__package__" +msgstr "" + +msgid "" +"The :func:`__import__` function is now powered by :func:`importlib." +"__import__`. This work leads to the completion of \"phase 2\" of :pep:`302`. " +"There are multiple benefits to this change. First, it has allowed for more " +"of the machinery powering import to be exposed instead of being implicit and " +"hidden within the C code. It also provides a single implementation for all " +"Python VMs supporting Python 3.3 to use, helping to end any VM-specific " +"deviations in import semantics. And finally it eases the maintenance of " +"import, allowing for future growth to occur." +msgstr "" + +msgid "" +"For the common user, there should be no visible change in semantics. For " +"those whose code currently manipulates import or calls import " +"programmatically, the code changes that might possibly be required are " +"covered in the `Porting Python code`_ section of this document." +msgstr "" + +msgid "New APIs" +msgstr "" + +msgid "" +"One of the large benefits of this work is the exposure of what goes into " +"making the import statement work. That means the various importers that were " +"once implicit are now fully exposed as part of the :mod:`importlib` package." +msgstr "" + +msgid "" +"The abstract base classes defined in :mod:`importlib.abc` have been expanded " +"to properly delineate between :term:`meta path finders ` " +"and :term:`path entry finders ` by introducing :class:" +"`importlib.abc.MetaPathFinder` and :class:`importlib.abc.PathEntryFinder`, " +"respectively. The old ABC of :class:`importlib.abc.Finder` is now only " +"provided for backwards-compatibility and does not enforce any method " +"requirements." +msgstr "" + +msgid "" +"In terms of finders, :class:`importlib.machinery.FileFinder` exposes the " +"mechanism used to search for source and bytecode files of a module. " +"Previously this class was an implicit member of :data:`sys.path_hooks`." +msgstr "" + +msgid "" +"For loaders, the new abstract base class :class:`importlib.abc.FileLoader` " +"helps write a loader that uses the file system as the storage mechanism for " +"a module's code. The loader for source files (:class:`importlib.machinery." +"SourceFileLoader`), sourceless bytecode files (:class:`importlib.machinery." +"SourcelessFileLoader`), and extension modules (:class:`importlib.machinery." +"ExtensionFileLoader`) are now available for direct use." +msgstr "" + +msgid "" +":exc:`ImportError` now has ``name`` and ``path`` attributes which are set " +"when there is relevant data to provide. The message for failed imports will " +"also provide the full name of the module now instead of just the tail end of " +"the module's name." +msgstr "" + +msgid "" +"The :func:`importlib.invalidate_caches` function will now call the method " +"with the same name on all finders cached in :data:`sys.path_importer_cache` " +"to help clean up any stored state as necessary." +msgstr "" + +msgid "Visible Changes" +msgstr "" + +msgid "" +"For potential required changes to code, see the `Porting Python code`_ " +"section." +msgstr "" + +msgid "" +"Beyond the expanse of what :mod:`importlib` now exposes, there are other " +"visible changes to import. The biggest is that :data:`sys.meta_path` and :" +"data:`sys.path_hooks` now store all of the meta path finders and path entry " +"hooks used by import. Previously the finders were implicit and hidden " +"within the C code of import instead of being directly exposed. This means " +"that one can now easily remove or change the order of the various finders to " +"fit one's needs." +msgstr "" + +msgid "" +"Another change is that all modules have a ``__loader__`` attribute, storing " +"the loader used to create the module. :pep:`302` has been updated to make " +"this attribute mandatory for loaders to implement, so in the future once 3rd-" +"party loaders have been updated people will be able to rely on the existence " +"of the attribute. Until such time, though, import is setting the module post-" +"load." +msgstr "" + +msgid "" +"Loaders are also now expected to set the ``__package__`` attribute from :pep:" +"`366`. Once again, import itself is already setting this on all loaders " +"from :mod:`importlib` and import itself is setting the attribute post-load." +msgstr "" + +msgid "" +"``None`` is now inserted into :data:`sys.path_importer_cache` when no finder " +"can be found on :data:`sys.path_hooks`. Since :class:`imp.NullImporter` is " +"not directly exposed on :data:`sys.path_hooks` it could no longer be relied " +"upon to always be available to use as a value representing no finder found." +msgstr "" + +msgid "" +"All other changes relate to semantic changes which should be taken into " +"consideration when updating code for Python 3.3, and thus should be read " +"about in the `Porting Python code`_ section of this document." +msgstr "" + +msgid "(Implementation by Brett Cannon)" +msgstr "" + +msgid "Other Language Changes" +msgstr "" + +msgid "Some smaller changes made to the core Python language are:" +msgstr "" + +msgid "" +"Added support for Unicode name aliases and named sequences. Both :func:" +"`unicodedata.lookup()` and ``'\\N{...}'`` now resolve name aliases, and :" +"func:`unicodedata.lookup()` resolves named sequences too." +msgstr "" + +msgid "(Contributed by Ezio Melotti in :issue:`12753`.)" +msgstr "" + +msgid "Unicode database updated to UCD version 6.1.0" +msgstr "" + +msgid "" +"Equality comparisons on :func:`range` objects now return a result reflecting " +"the equality of the underlying sequences generated by those range objects. (:" +"issue:`13201`)" +msgstr "" + +msgid "" +"The ``count()``, ``find()``, ``rfind()``, ``index()`` and ``rindex()`` " +"methods of :class:`bytes` and :class:`bytearray` objects now accept an " +"integer between 0 and 255 as their first argument." +msgstr "" + +msgid "(Contributed by Petri Lehtinen in :issue:`12170`.)" +msgstr "" + +msgid "" +"The ``rjust()``, ``ljust()``, and ``center()`` methods of :class:`bytes` " +"and :class:`bytearray` now accept a :class:`bytearray` for the ``fill`` " +"argument. (Contributed by Petri Lehtinen in :issue:`12380`.)" +msgstr "" + +msgid "" +"New methods have been added to :class:`list` and :class:`bytearray`: " +"``copy()`` and ``clear()`` (:issue:`10516`). Consequently, :class:" +"`~collections.abc.MutableSequence` now also defines a :meth:`~collections." +"abc.MutableSequence.clear` method (:issue:`11388`)." +msgstr "" + +msgid "" +"Raw bytes literals can now be written ``rb\"...\"`` as well as ``br\"...\"``." +msgstr "" + +msgid "(Contributed by Antoine Pitrou in :issue:`13748`.)" +msgstr "" + +msgid "" +":meth:`dict.setdefault` now does only one lookup for the given key, making " +"it atomic when used with built-in types." +msgstr "" + +msgid "(Contributed by Filip Gruszczyński in :issue:`13521`.)" +msgstr "" + +msgid "" +"The error messages produced when a function call does not match the function " +"signature have been significantly improved." +msgstr "" + +msgid "(Contributed by Benjamin Peterson.)" +msgstr "" + +msgid "A Finer-Grained Import Lock" +msgstr "" + +msgid "" +"Previous versions of CPython have always relied on a global import lock. " +"This led to unexpected annoyances, such as deadlocks when importing a module " +"would trigger code execution in a different thread as a side-effect. Clumsy " +"workarounds were sometimes employed, such as the :c:func:" +"`PyImport_ImportModuleNoBlock` C API function." +msgstr "" + +msgid "" +"In Python 3.3, importing a module takes a per-module lock. This correctly " +"serializes importation of a given module from multiple threads (preventing " +"the exposure of incompletely initialized modules), while eliminating the " +"aforementioned annoyances." +msgstr "" + +msgid "(Contributed by Antoine Pitrou in :issue:`9260`.)" +msgstr "" + +msgid "Builtin functions and types" +msgstr "" + +msgid "" +":func:`open` gets a new *opener* parameter: the underlying file descriptor " +"for the file object is then obtained by calling *opener* with (*file*, " +"*flags*). It can be used to use custom flags like :const:`os.O_CLOEXEC` for " +"example. The ``'x'`` mode was added: open for exclusive creation, failing if " +"the file already exists." +msgstr "" + +msgid "" +":func:`print`: added the *flush* keyword argument. If the *flush* keyword " +"argument is true, the stream is forcibly flushed." +msgstr "" + +msgid "" +":func:`hash`: hash randomization is enabled by default, see :meth:`object." +"__hash__` and :envvar:`PYTHONHASHSEED`." +msgstr "" + +msgid "" +"The :class:`str` type gets a new :meth:`~str.casefold` method: return a " +"casefolded copy of the string, casefolded strings may be used for caseless " +"matching. For example, ``'ß'.casefold()`` returns ``'ss'``." +msgstr "" + +msgid "" +"The sequence documentation has been substantially rewritten to better " +"explain the binary/text sequence distinction and to provide specific " +"documentation sections for the individual builtin sequence types (:issue:" +"`4966`)." +msgstr "" + +msgid "New Modules" +msgstr "" + +msgid "faulthandler" +msgstr "" + +msgid "" +"This new debug module :mod:`faulthandler` contains functions to dump Python " +"tracebacks explicitly, on a fault (a crash like a segmentation fault), after " +"a timeout, or on a user signal. Call :func:`faulthandler.enable` to install " +"fault handlers for the :const:`SIGSEGV`, :const:`SIGFPE`, :const:`SIGABRT`, :" +"const:`SIGBUS`, and :const:`SIGILL` signals. You can also enable them at " +"startup by setting the :envvar:`PYTHONFAULTHANDLER` environment variable or " +"by using :option:`-X` ``faulthandler`` command line option." +msgstr "" + +msgid "Example of a segmentation fault on Linux:" +msgstr "" + +msgid "ipaddress" +msgstr "" + +msgid "" +"The new :mod:`ipaddress` module provides tools for creating and manipulating " +"objects representing IPv4 and IPv6 addresses, networks and interfaces (i.e. " +"an IP address associated with a specific IP subnet)." +msgstr "" + +msgid "(Contributed by Google and Peter Moody in :pep:`3144`.)" +msgstr "" + +msgid "lzma" +msgstr "" + +msgid "" +"The newly added :mod:`lzma` module provides data compression and " +"decompression using the LZMA algorithm, including support for the ``.xz`` " +"and ``.lzma`` file formats." +msgstr "" + +msgid "(Contributed by Nadeem Vawda and Per Øyvind Karlsen in :issue:`6715`.)" +msgstr "" + +msgid "Improved Modules" +msgstr "Ulepszone moduły" + +msgid "abc" +msgstr "" + +msgid "" +"Improved support for abstract base classes containing descriptors composed " +"with abstract methods. The recommended approach to declaring abstract " +"descriptors is now to provide :attr:`__isabstractmethod__` as a dynamically " +"updated property. The built-in descriptors have been updated accordingly." +msgstr "" + +msgid "" +":class:`abc.abstractproperty` has been deprecated, use :class:`property` " +"with :func:`abc.abstractmethod` instead." +msgstr "" + +msgid "" +":class:`abc.abstractclassmethod` has been deprecated, use :class:" +"`classmethod` with :func:`abc.abstractmethod` instead." +msgstr "" + +msgid "" +":class:`abc.abstractstaticmethod` has been deprecated, use :class:" +"`staticmethod` with :func:`abc.abstractmethod` instead." +msgstr "" + +msgid "(Contributed by Darren Dale in :issue:`11610`.)" +msgstr "" + +msgid "" +":meth:`abc.ABCMeta.register` now returns the registered subclass, which " +"means it can now be used as a class decorator (:issue:`10868`)." +msgstr "" + +msgid "array" +msgstr "" + +msgid "" +"The :mod:`array` module supports the :c:expr:`long long` type using ``q`` " +"and ``Q`` type codes." +msgstr "" + +msgid "(Contributed by Oren Tirosh and Hirokazu Yamamoto in :issue:`1172711`.)" +msgstr "" + +msgid "base64" +msgstr "" + +msgid "" +"ASCII-only Unicode strings are now accepted by the decoding functions of " +"the :mod:`base64` modern interface. For example, ``base64." +"b64decode('YWJj')`` returns ``b'abc'``. (Contributed by Catalin Iacob in :" +"issue:`13641`.)" +msgstr "" + +msgid "binascii" +msgstr "" + +msgid "" +"In addition to the binary objects they normally accept, the ``a2b_`` " +"functions now all also accept ASCII-only strings as input. (Contributed by " +"Antoine Pitrou in :issue:`13637`.)" +msgstr "" + +msgid "bz2" +msgstr "" + +msgid "" +"The :mod:`bz2` module has been rewritten from scratch. In the process, " +"several new features have been added:" +msgstr "" + +msgid "" +"New :func:`bz2.open` function: open a bzip2-compressed file in binary or " +"text mode." +msgstr "" + +msgid "" +":class:`bz2.BZ2File` can now read from and write to arbitrary file-like " +"objects, by means of its constructor's *fileobj* argument." +msgstr "" + +msgid "(Contributed by Nadeem Vawda in :issue:`5863`.)" +msgstr "" + +msgid "" +":class:`bz2.BZ2File` and :func:`bz2.decompress` can now decompress multi-" +"stream inputs (such as those produced by the :program:`pbzip2` tool). :class:" +"`bz2.BZ2File` can now also be used to create this type of file, using the " +"``'a'`` (append) mode." +msgstr "" + +msgid "(Contributed by Nir Aides in :issue:`1625`.)" +msgstr "" + +msgid "" +":class:`bz2.BZ2File` now implements all of the :class:`io.BufferedIOBase` " +"API, except for the :meth:`detach` and :meth:`truncate` methods." +msgstr "" + +msgid "codecs" +msgstr "" + +msgid "" +"The :mod:`~encodings.mbcs` codec has been rewritten to handle correctly " +"``replace`` and ``ignore`` error handlers on all Windows versions. The :mod:" +"`~encodings.mbcs` codec now supports all error handlers, instead of only " +"``replace`` to encode and ``ignore`` to decode." +msgstr "" + +msgid "" +"A new Windows-only codec has been added: ``cp65001`` (:issue:`13216`). It is " +"the Windows code page 65001 (Windows UTF-8, ``CP_UTF8``). For example, it " +"is used by ``sys.stdout`` if the console output code page is set to cp65001 " +"(e.g., using ``chcp 65001`` command)." +msgstr "" + +msgid "" +"Multibyte CJK decoders now resynchronize faster. They only ignore the first " +"byte of an invalid byte sequence. For example, ``b'\\xff\\n'." +"decode('gb2312', 'replace')`` now returns a ``\\n`` after the replacement " +"character." +msgstr "" + +msgid "(:issue:`12016`)" +msgstr "(:issue:`12016`)" + +msgid "" +"Incremental CJK codec encoders are no longer reset at each call to their " +"encode() methods. For example::" +msgstr "" + +msgid "" +"This example gives ``b'~{Np~}~{J)~}~{l6~}~{HK~}~{!#~} Bye.'`` with older " +"Python versions." +msgstr "" + +msgid "(:issue:`12100`)" +msgstr "(:issue:`12100`)" + +msgid "The ``unicode_internal`` codec has been deprecated." +msgstr "" + +msgid "collections" +msgstr "" + +msgid "" +"Addition of a new :class:`~collections.ChainMap` class to allow treating a " +"number of mappings as a single unit. (Written by Raymond Hettinger for :" +"issue:`11089`, made public in :issue:`11297`.)" +msgstr "" + +msgid "" +"The abstract base classes have been moved in a new :mod:`collections.abc` " +"module, to better differentiate between the abstract and the concrete " +"collections classes. Aliases for ABCs are still present in the :mod:" +"`collections` module to preserve existing imports. (:issue:`11085`)" +msgstr "" + +msgid "" +"The :class:`~collections.Counter` class now supports the unary ``+`` and ``-" +"`` operators, as well as the in-place operators ``+=``, ``-=``, ``|=``, and " +"``&=``. (Contributed by Raymond Hettinger in :issue:`13121`.)" +msgstr "" + +msgid "contextlib" +msgstr "" + +msgid "" +":class:`~contextlib.ExitStack` now provides a solid foundation for " +"programmatic manipulation of context managers and similar cleanup " +"functionality. Unlike the previous ``contextlib.nested`` API (which was " +"deprecated and removed), the new API is designed to work correctly " +"regardless of whether context managers acquire their resources in their " +"``__init__`` method (for example, file objects) or in their ``__enter__`` " +"method (for example, synchronisation objects from the :mod:`threading` " +"module)." +msgstr "" + +msgid "(:issue:`13585`)" +msgstr "(:issue:`13585`)" + +msgid "crypt" +msgstr "" + +msgid "" +"Addition of salt and modular crypt format (hashing method) and the :func:" +"`~crypt.mksalt` function to the :mod:`crypt` module." +msgstr "" + +msgid "(:issue:`10924`)" +msgstr "(:issue:`10924`)" + +msgid "curses" +msgstr "" + +msgid "" +"If the :mod:`curses` module is linked to the ncursesw library, use Unicode " +"functions when Unicode strings or characters are passed (e.g. :c:func:" +"`waddwstr`), and bytes functions otherwise (e.g. :c:func:`waddstr`)." +msgstr "" + +msgid "Use the locale encoding instead of ``utf-8`` to encode Unicode strings." +msgstr "" + +msgid "" +":class:`curses.window` has a new :attr:`curses.window.encoding` attribute." +msgstr "" + +msgid "" +"The :class:`curses.window` class has a new :meth:`~curses.window.get_wch` " +"method to get a wide character" +msgstr "" + +msgid "" +"The :mod:`curses` module has a new :meth:`~curses.unget_wch` function to " +"push a wide character so the next :meth:`~curses.window.get_wch` will return " +"it" +msgstr "" + +msgid "(Contributed by Iñigo Serna in :issue:`6755`.)" +msgstr "" + +msgid "datetime" +msgstr "" + +msgid "" +"Equality comparisons between naive and aware :class:`~datetime.datetime` " +"instances now return :const:`False` instead of raising :exc:`TypeError` (:" +"issue:`15006`)." +msgstr "" + +msgid "" +"New :meth:`datetime.datetime.timestamp` method: Return POSIX timestamp " +"corresponding to the :class:`~datetime.datetime` instance." +msgstr "" + +msgid "" +"The :meth:`datetime.datetime.strftime` method supports formatting years " +"older than 1000." +msgstr "" + +msgid "" +"The :meth:`datetime.datetime.astimezone` method can now be called without " +"arguments to convert datetime instance to the system timezone." +msgstr "" + +msgid "decimal" +msgstr "" + +msgid ":issue:`7652` - integrate fast native decimal arithmetic." +msgstr "" + +msgid "C-module and libmpdec written by Stefan Krah." +msgstr "" + +msgid "" +"The new C version of the decimal module integrates the high speed libmpdec " +"library for arbitrary precision correctly rounded decimal floating point " +"arithmetic. libmpdec conforms to IBM's General Decimal Arithmetic " +"Specification." +msgstr "" + +msgid "" +"Performance gains range from 10x for database applications to 100x for " +"numerically intensive applications. These numbers are expected gains for " +"standard precisions used in decimal floating point arithmetic. Since the " +"precision is user configurable, the exact figures may vary. For example, in " +"integer bignum arithmetic the differences can be significantly higher." +msgstr "" + +msgid "" +"The following table is meant as an illustration. Benchmarks are available at " +"https://www.bytereef.org/mpdecimal/quickstart.html." +msgstr "" + +msgid "decimal.py" +msgstr "" + +msgid "_decimal" +msgstr "" + +msgid "speedup" +msgstr "" + +msgid "pi" +msgstr "" + +msgid "42.02s" +msgstr "" + +msgid "0.345s" +msgstr "" + +msgid "120x" +msgstr "" + +msgid "telco" +msgstr "" + +msgid "172.19s" +msgstr "" + +msgid "5.68s" +msgstr "" + +msgid "30x" +msgstr "" + +msgid "psycopg" +msgstr "" + +msgid "3.57s" +msgstr "" + +msgid "0.29s" +msgstr "" + +msgid "12x" +msgstr "" + +msgid "" +"The :exc:`~decimal.FloatOperation` signal optionally enables stricter " +"semantics for mixing floats and Decimals." +msgstr "" + +msgid "" +"If Python is compiled without threads, the C version automatically disables " +"the expensive thread local context machinery. In this case, the variable :" +"const:`~decimal.HAVE_THREADS` is set to ``False``." +msgstr "" + +msgid "" +"The C module has the following context limits, depending on the machine " +"architecture:" +msgstr "" + +msgid "32-bit" +msgstr "" + +msgid "64-bit" +msgstr "" + +msgid ":const:`MAX_PREC`" +msgstr ":const:`MAX_PREC`" + +msgid "``425000000``" +msgstr "``425000000``" + +msgid "``999999999999999999``" +msgstr "``999999999999999999``" + +msgid ":const:`MAX_EMAX`" +msgstr ":const:`MAX_EMAX`" + +msgid ":const:`MIN_EMIN`" +msgstr ":const:`MIN_EMIN`" + +msgid "``-425000000``" +msgstr "``-425000000``" + +msgid "``-999999999999999999``" +msgstr "``-999999999999999999``" + +msgid "" +"In the context templates (:class:`~decimal.DefaultContext`, :class:`~decimal." +"BasicContext` and :class:`~decimal.ExtendedContext`) the magnitude of :attr:" +"`~decimal.Context.Emax` and :attr:`~decimal.Context.Emin` has changed to " +"``999999``." +msgstr "" + +msgid "" +"The :class:`~decimal.Decimal` constructor in decimal.py does not observe the " +"context limits and converts values with arbitrary exponents or precision " +"exactly. Since the C version has internal limits, the following scheme is " +"used: If possible, values are converted exactly, otherwise :exc:`~decimal." +"InvalidOperation` is raised and the result is NaN. In the latter case it is " +"always possible to use :meth:`~decimal.Context.create_decimal` in order to " +"obtain a rounded or inexact value." +msgstr "" + +msgid "" +"The power function in decimal.py is always correctly rounded. In the C " +"version, it is defined in terms of the correctly rounded :meth:`~decimal." +"Decimal.exp` and :meth:`~decimal.Decimal.ln` functions, but the final result " +"is only \"almost always correctly rounded\"." +msgstr "" + +msgid "" +"In the C version, the context dictionary containing the signals is a :class:" +"`~collections.abc.MutableMapping`. For speed reasons, :attr:`~decimal." +"Context.flags` and :attr:`~decimal.Context.traps` always refer to the same :" +"class:`~collections.abc.MutableMapping` that the context was initialized " +"with. If a new signal dictionary is assigned, :attr:`~decimal.Context.flags` " +"and :attr:`~decimal.Context.traps` are updated with the new values, but they " +"do not reference the RHS dictionary." +msgstr "" + +msgid "" +"Pickling a :class:`~decimal.Context` produces a different output in order to " +"have a common interchange format for the Python and C versions." +msgstr "" + +msgid "" +"The order of arguments in the :class:`~decimal.Context` constructor has been " +"changed to match the order displayed by :func:`repr`." +msgstr "" + +msgid "" +"The ``watchexp`` parameter in the :meth:`~decimal.Decimal.quantize` method " +"is deprecated." +msgstr "" + +msgid "email" +msgstr "" + +msgid "Policy Framework" +msgstr "" + +msgid "" +"The email package now has a :mod:`~email.policy` framework. A :class:" +"`~email.policy.Policy` is an object with several methods and properties that " +"control how the email package behaves. The primary policy for Python 3.3 is " +"the :class:`~email.policy.Compat32` policy, which provides backward " +"compatibility with the email package in Python 3.2. A ``policy`` can be " +"specified when an email message is parsed by a :mod:`~email.parser`, or when " +"a :class:`~email.message.Message` object is created, or when an email is " +"serialized using a :mod:`~email.generator`. Unless overridden, a policy " +"passed to a ``parser`` is inherited by all the ``Message`` object and sub-" +"objects created by the ``parser``. By default a ``generator`` will use the " +"policy of the ``Message`` object it is serializing. The default policy is :" +"data:`~email.policy.compat32`." +msgstr "" + +msgid "The minimum set of controls implemented by all ``policy`` objects are:" +msgstr "" + +msgid "max_line_length" +msgstr "" + +msgid "" +"The maximum length, excluding the linesep character(s), individual lines may " +"have when a ``Message`` is serialized. Defaults to 78." +msgstr "" + +msgid "linesep" +msgstr "" + +msgid "" +"The character used to separate individual lines when a ``Message`` is " +"serialized. Defaults to ``\\n``." +msgstr "" + +msgid "cte_type" +msgstr "" + +msgid "" +"``7bit`` or ``8bit``. ``8bit`` applies only to a ``Bytes`` ``generator``, " +"and means that non-ASCII may be used where allowed by the protocol (or where " +"it exists in the original input)." +msgstr "" + +msgid "raise_on_defect" +msgstr "" + +msgid "" +"Causes a ``parser`` to raise error when defects are encountered instead of " +"adding them to the ``Message`` object's ``defects`` list." +msgstr "" + +msgid "" +"A new policy instance, with new settings, is created using the :meth:`~email." +"policy.Policy.clone` method of policy objects. ``clone`` takes any of the " +"above controls as keyword arguments. Any control not specified in the call " +"retains its default value. Thus you can create a policy that uses " +"``\\r\\n`` linesep characters like this::" +msgstr "" + +msgid "" +"Policies can be used to make the generation of messages in the format needed " +"by your application simpler. Instead of having to remember to specify " +"``linesep='\\r\\n'`` in all the places you call a ``generator``, you can " +"specify it once, when you set the policy used by the ``parser`` or the " +"``Message``, whichever your program uses to create ``Message`` objects. On " +"the other hand, if you need to generate messages in multiple forms, you can " +"still specify the parameters in the appropriate ``generator`` call. Or you " +"can have custom policy instances for your different cases, and pass those in " +"when you create the ``generator``." +msgstr "" + +msgid "Provisional Policy with New Header API" +msgstr "" + +msgid "" +"While the policy framework is worthwhile all by itself, the main motivation " +"for introducing it is to allow the creation of new policies that implement " +"new features for the email package in a way that maintains backward " +"compatibility for those who do not use the new policies. Because the new " +"policies introduce a new API, we are releasing them in Python 3.3 as a :term:" +"`provisional policy `. Backwards incompatible changes " +"(up to and including removal of the code) may occur if deemed necessary by " +"the core developers." +msgstr "" + +msgid "" +"The new policies are instances of :class:`~email.policy.EmailPolicy`, and " +"add the following additional controls:" +msgstr "" + +msgid "refold_source" +msgstr "" + +msgid "" +"Controls whether or not headers parsed by a :mod:`~email.parser` are " +"refolded by the :mod:`~email.generator`. It can be ``none``, ``long``, or " +"``all``. The default is ``long``, which means that source headers with a " +"line longer than ``max_line_length`` get refolded. ``none`` means no line " +"get refolded, and ``all`` means that all lines get refolded." +msgstr "" + +msgid "header_factory" +msgstr "" + +msgid "" +"A callable that take a ``name`` and ``value`` and produces a custom header " +"object." +msgstr "" + +msgid "" +"The ``header_factory`` is the key to the new features provided by the new " +"policies. When one of the new policies is used, any header retrieved from a " +"``Message`` object is an object produced by the ``header_factory``, and any " +"time you set a header on a ``Message`` it becomes an object produced by " +"``header_factory``. All such header objects have a ``name`` attribute equal " +"to the header name. Address and Date headers have additional attributes " +"that give you access to the parsed data of the header. This means you can " +"now do things like this::" +msgstr "" + +msgid "" +"You will note that the unicode display name is automatically encoded as " +"``utf-8`` when the message is serialized, but that when the header is " +"accessed directly, you get the unicode version. This eliminates any need to " +"deal with the :mod:`email.header` :meth:`~email.header.decode_header` or :" +"meth:`~email.header.make_header` functions." +msgstr "" + +msgid "You can also create addresses from parts::" +msgstr "" + +msgid "Decoding to unicode is done automatically::" +msgstr "" + +msgid "" +"When you parse a message, you can use the ``addresses`` and ``groups`` " +"attributes of the header objects to access the groups and individual " +"addresses::" +msgstr "" + +msgid "" +"In summary, if you use one of the new policies, header manipulation works " +"the way it ought to: your application works with unicode strings, and the " +"email package transparently encodes and decodes the unicode to and from the " +"RFC standard Content Transfer Encodings." +msgstr "" + +msgid "Other API Changes" +msgstr "" + +msgid "" +"New :class:`~email.parser.BytesHeaderParser`, added to the :mod:`~email." +"parser` module to complement :class:`~email.parser.HeaderParser` and " +"complete the Bytes API." +msgstr "" + +msgid "New utility functions:" +msgstr "" + +msgid "" +":func:`~email.utils.format_datetime`: given a :class:`~datetime.datetime`, " +"produce a string formatted for use in an email header." +msgstr "" + +msgid "" +":func:`~email.utils.parsedate_to_datetime`: given a date string from an " +"email header, convert it into an aware :class:`~datetime.datetime`, or a " +"naive :class:`~datetime.datetime` if the offset is ``-0000``." +msgstr "" + +msgid "" +":func:`~email.utils.localtime`: With no argument, returns the current local " +"time as an aware :class:`~datetime.datetime` using the local :class:" +"`~datetime.timezone`. Given an aware :class:`~datetime.datetime`, converts " +"it into an aware :class:`~datetime.datetime` using the local :class:" +"`~datetime.timezone`." +msgstr "" + +msgid "ftplib" +msgstr "" + +msgid "" +":class:`ftplib.FTP` now accepts a ``source_address`` keyword argument to " +"specify the ``(host, port)`` to use as the source address in the bind call " +"when creating the outgoing socket. (Contributed by Giampaolo Rodolà in :" +"issue:`8594`.)" +msgstr "" + +msgid "" +"The :class:`~ftplib.FTP_TLS` class now provides a new :func:`~ftplib.FTP_TLS." +"ccc` function to revert control channel back to plaintext. This can be " +"useful to take advantage of firewalls that know how to handle NAT with non-" +"secure FTP without opening fixed ports. (Contributed by Giampaolo Rodolà " +"in :issue:`12139`.)" +msgstr "" + +msgid "" +"Added :meth:`ftplib.FTP.mlsd` method which provides a parsable directory " +"listing format and deprecates :meth:`ftplib.FTP.nlst` and :meth:`ftplib.FTP." +"dir`. (Contributed by Giampaolo Rodolà in :issue:`11072`.)" +msgstr "" + +msgid "functools" +msgstr "" + +msgid "" +"The :func:`functools.lru_cache` decorator now accepts a ``typed`` keyword " +"argument (that defaults to ``False`` to ensure that it caches values of " +"different types that compare equal in separate cache slots. (Contributed by " +"Raymond Hettinger in :issue:`13227`.)" +msgstr "" + +msgid "gc" +msgstr "" + +msgid "" +"It is now possible to register callbacks invoked by the garbage collector " +"before and after collection using the new :data:`~gc.callbacks` list." +msgstr "" + +msgid "hmac" +msgstr "" + +msgid "" +"A new :func:`~hmac.compare_digest` function has been added to prevent side " +"channel attacks on digests through timing analysis. (Contributed by Nick " +"Coghlan and Christian Heimes in :issue:`15061`.)" +msgstr "" + +msgid "http" +msgstr "" + +msgid "" +":class:`http.server.BaseHTTPRequestHandler` now buffers the headers and " +"writes them all at once when :meth:`~http.server.BaseHTTPRequestHandler." +"end_headers` is called. A new method :meth:`~http.server." +"BaseHTTPRequestHandler.flush_headers` can be used to directly manage when " +"the accumulated headers are sent. (Contributed by Andrew Schaaf in :issue:" +"`3709`.)" +msgstr "" + +msgid "" +":class:`http.server` now produces valid ``HTML 4.01 strict`` output. " +"(Contributed by Ezio Melotti in :issue:`13295`.)" +msgstr "" + +msgid "" +":class:`http.client.HTTPResponse` now has a :meth:`~http.client.HTTPResponse." +"readinto` method, which means it can be used as an :class:`io.RawIOBase` " +"class. (Contributed by John Kuhn in :issue:`13464`.)" +msgstr "" + +msgid "html" +msgstr "" + +msgid "" +":class:`html.parser.HTMLParser` is now able to parse broken markup without " +"raising errors, therefore the *strict* argument of the constructor and the :" +"exc:`~html.parser.HTMLParseError` exception are now deprecated. The ability " +"to parse broken markup is the result of a number of bug fixes that are also " +"available on the latest bug fix releases of Python 2.7/3.2. (Contributed by " +"Ezio Melotti in :issue:`15114`, and :issue:`14538`, :issue:`13993`, :issue:" +"`13960`, :issue:`13358`, :issue:`1745761`, :issue:`755670`, :issue:`13357`, :" +"issue:`12629`, :issue:`1200313`, :issue:`670664`, :issue:`13273`, :issue:" +"`12888`, :issue:`7311`.)" +msgstr "" + +msgid "" +"A new :data:`~html.entities.html5` dictionary that maps HTML5 named " +"character references to the equivalent Unicode character(s) (e.g. " +"``html5['gt;'] == '>'``) has been added to the :mod:`html.entities` module. " +"The dictionary is now also used by :class:`~html.parser.HTMLParser`. " +"(Contributed by Ezio Melotti in :issue:`11113` and :issue:`15156`.)" +msgstr "" + +msgid "imaplib" +msgstr "" + +msgid "" +"The :class:`~imaplib.IMAP4_SSL` constructor now accepts an SSLContext " +"parameter to control parameters of the secure channel." +msgstr "" + +msgid "(Contributed by Sijin Joseph in :issue:`8808`.)" +msgstr "" + +msgid "inspect" +msgstr "" + +msgid "" +"A new :func:`~inspect.getclosurevars` function has been added. This function " +"reports the current binding of all names referenced from the function body " +"and where those names were resolved, making it easier to verify correct " +"internal state when testing code that relies on stateful closures." +msgstr "" + +msgid "(Contributed by Meador Inge and Nick Coghlan in :issue:`13062`.)" +msgstr "" + +msgid "" +"A new :func:`~inspect.getgeneratorlocals` function has been added. This " +"function reports the current binding of local variables in the generator's " +"stack frame, making it easier to verify correct internal state when testing " +"generators." +msgstr "" + +msgid "(Contributed by Meador Inge in :issue:`15153`.)" +msgstr "" + +msgid "io" +msgstr "" + +msgid "" +"The :func:`~io.open` function has a new ``'x'`` mode that can be used to " +"exclusively create a new file, and raise a :exc:`FileExistsError` if the " +"file already exists. It is based on the C11 'x' mode to fopen()." +msgstr "" + +msgid "(Contributed by David Townshend in :issue:`12760`.)" +msgstr "" + +msgid "" +"The constructor of the :class:`~io.TextIOWrapper` class has a new " +"*write_through* optional argument. If *write_through* is ``True``, calls to :" +"meth:`~io.TextIOWrapper.write` are guaranteed not to be buffered: any data " +"written on the :class:`~io.TextIOWrapper` object is immediately handled to " +"its underlying binary buffer." +msgstr "" + +msgid "itertools" +msgstr "" + +msgid "" +":func:`~itertools.accumulate` now takes an optional ``func`` argument for " +"providing a user-supplied binary function." +msgstr "" + +msgid "logging" +msgstr "" + +msgid "" +"The :func:`~logging.basicConfig` function now supports an optional " +"``handlers`` argument taking an iterable of handlers to be added to the root " +"logger." +msgstr "" + +msgid "" +"A class level attribute :attr:`~logging.handlers.SysLogHandler.append_nul` " +"has been added to :class:`~logging.handlers.SysLogHandler` to allow control " +"of the appending of the ``NUL`` (``\\000``) byte to syslog records, since " +"for some daemons it is required while for others it is passed through to the " +"log." +msgstr "" + +msgid "math" +msgstr "" + +msgid "" +"The :mod:`math` module has a new function, :func:`~math.log2`, which " +"returns the base-2 logarithm of *x*." +msgstr "" + +msgid "(Written by Mark Dickinson in :issue:`11888`.)" +msgstr "" + +msgid "mmap" +msgstr "" + +msgid "" +"The :meth:`~mmap.mmap.read` method is now more compatible with other file-" +"like objects: if the argument is omitted or specified as ``None``, it " +"returns the bytes from the current file position to the end of the mapping. " +"(Contributed by Petri Lehtinen in :issue:`12021`.)" +msgstr "" + +msgid "multiprocessing" +msgstr "" + +msgid "" +"The new :func:`multiprocessing.connection.wait` function allows polling " +"multiple objects (such as connections, sockets and pipes) with a timeout. " +"(Contributed by Richard Oudkerk in :issue:`12328`.)" +msgstr "" + +msgid "" +":class:`multiprocessing.Connection` objects can now be transferred over " +"multiprocessing connections. (Contributed by Richard Oudkerk in :issue:" +"`4892`.)" +msgstr "" + +msgid "" +":class:`multiprocessing.Process` now accepts a ``daemon`` keyword argument " +"to override the default behavior of inheriting the ``daemon`` flag from the " +"parent process (:issue:`6064`)." +msgstr "" + +msgid "" +"New attribute :data:`multiprocessing.Process.sentinel` allows a program to " +"wait on multiple :class:`~multiprocessing.Process` objects at one time using " +"the appropriate OS primitives (for example, :mod:`select` on posix systems)." +msgstr "" + +msgid "" +"New methods :meth:`multiprocessing.pool.Pool.starmap` and :meth:" +"`~multiprocessing.pool.Pool.starmap_async` provide :func:`itertools.starmap` " +"equivalents to the existing :meth:`multiprocessing.pool.Pool.map` and :meth:" +"`~multiprocessing.pool.Pool.map_async` functions. (Contributed by Hynek " +"Schlawack in :issue:`12708`.)" +msgstr "" + +msgid "nntplib" +msgstr "" + +msgid "" +"The :class:`nntplib.NNTP` class now supports the context management protocol " +"to unconditionally consume :exc:`socket.error` exceptions and to close the " +"NNTP connection when done::" +msgstr "" + +msgid "(Contributed by Giampaolo Rodolà in :issue:`9795`.)" +msgstr "" + +msgid "os" +msgstr "" + +msgid "" +"The :mod:`os` module has a new :func:`~os.pipe2` function that makes it " +"possible to create a pipe with :const:`~os.O_CLOEXEC` or :const:`~os." +"O_NONBLOCK` flags set atomically. This is especially useful to avoid race " +"conditions in multi-threaded programs." +msgstr "" + +msgid "" +"The :mod:`os` module has a new :func:`~os.sendfile` function which provides " +"an efficient \"zero-copy\" way for copying data from one file (or socket) " +"descriptor to another. The phrase \"zero-copy\" refers to the fact that all " +"of the copying of data between the two descriptors is done entirely by the " +"kernel, with no copying of data into userspace buffers. :func:`~os.sendfile` " +"can be used to efficiently copy data from a file on disk to a network " +"socket, e.g. for downloading a file." +msgstr "" + +msgid "" +"(Patch submitted by Ross Lagerwall and Giampaolo Rodolà in :issue:`10882`.)" +msgstr "" + +msgid "" +"To avoid race conditions like symlink attacks and issues with temporary " +"files and directories, it is more reliable (and also faster) to manipulate " +"file descriptors instead of file names. Python 3.3 enhances existing " +"functions and introduces new functions to work on file descriptors (:issue:" +"`4761`, :issue:`10755` and :issue:`14626`)." +msgstr "" + +msgid "" +"The :mod:`os` module has a new :func:`~os.fwalk` function similar to :func:" +"`~os.walk` except that it also yields file descriptors referring to the " +"directories visited. This is especially useful to avoid symlink races." +msgstr "" + +msgid "" +"The following functions get new optional *dir_fd* (:ref:`paths relative to " +"directory descriptors `) and/or *follow_symlinks* (:ref:`not " +"following symlinks `): :func:`~os.access`, :func:`~os." +"chflags`, :func:`~os.chmod`, :func:`~os.chown`, :func:`~os.link`, :func:`~os." +"lstat`, :func:`~os.mkdir`, :func:`~os.mkfifo`, :func:`~os.mknod`, :func:`~os." +"open`, :func:`~os.readlink`, :func:`~os.remove`, :func:`~os.rename`, :func:" +"`~os.replace`, :func:`~os.rmdir`, :func:`~os.stat`, :func:`~os.symlink`, :" +"func:`~os.unlink`, :func:`~os.utime`. Platform support for using these " +"parameters can be checked via the sets :data:`os.supports_dir_fd` and :data:" +"`os.supports_follows_symlinks`." +msgstr "" + +msgid "" +"The following functions now support a file descriptor for their path " +"argument: :func:`~os.chdir`, :func:`~os.chmod`, :func:`~os.chown`, :func:" +"`~os.execve`, :func:`~os.listdir`, :func:`~os.pathconf`, :func:`~os.path." +"exists`, :func:`~os.stat`, :func:`~os.statvfs`, :func:`~os.utime`. Platform " +"support for this can be checked via the :data:`os.supports_fd` set." +msgstr "" + +msgid "" +":func:`~os.access` accepts an ``effective_ids`` keyword argument to turn on " +"using the effective uid/gid rather than the real uid/gid in the access " +"check. Platform support for this can be checked via the :data:`~os." +"supports_effective_ids` set." +msgstr "" + +msgid "" +"The :mod:`os` module has two new functions: :func:`~os.getpriority` and :" +"func:`~os.setpriority`. They can be used to get or set process niceness/" +"priority in a fashion similar to :func:`os.nice` but extended to all " +"processes instead of just the current one." +msgstr "" + +msgid "(Patch submitted by Giampaolo Rodolà in :issue:`10784`.)" +msgstr "" + +msgid "" +"The new :func:`os.replace` function allows cross-platform renaming of a file " +"with overwriting the destination. With :func:`os.rename`, an existing " +"destination file is overwritten under POSIX, but raises an error under " +"Windows. (Contributed by Antoine Pitrou in :issue:`8828`.)" +msgstr "" + +msgid "" +"The stat family of functions (:func:`~os.stat`, :func:`~os.fstat`, and :func:" +"`~os.lstat`) now support reading a file's timestamps with nanosecond " +"precision. Symmetrically, :func:`~os.utime` can now write file timestamps " +"with nanosecond precision. (Contributed by Larry Hastings in :issue:" +"`14127`.)" +msgstr "" + +msgid "" +"The new :func:`os.get_terminal_size` function queries the size of the " +"terminal attached to a file descriptor. See also :func:`shutil." +"get_terminal_size`. (Contributed by Zbigniew Jędrzejewski-Szmek in :issue:" +"`13609`.)" +msgstr "" + +msgid "" +"New functions to support Linux extended attributes (:issue:`12720`): :func:" +"`~os.getxattr`, :func:`~os.listxattr`, :func:`~os.removexattr`, :func:`~os." +"setxattr`." +msgstr "" + +msgid "" +"New interface to the scheduler. These functions control how a process is " +"allocated CPU time by the operating system. New functions: :func:`~os." +"sched_get_priority_max`, :func:`~os.sched_get_priority_min`, :func:`~os." +"sched_getaffinity`, :func:`~os.sched_getparam`, :func:`~os." +"sched_getscheduler`, :func:`~os.sched_rr_get_interval`, :func:`~os." +"sched_setaffinity`, :func:`~os.sched_setparam`, :func:`~os." +"sched_setscheduler`, :func:`~os.sched_yield`," +msgstr "" + +msgid "New functions to control the file system:" +msgstr "" + +msgid "" +":func:`~os.posix_fadvise`: Announces an intention to access data in a " +"specific pattern thus allowing the kernel to make optimizations." +msgstr "" + +msgid "" +":func:`~os.posix_fallocate`: Ensures that enough disk space is allocated for " +"a file." +msgstr "" + +msgid ":func:`~os.sync`: Force write of everything to disk." +msgstr "" + +msgid "Additional new posix functions:" +msgstr "" + +msgid "" +":func:`~os.lockf`: Apply, test or remove a POSIX lock on an open file " +"descriptor." +msgstr "" + +msgid "" +":func:`~os.pread`: Read from a file descriptor at an offset, the file offset " +"remains unchanged." +msgstr "" + +msgid "" +":func:`~os.pwrite`: Write to a file descriptor from an offset, leaving the " +"file offset unchanged." +msgstr "" + +msgid "" +":func:`~os.readv`: Read from a file descriptor into a number of writable " +"buffers." +msgstr "" + +msgid "" +":func:`~os.truncate`: Truncate the file corresponding to *path*, so that it " +"is at most *length* bytes in size." +msgstr "" + +msgid "" +":func:`~os.waitid`: Wait for the completion of one or more child processes." +msgstr "" + +msgid "" +":func:`~os.writev`: Write the contents of *buffers* to a file descriptor, " +"where *buffers* is an arbitrary sequence of buffers." +msgstr "" + +msgid "" +":func:`~os.getgrouplist` (:issue:`9344`): Return list of group ids that " +"specified user belongs to." +msgstr "" + +msgid "" +":func:`~os.times` and :func:`~os.uname`: Return type changed from a tuple to " +"a tuple-like object with named attributes." +msgstr "" + +msgid "" +"Some platforms now support additional constants for the :func:`~os.lseek` " +"function, such as ``os.SEEK_HOLE`` and ``os.SEEK_DATA``." +msgstr "" + +msgid "" +"New constants :const:`~os.RTLD_LAZY`, :const:`~os.RTLD_NOW`, :const:`~os." +"RTLD_GLOBAL`, :const:`~os.RTLD_LOCAL`, :const:`~os.RTLD_NODELETE`, :const:" +"`~os.RTLD_NOLOAD`, and :const:`~os.RTLD_DEEPBIND` are available on platforms " +"that support them. These are for use with the :func:`sys.setdlopenflags` " +"function, and supersede the similar constants defined in :mod:`ctypes` and :" +"mod:`DLFCN`. (Contributed by Victor Stinner in :issue:`13226`.)" +msgstr "" + +msgid "" +":func:`os.symlink` now accepts (and ignores) the ``target_is_directory`` " +"keyword argument on non-Windows platforms, to ease cross-platform support." +msgstr "" + +msgid "pdb" +msgstr "" + +msgid "" +"Tab-completion is now available not only for command names, but also their " +"arguments. For example, for the ``break`` command, function and file names " +"are completed." +msgstr "" + +msgid "(Contributed by Georg Brandl in :issue:`14210`)" +msgstr "" + +msgid "pickle" +msgstr "" + +msgid "" +":class:`pickle.Pickler` objects now have an optional :attr:`~pickle.Pickler." +"dispatch_table` attribute allowing per-pickler reduction functions to be set." +msgstr "" + +msgid "(Contributed by Richard Oudkerk in :issue:`14166`.)" +msgstr "" + +msgid "pydoc" +msgstr "" + +msgid "" +"The Tk GUI and the :func:`~pydoc.serve` function have been removed from the :" +"mod:`pydoc` module: ``pydoc -g`` and :func:`~pydoc.serve` have been " +"deprecated in Python 3.2." +msgstr "" + +msgid "re" +msgstr "" + +msgid "" +":class:`str` regular expressions now support ``\\u`` and ``\\U`` escapes." +msgstr "" + +msgid "(Contributed by Serhiy Storchaka in :issue:`3665`.)" +msgstr "" + +msgid "sched" +msgstr "" + +msgid "" +":meth:`~sched.scheduler.run` now accepts a *blocking* parameter which when " +"set to false makes the method execute the scheduled events due to expire " +"soonest (if any) and then return immediately. This is useful in case you " +"want to use the :class:`~sched.scheduler` in non-blocking applications. " +"(Contributed by Giampaolo Rodolà in :issue:`13449`.)" +msgstr "" + +msgid "" +":class:`~sched.scheduler` class can now be safely used in multi-threaded " +"environments. (Contributed by Josiah Carlson and Giampaolo Rodolà in :issue:" +"`8684`.)" +msgstr "" + +msgid "" +"*timefunc* and *delayfunct* parameters of :class:`~sched.scheduler` class " +"constructor are now optional and defaults to :func:`time.time` and :func:" +"`time.sleep` respectively. (Contributed by Chris Clark in :issue:`13245`.)" +msgstr "" + +msgid "" +":meth:`~sched.scheduler.enter` and :meth:`~sched.scheduler.enterabs` " +"*argument* parameter is now optional. (Contributed by Chris Clark in :issue:" +"`13245`.)" +msgstr "" + +msgid "" +":meth:`~sched.scheduler.enter` and :meth:`~sched.scheduler.enterabs` now " +"accept a *kwargs* parameter. (Contributed by Chris Clark in :issue:`13245`.)" +msgstr "" + +msgid "select" +msgstr "" + +msgid "" +"Solaris and derivative platforms have a new class :class:`select.devpoll` " +"for high performance asynchronous sockets via :file:`/dev/poll`. " +"(Contributed by Jesús Cea Avión in :issue:`6397`.)" +msgstr "" + +msgid "shlex" +msgstr "" + +msgid "" +"The previously undocumented helper function ``quote`` from the :mod:`pipes` " +"modules has been moved to the :mod:`shlex` module and documented. :func:" +"`~shlex.quote` properly escapes all characters in a string that might be " +"otherwise given special meaning by the shell." +msgstr "" + +msgid "shutil" +msgstr "" + +msgid "New functions:" +msgstr "" + +msgid "" +":func:`~shutil.disk_usage`: provides total, used and free disk space " +"statistics. (Contributed by Giampaolo Rodolà in :issue:`12442`.)" +msgstr "" + +msgid "" +":func:`~shutil.chown`: allows one to change user and/or group of the given " +"path also specifying the user/group names and not only their numeric ids. " +"(Contributed by Sandro Tosi in :issue:`12191`.)" +msgstr "" + +msgid "" +":func:`shutil.get_terminal_size`: returns the size of the terminal window to " +"which the interpreter is attached. (Contributed by Zbigniew Jędrzejewski-" +"Szmek in :issue:`13609`.)" +msgstr "" + +msgid "" +":func:`~shutil.copy2` and :func:`~shutil.copystat` now preserve file " +"timestamps with nanosecond precision on platforms that support it. They also " +"preserve file \"extended attributes\" on Linux. (Contributed by Larry " +"Hastings in :issue:`14127` and :issue:`15238`.)" +msgstr "" + +msgid "" +"Several functions now take an optional ``symlinks`` argument: when that " +"parameter is true, symlinks aren't dereferenced and the operation instead " +"acts on the symlink itself (or creates one, if relevant). (Contributed by " +"Hynek Schlawack in :issue:`12715`.)" +msgstr "" + +msgid "" +"When copying files to a different file system, :func:`~shutil.move` now " +"handles symlinks the way the posix ``mv`` command does, recreating the " +"symlink rather than copying the target file contents. (Contributed by " +"Jonathan Niehof in :issue:`9993`.) :func:`~shutil.move` now also returns " +"the ``dst`` argument as its result." +msgstr "" + +msgid "" +":func:`~shutil.rmtree` is now resistant to symlink attacks on platforms " +"which support the new ``dir_fd`` parameter in :func:`os.open` and :func:`os." +"unlink`. (Contributed by Martin von Löwis and Hynek Schlawack in :issue:" +"`4489`.)" +msgstr "" + +msgid "signal" +msgstr "" + +msgid "The :mod:`signal` module has new functions:" +msgstr "" + +msgid "" +":func:`~signal.pthread_sigmask`: fetch and/or change the signal mask of the " +"calling thread (Contributed by Jean-Paul Calderone in :issue:`8407`);" +msgstr "" + +msgid ":func:`~signal.pthread_kill`: send a signal to a thread;" +msgstr "" + +msgid ":func:`~signal.sigpending`: examine pending functions;" +msgstr "" + +msgid ":func:`~signal.sigwait`: wait a signal;" +msgstr "" + +msgid "" +":func:`~signal.sigwaitinfo`: wait for a signal, returning detailed " +"information about it;" +msgstr "" + +msgid "" +":func:`~signal.sigtimedwait`: like :func:`~signal.sigwaitinfo` but with a " +"timeout." +msgstr "" + +msgid "" +"The signal handler writes the signal number as a single byte instead of a " +"nul byte into the wakeup file descriptor. So it is possible to wait more " +"than one signal and know which signals were raised." +msgstr "" + +msgid "" +":func:`signal.signal` and :func:`signal.siginterrupt` raise an OSError, " +"instead of a RuntimeError: OSError has an errno attribute." +msgstr "" + +msgid "smtpd" +msgstr "" + +msgid "" +"The :mod:`smtpd` module now supports :rfc:`5321` (extended SMTP) and :rfc:" +"`1870` (size extension). Per the standard, these extensions are enabled if " +"and only if the client initiates the session with an ``EHLO`` command." +msgstr "" + +msgid "" +"(Initial ``ELHO`` support by Alberto Trevino. Size extension by Juhana " +"Jauhiainen. Substantial additional work on the patch contributed by Michele " +"Orrù and Dan Boswell. :issue:`8739`)" +msgstr "" + +msgid "smtplib" +msgstr "" + +msgid "" +"The :class:`~smtplib.SMTP`, :class:`~smtplib.SMTP_SSL`, and :class:`~smtplib." +"LMTP` classes now accept a ``source_address`` keyword argument to specify " +"the ``(host, port)`` to use as the source address in the bind call when " +"creating the outgoing socket. (Contributed by Paulo Scardine in :issue:" +"`11281`.)" +msgstr "" + +msgid "" +":class:`~smtplib.SMTP` now supports the context management protocol, " +"allowing an ``SMTP`` instance to be used in a ``with`` statement. " +"(Contributed by Giampaolo Rodolà in :issue:`11289`.)" +msgstr "" + +msgid "" +"The :class:`~smtplib.SMTP_SSL` constructor and the :meth:`~smtplib.SMTP." +"starttls` method now accept an SSLContext parameter to control parameters of " +"the secure channel. (Contributed by Kasun Herath in :issue:`8809`.)" +msgstr "" + +msgid "socket" +msgstr "" + +msgid "" +"The :class:`~socket.socket` class now exposes additional methods to process " +"ancillary data when supported by the underlying platform:" +msgstr "" + +msgid ":func:`~socket.socket.sendmsg`" +msgstr ":func:`~socket.socket.sendmsg`" + +msgid ":func:`~socket.socket.recvmsg`" +msgstr ":func:`~socket.socket.recvmsg`" + +msgid ":func:`~socket.socket.recvmsg_into`" +msgstr ":func:`~socket.socket.recvmsg_into`" + +msgid "" +"(Contributed by David Watson in :issue:`6560`, based on an earlier patch by " +"Heiko Wundram)" +msgstr "" + +msgid "" +"The :class:`~socket.socket` class now supports the PF_CAN protocol family " +"(https://en.wikipedia.org/wiki/Socketcan), on Linux (https://lwn.net/" +"Articles/253425)." +msgstr "" + +msgid "" +"(Contributed by Matthias Fuchs, updated by Tiago Gonçalves in :issue:" +"`10141`.)" +msgstr "" + +msgid "" +"The :class:`~socket.socket` class now supports the PF_RDS protocol family " +"(https://en.wikipedia.org/wiki/Reliable_Datagram_Sockets and `https://oss." +"oracle.com/projects/rds `__)." +msgstr "" + +msgid "" +"The :class:`~socket.socket` class now supports the ``PF_SYSTEM`` protocol " +"family on OS X. (Contributed by Michael Goderbauer in :issue:`13777`.)" +msgstr "" + +msgid "" +"New function :func:`~socket.sethostname` allows the hostname to be set on " +"Unix systems if the calling process has sufficient privileges. (Contributed " +"by Ross Lagerwall in :issue:`10866`.)" +msgstr "" + +msgid "socketserver" +msgstr "" + +msgid "" +":class:`~socketserver.BaseServer` now has an overridable method :meth:" +"`~socketserver.BaseServer.service_actions` that is called by the :meth:" +"`~socketserver.BaseServer.serve_forever` method in the service loop. :class:" +"`~socketserver.ForkingMixIn` now uses this to clean up zombie child " +"processes. (Contributed by Justin Warkentin in :issue:`11109`.)" +msgstr "" + +msgid "sqlite3" +msgstr "" + +msgid "" +"New :class:`sqlite3.Connection` method :meth:`~sqlite3.Connection." +"set_trace_callback` can be used to capture a trace of all sql commands " +"processed by sqlite. (Contributed by Torsten Landschoff in :issue:`11688`.)" +msgstr "" + +msgid "ssl" +msgstr "" + +msgid "The :mod:`ssl` module has two new random generation functions:" +msgstr "" + +msgid "" +":func:`~ssl.RAND_bytes`: generate cryptographically strong pseudo-random " +"bytes." +msgstr "" + +msgid ":func:`~ssl.RAND_pseudo_bytes`: generate pseudo-random bytes." +msgstr "" + +msgid "(Contributed by Victor Stinner in :issue:`12049`.)" +msgstr "" + +msgid "" +"The :mod:`ssl` module now exposes a finer-grained exception hierarchy in " +"order to make it easier to inspect the various kinds of errors. (Contributed " +"by Antoine Pitrou in :issue:`11183`.)" +msgstr "" + +msgid "" +":meth:`~ssl.SSLContext.load_cert_chain` now accepts a *password* argument to " +"be used if the private key is encrypted. (Contributed by Adam Simpkins in :" +"issue:`12803`.)" +msgstr "" + +msgid "" +"Diffie-Hellman key exchange, both regular and Elliptic Curve-based, is now " +"supported through the :meth:`~ssl.SSLContext.load_dh_params` and :meth:`~ssl." +"SSLContext.set_ecdh_curve` methods. (Contributed by Antoine Pitrou in :issue:" +"`13626` and :issue:`13627`.)" +msgstr "" + +msgid "" +"SSL sockets have a new :meth:`~ssl.SSLSocket.get_channel_binding` method " +"allowing the implementation of certain authentication mechanisms such as " +"SCRAM-SHA-1-PLUS. (Contributed by Jacek Konieczny in :issue:`12551`.)" +msgstr "" + +msgid "" +"You can query the SSL compression algorithm used by an SSL socket, thanks to " +"its new :meth:`~ssl.SSLSocket.compression` method. The new attribute :const:" +"`~ssl.OP_NO_COMPRESSION` can be used to disable compression. (Contributed by " +"Antoine Pitrou in :issue:`13634`.)" +msgstr "" + +msgid "" +"Support has been added for the Next Protocol Negotiation extension using " +"the :meth:`ssl.SSLContext.set_npn_protocols` method. (Contributed by Colin " +"Marc in :issue:`14204`.)" +msgstr "" + +msgid "" +"SSL errors can now be introspected more easily thanks to :attr:`~ssl." +"SSLError.library` and :attr:`~ssl.SSLError.reason` attributes. (Contributed " +"by Antoine Pitrou in :issue:`14837`.)" +msgstr "" + +msgid "" +"The :func:`~ssl.get_server_certificate` function now supports IPv6. " +"(Contributed by Charles-François Natali in :issue:`11811`.)" +msgstr "" + +msgid "" +"New attribute :const:`~ssl.OP_CIPHER_SERVER_PREFERENCE` allows setting SSLv3 " +"server sockets to use the server's cipher ordering preference rather than " +"the client's (:issue:`13635`)." +msgstr "" + +msgid "stat" +msgstr "" + +msgid "" +"The undocumented tarfile.filemode function has been moved to :func:`stat." +"filemode`. It can be used to convert a file's mode to a string of the form '-" +"rwxrwxrwx'." +msgstr "" + +msgid "(Contributed by Giampaolo Rodolà in :issue:`14807`.)" +msgstr "" + +msgid "struct" +msgstr "" + +msgid "" +"The :mod:`struct` module now supports :c:type:`ssize_t` and :c:type:`size_t` " +"via the new codes ``n`` and ``N``, respectively. (Contributed by Antoine " +"Pitrou in :issue:`3163`.)" +msgstr "" + +msgid "subprocess" +msgstr "" + +msgid "" +"Command strings can now be bytes objects on posix platforms. (Contributed " +"by Victor Stinner in :issue:`8513`.)" +msgstr "" + +msgid "" +"A new constant :const:`~subprocess.DEVNULL` allows suppressing output in a " +"platform-independent fashion. (Contributed by Ross Lagerwall in :issue:" +"`5870`.)" +msgstr "" + +msgid "sys" +msgstr "sys" + +msgid "" +"The :mod:`sys` module has a new :data:`~sys.thread_info` :term:`named tuple` " +"holding information about the thread implementation (:issue:`11223`)." +msgstr "" + +msgid "tarfile" +msgstr "" + +msgid "" +":mod:`tarfile` now supports ``lzma`` encoding via the :mod:`lzma` module. " +"(Contributed by Lars Gustäbel in :issue:`5689`.)" +msgstr "" + +msgid "tempfile" +msgstr "" + +msgid "" +":class:`tempfile.SpooledTemporaryFile`\\'s :meth:`~tempfile." +"SpooledTemporaryFile.truncate` method now accepts a ``size`` parameter. " +"(Contributed by Ryan Kelly in :issue:`9957`.)" +msgstr "" + +msgid "textwrap" +msgstr "" + +msgid "" +"The :mod:`textwrap` module has a new :func:`~textwrap.indent` that makes it " +"straightforward to add a common prefix to selected lines in a block of text " +"(:issue:`13857`)." +msgstr "" + +msgid "threading" +msgstr "" + +msgid "" +":class:`threading.Condition`, :class:`threading.Semaphore`, :class:" +"`threading.BoundedSemaphore`, :class:`threading.Event`, and :class:" +"`threading.Timer`, all of which used to be factory functions returning a " +"class instance, are now classes and may be subclassed. (Contributed by Éric " +"Araujo in :issue:`10968`.)" +msgstr "" + +msgid "" +"The :class:`threading.Thread` constructor now accepts a ``daemon`` keyword " +"argument to override the default behavior of inheriting the ``daemon`` flag " +"value from the parent thread (:issue:`6064`)." +msgstr "" + +msgid "" +"The formerly private function ``_thread.get_ident`` is now available as the " +"public function :func:`threading.get_ident`. This eliminates several cases " +"of direct access to the ``_thread`` module in the stdlib. Third party code " +"that used ``_thread.get_ident`` should likewise be changed to use the new " +"public interface." +msgstr "" + +msgid "time" +msgstr "" + +msgid "The :pep:`418` added new functions to the :mod:`time` module:" +msgstr "" + +msgid ":func:`~time.get_clock_info`: Get information on a clock." +msgstr "" + +msgid "" +":func:`~time.monotonic`: Monotonic clock (cannot go backward), not affected " +"by system clock updates." +msgstr "" + +msgid "" +":func:`~time.perf_counter`: Performance counter with the highest available " +"resolution to measure a short duration." +msgstr "" + +msgid "" +":func:`~time.process_time`: Sum of the system and user CPU time of the " +"current process." +msgstr "" + +msgid "Other new functions:" +msgstr "" + +msgid "" +":func:`~time.clock_getres`, :func:`~time.clock_gettime` and :func:`~time." +"clock_settime` functions with :samp:`CLOCK_{xxx}` constants. (Contributed by " +"Victor Stinner in :issue:`10278`.)" +msgstr "" + +msgid "" +"To improve cross platform consistency, :func:`~time.sleep` now raises a :exc:" +"`ValueError` when passed a negative sleep value. Previously this was an " +"error on posix, but produced an infinite sleep on Windows." +msgstr "" + +msgid "types" +msgstr "" + +msgid "" +"Add a new :class:`types.MappingProxyType` class: Read-only proxy of a " +"mapping. (:issue:`14386`)" +msgstr "" + +msgid "" +"The new functions :func:`types.new_class` and :func:`types.prepare_class` " +"provide support for :pep:`3115` compliant dynamic type creation. (:issue:" +"`14588`)" +msgstr "" + +msgid "unittest" +msgstr "" + +msgid "" +":meth:`.assertRaises`, :meth:`.assertRaisesRegex`, :meth:`.assertWarns`, " +"and :meth:`.assertWarnsRegex` now accept a keyword argument *msg* when used " +"as context managers. (Contributed by Ezio Melotti and Winston Ewert in :" +"issue:`10775`.)" +msgstr "" + +msgid "" +":meth:`unittest.TestCase.run` now returns the :class:`~unittest.TestResult` " +"object." +msgstr "" + +msgid "urllib" +msgstr "" + +msgid "" +"The :class:`~urllib.request.Request` class, now accepts a *method* argument " +"used by :meth:`~urllib.request.Request.get_method` to determine what HTTP " +"method should be used. For example, this will send a ``'HEAD'`` request::" +msgstr "" + +msgid "(:issue:`1673007`)" +msgstr "(:issue:`1673007`)" + +msgid "webbrowser" +msgstr "" + +msgid "" +"The :mod:`webbrowser` module supports more \"browsers\": Google Chrome " +"(named :program:`chrome`, :program:`chromium`, :program:`chrome-browser` or :" +"program:`chromium-browser` depending on the version and operating system), " +"and the generic launchers :program:`xdg-open`, from the FreeDesktop.org " +"project, and :program:`gvfs-open`, which is the default URI handler for " +"GNOME 3. (The former contributed by Arnaud Calmettes in :issue:`13620`, the " +"latter by Matthias Klose in :issue:`14493`.)" +msgstr "" + +msgid "xml.etree.ElementTree" +msgstr "" + +msgid "" +"The :mod:`xml.etree.ElementTree` module now imports its C accelerator by " +"default; there is no longer a need to explicitly import :mod:`xml.etree." +"cElementTree` (this module stays for backwards compatibility, but is now " +"deprecated). In addition, the ``iter`` family of methods of :class:`~xml." +"etree.ElementTree.Element` has been optimized (rewritten in C). The module's " +"documentation has also been greatly improved with added examples and a more " +"detailed reference." +msgstr "" + +msgid "zlib" +msgstr "zlib" + +msgid "" +"New attribute :attr:`zlib.Decompress.eof` makes it possible to distinguish " +"between a properly formed compressed stream and an incomplete or truncated " +"one. (Contributed by Nadeem Vawda in :issue:`12646`.)" +msgstr "" + +msgid "" +"New attribute :const:`zlib.ZLIB_RUNTIME_VERSION` reports the version string " +"of the underlying ``zlib`` library that is loaded at runtime. (Contributed " +"by Torsten Landschoff in :issue:`12306`.)" +msgstr "" + +msgid "Optimizations" +msgstr "" + +msgid "Major performance enhancements have been added:" +msgstr "" + +msgid "" +"Thanks to :pep:`393`, some operations on Unicode strings have been optimized:" +msgstr "" + +msgid "the memory footprint is divided by 2 to 4 depending on the text" +msgstr "" + +msgid "" +"encode an ASCII string to UTF-8 doesn't need to encode characters anymore, " +"the UTF-8 representation is shared with the ASCII representation" +msgstr "" + +msgid "the UTF-8 encoder has been optimized" +msgstr "" + +msgid "" +"repeating a single ASCII letter and getting a substring of an ASCII string " +"is 4 times faster" +msgstr "" + +msgid "UTF-8 is now 2x to 4x faster. UTF-16 encoding is now up to 10x faster." +msgstr "" + +msgid "" +"(Contributed by Serhiy Storchaka, :issue:`14624`, :issue:`14738` and :issue:" +"`15026`.)" +msgstr "" + +msgid "Build and C API Changes" +msgstr "" + +msgid "Changes to Python's build process and to the C API include:" +msgstr "" + +msgid "New :pep:`3118` related function:" +msgstr "" + +msgid ":c:func:`PyMemoryView_FromMemory`" +msgstr ":c:func:`PyMemoryView_FromMemory`" + +msgid ":pep:`393` added new Unicode types, macros and functions:" +msgstr "" + +msgid "High-level API:" +msgstr "" + +msgid ":c:func:`PyUnicode_CopyCharacters`" +msgstr ":c:func:`PyUnicode_CopyCharacters`" + +msgid ":c:func:`PyUnicode_FindChar`" +msgstr ":c:func:`PyUnicode_FindChar`" + +msgid ":c:func:`PyUnicode_GetLength`, :c:macro:`PyUnicode_GET_LENGTH`" +msgstr "" + +msgid ":c:func:`PyUnicode_New`" +msgstr ":c:func:`PyUnicode_New`" + +msgid ":c:func:`PyUnicode_Substring`" +msgstr ":c:func:`PyUnicode_Substring`" + +msgid ":c:func:`PyUnicode_ReadChar`, :c:func:`PyUnicode_WriteChar`" +msgstr "" + +msgid "Low-level API:" +msgstr "" + +msgid ":c:type:`Py_UCS1`, :c:type:`Py_UCS2`, :c:type:`Py_UCS4` types" +msgstr "" + +msgid ":c:type:`PyASCIIObject` and :c:type:`PyCompactUnicodeObject` structures" +msgstr "" + +msgid ":c:macro:`PyUnicode_READY`" +msgstr ":c:macro:`PyUnicode_READY`" + +msgid ":c:func:`PyUnicode_FromKindAndData`" +msgstr ":c:func:`PyUnicode_FromKindAndData`" + +msgid ":c:func:`PyUnicode_AsUCS4`, :c:func:`PyUnicode_AsUCS4Copy`" +msgstr "" + +msgid "" +":c:macro:`PyUnicode_DATA`, :c:macro:`PyUnicode_1BYTE_DATA`, :c:macro:" +"`PyUnicode_2BYTE_DATA`, :c:macro:`PyUnicode_4BYTE_DATA`" +msgstr "" + +msgid "" +":c:macro:`PyUnicode_KIND` with :c:enum:`PyUnicode_Kind` enum: :c:data:`!" +"PyUnicode_WCHAR_KIND`, :c:data:`PyUnicode_1BYTE_KIND`, :c:data:" +"`PyUnicode_2BYTE_KIND`, :c:data:`PyUnicode_4BYTE_KIND`" +msgstr "" + +msgid "" +":c:macro:`PyUnicode_READ`, :c:macro:`PyUnicode_READ_CHAR`, :c:macro:" +"`PyUnicode_WRITE`" +msgstr "" + +msgid ":c:macro:`PyUnicode_MAX_CHAR_VALUE`" +msgstr ":c:macro:`PyUnicode_MAX_CHAR_VALUE`" + +msgid "" +":c:macro:`PyArg_ParseTuple` now accepts a :class:`bytearray` for the ``c`` " +"format (:issue:`12380`)." +msgstr "" + +msgid "Deprecated" +msgstr "" + +msgid "Unsupported Operating Systems" +msgstr "" + +msgid "OS/2 and VMS are no longer supported due to the lack of a maintainer." +msgstr "" + +msgid "" +"Windows 2000 and Windows platforms which set ``COMSPEC`` to ``command.com`` " +"are no longer supported due to maintenance burden." +msgstr "" + +msgid "OSF support, which was deprecated in 3.2, has been completely removed." +msgstr "" + +msgid "Deprecated Python modules, functions and methods" +msgstr "" + +msgid "" +"Passing a non-empty string to ``object.__format__()`` is deprecated, and " +"will produce a :exc:`TypeError` in Python 3.4 (:issue:`9856`)." +msgstr "" + +msgid "" +"The ``unicode_internal`` codec has been deprecated because of the :pep:" +"`393`, use UTF-8, UTF-16 (``utf-16-le`` or ``utf-16-be``), or UTF-32 " +"(``utf-32-le`` or ``utf-32-be``)" +msgstr "" + +msgid "" +":meth:`ftplib.FTP.nlst` and :meth:`ftplib.FTP.dir`: use :meth:`ftplib.FTP." +"mlsd`" +msgstr "" + +msgid "" +":func:`platform.popen`: use the :mod:`subprocess` module. Check especially " +"the :ref:`subprocess-replacements` section (:issue:`11377`)." +msgstr "" + +msgid "" +":issue:`13374`: The Windows bytes API has been deprecated in the :mod:`os` " +"module. Use Unicode filenames, instead of bytes filenames, to not depend on " +"the ANSI code page anymore and to support any filename." +msgstr "" + +msgid "" +":issue:`13988`: The :mod:`xml.etree.cElementTree` module is deprecated. The " +"accelerator is used automatically whenever available." +msgstr "" + +msgid "" +"The behaviour of :func:`time.clock` depends on the platform: use the new :" +"func:`time.perf_counter` or :func:`time.process_time` function instead, " +"depending on your requirements, to have a well defined behaviour." +msgstr "" + +msgid "The :func:`os.stat_float_times` function is deprecated." +msgstr "" + +msgid ":mod:`abc` module:" +msgstr "" + +msgid ":mod:`importlib` package:" +msgstr "" + +msgid "" +":meth:`importlib.abc.SourceLoader.path_mtime` is now deprecated in favour " +"of :meth:`importlib.abc.SourceLoader.path_stats` as bytecode files now store " +"both the modification time and size of the source file the bytecode file was " +"compiled from." +msgstr "" + +msgid "Deprecated functions and types of the C API" +msgstr "" + +msgid "" +"The :c:type:`Py_UNICODE` has been deprecated by :pep:`393` and will be " +"removed in Python 4. All functions using this type are deprecated:" +msgstr "" + +msgid "" +"Unicode functions and methods using :c:type:`Py_UNICODE` and :c:expr:" +"`Py_UNICODE*` types:" +msgstr "" + +msgid "" +":c:macro:`!PyUnicode_FromUnicode`: use :c:func:`PyUnicode_FromWideChar` or :" +"c:func:`PyUnicode_FromKindAndData`" +msgstr "" + +msgid "" +":c:macro:`!PyUnicode_AS_UNICODE`, :c:func:`!PyUnicode_AsUnicode`, :c:func:`!" +"PyUnicode_AsUnicodeAndSize`: use :c:func:`PyUnicode_AsWideCharString`" +msgstr "" + +msgid "" +":c:macro:`!PyUnicode_AS_DATA`: use :c:macro:`PyUnicode_DATA` with :c:macro:" +"`PyUnicode_READ` and :c:macro:`PyUnicode_WRITE`" +msgstr "" + +msgid "" +":c:macro:`!PyUnicode_GET_SIZE`, :c:func:`!PyUnicode_GetSize`: use :c:macro:" +"`PyUnicode_GET_LENGTH` or :c:func:`PyUnicode_GetLength`" +msgstr "" + +msgid "" +":c:macro:`!PyUnicode_GET_DATA_SIZE`: use ``PyUnicode_GET_LENGTH(str) * " +"PyUnicode_KIND(str)`` (only work on ready strings)" +msgstr "" + +msgid "" +":c:func:`!PyUnicode_AsUnicodeCopy`: use :c:func:`PyUnicode_AsUCS4Copy` or :c:" +"func:`PyUnicode_AsWideCharString`" +msgstr "" + +msgid ":c:func:`!PyUnicode_GetMax`" +msgstr ":c:func:`!PyUnicode_GetMax`" + +msgid "Functions and macros manipulating Py_UNICODE* strings:" +msgstr "" + +msgid "" +":c:macro:`!Py_UNICODE_strlen()`: use :c:func:`PyUnicode_GetLength` or :c:" +"macro:`PyUnicode_GET_LENGTH`" +msgstr "" + +msgid "" +":c:macro:`!Py_UNICODE_strcat()`: use :c:func:`PyUnicode_CopyCharacters` or :" +"c:func:`PyUnicode_FromFormat`" +msgstr "" + +msgid "" +":c:macro:`!Py_UNICODE_strcpy()`, :c:macro:`!Py_UNICODE_strncpy()`, :c:macro:" +"`!Py_UNICODE_COPY()`: use :c:func:`PyUnicode_CopyCharacters` or :c:func:" +"`PyUnicode_Substring`" +msgstr "" + +msgid ":c:macro:`!Py_UNICODE_strcmp()`: use :c:func:`PyUnicode_Compare`" +msgstr "" + +msgid ":c:macro:`!Py_UNICODE_strncmp()`: use :c:func:`PyUnicode_Tailmatch`" +msgstr "" + +msgid "" +":c:macro:`!Py_UNICODE_strchr()`, :c:macro:`!Py_UNICODE_strrchr()`: use :c:" +"func:`PyUnicode_FindChar`" +msgstr "" + +msgid ":c:macro:`!Py_UNICODE_FILL()`: use :c:func:`PyUnicode_Fill`" +msgstr "" + +msgid ":c:macro:`!Py_UNICODE_MATCH`" +msgstr ":c:macro:`!Py_UNICODE_MATCH`" + +msgid "Encoders:" +msgstr "" + +msgid ":c:func:`!PyUnicode_Encode`: use :c:func:`!PyUnicode_AsEncodedObject`" +msgstr "" + +msgid ":c:func:`!PyUnicode_EncodeUTF7`" +msgstr ":c:func:`!PyUnicode_EncodeUTF7`" + +msgid "" +":c:func:`!PyUnicode_EncodeUTF8`: use :c:func:`PyUnicode_AsUTF8` or :c:func:" +"`PyUnicode_AsUTF8String`" +msgstr "" + +msgid ":c:func:`!PyUnicode_EncodeUTF32`" +msgstr ":c:func:`!PyUnicode_EncodeUTF32`" + +msgid ":c:func:`!PyUnicode_EncodeUTF16`" +msgstr ":c:func:`!PyUnicode_EncodeUTF16`" + +msgid "" +":c:func:`!PyUnicode_EncodeUnicodeEscape` use :c:func:" +"`PyUnicode_AsUnicodeEscapeString`" +msgstr "" + +msgid "" +":c:func:`!PyUnicode_EncodeRawUnicodeEscape` use :c:func:" +"`PyUnicode_AsRawUnicodeEscapeString`" +msgstr "" + +msgid "" +":c:func:`!PyUnicode_EncodeLatin1`: use :c:func:`PyUnicode_AsLatin1String`" +msgstr "" + +msgid ":c:func:`!PyUnicode_EncodeASCII`: use :c:func:`PyUnicode_AsASCIIString`" +msgstr "" + +msgid ":c:func:`!PyUnicode_EncodeCharmap`" +msgstr ":c:func:`!PyUnicode_EncodeCharmap`" + +msgid ":c:func:`!PyUnicode_TranslateCharmap`" +msgstr ":c:func:`!PyUnicode_TranslateCharmap`" + +msgid "" +":c:func:`!PyUnicode_EncodeMBCS`: use :c:func:`PyUnicode_AsMBCSString` or :c:" +"func:`PyUnicode_EncodeCodePage` (with ``CP_ACP`` code_page)" +msgstr "" + +msgid "" +":c:func:`!PyUnicode_EncodeDecimal`, :c:func:`!" +"PyUnicode_TransformDecimalToASCII`" +msgstr "" + +msgid "Deprecated features" +msgstr "" + +msgid "" +"The :mod:`array` module's ``'u'`` format code is now deprecated and will be " +"removed in Python 4 together with the rest of the (:c:type:`Py_UNICODE`) API." +msgstr "" + +msgid "Porting to Python 3.3" +msgstr "" + +msgid "" +"This section lists previously described changes and other bugfixes that may " +"require changes to your code." +msgstr "" + +msgid "Porting Python code" +msgstr "" + +msgid "" +"Hash randomization is enabled by default. Set the :envvar:`PYTHONHASHSEED` " +"environment variable to ``0`` to disable hash randomization. See also the :" +"meth:`object.__hash__` method." +msgstr "" + +msgid "" +":issue:`12326`: On Linux, sys.platform doesn't contain the major version " +"anymore. It is now always 'linux', instead of 'linux2' or 'linux3' depending " +"on the Linux version used to build Python. Replace sys.platform == 'linux2' " +"with sys.platform.startswith('linux'), or directly sys.platform == 'linux' " +"if you don't need to support older Python versions." +msgstr "" + +msgid "" +":issue:`13847`, :issue:`14180`: :mod:`time` and :mod:`datetime`: :exc:" +"`OverflowError` is now raised instead of :exc:`ValueError` if a timestamp is " +"out of range. :exc:`OSError` is now raised if C functions :c:func:`gmtime` " +"or :c:func:`localtime` failed." +msgstr "" + +msgid "" +"The default finders used by import now utilize a cache of what is contained " +"within a specific directory. If you create a Python source file or " +"sourceless bytecode file, make sure to call :func:`importlib." +"invalidate_caches` to clear out the cache for the finders to notice the new " +"file." +msgstr "" + +msgid "" +":exc:`ImportError` now uses the full name of the module that was attempted " +"to be imported. Doctests that check ImportErrors' message will need to be " +"updated to use the full name of the module instead of just the tail of the " +"name." +msgstr "" + +msgid "" +"The *index* argument to :func:`__import__` now defaults to 0 instead of -1 " +"and no longer support negative values. It was an oversight when :pep:`328` " +"was implemented that the default value remained -1. If you need to continue " +"to perform a relative import followed by an absolute import, then perform " +"the relative import using an index of 1, followed by another import using an " +"index of 0. It is preferred, though, that you use :func:`importlib." +"import_module` rather than call :func:`__import__` directly." +msgstr "" + +msgid "" +":func:`__import__` no longer allows one to use an index value other than 0 " +"for top-level modules. E.g. ``__import__('sys', level=1)`` is now an error." +msgstr "" + +msgid "" +"Because :data:`sys.meta_path` and :data:`sys.path_hooks` now have finders on " +"them by default, you will most likely want to use :meth:`list.insert` " +"instead of :meth:`list.append` to add to those lists." +msgstr "" + +msgid "" +"Because ``None`` is now inserted into :data:`sys.path_importer_cache`, if " +"you are clearing out entries in the dictionary of paths that do not have a " +"finder, you will need to remove keys paired with values of ``None`` **and** :" +"class:`imp.NullImporter` to be backwards-compatible. This will lead to extra " +"overhead on older versions of Python that re-insert ``None`` into :data:`sys." +"path_importer_cache` where it represents the use of implicit finders, but " +"semantically it should not change anything." +msgstr "" + +msgid "" +":class:`importlib.abc.Finder` no longer specifies a ``find_module()`` " +"abstract method that must be implemented. If you were relying on subclasses " +"to implement that method, make sure to check for the method's existence " +"first. You will probably want to check for ``find_loader()`` first, though, " +"in the case of working with :term:`path entry finders `." +msgstr "" + +msgid "" +":mod:`pkgutil` has been converted to use :mod:`importlib` internally. This " +"eliminates many edge cases where the old behaviour of the :pep:`302` import " +"emulation failed to match the behaviour of the real import system. The " +"import emulation itself is still present, but is now deprecated. The :func:" +"`pkgutil.iter_importers` and :func:`pkgutil.walk_packages` functions special " +"case the standard import hooks so they are still supported even though they " +"do not provide the non-standard ``iter_modules()`` method." +msgstr "" + +msgid "" +"A longstanding RFC-compliance bug (:issue:`1079`) in the parsing done by :" +"func:`email.header.decode_header` has been fixed. Code that uses the " +"standard idiom to convert encoded headers into unicode " +"(``str(make_header(decode_header(h))``) will see no change, but code that " +"looks at the individual tuples returned by decode_header will see that " +"whitespace that precedes or follows ``ASCII`` sections is now included in " +"the ``ASCII`` section. Code that builds headers using ``make_header`` " +"should also continue to work without change, since ``make_header`` continues " +"to add whitespace between ``ASCII`` and non-``ASCII`` sections if it is not " +"already present in the input strings." +msgstr "" + +msgid "" +":func:`email.utils.formataddr` now does the correct content transfer " +"encoding when passed non-``ASCII`` display names. Any code that depended on " +"the previous buggy behavior that preserved the non-``ASCII`` unicode in the " +"formatted output string will need to be changed (:issue:`1690608`)." +msgstr "" + +msgid "" +":meth:`poplib.POP3.quit` may now raise protocol errors like all other " +"``poplib`` methods. Code that assumes ``quit`` does not raise :exc:`poplib." +"error_proto` errors may need to be changed if errors on ``quit`` are " +"encountered by a particular application (:issue:`11291`)." +msgstr "" + +msgid "" +"The ``strict`` argument to :class:`email.parser.Parser`, deprecated since " +"Python 2.4, has finally been removed." +msgstr "" + +msgid "" +"The deprecated method ``unittest.TestCase.assertSameElements`` has been " +"removed." +msgstr "" + +msgid "The deprecated variable ``time.accept2dyear`` has been removed." +msgstr "" + +msgid "" +"The deprecated ``Context._clamp`` attribute has been removed from the :mod:" +"`decimal` module. It was previously replaced by the public attribute :attr:" +"`~decimal.Context.clamp`. (See :issue:`8540`.)" +msgstr "" + +msgid "" +"The undocumented internal helper class ``SSLFakeFile`` has been removed " +"from :mod:`smtplib`, since its functionality has long been provided directly " +"by :meth:`socket.socket.makefile`." +msgstr "" + +msgid "" +"Passing a negative value to :func:`time.sleep` on Windows now raises an " +"error instead of sleeping forever. It has always raised an error on posix." +msgstr "" + +msgid "" +"The ``ast.__version__`` constant has been removed. If you need to make " +"decisions affected by the AST version, use :data:`sys.version_info` to make " +"the decision." +msgstr "" + +msgid "" +"Code that used to work around the fact that the :mod:`threading` module used " +"factory functions by subclassing the private classes will need to change to " +"subclass the now-public classes." +msgstr "" + +msgid "" +"The undocumented debugging machinery in the threading module has been " +"removed, simplifying the code. This should have no effect on production " +"code, but is mentioned here in case any application debug frameworks were " +"interacting with it (:issue:`13550`)." +msgstr "" + +msgid "Porting C code" +msgstr "" + +msgid "" +"In the course of changes to the buffer API the undocumented :c:member:`!" +"smalltable` member of the :c:type:`Py_buffer` structure has been removed and " +"the layout of the :c:type:`PyMemoryViewObject` has changed." +msgstr "" + +msgid "" +"All extensions relying on the relevant parts in ``memoryobject.h`` or " +"``object.h`` must be rebuilt." +msgstr "" + +msgid "" +"Due to :ref:`PEP 393 `, the :c:type:`Py_UNICODE` type and all " +"functions using this type are deprecated (but will stay available for at " +"least five years). If you were using low-level Unicode APIs to construct " +"and access unicode objects and you want to benefit of the memory footprint " +"reduction provided by :pep:`393`, you have to convert your code to the new :" +"doc:`Unicode API <../c-api/unicode>`." +msgstr "" + +msgid "" +"However, if you only have been using high-level functions such as :c:func:" +"`PyUnicode_Concat()`, :c:func:`PyUnicode_Join` or :c:func:" +"`PyUnicode_FromFormat()`, your code will automatically take advantage of the " +"new unicode representations." +msgstr "" + +msgid ":c:func:`PyImport_GetMagicNumber` now returns ``-1`` upon failure." +msgstr "" + +msgid "" +"As a negative value for the *level* argument to :func:`__import__` is no " +"longer valid, the same now holds for :c:func:`PyImport_ImportModuleLevel`. " +"This also means that the value of *level* used by :c:func:" +"`PyImport_ImportModuleEx` is now ``0`` instead of ``-1``." +msgstr "" + +msgid "Building C extensions" +msgstr "" + +msgid "" +"The range of possible file names for C extensions has been narrowed. Very " +"rarely used spellings have been suppressed: under POSIX, files named " +"``xxxmodule.so``, ``xxxmodule.abi3.so`` and ``xxxmodule.cpython-*.so`` are " +"no longer recognized as implementing the ``xxx`` module. If you had been " +"generating such files, you have to switch to the other spellings (i.e., " +"remove the ``module`` string from the file names)." +msgstr "" + +msgid "(implemented in :issue:`14040`.)" +msgstr "" + +msgid "Command Line Switch Changes" +msgstr "" + +msgid "" +"The -Q command-line flag and related artifacts have been removed. Code " +"checking sys.flags.division_warning will need updating." +msgstr "" + +msgid "(:issue:`10998`, contributed by Éric Araujo.)" +msgstr "" + +msgid "" +"When :program:`python` is started with :option:`-S`, ``import site`` will no " +"longer add site-specific paths to the module search paths. In previous " +"versions, it did." +msgstr "" + +msgid "" +"(:issue:`11591`, contributed by Carl Meyer with editions by Éric Araujo.)" +msgstr "" + +msgid "yield" +msgstr "" + +msgid "yield from (in What's New)" +msgstr "" diff --git a/whatsnew/3.4.po b/whatsnew/3.4.po new file mode 100644 index 0000000000..7a346320a0 --- /dev/null +++ b/whatsnew/3.4.po @@ -0,0 +1,3017 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "What's New In Python 3.4" +msgstr "" + +msgid "Author" +msgstr "Autor" + +msgid "R. David Murray (Editor)" +msgstr "" + +msgid "" +"This article explains the new features in Python 3.4, compared to 3.3. " +"Python 3.4 was released on March 16, 2014. For full details, see the " +"`changelog `_." +msgstr "" + +msgid ":pep:`429` -- Python 3.4 Release Schedule" +msgstr "" + +msgid "Summary -- Release Highlights" +msgstr "Podsumowanie - najważniejsze informacje o wydaniu" + +msgid "New syntax features:" +msgstr "Nowe cechy składni:" + +msgid "No new syntax features were added in Python 3.4." +msgstr "" + +msgid "Other new features:" +msgstr "" + +msgid ":ref:`pip should always be available ` (:pep:`453`)." +msgstr "" + +msgid "" +":ref:`Newly created file descriptors are non-inheritable ` " +"(:pep:`446`)." +msgstr "" + +msgid "" +"command line option for :ref:`isolated mode ` (:" +"issue:`16499`)." +msgstr "" + +msgid "" +":ref:`improvements in the handling of codecs ` " +"that are not text encodings (multiple issues)." +msgstr "" + +msgid "" +":ref:`A ModuleSpec Type ` for the Import System (:pep:" +"`451`). (Affects importer authors.)" +msgstr "" + +msgid "" +"The :mod:`marshal` format has been made :ref:`more compact and efficient " +"` (:issue:`16475`)." +msgstr "" + +msgid "New library modules:" +msgstr "Nowe moduły biblioteki:" + +msgid "" +":mod:`asyncio`: :ref:`New provisional API for asynchronous IO ` (:pep:`3156`)." +msgstr "" + +msgid "" +":mod:`ensurepip`: :ref:`Bootstrapping the pip installer ` (:pep:`453`)." +msgstr "" + +msgid "" +":mod:`enum`: :ref:`Support for enumeration types ` (:pep:" +"`435`)." +msgstr "" + +msgid "" +":mod:`pathlib`: :ref:`Object-oriented filesystem paths ` (:" +"pep:`428`)." +msgstr "" + +msgid "" +":mod:`selectors`: :ref:`High-level and efficient I/O multiplexing `, built upon the :mod:`select` module primitives (part of :pep:" +"`3156`)." +msgstr "" + +msgid "" +":mod:`statistics`: A basic :ref:`numerically stable statistics library " +"` (:pep:`450`)." +msgstr "" + +msgid "" +":mod:`tracemalloc`: :ref:`Trace Python memory allocations ` (:pep:`454`)." +msgstr "" + +msgid "Significantly improved library modules:" +msgstr "" + +msgid "" +":ref:`Single-dispatch generic functions ` in :mod:" +"`functools` (:pep:`443`)." +msgstr "" + +msgid "" +"New :mod:`pickle` :ref:`protocol 4 ` (:pep:`3154`)." +msgstr "" + +msgid "" +":mod:`multiprocessing` now has :ref:`an option to avoid using os.fork on " +"Unix ` (:issue:`8713`)." +msgstr "" + +msgid "" +":mod:`email` has a new submodule, :mod:`~email.contentmanager`, and a new :" +"mod:`~email.message.Message` subclass (:class:`~email.contentmanager." +"EmailMessage`) that :ref:`simplify MIME handling " +"` (:issue:`18891`)." +msgstr "" + +msgid "" +"The :mod:`inspect` and :mod:`pydoc` modules are now capable of correct " +"introspection of a much wider variety of callable objects, which improves " +"the output of the Python :func:`help` system." +msgstr "" + +msgid "The :mod:`ipaddress` module API has been declared stable" +msgstr "" + +msgid "Security improvements:" +msgstr "" + +msgid "" +":ref:`Secure and interchangeable hash algorithm ` (:pep:" +"`456`)." +msgstr "" + +msgid "" +":ref:`Make newly created file descriptors non-inheritable ` (:pep:`446`) to avoid leaking file descriptors to child processes." +msgstr "" + +msgid "" +"New command line option for :ref:`isolated mode `, (:" +"issue:`16499`)." +msgstr "" + +msgid "" +":mod:`multiprocessing` now has :ref:`an option to avoid using os.fork on " +"Unix `. *spawn* and *forkserver* are more " +"secure because they avoid sharing data with child processes." +msgstr "" + +msgid "" +":mod:`multiprocessing` child processes on Windows no longer inherit all of " +"the parent's inheritable handles, only the necessary ones." +msgstr "" + +msgid "" +"A new :func:`hashlib.pbkdf2_hmac` function provides the `PKCS#5 password-" +"based key derivation function 2 `_." +msgstr "" + +msgid ":ref:`TLSv1.1 and TLSv1.2 support ` for :mod:`ssl`." +msgstr "" + +msgid "" +":ref:`Retrieving certificates from the Windows system cert store support " +"` for :mod:`ssl`." +msgstr "" + +msgid "" +":ref:`Server-side SNI (Server Name Indication) support ` " +"for :mod:`ssl`." +msgstr "" + +msgid "" +"The :class:`ssl.SSLContext` class has a :ref:`lot of improvements " +"`." +msgstr "" + +msgid "" +"All modules in the standard library that support SSL now support server " +"certificate verification, including hostname matching (:func:`ssl." +"match_hostname`) and CRLs (Certificate Revocation lists, see :func:`ssl." +"SSLContext.load_verify_locations`)." +msgstr "" + +msgid "CPython implementation improvements:" +msgstr "" + +msgid ":ref:`Safe object finalization ` (:pep:`442`)." +msgstr "" + +msgid "" +"Leveraging :pep:`442`, in most cases :ref:`module globals are no longer set " +"to None during finalization ` (:issue:`18214`)." +msgstr "" + +msgid ":ref:`Configurable memory allocators ` (:pep:`445`)." +msgstr "" + +msgid ":ref:`Argument Clinic ` (:pep:`436`)." +msgstr "" + +msgid "" +"Please read on for a comprehensive list of user-facing changes, including " +"many other smaller improvements, CPython optimizations, deprecations, and " +"potential porting issues." +msgstr "" + +msgid "New Features" +msgstr "Nowe funkcjonalności" + +msgid "PEP 453: Explicit Bootstrapping of PIP in Python Installations" +msgstr "" + +msgid "Bootstrapping pip By Default" +msgstr "" + +msgid "" +"The new :mod:`ensurepip` module (defined in :pep:`453`) provides a standard " +"cross-platform mechanism to bootstrap the pip installer into Python " +"installations and virtual environments. The version of ``pip`` included with " +"Python 3.4.0 is ``pip`` 1.5.4, and future 3.4.x maintenance releases will " +"update the bundled version to the latest version of ``pip`` that is " +"available at the time of creating the release candidate." +msgstr "" + +msgid "" +"By default, the commands ``pipX`` and ``pipX.Y`` will be installed on all " +"platforms (where X.Y stands for the version of the Python installation), " +"along with the ``pip`` Python package and its dependencies. On Windows and " +"in virtual environments on all platforms, the unversioned ``pip`` command " +"will also be installed. On other platforms, the system wide unversioned " +"``pip`` command typically refers to the separately installed Python 2 " +"version." +msgstr "" + +msgid "" +"The ``pyvenv`` command line utility and the :mod:`venv` module make use of " +"the :mod:`ensurepip` module to make ``pip`` readily available in virtual " +"environments. When using the command line utility, ``pip`` is installed by " +"default, while when using the :mod:`venv` module :ref:`venv-api` " +"installation of ``pip`` must be requested explicitly." +msgstr "" + +msgid "" +"For CPython :ref:`source builds on POSIX systems `, " +"the ``make install`` and ``make altinstall`` commands bootstrap ``pip`` by " +"default. This behaviour can be controlled through configure options, and " +"overridden through Makefile options." +msgstr "" + +msgid "" +"On Windows and Mac OS X, the CPython installers now default to installing " +"``pip`` along with CPython itself (users may opt out of installing it during " +"the installation process). Window users will need to opt in to the automatic " +"``PATH`` modifications to have ``pip`` available from the command line by " +"default, otherwise it can still be accessed through the Python launcher for " +"Windows as ``py -m pip``." +msgstr "" + +msgid "" +"As `discussed in the PEP`__, platform packagers may choose not to install " +"these commands by default, as long as, when invoked, they provide clear and " +"simple directions on how to install them on that platform (usually using the " +"system package manager)." +msgstr "" + +msgid "" +"To avoid conflicts between parallel Python 2 and Python 3 installations, " +"only the versioned ``pip3`` and ``pip3.4`` commands are bootstrapped by " +"default when ``ensurepip`` is invoked directly - the ``--default-pip`` " +"option is needed to also request the unversioned ``pip`` command. ``pyvenv`` " +"and the Windows installer ensure that the unqualified ``pip`` command is " +"made available in those environments, and ``pip`` can always be invoked via " +"the ``-m`` switch rather than directly to avoid ambiguity on systems with " +"multiple Python installations." +msgstr "" + +msgid "Documentation Changes" +msgstr "" + +msgid "" +"As part of this change, the :ref:`installing-index` and :ref:`distributing-" +"index` sections of the documentation have been completely redesigned as " +"short getting started and FAQ documents. Most packaging documentation has " +"now been moved out to the Python Packaging Authority maintained `Python " +"Packaging User Guide `__ and the documentation " +"of the individual projects." +msgstr "" + +msgid "" +"However, as this migration is currently still incomplete, the legacy " +"versions of those guides remaining available as :ref:`install-index` and :" +"ref:`distutils-index`." +msgstr "" + +msgid ":pep:`453` -- Explicit bootstrapping of pip in Python installations" +msgstr "" + +msgid "" +"PEP written by Donald Stufft and Nick Coghlan, implemented by Donald Stufft, " +"Nick Coghlan, Martin von Löwis and Ned Deily." +msgstr "" + +msgid "PEP 446: Newly Created File Descriptors Are Non-Inheritable" +msgstr "" + +msgid "" +":pep:`446` makes newly created file descriptors :ref:`non-inheritable " +"`. In general, this is the behavior an application will " +"want: when launching a new process, having currently open files also open in " +"the new process can lead to all sorts of hard to find bugs, and potentially " +"to security issues." +msgstr "" + +msgid "" +"However, there are occasions when inheritance is desired. To support these " +"cases, the following new functions and methods are available:" +msgstr "" + +msgid ":func:`os.get_inheritable`, :func:`os.set_inheritable`" +msgstr "" + +msgid ":func:`os.get_handle_inheritable`, :func:`os.set_handle_inheritable`" +msgstr "" + +msgid "" +":meth:`socket.socket.get_inheritable`, :meth:`socket.socket.set_inheritable`" +msgstr "" + +msgid ":pep:`446` -- Make newly created file descriptors non-inheritable" +msgstr "" + +msgid "PEP written and implemented by Victor Stinner." +msgstr "" + +msgid "Improvements to Codec Handling" +msgstr "" + +msgid "" +"Since it was first introduced, the :mod:`codecs` module has always been " +"intended to operate as a type-neutral dynamic encoding and decoding system. " +"However, its close coupling with the Python text model, especially the type " +"restricted convenience methods on the builtin :class:`str`, :class:`bytes` " +"and :class:`bytearray` types, has historically obscured that fact." +msgstr "" + +msgid "" +"As a key step in clarifying the situation, the :meth:`codecs.encode` and :" +"meth:`codecs.decode` convenience functions are now properly documented in " +"Python 2.7, 3.3 and 3.4. These functions have existed in the :mod:`codecs` " +"module (and have been covered by the regression test suite) since Python " +"2.4, but were previously only discoverable through runtime introspection." +msgstr "" + +msgid "" +"Unlike the convenience methods on :class:`str`, :class:`bytes` and :class:" +"`bytearray`, the :mod:`codecs` convenience functions support arbitrary " +"codecs in both Python 2 and Python 3, rather than being limited to Unicode " +"text encodings (in Python 3) or ``basestring`` <-> ``basestring`` " +"conversions (in Python 2)." +msgstr "" + +msgid "" +"In Python 3.4, the interpreter is able to identify the known non-text " +"encodings provided in the standard library and direct users towards these " +"general purpose convenience functions when appropriate::" +msgstr "" + +msgid "" +"In a related change, whenever it is feasible without breaking backwards " +"compatibility, exceptions raised during encoding and decoding operations are " +"wrapped in a chained exception of the same type that mentions the name of " +"the codec responsible for producing the error::" +msgstr "" + +msgid "" +"Finally, as the examples above show, these improvements have permitted the " +"restoration of the convenience aliases for the non-Unicode codecs that were " +"themselves restored in Python 3.2. This means that encoding binary data to " +"and from its hexadecimal representation (for example) can now be written as::" +msgstr "" + +msgid "" +"The binary and text transforms provided in the standard library are detailed " +"in :ref:`binary-transforms` and :ref:`text-transforms`." +msgstr "" + +msgid "" +"(Contributed by Nick Coghlan in :issue:`7475`, :issue:`17827`, :issue:" +"`17828` and :issue:`19619`.)" +msgstr "" + +msgid "PEP 451: A ModuleSpec Type for the Import System" +msgstr "" + +msgid "" +":pep:`451` provides an encapsulation of the information about a module that " +"the import machinery will use to load it (that is, a module specification). " +"This helps simplify both the import implementation and several import-" +"related APIs. The change is also a stepping stone for `several future import-" +"related improvements`__." +msgstr "" + +msgid "" +"The public-facing changes from the PEP are entirely backward-compatible. " +"Furthermore, they should be transparent to everyone but importer authors. " +"Key finder and loader methods have been deprecated, but they will continue " +"working. New importers should use the new methods described in the PEP. " +"Existing importers should be updated to implement the new methods. See the :" +"ref:`deprecated-3.4` section for a list of methods that should be replaced " +"and their replacements." +msgstr "" + +msgid "Other Language Changes" +msgstr "" + +msgid "Some smaller changes made to the core Python language are:" +msgstr "" + +msgid "Unicode database updated to UCD version 6.3." +msgstr "" + +msgid "" +":func:`min` and :func:`max` now accept a *default* keyword-only argument " +"that can be used to specify the value they return if the iterable they are " +"evaluating has no elements. (Contributed by Julian Berman in :issue:" +"`18111`.)" +msgstr "" + +msgid "Module objects are now :ref:`weakly referenceable `." +msgstr "" + +msgid "" +"Module ``__file__`` attributes (and related values) should now always " +"contain absolute paths by default, with the sole exception of ``__main__." +"__file__`` when a script has been executed directly using a relative path. " +"(Contributed by Brett Cannon in :issue:`18416`.)" +msgstr "" + +msgid "" +"All the UTF-\\* codecs (except UTF-7) now reject surrogates during both " +"encoding and decoding unless the ``surrogatepass`` error handler is used, " +"with the exception of the UTF-16 decoder (which accepts valid surrogate " +"pairs) and the UTF-16 encoder (which produces them while encoding non-BMP " +"characters). (Contributed by Victor Stinner, Kang-Hao (Kenny) Lu and Serhiy " +"Storchaka in :issue:`12892`.)" +msgstr "" + +msgid "" +"New German EBCDIC :ref:`codec ` ``cp273``. (Contributed " +"by Michael Bierenfeld and Andrew Kuchling in :issue:`1097797`.)" +msgstr "" + +msgid "" +"New Ukrainian :ref:`codec ` ``cp1125``. (Contributed by " +"Serhiy Storchaka in :issue:`19668`.)" +msgstr "" + +msgid "" +":class:`bytes`.join() and :class:`bytearray`.join() now accept arbitrary " +"buffer objects as arguments. (Contributed by Antoine Pitrou in :issue:" +"`15958`.)" +msgstr "" + +msgid "" +"The :class:`int` constructor now accepts any object that has an " +"``__index__`` method for its *base* argument. (Contributed by Mark " +"Dickinson in :issue:`16772`.)" +msgstr "" + +msgid "" +"Frame objects now have a :func:`~frame.clear` method that clears all " +"references to local variables from the frame. (Contributed by Antoine " +"Pitrou in :issue:`17934`.)" +msgstr "" + +msgid "" +":class:`memoryview` is now registered as a :class:`Sequence `, and supports the :func:`reversed` builtin. (Contributed by Nick " +"Coghlan and Claudiu Popa in :issue:`18690` and :issue:`19078`.)" +msgstr "" + +msgid "" +"Signatures reported by :func:`help` have been modified and improved in " +"several cases as a result of the introduction of Argument Clinic and other " +"changes to the :mod:`inspect` and :mod:`pydoc` modules." +msgstr "" + +msgid "" +":meth:`~object.__length_hint__` is now part of the formal language " +"specification (see :pep:`424`). (Contributed by Armin Ronacher in :issue:" +"`16148`.)" +msgstr "" + +msgid "New Modules" +msgstr "" + +msgid "asyncio" +msgstr "" + +msgid "" +"The new :mod:`asyncio` module (defined in :pep:`3156`) provides a standard " +"pluggable event loop model for Python, providing solid asynchronous IO " +"support in the standard library, and making it easier for other event loop " +"implementations to interoperate with the standard library and each other." +msgstr "" + +msgid "For Python 3.4, this module is considered a :term:`provisional API`." +msgstr "" + +msgid ":pep:`3156` -- Asynchronous IO Support Rebooted: the \"asyncio\" Module" +msgstr "" + +msgid "PEP written and implementation led by Guido van Rossum." +msgstr "" + +msgid "ensurepip" +msgstr "" + +msgid "" +"The new :mod:`ensurepip` module is the primary infrastructure for the :pep:" +"`453` implementation. In the normal course of events end users will not " +"need to interact with this module, but it can be used to manually bootstrap " +"``pip`` if the automated bootstrapping into an installation or virtual " +"environment was declined." +msgstr "" + +msgid "" +":mod:`ensurepip` includes a bundled copy of ``pip``, up-to-date as of the " +"first release candidate of the release of CPython with which it ships (this " +"applies to both maintenance releases and feature releases). ``ensurepip`` " +"does not access the internet. If the installation has internet access, " +"after ``ensurepip`` is run the bundled ``pip`` can be used to upgrade " +"``pip`` to a more recent release than the bundled one. (Note that such an " +"upgraded version of ``pip`` is considered to be a separately installed " +"package and will not be removed if Python is uninstalled.)" +msgstr "" + +msgid "" +"The module is named *ensure*\\ pip because if called when ``pip`` is already " +"installed, it does nothing. It also has an ``--upgrade`` option that will " +"cause it to install the bundled copy of ``pip`` if the existing installed " +"version of ``pip`` is older than the bundled copy." +msgstr "" + +msgid "enum" +msgstr "" + +msgid "" +"The new :mod:`enum` module (defined in :pep:`435`) provides a standard " +"implementation of enumeration types, allowing other modules (such as :mod:" +"`socket`) to provide more informative error messages and better debugging " +"support by replacing opaque integer constants with backwards compatible " +"enumeration values." +msgstr "" + +msgid ":pep:`435` -- Adding an Enum type to the Python standard library" +msgstr "" + +msgid "" +"PEP written by Barry Warsaw, Eli Bendersky and Ethan Furman, implemented by " +"Ethan Furman." +msgstr "" + +msgid "pathlib" +msgstr "" + +msgid "" +"The new :mod:`pathlib` module offers classes representing filesystem paths " +"with semantics appropriate for different operating systems. Path classes " +"are divided between *pure paths*, which provide purely computational " +"operations without I/O, and *concrete paths*, which inherit from pure paths " +"but also provide I/O operations." +msgstr "" + +msgid ":pep:`428` -- The pathlib module -- object-oriented filesystem paths" +msgstr "" + +msgid "PEP written and implemented by Antoine Pitrou." +msgstr "" + +msgid "selectors" +msgstr "" + +msgid "" +"The new :mod:`selectors` module (created as part of implementing :pep:" +"`3156`) allows high-level and efficient I/O multiplexing, built upon the :" +"mod:`select` module primitives." +msgstr "" + +msgid "statistics" +msgstr "" + +msgid "" +"The new :mod:`statistics` module (defined in :pep:`450`) offers some core " +"statistics functionality directly in the standard library. This module " +"supports calculation of the mean, median, mode, variance and standard " +"deviation of a data series." +msgstr "" + +msgid ":pep:`450` -- Adding A Statistics Module To The Standard Library" +msgstr "" + +msgid "PEP written and implemented by Steven D'Aprano" +msgstr "" + +msgid "tracemalloc" +msgstr "" + +msgid "" +"The new :mod:`tracemalloc` module (defined in :pep:`454`) is a debug tool to " +"trace memory blocks allocated by Python. It provides the following " +"information:" +msgstr "" + +msgid "Trace where an object was allocated" +msgstr "" + +msgid "" +"Statistics on allocated memory blocks per filename and per line number: " +"total size, number and average size of allocated memory blocks" +msgstr "" + +msgid "Compute the differences between two snapshots to detect memory leaks" +msgstr "" + +msgid "" +":pep:`454` -- Add a new tracemalloc module to trace Python memory allocations" +msgstr "" + +msgid "PEP written and implemented by Victor Stinner" +msgstr "" + +msgid "Improved Modules" +msgstr "Ulepszone moduły" + +msgid "abc" +msgstr "" + +msgid "" +"New function :func:`abc.get_cache_token` can be used to know when to " +"invalidate caches that are affected by changes in the object graph. " +"(Contributed by Łukasz Langa in :issue:`16832`.)" +msgstr "" + +msgid "" +"New class :class:`~abc.ABC` has :class:`~abc.ABCMeta` as its meta class. " +"Using ``ABC`` as a base class has essentially the same effect as specifying " +"``metaclass=abc.ABCMeta``, but is simpler to type and easier to read. " +"(Contributed by Bruno Dupuis in :issue:`16049`.)" +msgstr "" + +msgid "aifc" +msgstr "" + +msgid "" +"The :meth:`~aifc.aifc.getparams` method now returns a namedtuple rather than " +"a plain tuple. (Contributed by Claudiu Popa in :issue:`17818`.)" +msgstr "" + +msgid "" +":func:`aifc.open` now supports the context management protocol: when used in " +"a :keyword:`with` block, the :meth:`~aifc.aifc.close` method of the returned " +"object will be called automatically at the end of the block. (Contributed " +"by Serhiy Storchacha in :issue:`16486`.)" +msgstr "" + +msgid "" +"The :meth:`~aifc.aifc.writeframesraw` and :meth:`~aifc.aifc.writeframes` " +"methods now accept any :term:`bytes-like object`. (Contributed by Serhiy " +"Storchaka in :issue:`8311`.)" +msgstr "" + +msgid "argparse" +msgstr "" + +msgid "" +"The :class:`~argparse.FileType` class now accepts *encoding* and *errors* " +"arguments, which are passed through to :func:`open`. (Contributed by Lucas " +"Maystre in :issue:`11175`.)" +msgstr "" + +msgid "audioop" +msgstr "" + +msgid "" +":mod:`audioop` now supports 24-bit samples. (Contributed by Serhiy " +"Storchaka in :issue:`12866`.)" +msgstr "" + +msgid "" +"New :func:`~audioop.byteswap` function converts big-endian samples to little-" +"endian and vice versa. (Contributed by Serhiy Storchaka in :issue:`19641`.)" +msgstr "" + +msgid "" +"All :mod:`audioop` functions now accept any :term:`bytes-like object`. " +"Strings are not accepted: they didn't work before, now they raise an error " +"right away. (Contributed by Serhiy Storchaka in :issue:`16685`.)" +msgstr "" + +msgid "base64" +msgstr "" + +msgid "" +"The encoding and decoding functions in :mod:`base64` now accept any :term:" +"`bytes-like object` in cases where it previously required a :class:`bytes` " +"or :class:`bytearray` instance. (Contributed by Nick Coghlan in :issue:" +"`17839`.)" +msgstr "" + +msgid "" +"New functions :func:`~base64.a85encode`, :func:`~base64.a85decode`, :func:" +"`~base64.b85encode`, and :func:`~base64.b85decode` provide the ability to " +"encode and decode binary data from and to ``Ascii85`` and the git/mercurial " +"``Base85`` formats, respectively. The ``a85`` functions have options that " +"can be used to make them compatible with the variants of the ``Ascii85`` " +"encoding, including the Adobe variant. (Contributed by Martin Morrison, the " +"Mercurial project, Serhiy Storchaka, and Antoine Pitrou in :issue:`17618`.)" +msgstr "" + +msgid "collections" +msgstr "" + +msgid "" +"The :meth:`.ChainMap.new_child` method now accepts an *m* argument " +"specifying the child map to add to the chain. This allows an existing " +"mapping and/or a custom mapping type to be used for the child. (Contributed " +"by Vinay Sajip in :issue:`16613`.)" +msgstr "" + +msgid "colorsys" +msgstr "" + +msgid "" +"The number of digits in the coefficients for the RGB --- YIQ conversions " +"have been expanded so that they match the FCC NTSC versions. The change in " +"results should be less than 1% and may better match results found elsewhere. " +"(Contributed by Brian Landers and Serhiy Storchaka in :issue:`14323`.)" +msgstr "" + +msgid "contextlib" +msgstr "" + +msgid "" +"The new :class:`contextlib.suppress` context manager helps to clarify the " +"intent of code that deliberately suppresses exceptions from a single " +"statement. (Contributed by Raymond Hettinger in :issue:`15806` and Zero " +"Piraeus in :issue:`19266`.)" +msgstr "" + +msgid "" +"The new :func:`contextlib.redirect_stdout` context manager makes it easier " +"for utility scripts to handle inflexible APIs that write their output to :" +"data:`sys.stdout` and don't provide any options to redirect it. Using the " +"context manager, the :data:`sys.stdout` output can be redirected to any " +"other stream or, in conjunction with :class:`io.StringIO`, to a string. The " +"latter can be especially useful, for example, to capture output from a " +"function that was written to implement a command line interface. It is " +"recommended only for utility scripts because it affects the global state of :" +"data:`sys.stdout`. (Contributed by Raymond Hettinger in :issue:`15805`.)" +msgstr "" + +msgid "" +"The :mod:`contextlib` documentation has also been updated to include a :ref:" +"`discussion ` of the differences " +"between single use, reusable and reentrant context managers." +msgstr "" + +msgid "dbm" +msgstr "" + +msgid "" +":func:`dbm.open` objects now support the context management protocol. When " +"used in a :keyword:`with` statement, the ``close`` method of the database " +"object will be called automatically at the end of the block. (Contributed " +"by Claudiu Popa and Nick Coghlan in :issue:`19282`.)" +msgstr "" + +msgid "dis" +msgstr "" + +msgid "" +"Functions :func:`~dis.show_code`, :func:`~dis.dis`, :func:`~dis.distb`, and :" +"func:`~dis.disassemble` now accept a keyword-only *file* argument that " +"controls where they write their output." +msgstr "" + +msgid "" +"The :mod:`dis` module is now built around an :class:`~dis.Instruction` class " +"that provides object oriented access to the details of each individual " +"bytecode operation." +msgstr "" + +msgid "" +"A new method, :func:`~dis.get_instructions`, provides an iterator that emits " +"the Instruction stream for a given piece of Python code. Thus it is now " +"possible to write a program that inspects and manipulates a bytecode object " +"in ways different from those provided by the :mod:`~dis` module itself. For " +"example::" +msgstr "" + +msgid "" +"The various display tools in the :mod:`dis` module have been rewritten to " +"use these new components." +msgstr "" + +msgid "" +"In addition, a new application-friendly class :class:`~dis.Bytecode` " +"provides an object-oriented API for inspecting bytecode in both in human-" +"readable form and for iterating over instructions. The :class:`~dis." +"Bytecode` constructor takes the same arguments that :func:`~dis." +"get_instruction` does (plus an optional *current_offset*), and the resulting " +"object can be iterated to produce :class:`~dis.Instruction` objects. But it " +"also has a :mod:`~dis.Bytecode.dis` method, equivalent to calling :mod:`~dis." +"dis` on the constructor argument, but returned as a multi-line string::" +msgstr "" + +msgid "" +":class:`~dis.Bytecode` also has a class method, :meth:`~dis.Bytecode." +"from_traceback`, that provides the ability to manipulate a traceback (that " +"is, ``print(Bytecode.from_traceback(tb).dis())`` is equivalent to " +"``distb(tb)``)." +msgstr "" + +msgid "" +"(Contributed by Nick Coghlan, Ryan Kelly and Thomas Kluyver in :issue:" +"`11816` and Claudiu Popa in :issue:`17916`.)" +msgstr "" + +msgid "" +"New function :func:`~dis.stack_effect` computes the effect on the Python " +"stack of a given opcode and argument, information that is not otherwise " +"available. (Contributed by Larry Hastings in :issue:`19722`.)" +msgstr "" + +msgid "doctest" +msgstr "" + +msgid "" +"A new :ref:`option flag `, :const:`~doctest.FAIL_FAST`, " +"halts test running as soon as the first failure is detected. (Contributed " +"by R. David Murray and Daniel Urban in :issue:`16522`.)" +msgstr "" + +msgid "" +"The :mod:`doctest` command line interface now uses :mod:`argparse`, and has " +"two new options, ``-o`` and ``-f``. ``-o`` allows :ref:`doctest options " +"` to be specified on the command line, and ``-f`` is a " +"shorthand for ``-o FAIL_FAST`` (to parallel the similar option supported by " +"the :mod:`unittest` CLI). (Contributed by R. David Murray in :issue:" +"`11390`.)" +msgstr "" + +msgid "" +":mod:`doctest` will now find doctests in extension module ``__doc__`` " +"strings. (Contributed by Zachary Ware in :issue:`3158`.)" +msgstr "" + +msgid "email" +msgstr "" + +msgid "" +":meth:`~email.message.Message.as_string` now accepts a *policy* argument to " +"override the default policy of the message when generating a string " +"representation of it. This means that ``as_string`` can now be used in more " +"circumstances, instead of having to create and use a :mod:`~email.generator` " +"in order to pass formatting parameters to its ``flatten`` method. " +"(Contributed by R. David Murray in :issue:`18600`.)" +msgstr "" + +msgid "" +"New method :meth:`~email.message.Message.as_bytes` added to produce a bytes " +"representation of the message in a fashion similar to how ``as_string`` " +"produces a string representation. It does not accept the *maxheaderlen* " +"argument, but does accept the *unixfrom* and *policy* arguments. The :class:" +"`~email.message.Message` :meth:`~email.message.Message.__bytes__` method " +"calls it, meaning that ``bytes(mymsg)`` will now produce the intuitive " +"result: a bytes object containing the fully formatted message. " +"(Contributed by R. David Murray in :issue:`18600`.)" +msgstr "" + +msgid "" +"The :meth:`.Message.set_param` message now accepts a *replace* keyword " +"argument. When specified, the associated header will be updated without " +"changing its location in the list of headers. For backward compatibility, " +"the default is ``False``. (Contributed by R. David Murray in :issue:" +"`18891`.)" +msgstr "" + +msgid "" +"A pair of new subclasses of :class:`~email.message.Message` have been added " +"(:class:`.EmailMessage` and :class:`.MIMEPart`), along with a new sub-" +"module, :mod:`~email.contentmanager` and a new :mod:`~email.policy` " +"attribute :attr:`~email.policy.EmailPolicy.content_manager`. All " +"documentation is currently in the new module, which is being added as part " +"of email's new :term:`provisional API`. These classes provide a number of " +"new methods that make extracting content from and inserting content into " +"email messages much easier. For details, see the :mod:`~email." +"contentmanager` documentation and the :ref:`email-examples`. These API " +"additions complete the bulk of the work that was planned as part of the " +"email6 project. The currently provisional API is scheduled to become final " +"in Python 3.5 (possibly with a few minor additions in the area of error " +"handling). (Contributed by R. David Murray in :issue:`18891`.)" +msgstr "" + +msgid "filecmp" +msgstr "" + +msgid "" +"A new :func:`~filecmp.clear_cache` function provides the ability to clear " +"the :mod:`filecmp` comparison cache, which uses :func:`os.stat` information " +"to determine if the file has changed since the last compare. This can be " +"used, for example, if the file might have been changed and re-checked in " +"less time than the resolution of a particular filesystem's file modification " +"time field. (Contributed by Mark Levitt in :issue:`18149`.)" +msgstr "" + +msgid "" +"New module attribute :const:`~filecmp.DEFAULT_IGNORES` provides the list of " +"directories that are used as the default value for the *ignore* parameter of " +"the :func:`~filecmp.dircmp` function. (Contributed by Eli Bendersky in :" +"issue:`15442`.)" +msgstr "" + +msgid "functools" +msgstr "" + +msgid "" +"The new :func:`~functools.partialmethod` descriptor brings partial argument " +"application to descriptors, just as :func:`~functools.partial` provides for " +"normal callables. The new descriptor also makes it easier to get arbitrary " +"callables (including :func:`~functools.partial` instances) to behave like " +"normal instance methods when included in a class definition. (Contributed by " +"Alon Horev and Nick Coghlan in :issue:`4331`.)" +msgstr "" + +msgid "" +"The new :func:`~functools.singledispatch` decorator brings support for " +"single-dispatch generic functions to the Python standard library. Where " +"object oriented programming focuses on grouping multiple operations on a " +"common set of data into a class, a generic function focuses on grouping " +"multiple implementations of an operation that allows it to work with " +"*different* kinds of data." +msgstr "" + +msgid ":pep:`443` -- Single-dispatch generic functions" +msgstr "" + +msgid "PEP written and implemented by Łukasz Langa." +msgstr "" + +msgid "" +":func:`~functools.total_ordering` now supports a return value of :data:" +"`NotImplemented` from the underlying comparison function. (Contributed by " +"Katie Miller in :issue:`10042`.)" +msgstr "" + +msgid "" +"A pure-python version of the :func:`~functools.partial` function is now in " +"the stdlib; in CPython it is overridden by the C accelerated version, but it " +"is available for other implementations to use. (Contributed by Brian Thorne " +"in :issue:`12428`.)" +msgstr "" + +msgid "gc" +msgstr "" + +msgid "" +"New function :func:`~gc.get_stats` returns a list of three per-generation " +"dictionaries containing the collections statistics since interpreter " +"startup. (Contributed by Antoine Pitrou in :issue:`16351`.)" +msgstr "" + +msgid "glob" +msgstr "" + +msgid "" +"A new function :func:`~glob.escape` provides a way to escape special " +"characters in a filename so that they do not become part of the globbing " +"expansion but are instead matched literally. (Contributed by Serhiy " +"Storchaka in :issue:`8402`.)" +msgstr "" + +msgid "hashlib" +msgstr "" + +msgid "" +"A new :func:`hashlib.pbkdf2_hmac` function provides the `PKCS#5 password-" +"based key derivation function 2 `_. " +"(Contributed by Christian Heimes in :issue:`18582`.)" +msgstr "" + +msgid "" +"The :attr:`~hashlib.hash.name` attribute of :mod:`hashlib` hash objects is " +"now a formally supported interface. It has always existed in CPython's :mod:" +"`hashlib` (although it did not return lower case names for all supported " +"hashes), but it was not a public interface and so some other Python " +"implementations have not previously supported it. (Contributed by Jason R. " +"Coombs in :issue:`18532`.)" +msgstr "" + +msgid "hmac" +msgstr "" + +msgid "" +":mod:`hmac` now accepts ``bytearray`` as well as ``bytes`` for the *key* " +"argument to the :func:`~hmac.new` function, and the *msg* parameter to both " +"the :func:`~hmac.new` function and the :meth:`~hmac.HMAC.update` method now " +"accepts any type supported by the :mod:`hashlib` module. (Contributed by " +"Jonas Borgström in :issue:`18240`.)" +msgstr "" + +msgid "" +"The *digestmod* argument to the :func:`hmac.new` function may now be any " +"hash digest name recognized by :mod:`hashlib`. In addition, the current " +"behavior in which the value of *digestmod* defaults to ``MD5`` is " +"deprecated: in a future version of Python there will be no default value. " +"(Contributed by Christian Heimes in :issue:`17276`.)" +msgstr "" + +msgid "" +"With the addition of :attr:`~hmac.HMAC.block_size` and :attr:`~hmac.HMAC." +"name` attributes (and the formal documentation of the :attr:`~hmac.HMAC." +"digest_size` attribute), the :mod:`hmac` module now conforms fully to the :" +"pep:`247` API. (Contributed by Christian Heimes in :issue:`18775`.)" +msgstr "" + +msgid "html" +msgstr "" + +msgid "" +"New function :func:`~html.unescape` function converts HTML5 character " +"references to the corresponding Unicode characters. (Contributed by Ezio " +"Melotti in :issue:`2927`.)" +msgstr "" + +msgid "" +":class:`~html.parser.HTMLParser` accepts a new keyword argument " +"*convert_charrefs* that, when ``True``, automatically converts all character " +"references. For backward-compatibility, its value defaults to ``False``, " +"but it will change to ``True`` in a future version of Python, so you are " +"invited to set it explicitly and update your code to use this new feature. " +"(Contributed by Ezio Melotti in :issue:`13633`.)" +msgstr "" + +msgid "" +"The *strict* argument of :class:`~html.parser.HTMLParser` is now deprecated. " +"(Contributed by Ezio Melotti in :issue:`15114`.)" +msgstr "" + +msgid "http" +msgstr "" + +msgid "" +":meth:`~http.server.BaseHTTPRequestHandler.send_error` now accepts an " +"optional additional *explain* parameter which can be used to provide an " +"extended error description, overriding the hardcoded default if there is " +"one. This extended error description will be formatted using the :attr:" +"`~http.server.HTTP.error_message_format` attribute and sent as the body of " +"the error response. (Contributed by Karl Cow in :issue:`12921`.)" +msgstr "" + +msgid "" +"The :mod:`http.server` :ref:`command line interface ` now " +"has a ``-b/--bind`` option that causes the server to listen on a specific " +"address. (Contributed by Malte Swart in :issue:`17764`.)" +msgstr "" + +msgid "idlelib and IDLE" +msgstr "" + +msgid "" +"Since idlelib implements the IDLE shell and editor and is not intended for " +"import by other programs, it gets improvements with every release. See :file:" +"`Lib/idlelib/NEWS.txt` for a cumulative list of changes since 3.3.0, as well " +"as changes made in future 3.4.x releases. This file is also available from " +"the IDLE :menuselection:`Help --> About IDLE` dialog." +msgstr "" + +msgid "importlib" +msgstr "" + +msgid "" +"The :class:`~importlib.abc.InspectLoader` ABC defines a new method, :meth:" +"`~importlib.abc.InspectLoader.source_to_code` that accepts source data and a " +"path and returns a code object. The default implementation is equivalent to " +"``compile(data, path, 'exec', dont_inherit=True)``. (Contributed by Eric " +"Snow and Brett Cannon in :issue:`15627`.)" +msgstr "" + +msgid "" +":class:`~importlib.abc.InspectLoader` also now has a default implementation " +"for the :meth:`~importlib.abc.InspectLoader.get_code` method. However, it " +"will normally be desirable to override the default implementation for " +"performance reasons. (Contributed by Brett Cannon in :issue:`18072`.)" +msgstr "" + +msgid "" +"The :func:`~importlib.reload` function has been moved from :mod:`imp` to :" +"mod:`importlib` as part of the :mod:`imp` module deprecation. (Contributed " +"by Berker Peksag in :issue:`18193`.)" +msgstr "" + +msgid "" +":mod:`importlib.util` now has a :data:`~importlib.util.MAGIC_NUMBER` " +"attribute providing access to the bytecode version number. This replaces " +"the :func:`~imp.get_magic` function in the deprecated :mod:`imp` module. " +"(Contributed by Brett Cannon in :issue:`18192`.)" +msgstr "" + +msgid "" +"New :mod:`importlib.util` functions :func:`~importlib.util." +"cache_from_source` and :func:`~importlib.util.source_from_cache` replace the " +"same-named functions in the deprecated :mod:`imp` module. (Contributed by " +"Brett Cannon in :issue:`18194`.)" +msgstr "" + +msgid "" +"The :mod:`importlib` bootstrap :class:`.NamespaceLoader` now conforms to " +"the :class:`.InspectLoader` ABC, which means that ``runpy`` and ``python -" +"m`` can now be used with namespace packages. (Contributed by Brett Cannon " +"in :issue:`18058`.)" +msgstr "" + +msgid "" +":mod:`importlib.util` has a new function :func:`~importlib.util." +"decode_source` that decodes source from bytes using universal newline " +"processing. This is useful for implementing :meth:`.InspectLoader." +"get_source` methods." +msgstr "" + +msgid "" +":class:`importlib.machinery.ExtensionFileLoader` now has a :meth:`~importlib." +"machinery.ExtensionFileLoader.get_filename` method. This was inadvertently " +"omitted in the original implementation. (Contributed by Eric Snow in :issue:" +"`19152`.)" +msgstr "" + +msgid "inspect" +msgstr "" + +msgid "" +"The :mod:`inspect` module now offers a basic :ref:`command line interface " +"` to quickly display source code and other information " +"for modules, classes and functions. (Contributed by Claudiu Popa and Nick " +"Coghlan in :issue:`18626`.)" +msgstr "" + +msgid "" +":func:`~inspect.unwrap` makes it easy to unravel wrapper function chains " +"created by :func:`functools.wraps` (and any other API that sets the " +"``__wrapped__`` attribute on a wrapper function). (Contributed by Daniel " +"Urban, Aaron Iles and Nick Coghlan in :issue:`13266`.)" +msgstr "" + +msgid "" +"As part of the implementation of the new :mod:`enum` module, the :mod:" +"`inspect` module now has substantially better support for custom ``__dir__`` " +"methods and dynamic class attributes provided through metaclasses. " +"(Contributed by Ethan Furman in :issue:`18929` and :issue:`19030`.)" +msgstr "" + +msgid "" +":func:`~inspect.getfullargspec` and :func:`~inspect.getargspec` now use the :" +"func:`~inspect.signature` API. This allows them to support a much broader " +"range of callables, including those with ``__signature__`` attributes, those " +"with metadata provided by argument clinic, :func:`functools.partial` objects " +"and more. Note that, unlike :func:`~inspect.signature`, these functions " +"still ignore ``__wrapped__`` attributes, and report the already bound first " +"argument for bound methods, so it is still necessary to update your code to " +"use :func:`~inspect.signature` directly if those features are desired. " +"(Contributed by Yury Selivanov in :issue:`17481`.)" +msgstr "" + +msgid "" +":func:`~inspect.signature` now supports duck types of CPython functions, " +"which adds support for functions compiled with Cython. (Contributed by " +"Stefan Behnel and Yury Selivanov in :issue:`17159`.)" +msgstr "" + +msgid "ipaddress" +msgstr "" + +msgid "" +":mod:`ipaddress` was added to the standard library in Python 3.3 as a :term:" +"`provisional API`. With the release of Python 3.4, this qualification has " +"been removed: :mod:`ipaddress` is now considered a stable API, covered by " +"the normal standard library requirements to maintain backwards compatibility." +msgstr "" + +msgid "" +"A new :attr:`~ipaddress.IPv4Address.is_global` property is ``True`` if an " +"address is globally routeable. (Contributed by Peter Moody in :issue:" +"`17400`.)" +msgstr "" + +msgid "logging" +msgstr "" + +msgid "" +"The :class:`~logging.handlers.TimedRotatingFileHandler` has a new *atTime* " +"parameter that can be used to specify the time of day when rollover should " +"happen. (Contributed by Ronald Oussoren in :issue:`9556`.)" +msgstr "" + +msgid "" +":class:`~logging.handlers.SocketHandler` and :class:`~logging.handlers." +"DatagramHandler` now support Unix domain sockets (by setting *port* to " +"``None``). (Contributed by Vinay Sajip in commit ce46195b56a9.)" +msgstr "" + +msgid "" +":func:`~logging.config.fileConfig` now accepts a :class:`configparser." +"RawConfigParser` subclass instance for the *fname* parameter. This " +"facilitates using a configuration file when logging configuration is just a " +"part of the overall application configuration, or where the application " +"modifies the configuration before passing it to :func:`~logging.config." +"fileConfig`. (Contributed by Vinay Sajip in :issue:`16110`.)" +msgstr "" + +msgid "" +"Logging configuration data received from a socket via the :func:`logging." +"config.listen` function can now be validated before being processed by " +"supplying a verification function as the argument to the new *verify* " +"keyword argument. (Contributed by Vinay Sajip in :issue:`15452`.)" +msgstr "" + +msgid "marshal" +msgstr "" + +msgid "" +"The default :mod:`marshal` version has been bumped to 3. The code " +"implementing the new version restores the Python2 behavior of recording only " +"one copy of interned strings and preserving the interning on " +"deserialization, and extends this \"one copy\" ability to any object type " +"(including handling recursive references). This reduces both the size of ``." +"pyc`` files and the amount of memory a module occupies in memory when it is " +"loaded from a ``.pyc`` (or ``.pyo``) file. (Contributed by Kristján Valur " +"Jónsson in :issue:`16475`, with additional speedups by Antoine Pitrou in :" +"issue:`19219`.)" +msgstr "" + +msgid "mmap" +msgstr "" + +msgid "" +"mmap objects are now :ref:`weakly referenceable `. (Contributed " +"by Valerie Lambert in :issue:`4885`.)" +msgstr "" + +msgid "multiprocessing" +msgstr "" + +msgid "" +"On Unix two new :ref:`start methods `, " +"``spawn`` and ``forkserver``, have been added for starting processes using :" +"mod:`multiprocessing`. These make the mixing of processes with threads more " +"robust, and the ``spawn`` method matches the semantics that multiprocessing " +"has always used on Windows. New function :func:`~multiprocessing." +"get_all_start_methods` reports all start methods available on the platform, :" +"func:`~multiprocessing.get_start_method` reports the current start method, " +"and :func:`~multiprocessing.set_start_method` sets the start method. " +"(Contributed by Richard Oudkerk in :issue:`8713`.)" +msgstr "" + +msgid "" +":mod:`multiprocessing` also now has the concept of a ``context``, which " +"determines how child processes are created. New function :func:" +"`~multiprocessing.get_context` returns a context that uses a specified start " +"method. It has the same API as the :mod:`multiprocessing` module itself, so " +"you can use it to create :class:`~multiprocessing.pool.Pool`\\ s and other " +"objects that will operate within that context. This allows a framework and " +"an application or different parts of the same application to use " +"multiprocessing without interfering with each other. (Contributed by " +"Richard Oudkerk in :issue:`18999`.)" +msgstr "" + +msgid "" +"Except when using the old *fork* start method, child processes no longer " +"inherit unneeded handles/file descriptors from their parents (part of :issue:" +"`8713`)." +msgstr "" + +msgid "" +":mod:`multiprocessing` now relies on :mod:`runpy` (which implements the ``-" +"m`` switch) to initialise ``__main__`` appropriately in child processes when " +"using the ``spawn`` or ``forkserver`` start methods. This resolves some edge " +"cases where combining multiprocessing, the ``-m`` command line switch, and " +"explicit relative imports could cause obscure failures in child processes. " +"(Contributed by Nick Coghlan in :issue:`19946`.)" +msgstr "" + +msgid "operator" +msgstr "" + +msgid "" +"New function :func:`~operator.length_hint` provides an implementation of the " +"specification for how the :meth:`~object.__length_hint__` special method " +"should be used, as part of the :pep:`424` formal specification of this " +"language feature. (Contributed by Armin Ronacher in :issue:`16148`.)" +msgstr "" + +msgid "" +"There is now a pure-python version of the :mod:`operator` module available " +"for reference and for use by alternate implementations of Python. " +"(Contributed by Zachary Ware in :issue:`16694`.)" +msgstr "" + +msgid "os" +msgstr "" + +msgid "" +"There are new functions to get and set the :ref:`inheritable flag " +"` of a file descriptor (:func:`os.get_inheritable`, :func:" +"`os.set_inheritable`) or a Windows handle (:func:`os." +"get_handle_inheritable`, :func:`os.set_handle_inheritable`)." +msgstr "" + +msgid "" +"New function :func:`~os.cpu_count` reports the number of CPUs available on " +"the platform on which Python is running (or ``None`` if the count can't be " +"determined). The :func:`multiprocessing.cpu_count` function is now " +"implemented in terms of this function). (Contributed by Trent Nelson, " +"Yogesh Chaudhari, Victor Stinner, and Charles-François Natali in :issue:" +"`17914`.)" +msgstr "" + +msgid "" +":func:`os.path.samestat` is now available on the Windows platform (and the :" +"func:`os.path.samefile` implementation is now shared between Unix and " +"Windows). (Contributed by Brian Curtin in :issue:`11939`.)" +msgstr "" + +msgid "" +":func:`os.path.ismount` now recognizes volumes mounted below a drive root on " +"Windows. (Contributed by Tim Golden in :issue:`9035`.)" +msgstr "" + +msgid "" +":func:`os.open` supports two new flags on platforms that provide them, :" +"const:`~os.O_PATH` (un-opened file descriptor), and :const:`~os.O_TMPFILE` " +"(unnamed temporary file; as of 3.4.0 release available only on Linux systems " +"with a kernel version of 3.11 or newer that have uapi headers). " +"(Contributed by Christian Heimes in :issue:`18673` and Benjamin Peterson, " +"respectively.)" +msgstr "" + +msgid "pdb" +msgstr "" + +msgid "" +":mod:`pdb` has been enhanced to handle generators, :keyword:`yield`, and " +"``yield from`` in a more useful fashion. This is especially helpful when " +"debugging :mod:`asyncio` based programs. (Contributed by Andrew Svetlov and " +"Xavier de Gaye in :issue:`16596`.)" +msgstr "" + +msgid "" +"The ``print`` command has been removed from :mod:`pdb`, restoring access to " +"the Python :func:`print` function from the pdb command line. Python2's " +"``pdb`` did not have a ``print`` command; instead, entering ``print`` " +"executed the ``print`` statement. In Python3 ``print`` was mistakenly made " +"an alias for the pdb :pdbcmd:`p` command. ``p``, however, prints the " +"``repr`` of its argument, not the ``str`` like the Python2 ``print`` command " +"did. Worse, the Python3 ``pdb print`` command shadowed the Python3 " +"``print`` function, making it inaccessible at the ``pdb`` prompt. " +"(Contributed by Connor Osborn in :issue:`18764`.)" +msgstr "" + +msgid "pickle" +msgstr "" + +msgid "" +":mod:`pickle` now supports (but does not use by default) a new pickle " +"protocol, protocol 4. This new protocol addresses a number of issues that " +"were present in previous protocols, such as the serialization of nested " +"classes, very large strings and containers, and classes whose :meth:" +"`__new__` method takes keyword-only arguments. It also provides some " +"efficiency improvements." +msgstr "" + +msgid ":pep:`3154` -- Pickle protocol 4" +msgstr "" + +msgid "PEP written by Antoine Pitrou and implemented by Alexandre Vassalotti." +msgstr "" + +msgid "plistlib" +msgstr "" + +msgid "" +":mod:`plistlib` now has an API that is similar to the standard pattern for " +"stdlib serialization protocols, with new :func:`~plistlib.load`, :func:" +"`~plistlib.dump`, :func:`~plistlib.loads`, and :func:`~plistlib.dumps` " +"functions. (The older API is now deprecated.) In addition to the already " +"supported XML plist format (:const:`~plistlib.FMT_XML`), it also now " +"supports the binary plist format (:const:`~plistlib.FMT_BINARY`). " +"(Contributed by Ronald Oussoren and others in :issue:`14455`.)" +msgstr "" + +msgid "poplib" +msgstr "" + +msgid "" +"Two new methods have been added to :mod:`poplib`: :meth:`~poplib.POP3.capa`, " +"which returns the list of capabilities advertised by the POP server, and :" +"meth:`~poplib.POP3.stls`, which switches a clear-text POP3 session into an " +"encrypted POP3 session if the POP server supports it. (Contributed by " +"Lorenzo Catucci in :issue:`4473`.)" +msgstr "" + +msgid "pprint" +msgstr "" + +msgid "" +"The :mod:`pprint` module's :class:`~pprint.PrettyPrinter` class and its :" +"func:`~pprint.pformat`, and :func:`~pprint.pprint` functions have a new " +"option, *compact*, that controls how the output is formatted. Currently " +"setting *compact* to ``True`` means that sequences will be printed with as " +"many sequence elements as will fit within *width* on each (indented) line. " +"(Contributed by Serhiy Storchaka in :issue:`19132`.)" +msgstr "" + +msgid "" +"Long strings are now wrapped using Python's normal line continuation " +"syntax. (Contributed by Antoine Pitrou in :issue:`17150`.)" +msgstr "" + +msgid "pty" +msgstr "" + +msgid "" +":func:`pty.spawn` now returns the status value from :func:`os.waitpid` on " +"the child process, instead of ``None``. (Contributed by Gregory P. Smith.)" +msgstr "" + +msgid "pydoc" +msgstr "" + +msgid "" +"The :mod:`pydoc` module is now based directly on the :func:`inspect." +"signature` introspection API, allowing it to provide signature information " +"for a wider variety of callable objects. This change also means that " +"``__wrapped__`` attributes are now taken into account when displaying help " +"information. (Contributed by Larry Hastings in :issue:`19674`.)" +msgstr "" + +msgid "" +"The :mod:`pydoc` module no longer displays the ``self`` parameter for " +"already bound methods. Instead, it aims to always display the exact current " +"signature of the supplied callable. (Contributed by Larry Hastings in :" +"issue:`20710`.)" +msgstr "" + +msgid "" +"In addition to the changes that have been made to :mod:`pydoc` directly, its " +"handling of custom ``__dir__`` methods and various descriptor behaviours has " +"also been improved substantially by the underlying changes in the :mod:" +"`inspect` module." +msgstr "" + +msgid "" +"As the :func:`help` builtin is based on :mod:`pydoc`, the above changes also " +"affect the behaviour of :func:`help`." +msgstr "" + +msgid "re" +msgstr "" + +msgid "" +"New :func:`~re.fullmatch` function and :meth:`.regex.fullmatch` method " +"anchor the pattern at both ends of the string to match. This provides a way " +"to be explicit about the goal of the match, which avoids a class of subtle " +"bugs where ``$`` characters get lost during code changes or the addition of " +"alternatives to an existing regular expression. (Contributed by Matthew " +"Barnett in :issue:`16203`.)" +msgstr "" + +msgid "" +"The repr of :ref:`regex objects ` now includes the pattern and " +"the flags; the repr of :ref:`match objects ` now includes the " +"start, end, and the part of the string that matched. (Contributed by Hugo " +"Lopes Tavares and Serhiy Storchaka in :issue:`13592` and :issue:`17087`.)" +msgstr "" + +msgid "resource" +msgstr "" + +msgid "" +"New :func:`~resource.prlimit` function, available on Linux platforms with a " +"kernel version of 2.6.36 or later and glibc of 2.13 or later, provides the " +"ability to query or set the resource limits for processes other than the one " +"making the call. (Contributed by Christian Heimes in :issue:`16595`.)" +msgstr "" + +msgid "" +"On Linux kernel version 2.6.36 or later, there are also some new Linux " +"specific constants: :const:`~resource.RLIMIT_MSGQUEUE`, :const:`~resource." +"RLIMIT_NICE`, :const:`~resource.RLIMIT_RTPRIO`, :const:`~resource." +"RLIMIT_RTTIME`, and :const:`~resource.RLIMIT_SIGPENDING`. (Contributed by " +"Christian Heimes in :issue:`19324`.)" +msgstr "" + +msgid "" +"On FreeBSD version 9 and later, there some new FreeBSD specific constants: :" +"const:`~resource.RLIMIT_SBSIZE`, :const:`~resource.RLIMIT_SWAP`, and :const:" +"`~resource.RLIMIT_NPTS`. (Contributed by Claudiu Popa in :issue:`19343`.)" +msgstr "" + +msgid "select" +msgstr "" + +msgid "" +":class:`~select.epoll` objects now support the context management protocol. " +"When used in a :keyword:`with` statement, the :meth:`~select.epoll.close` " +"method will be called automatically at the end of the block. (Contributed " +"by Serhiy Storchaka in :issue:`16488`.)" +msgstr "" + +msgid "" +":class:`~select.devpoll` objects now have :meth:`~select.devpoll.fileno` " +"and :meth:`~select.devpoll.close` methods, as well as a new attribute :attr:" +"`~select.devpoll.closed`. (Contributed by Victor Stinner in :issue:`18794`.)" +msgstr "" + +msgid "shelve" +msgstr "" + +msgid "" +":class:`~shelve.Shelf` instances may now be used in :keyword:`with` " +"statements, and will be automatically closed at the end of the :keyword:`!" +"with` block. (Contributed by Filip Gruszczyński in :issue:`13896`.)" +msgstr "" + +msgid "shutil" +msgstr "" + +msgid "" +":func:`~shutil.copyfile` now raises a specific :exc:`~shutil.Error` " +"subclass, :exc:`~shutil.SameFileError`, when the source and destination are " +"the same file, which allows an application to take appropriate action on " +"this specific error. (Contributed by Atsuo Ishimoto and Hynek Schlawack in :" +"issue:`1492704`.)" +msgstr "" + +msgid "smtpd" +msgstr "" + +msgid "" +"The :class:`~smtpd.SMTPServer` and :class:`~smtpd.SMTPChannel` classes now " +"accept a *map* keyword argument which, if specified, is passed in to :class:" +"`asynchat.async_chat` as its *map* argument. This allows an application to " +"avoid affecting the global socket map. (Contributed by Vinay Sajip in :" +"issue:`11959`.)" +msgstr "" + +msgid "smtplib" +msgstr "" + +msgid "" +":exc:`~smtplib.SMTPException` is now a subclass of :exc:`OSError`, which " +"allows both socket level errors and SMTP protocol level errors to be caught " +"in one try/except statement by code that only cares whether or not an error " +"occurred. (Contributed by Ned Jackson Lovely in :issue:`2118`.)" +msgstr "" + +msgid "socket" +msgstr "" + +msgid "" +"The socket module now supports the :const:`~socket.CAN_BCM` protocol on " +"platforms that support it. (Contributed by Brian Thorne in :issue:`15359`.)" +msgstr "" + +msgid "" +"Socket objects have new methods to get or set their :ref:`inheritable flag " +"`, :meth:`~socket.socket.get_inheritable` and :meth:`~socket." +"socket.set_inheritable`." +msgstr "" + +msgid "" +"The ``socket.AF_*`` and ``socket.SOCK_*`` constants are now enumeration " +"values using the new :mod:`enum` module. This allows meaningful names to be " +"printed during debugging, instead of integer \"magic numbers\"." +msgstr "" + +msgid "The :const:`~socket.AF_LINK` constant is now available on BSD and OSX." +msgstr "" + +msgid "" +":func:`~socket.inet_pton` and :func:`~socket.inet_ntop` are now supported on " +"Windows. (Contributed by Atsuo Ishimoto in :issue:`7171`.)" +msgstr "" + +msgid "sqlite3" +msgstr "" + +msgid "" +"A new boolean parameter to the :func:`~sqlite3.connect` function, *uri*, can " +"be used to indicate that the *database* parameter is a ``uri`` (see the " +"`SQLite URI documentation `_). " +"(Contributed by poq in :issue:`13773`.)" +msgstr "" + +msgid "ssl" +msgstr "" + +msgid "" +":data:`~ssl.PROTOCOL_TLSv1_1` and :data:`~ssl.PROTOCOL_TLSv1_2` (TLSv1.1 and " +"TLSv1.2 support) have been added; support for these protocols is only " +"available if Python is linked with OpenSSL 1.0.1 or later. (Contributed by " +"Michele Orrù and Antoine Pitrou in :issue:`16692`.)" +msgstr "" + +msgid "" +"New function :func:`~ssl.create_default_context` provides a standard way to " +"obtain an :class:`~ssl.SSLContext` whose settings are intended to be a " +"reasonable balance between compatibility and security. These settings are " +"more stringent than the defaults provided by the :class:`~ssl.SSLContext` " +"constructor, and may be adjusted in the future, without prior deprecation, " +"if best-practice security requirements change. The new recommended best " +"practice for using stdlib libraries that support SSL is to use :func:`~ssl." +"create_default_context` to obtain an :class:`~ssl.SSLContext` object, modify " +"it if needed, and then pass it as the *context* argument of the appropriate " +"stdlib API. (Contributed by Christian Heimes in :issue:`19689`.)" +msgstr "" + +msgid "" +":class:`~ssl.SSLContext` method :meth:`~ssl.SSLContext." +"load_verify_locations` accepts a new optional argument *cadata*, which can " +"be used to provide PEM or DER encoded certificates directly via strings or " +"bytes, respectively. (Contributed by Christian Heimes in :issue:`18138`.)" +msgstr "" + +msgid "" +"New function :func:`~ssl.get_default_verify_paths` returns a named tuple of " +"the paths and environment variables that the :meth:`~ssl.SSLContext." +"set_default_verify_paths` method uses to set OpenSSL's default ``cafile`` " +"and ``capath``. This can be an aid in debugging default verification " +"issues. (Contributed by Christian Heimes in :issue:`18143`.)" +msgstr "" + +msgid "" +":class:`~ssl.SSLContext` has a new method, :meth:`~ssl.SSLContext." +"cert_store_stats`, that reports the number of loaded ``X.509`` certs, " +"``X.509 CA`` certs, and certificate revocation lists (``crl``\\ s), as well " +"as a :meth:`~ssl.SSLContext.get_ca_certs` method that returns a list of the " +"loaded ``CA`` certificates. (Contributed by Christian Heimes in :issue:" +"`18147`.)" +msgstr "" + +msgid "" +"If OpenSSL 0.9.8 or later is available, :class:`~ssl.SSLContext` has a new " +"attribute :attr:`~ssl.SSLContext.verify_flags` that can be used to control " +"the certificate verification process by setting it to some combination of " +"the new constants :const:`~ssl.VERIFY_DEFAULT`, :const:`~ssl." +"VERIFY_CRL_CHECK_LEAF`, :const:`~ssl.VERIFY_CRL_CHECK_CHAIN`, or :const:" +"`~ssl.VERIFY_X509_STRICT`. OpenSSL does not do any CRL verification by " +"default. (Contributed by Christien Heimes in :issue:`8813`.)" +msgstr "" + +msgid "" +"New :class:`~ssl.SSLContext` method :meth:`~ssl.SSLContext." +"load_default_certs` loads a set of default \"certificate authority\" (CA) " +"certificates from default locations, which vary according to the platform. " +"It can be used to load both TLS web server authentication certificates " +"(``purpose=``:data:`~ssl.Purpose.SERVER_AUTH`) for a client to use to verify " +"a server, and certificates for a server to use in verifying client " +"certificates (``purpose=``:data:`~ssl.Purpose.CLIENT_AUTH`). (Contributed " +"by Christian Heimes in :issue:`19292`.)" +msgstr "" + +msgid "" +"Two new windows-only functions, :func:`~ssl.enum_certificates` and :func:" +"`~ssl.enum_crls` provide the ability to retrieve certificates, certificate " +"information, and CRLs from the Windows cert store. (Contributed by " +"Christian Heimes in :issue:`17134`.)" +msgstr "" + +msgid "" +"Support for server-side SNI (Server Name Indication) using the new :meth:" +"`ssl.SSLContext.set_servername_callback` method. (Contributed by Daniel " +"Black in :issue:`8109`.)" +msgstr "" + +msgid "" +"The dictionary returned by :meth:`.SSLSocket.getpeercert` contains " +"additional ``X509v3`` extension items: ``crlDistributionPoints``, " +"``calIssuers``, and ``OCSP`` URIs. (Contributed by Christian Heimes in :" +"issue:`18379`.)" +msgstr "" + +msgid "stat" +msgstr "" + +msgid "" +"The :mod:`stat` module is now backed by a C implementation in :mod:`_stat`. " +"A C implementation is required as most of the values aren't standardized and " +"are platform-dependent. (Contributed by Christian Heimes in :issue:`11016`.)" +msgstr "" + +msgid "" +"The module supports new :mod:`~stat.ST_MODE` flags, :mod:`~stat.S_IFDOOR`, :" +"const:`~stat.S_IFPORT`, and :const:`~stat.S_IFWHT`. (Contributed by " +"Christian Hiemes in :issue:`11016`.)" +msgstr "" + +msgid "struct" +msgstr "" + +msgid "" +"New function :mod:`~struct.iter_unpack` and a new :meth:`struct.Struct." +"iter_unpack` method on compiled formats provide streamed unpacking of a " +"buffer containing repeated instances of a given format of data. (Contributed " +"by Antoine Pitrou in :issue:`17804`.)" +msgstr "" + +msgid "subprocess" +msgstr "" + +msgid "" +":func:`~subprocess.check_output` now accepts an *input* argument that can be " +"used to provide the contents of ``stdin`` for the command that is run. " +"(Contributed by Zack Weinberg in :issue:`16624`.)" +msgstr "" + +msgid "" +":func:`~subprocess.getstatus` and :func:`~subprocess.getstatusoutput` now " +"work on Windows. This change was actually inadvertently made in 3.3.4. " +"(Contributed by Tim Golden in :issue:`10197`.)" +msgstr "" + +msgid "sunau" +msgstr "" + +msgid "" +"The :meth:`~sunau.getparams` method now returns a namedtuple rather than a " +"plain tuple. (Contributed by Claudiu Popa in :issue:`18901`.)" +msgstr "" + +msgid "" +":meth:`sunau.open` now supports the context management protocol: when used " +"in a :keyword:`with` block, the ``close`` method of the returned object will " +"be called automatically at the end of the block. (Contributed by Serhiy " +"Storchaka in :issue:`18878`.)" +msgstr "" + +msgid "" +":meth:`.AU_write.setsampwidth` now supports 24 bit samples, thus adding " +"support for writing 24 sample using the module. (Contributed by Serhiy " +"Storchaka in :issue:`19261`.)" +msgstr "" + +msgid "" +"The :meth:`~sunau.AU_write.writeframesraw` and :meth:`~sunau.AU_write." +"writeframes` methods now accept any :term:`bytes-like object`. (Contributed " +"by Serhiy Storchaka in :issue:`8311`.)" +msgstr "" + +msgid "sys" +msgstr "sys" + +msgid "" +"New function :func:`sys.getallocatedblocks` returns the current number of " +"blocks allocated by the interpreter. (In CPython with the default ``--with-" +"pymalloc`` setting, this is allocations made through the :c:func:" +"`PyObject_Malloc` API.) This can be useful for tracking memory leaks, " +"especially if automated via a test suite. (Contributed by Antoine Pitrou " +"in :issue:`13390`.)" +msgstr "" + +msgid "" +"When the Python interpreter starts in :ref:`interactive mode `, it checks for an :data:`~sys.__interactivehook__` attribute " +"on the :mod:`sys` module. If the attribute exists, its value is called with " +"no arguments just before interactive mode is started. The check is made " +"after the :envvar:`PYTHONSTARTUP` file is read, so it can be set there. " +"The :mod:`site` module :ref:`sets it ` to a function " +"that enables tab completion and history saving (in :file:`~/.python-" +"history`) if the platform supports :mod:`readline`. If you do not want this " +"(new) behavior, you can override it in :envvar:`PYTHONSTARTUP`, :mod:" +"`sitecustomize`, or :mod:`usercustomize` by deleting this attribute from :" +"mod:`sys` (or setting it to some other callable). (Contributed by Éric " +"Araujo and Antoine Pitrou in :issue:`5845`.)" +msgstr "" + +msgid "tarfile" +msgstr "" + +msgid "" +"The :mod:`tarfile` module now supports a simple :ref:`tarfile-commandline` " +"when called as a script directly or via ``-m``. This can be used to create " +"and extract tarfile archives. (Contributed by Berker Peksag in :issue:" +"`13477`.)" +msgstr "" + +msgid "textwrap" +msgstr "" + +msgid "" +"The :class:`~textwrap.TextWrapper` class has two new attributes/constructor " +"arguments: :attr:`~textwrap.TextWrapper.max_lines`, which limits the number " +"of lines in the output, and :attr:`~textwrap.TextWrapper.placeholder`, which " +"is a string that will appear at the end of the output if it has been " +"truncated because of *max_lines*. Building on these capabilities, a new " +"convenience function :func:`~textwrap.shorten` collapses all of the " +"whitespace in the input to single spaces and produces a single line of a " +"given *width* that ends with the *placeholder* (by default, ``[...]``). " +"(Contributed by Antoine Pitrou and Serhiy Storchaka in :issue:`18585` and :" +"issue:`18725`.)" +msgstr "" + +msgid "threading" +msgstr "" + +msgid "" +"The :class:`~threading.Thread` object representing the main thread can be " +"obtained from the new :func:`~threading.main_thread` function. In normal " +"conditions this will be the thread from which the Python interpreter was " +"started. (Contributed by Andrew Svetlov in :issue:`18882`.)" +msgstr "" + +msgid "traceback" +msgstr "" + +msgid "" +"A new :func:`traceback.clear_frames` function takes a traceback object and " +"clears the local variables in all of the frames it references, reducing the " +"amount of memory consumed. (Contributed by Andrew Kuchling in :issue:" +"`1565525`.)" +msgstr "" + +msgid "types" +msgstr "" + +msgid "" +"A new :func:`~types.DynamicClassAttribute` descriptor provides a way to " +"define an attribute that acts normally when looked up through an instance " +"object, but which is routed to the *class* ``__getattr__`` when looked up " +"through the class. This allows one to have properties active on a class, " +"and have virtual attributes on the class with the same name (see :mod:`Enum` " +"for an example). (Contributed by Ethan Furman in :issue:`19030`.)" +msgstr "" + +msgid "urllib" +msgstr "" + +msgid "" +":mod:`urllib.request` now supports ``data:`` URLs via the :class:`~urllib." +"request.DataHandler` class. (Contributed by Mathias Panzenböck in :issue:" +"`16423`.)" +msgstr "" + +msgid "" +"The http method that will be used by a :class:`~urllib.request.Request` " +"class can now be specified by setting a :class:`~urllib.request.Request." +"method` class attribute on the subclass. (Contributed by Jason R Coombs in :" +"issue:`18978`.)" +msgstr "" + +msgid "" +":class:`~urllib.request.Request` objects are now reusable: if the :attr:" +"`~urllib.request.Request.full_url` or :attr:`~urllib.request.Request.data` " +"attributes are modified, all relevant internal properties are updated. This " +"means, for example, that it is now possible to use the same :class:`~urllib." +"request.Request` object in more than one :meth:`.OpenerDirector.open` call " +"with different *data* arguments, or to modify a :class:`~urllib.request." +"Request`\\ 's ``url`` rather than recomputing it from scratch. There is " +"also a new :meth:`~urllib.request.Request.remove_header` method that can be " +"used to remove headers from a :class:`~urllib.request.Request`. " +"(Contributed by Alexey Kachayev in :issue:`16464`, Daniel Wozniak in :issue:" +"`17485`, and Damien Brecht and Senthil Kumaran in :issue:`17272`.)" +msgstr "" + +msgid "" +":class:`~urllib.error.HTTPError` objects now have a :attr:`~urllib.error." +"HTTPError.headers` attribute that provides access to the HTTP response " +"headers associated with the error. (Contributed by Berker Peksag in :issue:" +"`15701`.)" +msgstr "" + +msgid "unittest" +msgstr "" + +msgid "" +"The :class:`~unittest.TestCase` class has a new method, :meth:`~unittest." +"TestCase.subTest`, that produces a context manager whose :keyword:`with` " +"block becomes a \"sub-test\". This context manager allows a test method to " +"dynamically generate subtests by, say, calling the ``subTest`` context " +"manager inside a loop. A single test method can thereby produce an " +"indefinite number of separately identified and separately counted tests, all " +"of which will run even if one or more of them fail. For example::" +msgstr "" + +msgid "" +"will result in six subtests, each identified in the unittest verbose output " +"with a label consisting of the variable name ``i`` and a particular value " +"for that variable (``i=0``, ``i=1``, etc). See :ref:`subtests` for the full " +"version of this example. (Contributed by Antoine Pitrou in :issue:`16997`.)" +msgstr "" + +msgid "" +":func:`unittest.main` now accepts an iterable of test names for " +"*defaultTest*, where previously it only accepted a single test name as a " +"string. (Contributed by Jyrki Pulliainen in :issue:`15132`.)" +msgstr "" + +msgid "" +"If :class:`~unittest.SkipTest` is raised during test discovery (that is, at " +"the module level in the test file), it is now reported as a skip instead of " +"an error. (Contributed by Zach Ware in :issue:`16935`.)" +msgstr "" + +msgid "" +":meth:`~unittest.TestLoader.discover` now sorts the discovered files to " +"provide consistent test ordering. (Contributed by Martin Melin and Jeff " +"Ramnani in :issue:`16709`.)" +msgstr "" + +msgid "" +":class:`~unittest.TestSuite` now drops references to tests as soon as the " +"test has been run, if the test is successful. On Python interpreters that " +"do garbage collection, this allows the tests to be garbage collected if " +"nothing else is holding a reference to the test. It is possible to override " +"this behavior by creating a :class:`~unittest.TestSuite` subclass that " +"defines a custom ``_removeTestAtIndex`` method. (Contributed by Tom " +"Wardill, Matt McClure, and Andrew Svetlov in :issue:`11798`.)" +msgstr "" + +msgid "" +"A new test assertion context-manager, :meth:`~unittest.TestCase.assertLogs`, " +"will ensure that a given block of code emits a log message using the :mod:" +"`logging` module. By default the message can come from any logger and have " +"a priority of ``INFO`` or higher, but both the logger name and an " +"alternative minimum logging level may be specified. The object returned by " +"the context manager can be queried for the :class:`~logging.LogRecord`\\ s " +"and/or formatted messages that were logged. (Contributed by Antoine Pitrou " +"in :issue:`18937`.)" +msgstr "" + +msgid "" +"Test discovery now works with namespace packages (Contributed by Claudiu " +"Popa in :issue:`17457`.)" +msgstr "" + +msgid "" +":mod:`unittest.mock` objects now inspect their specification signatures when " +"matching calls, which means an argument can now be matched by either " +"position or name, instead of only by position. (Contributed by Antoine " +"Pitrou in :issue:`17015`.)" +msgstr "" + +msgid "" +":func:`~mock.mock_open` objects now have ``readline`` and ``readlines`` " +"methods. (Contributed by Toshio Kuratomi in :issue:`17467`.)" +msgstr "" + +msgid "venv" +msgstr "" + +msgid "" +":mod:`venv` now includes activation scripts for the ``csh`` and ``fish`` " +"shells. (Contributed by Andrew Svetlov in :issue:`15417`.)" +msgstr "" + +msgid "" +":class:`~venv.EnvBuilder` and the :func:`~venv.create` convenience function " +"take a new keyword argument *with_pip*, which defaults to ``False``, that " +"controls whether or not :class:`~venv.EnvBuilder` ensures that ``pip`` is " +"installed in the virtual environment. (Contributed by Nick Coghlan in :" +"issue:`19552` as part of the :pep:`453` implementation.)" +msgstr "" + +msgid "wave" +msgstr "" + +msgid "" +"The :meth:`~wave.getparams` method now returns a namedtuple rather than a " +"plain tuple. (Contributed by Claudiu Popa in :issue:`17487`.)" +msgstr "" + +msgid "" +":meth:`wave.open` now supports the context management protocol. " +"(Contributed by Claudiu Popa in :issue:`17616`.)" +msgstr "" + +msgid "" +":mod:`wave` can now :ref:`write output to unseekable files `. (Contributed by David Jones, Guilherme Polo, and Serhiy " +"Storchaka in :issue:`5202`.)" +msgstr "" + +msgid "" +"The :meth:`~wave.Wave_write.writeframesraw` and :meth:`~wave.Wave_write." +"writeframes` methods now accept any :term:`bytes-like object`. (Contributed " +"by Serhiy Storchaka in :issue:`8311`.)" +msgstr "" + +msgid "weakref" +msgstr "" + +msgid "" +"New :class:`~weakref.WeakMethod` class simulates weak references to bound " +"methods. (Contributed by Antoine Pitrou in :issue:`14631`.)" +msgstr "" + +msgid "" +"New :class:`~weakref.finalize` class makes it possible to register a " +"callback to be invoked when an object is garbage collected, without needing " +"to carefully manage the lifecycle of the weak reference itself. " +"(Contributed by Richard Oudkerk in :issue:`15528`.)" +msgstr "" + +msgid "" +"The callback, if any, associated with a :class:`~weakref.ref` is now exposed " +"via the :attr:`~weakref.ref.__callback__` attribute. (Contributed by Mark " +"Dickinson in :issue:`17643`.)" +msgstr "" + +msgid "xml.etree" +msgstr "" + +msgid "" +"A new parser, :class:`~xml.etree.ElementTree.XMLPullParser`, allows a non-" +"blocking applications to parse XML documents. An example can be seen at :" +"ref:`elementtree-pull-parsing`. (Contributed by Antoine Pitrou in :issue:" +"`17741`.)" +msgstr "" + +msgid "" +"The :mod:`xml.etree.ElementTree` :func:`~xml.etree.ElementTree.tostring` " +"and :func:`~xml.etree.ElementTree.tostringlist` functions, and the :class:" +"`~xml.etree.ElementTree.ElementTree` :meth:`~xml.etree.ElementTree." +"ElementTree.write` method, now have a *short_empty_elements* :ref:`keyword-" +"only parameter ` providing control over whether " +"elements with no content are written in abbreviated (````) or " +"expanded (````) form. (Contributed by Ariel Poliak and Serhiy " +"Storchaka in :issue:`14377`.)" +msgstr "" + +msgid "zipfile" +msgstr "" + +msgid "" +"The :meth:`~zipfile.PyZipFile.writepy` method of the :class:`~zipfile." +"PyZipFile` class has a new *filterfunc* option that can be used to control " +"which directories and files are added to the archive. For example, this " +"could be used to exclude test files from the archive. (Contributed by " +"Christian Tismer in :issue:`19274`.)" +msgstr "" + +msgid "" +"The *allowZip64* parameter to :class:`~zipfile.ZipFile` and :class:`~zipfile." +"PyZipfile` is now ``True`` by default. (Contributed by William Mallard in :" +"issue:`17201`.)" +msgstr "" + +msgid "CPython Implementation Changes" +msgstr "" + +msgid "PEP 445: Customization of CPython Memory Allocators" +msgstr "" + +msgid "" +":pep:`445` adds new C level interfaces to customize memory allocation in the " +"CPython interpreter." +msgstr "" + +msgid ":pep:`445` -- Add new APIs to customize Python memory allocators" +msgstr "" + +msgid "PEP 442: Safe Object Finalization" +msgstr "" + +msgid "" +":pep:`442` removes the current limitations and quirks of object finalization " +"in CPython. With it, objects with :meth:`__del__` methods, as well as " +"generators with :keyword:`finally` clauses, can be finalized when they are " +"part of a reference cycle." +msgstr "" + +msgid "" +"As part of this change, module globals are no longer forcibly set to :const:" +"`None` during interpreter shutdown in most cases, instead relying on the " +"normal operation of the cyclic garbage collector. This avoids a whole class " +"of interpreter-shutdown-time errors, usually involving ``__del__`` methods, " +"that have plagued Python since the cyclic GC was first introduced." +msgstr "" + +msgid ":pep:`442` -- Safe object finalization" +msgstr "" + +msgid "PEP 456: Secure and Interchangeable Hash Algorithm" +msgstr "" + +msgid "" +":pep:`456` follows up on earlier security fix work done on Python's hash " +"algorithm to address certain DOS attacks to which public facing APIs backed " +"by dictionary lookups may be subject. (See :issue:`14621` for the start of " +"the current round of improvements.) The PEP unifies CPython's hash code to " +"make it easier for a packager to substitute a different hash algorithm, and " +"switches Python's default implementation to a SipHash implementation on " +"platforms that have a 64 bit data type. Any performance differences in " +"comparison with the older FNV algorithm are trivial." +msgstr "" + +msgid "" +"The PEP adds additional fields to the :data:`sys.hash_info` named tuple to " +"describe the hash algorithm in use by the currently executing binary. " +"Otherwise, the PEP does not alter any existing CPython APIs." +msgstr "" + +msgid "PEP 436: Argument Clinic" +msgstr "" + +msgid "" +"\"Argument Clinic\" (:pep:`436`) is now part of the CPython build process " +"and can be used to simplify the process of defining and maintaining accurate " +"signatures for builtins and standard library extension modules implemented " +"in C." +msgstr "" + +msgid "" +"Some standard library extension modules have been converted to use Argument " +"Clinic in Python 3.4, and :mod:`pydoc` and :mod:`inspect` have been updated " +"accordingly." +msgstr "" + +msgid "" +"It is expected that signature metadata for programmatic introspection will " +"be added to additional callables implemented in C as part of Python 3.4 " +"maintenance releases." +msgstr "" + +msgid "" +"The Argument Clinic PEP is not fully up to date with the state of the " +"implementation. This has been deemed acceptable by the release manager and " +"core development team in this case, as Argument Clinic will not be made " +"available as a public API for third party use in Python 3.4." +msgstr "" + +msgid ":pep:`436` -- The Argument Clinic DSL" +msgstr "" + +msgid "PEP written and implemented by Larry Hastings." +msgstr "" + +msgid "Other Build and C API Changes" +msgstr "" + +msgid "" +"The new :c:func:`PyType_GetSlot` function has been added to the stable ABI, " +"allowing retrieval of function pointers from named type slots when using the " +"limited API. (Contributed by Martin von Löwis in :issue:`17162`.)" +msgstr "" + +msgid "" +"The new :c:func:`Py_SetStandardStreamEncoding` pre-initialization API allows " +"applications embedding the CPython interpreter to reliably force a " +"particular encoding and error handler for the standard streams. (Contributed " +"by Bastien Montagne and Nick Coghlan in :issue:`16129`.)" +msgstr "" + +msgid "" +"Most Python C APIs that don't mutate string arguments are now correctly " +"marked as accepting ``const char *`` rather than ``char *``. (Contributed " +"by Serhiy Storchaka in :issue:`1772673`.)" +msgstr "" + +msgid "" +"A new shell version of ``python-config`` can be used even when a python " +"interpreter is not available (for example, in cross compilation scenarios)." +msgstr "" + +msgid "" +":c:func:`PyUnicode_FromFormat` now supports width and precision " +"specifications for ``%s``, ``%A``, ``%U``, ``%V``, ``%S``, and ``%R``. " +"(Contributed by Ysj Ray and Victor Stinner in :issue:`7330`.)" +msgstr "" + +msgid "" +"New function :c:func:`PyStructSequence_InitType2` supplements the existing :" +"c:func:`PyStructSequence_InitType` function. The difference is that it " +"returns ``0`` on success and ``-1`` on failure." +msgstr "" + +msgid "" +"The CPython source can now be compiled using the address sanity checking " +"features of recent versions of GCC and clang: the false alarms in the small " +"object allocator have been silenced. (Contributed by Dhiru Kholia in :issue:" +"`18596`.)" +msgstr "" + +msgid "" +"The Windows build now uses `Address Space Layout Randomization `_ and `Data Execution " +"Prevention `_. " +"(Contributed by Christian Heimes in :issue:`16632`.)" +msgstr "" + +msgid "" +"New function :c:func:`PyObject_LengthHint` is the C API equivalent of :func:" +"`operator.length_hint`. (Contributed by Armin Ronacher in :issue:`16148`.)" +msgstr "" + +msgid "Other Improvements" +msgstr "" + +msgid "" +"The :ref:`python ` command has a new :ref:`option `, ``-I``, which causes it to run in \"isolated mode\", " +"which means that :data:`sys.path` contains neither the script's directory " +"nor the user's ``site-packages`` directory, and all :envvar:`!PYTHON*` " +"environment variables are ignored (it implies both ``-s`` and ``-E``). " +"Other restrictions may also be applied in the future, with the goal being to " +"isolate the execution of a script from the user's environment. This is " +"appropriate, for example, when Python is used to run a system script. On " +"most POSIX systems it can and should be used in the ``#!`` line of system " +"scripts. (Contributed by Christian Heimes in :issue:`16499`.)" +msgstr "" + +msgid "" +"Tab-completion is now enabled by default in the interactive interpreter on " +"systems that support :mod:`readline`. History is also enabled by default, " +"and is written to (and read from) the file :file:`~/.python-history`. " +"(Contributed by Antoine Pitrou and Éric Araujo in :issue:`5845`.)" +msgstr "" + +msgid "" +"Invoking the Python interpreter with ``--version`` now outputs the version " +"to standard output instead of standard error (:issue:`18338`). Similar " +"changes were made to :mod:`argparse` (:issue:`18920`) and other modules that " +"have script-like invocation capabilities (:issue:`18922`)." +msgstr "" + +msgid "" +"The CPython Windows installer now adds ``.py`` to the :envvar:`PATHEXT` " +"variable when extensions are registered, allowing users to run a python " +"script at the windows command prompt by just typing its name without the ``." +"py`` extension. (Contributed by Paul Moore in :issue:`18569`.)" +msgstr "" + +msgid "" +"A new ``make`` target `coverage-report `_ will build python, run " +"the test suite, and generate an HTML coverage report for the C codebase " +"using ``gcov`` and `lcov `_." +msgstr "" + +msgid "" +"The ``-R`` option to the :ref:`python regression test suite ` now " +"also checks for memory allocation leaks, using :func:`sys." +"getallocatedblocks()`. (Contributed by Antoine Pitrou in :issue:`13390`.)" +msgstr "" + +msgid "``python -m`` now works with namespace packages." +msgstr "" + +msgid "" +"The :mod:`stat` module is now implemented in C, which means it gets the " +"values for its constants from the C header files, instead of having the " +"values hard-coded in the python module as was previously the case." +msgstr "" + +msgid "" +"Loading multiple python modules from a single OS module (``.so``, ``.dll``) " +"now works correctly (previously it silently returned the first python module " +"in the file). (Contributed by Václav Šmilauer in :issue:`16421`.)" +msgstr "" + +msgid "" +"A new opcode, :opcode:`LOAD_CLASSDEREF`, has been added to fix a bug in the " +"loading of free variables in class bodies that could be triggered by certain " +"uses of :ref:`__prepare__ `. (Contributed by Benjamin Peterson in :" +"issue:`17853`.)" +msgstr "" + +msgid "" +"A number of MemoryError-related crashes were identified and fixed by Victor " +"Stinner using his :pep:`445`-based ``pyfailmalloc`` tool (:issue:`18408`, :" +"issue:`18520`)." +msgstr "" + +msgid "" +"The ``pyvenv`` command now accepts a ``--copies`` option to use copies " +"rather than symlinks even on systems where symlinks are the default. " +"(Contributed by Vinay Sajip in :issue:`18807`.)" +msgstr "" + +msgid "" +"The ``pyvenv`` command also accepts a ``--without-pip`` option to suppress " +"the otherwise-automatic bootstrapping of pip into the virtual environment. " +"(Contributed by Nick Coghlan in :issue:`19552` as part of the :pep:`453` " +"implementation.)" +msgstr "" + +msgid "" +"The encoding name is now optional in the value set for the :envvar:" +"`PYTHONIOENCODING` environment variable. This makes it possible to set just " +"the error handler, without changing the default encoding. (Contributed by " +"Serhiy Storchaka in :issue:`18818`.)" +msgstr "" + +msgid "" +"The :mod:`bz2`, :mod:`lzma`, and :mod:`gzip` module ``open`` functions now " +"support ``x`` (exclusive creation) mode. (Contributed by Tim Heaney and " +"Vajrasky Kok in :issue:`19201`, :issue:`19222`, and :issue:`19223`.)" +msgstr "" + +msgid "Significant Optimizations" +msgstr "" + +msgid "" +"The UTF-32 decoder is now 3x to 4x faster. (Contributed by Serhiy Storchaka " +"in :issue:`14625`.)" +msgstr "" + +msgid "" +"The cost of hash collisions for sets is now reduced. Each hash table probe " +"now checks a series of consecutive, adjacent key/hash pairs before " +"continuing to make random probes through the hash table. This exploits " +"cache locality to make collision resolution less expensive. The collision " +"resolution scheme can be described as a hybrid of linear probing and open " +"addressing. The number of additional linear probes defaults to nine. This " +"can be changed at compile-time by defining LINEAR_PROBES to be any value. " +"Set LINEAR_PROBES=0 to turn-off linear probing entirely. (Contributed by " +"Raymond Hettinger in :issue:`18771`.)" +msgstr "" + +msgid "" +"The interpreter starts about 30% faster. A couple of measures lead to the " +"speedup. The interpreter loads fewer modules on startup, e.g. the :mod:" +"`re`, :mod:`collections` and :mod:`locale` modules and their dependencies " +"are no longer imported by default. The marshal module has been improved to " +"load compiled Python code faster. (Contributed by Antoine Pitrou, Christian " +"Heimes and Victor Stinner in :issue:`19219`, :issue:`19218`, :issue:" +"`19209`, :issue:`19205` and :issue:`9548`.)" +msgstr "" + +msgid "" +":class:`bz2.BZ2File` is now as fast or faster than the Python2 version for " +"most cases. :class:`lzma.LZMAFile` has also been optimized. (Contributed " +"by Serhiy Storchaka and Nadeem Vawda in :issue:`16034`.)" +msgstr "" + +msgid "" +":func:`random.getrandbits` is 20%-40% faster for small integers (the most " +"common use case). (Contributed by Serhiy Storchaka in :issue:`16674`.)" +msgstr "" + +msgid "" +"By taking advantage of the new storage format for strings, pickling of " +"strings is now significantly faster. (Contributed by Victor Stinner and " +"Antoine Pitrou in :issue:`15596`.)" +msgstr "" + +msgid "" +"A performance issue in :meth:`io.FileIO.readall` has been solved. This " +"particularly affects Windows, and significantly speeds up the case of piping " +"significant amounts of data through :mod:`subprocess`. (Contributed by " +"Richard Oudkerk in :issue:`15758`.)" +msgstr "" + +msgid "" +":func:`html.escape` is now 10x faster. (Contributed by Matt Bryant in :" +"issue:`18020`.)" +msgstr "" + +msgid "" +"On Windows, the native ``VirtualAlloc`` is now used instead of the CRT " +"``malloc`` in ``obmalloc``. Artificial benchmarks show about a 3% memory " +"savings." +msgstr "" + +msgid "" +":func:`os.urandom` now uses a lazily opened persistent file descriptor so as " +"to avoid using many file descriptors when run in parallel from multiple " +"threads. (Contributed by Antoine Pitrou in :issue:`18756`.)" +msgstr "" + +msgid "Deprecated" +msgstr "" + +msgid "" +"This section covers various APIs and other features that have been " +"deprecated in Python 3.4, and will be removed in Python 3.5 or later. In " +"most (but not all) cases, using the deprecated APIs will produce a :exc:" +"`DeprecationWarning` when the interpreter is run with deprecation warnings " +"enabled (for example, by using ``-Wd``)." +msgstr "" + +msgid "Deprecations in the Python API" +msgstr "" + +msgid "" +"As mentioned in :ref:`whatsnew-pep-451`, a number of :mod:`importlib` " +"methods and functions are deprecated: :meth:`importlib.find_loader` is " +"replaced by :func:`importlib.util.find_spec`; :meth:`importlib.machinery." +"PathFinder.find_module` is replaced by :meth:`importlib.machinery.PathFinder." +"find_spec`; :meth:`importlib.abc.MetaPathFinder.find_module` is replaced by :" +"meth:`importlib.abc.MetaPathFinder.find_spec`; :meth:`importlib.abc." +"PathEntryFinder.find_loader` and :meth:`~importlib.abc.PathEntryFinder." +"find_module` are replaced by :meth:`importlib.abc.PathEntryFinder." +"find_spec`; all of the :samp:`{xxx}Loader` ABC ``load_module`` methods (:" +"meth:`importlib.abc.Loader.load_module`, :meth:`importlib.abc.InspectLoader." +"load_module`, :meth:`importlib.abc.FileLoader.load_module`, :meth:`importlib." +"abc.SourceLoader.load_module`) should no longer be implemented, instead " +"loaders should implement an ``exec_module`` method (:meth:`importlib.abc." +"Loader.exec_module`, :meth:`importlib.abc.InspectLoader.exec_module` :meth:" +"`importlib.abc.SourceLoader.exec_module`) and let the import system take " +"care of the rest; and :meth:`importlib.abc.Loader.module_repr`, :meth:" +"`importlib.util.module_for_loader`, :meth:`importlib.util.set_loader`, and :" +"meth:`importlib.util.set_package` are no longer needed because their " +"functions are now handled automatically by the import system." +msgstr "" + +msgid "" +"The :mod:`imp` module is pending deprecation. To keep compatibility with " +"Python 2/3 code bases, the module's removal is currently not scheduled." +msgstr "" + +msgid "" +"The :mod:`formatter` module is pending deprecation and is slated for removal " +"in Python 3.6." +msgstr "" + +msgid "" +"``MD5`` as the default *digestmod* for the :func:`hmac.new` function is " +"deprecated. Python 3.6 will require an explicit digest name or constructor " +"as *digestmod* argument." +msgstr "" + +msgid "" +"The internal ``Netrc`` class in the :mod:`ftplib` module has been documented " +"as deprecated in its docstring for quite some time. It now emits a :exc:" +"`DeprecationWarning` and will be removed completely in Python 3.5." +msgstr "" + +msgid "" +"The undocumented *endtime* argument to :meth:`subprocess.Popen.wait` should " +"not have been exposed and is hopefully not in use; it is deprecated and will " +"mostly likely be removed in Python 3.5." +msgstr "" + +msgid "" +"The *strict* argument of :class:`~html.parser.HTMLParser` is deprecated." +msgstr "" + +msgid "" +"The :mod:`plistlib` :func:`~plistlib.readPlist`, :func:`~plistlib." +"writePlist`, :func:`~plistlib.readPlistFromBytes`, and :func:`~plistlib." +"writePlistToBytes` functions are deprecated in favor of the corresponding " +"new functions :func:`~plistlib.load`, :func:`~plistlib.dump`, :func:" +"`~plistlib.loads`, and :func:`~plistlib.dumps`. :func:`~plistlib.Data` is " +"deprecated in favor of just using the :class:`bytes` constructor." +msgstr "" + +msgid "" +"The :mod:`sysconfig` key ``SO`` is deprecated, it has been replaced by " +"``EXT_SUFFIX``." +msgstr "" + +msgid "" +"The ``U`` mode accepted by various ``open`` functions is deprecated. In " +"Python3 it does not do anything useful, and should be replaced by " +"appropriate uses of :class:`io.TextIOWrapper` (if needed) and its *newline* " +"argument." +msgstr "" + +msgid "" +"The *parser* argument of :func:`xml.etree.ElementTree.iterparse` has been " +"deprecated, as has the *html* argument of :func:`~xml.etree.ElementTree." +"XMLParser`. To prepare for the removal of the latter, all arguments to " +"``XMLParser`` should be passed by keyword." +msgstr "" + +msgid "Deprecated Features" +msgstr "" + +msgid "" +"Running :ref:`idle` with the ``-n`` flag (no subprocess) is deprecated. " +"However, the feature will not be removed until :issue:`18823` is resolved." +msgstr "" + +msgid "" +"The site module adding a \"site-python\" directory to sys.path, if it " +"exists, is deprecated (:issue:`19375`)." +msgstr "" + +msgid "Removed" +msgstr "" + +msgid "Operating Systems No Longer Supported" +msgstr "" + +msgid "" +"Support for the following operating systems has been removed from the source " +"and build tools:" +msgstr "" + +msgid "OS/2 (:issue:`16135`)." +msgstr "OS/2 (:issue:`16135`)." + +msgid "Windows 2000 (changeset e52df05b496a)." +msgstr "" + +msgid "" +"Windows systems where ``COMSPEC`` points to ``command.com`` (:issue:`14470`)." +msgstr "" + +msgid "VMS (:issue:`16136`)." +msgstr "VMS (:issue:`16136`)." + +msgid "API and Feature Removals" +msgstr "" + +msgid "" +"The following obsolete and previously deprecated APIs and features have been " +"removed:" +msgstr "" + +msgid "" +"The unmaintained ``Misc/TextMate`` and ``Misc/vim`` directories have been " +"removed (see the `devguide `_ for suggestions " +"on what to use instead)." +msgstr "" + +msgid "" +"The ``SO`` makefile macro is removed (it was replaced by the " +"``SHLIB_SUFFIX`` and ``EXT_SUFFIX`` macros) (:issue:`16754`)." +msgstr "" + +msgid "" +"The ``PyThreadState.tick_counter`` field has been removed; its value has " +"been meaningless since Python 3.2, when the \"new GIL\" was introduced (:" +"issue:`19199`)." +msgstr "" + +msgid "" +"``PyLoader`` and ``PyPycLoader`` have been removed from :mod:`importlib`. " +"(Contributed by Taras Lyapun in :issue:`15641`.)" +msgstr "" + +msgid "" +"The *strict* argument to :class:`~http.client.HTTPConnection` and :class:" +"`~http.client.HTTPSConnection` has been removed. HTTP 0.9-style \"Simple " +"Responses\" are no longer supported." +msgstr "" + +msgid "" +"The deprecated :mod:`urllib.request.Request` getter and setter methods " +"``add_data``, ``has_data``, ``get_data``, ``get_type``, ``get_host``, " +"``get_selector``, ``set_proxy``, ``get_origin_req_host``, and " +"``is_unverifiable`` have been removed (use direct attribute access instead)." +msgstr "" + +msgid "" +"Support for loading the deprecated ``TYPE_INT64`` has been removed from :mod:" +"`marshal`. (Contributed by Dan Riti in :issue:`15480`.)" +msgstr "" + +msgid "" +":class:`inspect.Signature`: positional-only parameters are now required to " +"have a valid name." +msgstr "" + +msgid "" +":meth:`object.__format__` no longer accepts non-empty format strings, it now " +"raises a :exc:`TypeError` instead. Using a non-empty string has been " +"deprecated since Python 3.2. This change has been made to prevent a " +"situation where previously working (but incorrect) code would start failing " +"if an object gained a __format__ method, which means that your code may now " +"raise a :exc:`TypeError` if you are using an ``'s'`` format code with " +"objects that do not have a __format__ method that handles it. See :issue:" +"`7994` for background." +msgstr "" + +msgid "" +":meth:`difflib.SequenceMatcher.isbjunk` and :meth:`difflib.SequenceMatcher." +"isbpopular` were deprecated in 3.2, and have now been removed: use ``x in sm." +"bjunk`` and ``x in sm.bpopular``, where *sm* is a :class:`~difflib." +"SequenceMatcher` object (:issue:`13248`)." +msgstr "" + +msgid "Code Cleanups" +msgstr "" + +msgid "" +"The unused and undocumented internal ``Scanner`` class has been removed from " +"the :mod:`pydoc` module." +msgstr "" + +msgid "" +"The private and effectively unused ``_gestalt`` module has been removed, " +"along with the private :mod:`platform` functions ``_mac_ver_lookup``, " +"``_mac_ver_gstalt``, and ``_bcd2str``, which would only have ever been " +"called on badly broken OSX systems (see :issue:`18393`)." +msgstr "" + +msgid "" +"The hardcoded copies of certain :mod:`stat` constants that were included in " +"the :mod:`tarfile` module namespace have been removed." +msgstr "" + +msgid "Porting to Python 3.4" +msgstr "" + +msgid "" +"This section lists previously described changes and other bugfixes that may " +"require changes to your code." +msgstr "" + +msgid "Changes in 'python' Command Behavior" +msgstr "" + +msgid "" +"In a posix shell, setting the :envvar:`PATH` environment variable to an " +"empty value is equivalent to not setting it at all. However, setting :" +"envvar:`PYTHONPATH` to an empty value was *not* equivalent to not setting it " +"at all: setting :envvar:`PYTHONPATH` to an empty value was equivalent to " +"setting it to ``.``, which leads to confusion when reasoning by analogy to " +"how :envvar:`PATH` works. The behavior now conforms to the posix convention " +"for :envvar:`PATH`." +msgstr "" + +msgid "" +"The [X refs, Y blocks] output of a debug (``--with-pydebug``) build of the " +"CPython interpreter is now off by default. It can be re-enabled using the " +"``-X showrefcount`` option. (Contributed by Ezio Melotti in :issue:`17323`.)" +msgstr "" + +msgid "" +"The python command and most stdlib scripts (as well as :mod:`argparse`) now " +"output ``--version`` information to ``stdout`` instead of ``stderr`` (for " +"issue list see :ref:`other-improvements-3.4` above)." +msgstr "" + +msgid "Changes in the Python API" +msgstr "" + +msgid "" +"The ABCs defined in :mod:`importlib.abc` now either raise the appropriate " +"exception or return a default value instead of raising :exc:" +"`NotImplementedError` blindly. This will only affect code calling :func:" +"`super` and falling through all the way to the ABCs. For compatibility, " +"catch both :exc:`NotImplementedError` or the appropriate exception as needed." +msgstr "" + +msgid "" +"The module type now initializes the :attr:`__package__` and :attr:" +"`__loader__` attributes to ``None`` by default. To determine if these " +"attributes were set in a backwards-compatible fashion, use e.g. " +"``getattr(module, '__loader__', None) is not None``. (:issue:`17115`.)" +msgstr "" + +msgid "" +":meth:`importlib.util.module_for_loader` now sets ``__loader__`` and " +"``__package__`` unconditionally to properly support reloading. If this is " +"not desired then you will need to set these attributes manually. You can " +"use :func:`importlib.util.module_to_load` for module management." +msgstr "" + +msgid "" +"Import now resets relevant attributes (e.g. ``__name__``, ``__loader__``, " +"``__package__``, ``__file__``, ``__cached__``) unconditionally when " +"reloading. Note that this restores a pre-3.3 behavior in that it means a " +"module is re-found when re-loaded (:issue:`19413`)." +msgstr "" + +msgid "" +"Frozen packages no longer set ``__path__`` to a list containing the package " +"name, they now set it to an empty list. The previous behavior could cause " +"the import system to do the wrong thing on submodule imports if there was " +"also a directory with the same name as the frozen package. The correct way " +"to determine if a module is a package or not is to use ``hasattr(module, " +"'__path__')`` (:issue:`18065`)." +msgstr "" + +msgid "" +"Frozen modules no longer define a ``__file__`` attribute. It's semantically " +"incorrect for frozen modules to set the attribute as they are not loaded " +"from any explicit location. If you must know that a module comes from frozen " +"code then you can see if the module's ``__spec__.location`` is set to " +"``'frozen'``, check if the loader is a subclass of :class:`importlib." +"machinery.FrozenImporter`, or if Python 2 compatibility is necessary you can " +"use :func:`imp.is_frozen`." +msgstr "" + +msgid "" +":func:`py_compile.compile` now raises :exc:`FileExistsError` if the file " +"path it would write to is a symlink or a non-regular file. This is to act as " +"a warning that import will overwrite those files with a regular file " +"regardless of what type of file path they were originally." +msgstr "" + +msgid "" +":meth:`importlib.abc.SourceLoader.get_source` no longer raises :exc:" +"`ImportError` when the source code being loaded triggers a :exc:" +"`SyntaxError` or :exc:`UnicodeDecodeError`. As :exc:`ImportError` is meant " +"to be raised only when source code cannot be found but it should, it was " +"felt to be over-reaching/overloading of that meaning when the source code is " +"found but improperly structured. If you were catching ImportError before and " +"wish to continue to ignore syntax or decoding issues, catch all three " +"exceptions now." +msgstr "" + +msgid "" +":func:`functools.update_wrapper` and :func:`functools.wraps` now correctly " +"set the ``__wrapped__`` attribute to the function being wrapped, even if " +"that function also had its ``__wrapped__`` attribute set. This means " +"``__wrapped__`` attributes now correctly link a stack of decorated functions " +"rather than every ``__wrapped__`` attribute in the chain referring to the " +"innermost function. Introspection libraries that assumed the previous " +"behaviour was intentional can use :func:`inspect.unwrap` to access the first " +"function in the chain that has no ``__wrapped__`` attribute." +msgstr "" + +msgid "" +":func:`inspect.getfullargspec` has been reimplemented on top of :func:" +"`inspect.signature` and hence handles a much wider variety of callable " +"objects than it did in the past. It is expected that additional builtin and " +"extension module callables will gain signature metadata over the course of " +"the Python 3.4 series. Code that assumes that :func:`inspect.getfullargspec` " +"will fail on non-Python callables may need to be adjusted accordingly." +msgstr "" + +msgid "" +":class:`importlib.machinery.PathFinder` now passes on the current working " +"directory to objects in :data:`sys.path_hooks` for the empty string. This " +"results in :data:`sys.path_importer_cache` never containing ``''``, thus " +"iterating through :data:`sys.path_importer_cache` based on :data:`sys.path` " +"will not find all keys. A module's ``__file__`` when imported in the current " +"working directory will also now have an absolute path, including when using " +"``-m`` with the interpreter (except for ``__main__.__file__`` when a script " +"has been executed directly using a relative path) (Contributed by Brett " +"Cannon in :issue:`18416`). is specified on the command-line) (:issue:" +"`18416`)." +msgstr "" + +msgid "" +"The removal of the *strict* argument to :class:`~http.client.HTTPConnection` " +"and :class:`~http.client.HTTPSConnection` changes the meaning of the " +"remaining arguments if you are specifying them positionally rather than by " +"keyword. If you've been paying attention to deprecation warnings your code " +"should already be specifying any additional arguments via keywords." +msgstr "" + +msgid "" +"Strings between ``from __future__ import ...`` statements now *always* raise " +"a :exc:`SyntaxError`. Previously if there was no leading docstring, an " +"interstitial string would sometimes be ignored. This brings CPython into " +"compliance with the language spec; Jython and PyPy already were. (:issue:" +"`17434`)." +msgstr "" + +msgid "" +":meth:`ssl.SSLSocket.getpeercert` and :meth:`ssl.SSLSocket.do_handshake` now " +"raise an :exc:`OSError` with ``ENOTCONN`` when the ``SSLSocket`` is not " +"connected, instead of the previous behavior of raising an :exc:" +"`AttributeError`. In addition, :meth:`~ssl.SSLSocket.getpeercert` will " +"raise a :exc:`ValueError` if the handshake has not yet been done." +msgstr "" + +msgid "" +":func:`base64.b32decode` now raises a :exc:`binascii.Error` when the input " +"string contains non-b32-alphabet characters, instead of a :exc:`TypeError`. " +"This particular :exc:`TypeError` was missed when the other :exc:" +"`TypeError`\\ s were converted. (Contributed by Serhiy Storchaka in :issue:" +"`18011`.) Note: this change was also inadvertently applied in Python 3.3.3." +msgstr "" + +msgid "" +"The :attr:`~cgi.FieldStorage.file` attribute is now automatically closed " +"when the creating :class:`cgi.FieldStorage` instance is garbage collected. " +"If you were pulling the file object out separately from the :class:`cgi." +"FieldStorage` instance and not keeping the instance alive, then you should " +"either store the entire :class:`cgi.FieldStorage` instance or read the " +"contents of the file before the :class:`cgi.FieldStorage` instance is " +"garbage collected." +msgstr "" + +msgid "" +"Calling ``read`` or ``write`` on a closed SSL socket now raises an " +"informative :exc:`ValueError` rather than the previous more mysterious :exc:" +"`AttributeError` (:issue:`9177`)." +msgstr "" + +msgid "" +":meth:`slice.indices` no longer produces an :exc:`OverflowError` for huge " +"values. As a consequence of this fix, :meth:`slice.indices` now raises a :" +"exc:`ValueError` if given a negative length; previously it returned nonsense " +"values (:issue:`14794`)." +msgstr "" + +msgid "" +"The :class:`complex` constructor, unlike the :mod:`cmath` functions, was " +"incorrectly accepting :class:`float` values if an object's ``__complex__`` " +"special method returned one. This now raises a :exc:`TypeError`. (:issue:" +"`16290`.)" +msgstr "" + +msgid "" +"The :class:`int` constructor in 3.2 and 3.3 erroneously accepts :class:" +"`float` values for the *base* parameter. It is unlikely anyone was doing " +"this, but if so, it will now raise a :exc:`TypeError` (:issue:`16772`)." +msgstr "" + +msgid "" +"Defaults for keyword-only arguments are now evaluated *after* defaults for " +"regular keyword arguments, instead of before. Hopefully no one wrote any " +"code that depends on the previous buggy behavior (:issue:`16967`)." +msgstr "" + +msgid "" +"Stale thread states are now cleared after :func:`~os.fork`. This may cause " +"some system resources to be released that previously were incorrectly kept " +"perpetually alive (for example, database connections kept in thread-local " +"storage). (:issue:`17094`.)" +msgstr "" + +msgid "" +"Parameter names in ``__annotations__`` dicts are now mangled properly, " +"similarly to :attr:`~function.__kwdefaults__`. (Contributed by Yury " +"Selivanov in :issue:`20625`.)" +msgstr "" + +msgid "" +":attr:`hashlib.hash.name` now always returns the identifier in lower case. " +"Previously some builtin hashes had uppercase names, but now that it is a " +"formal public interface the naming has been made consistent (:issue:`18532`)." +msgstr "" + +msgid "" +"Because :mod:`unittest.TestSuite` now drops references to tests after they " +"are run, test harnesses that re-use a :class:`~unittest.TestSuite` to re-run " +"a set of tests may fail. Test suites should not be re-used in this fashion " +"since it means state is retained between test runs, breaking the test " +"isolation that :mod:`unittest` is designed to provide. However, if the lack " +"of isolation is considered acceptable, the old behavior can be restored by " +"creating a :mod:`~unittest.TestSuite` subclass that defines a " +"``_removeTestAtIndex`` method that does nothing (see :meth:`.TestSuite." +"__iter__`) (:issue:`11798`)." +msgstr "" + +msgid "" +":mod:`unittest` now uses :mod:`argparse` for command line parsing. There " +"are certain invalid command forms that used to work that are no longer " +"allowed; in theory this should not cause backward compatibility issues since " +"the disallowed command forms didn't make any sense and are unlikely to be in " +"use." +msgstr "" + +msgid "" +"The :func:`re.split`, :func:`re.findall`, and :func:`re.sub` functions, and " +"the :meth:`~re.match.group` and :meth:`~re.match.groups` methods of " +"``match`` objects now always return a *bytes* object when the string to be " +"matched is a :term:`bytes-like object`. Previously the return type matched " +"the input type, so if your code was depending on the return value being, " +"say, a ``bytearray``, you will need to change your code." +msgstr "" + +msgid "" +":mod:`audioop` functions now raise an error immediately if passed string " +"input, instead of failing randomly later on (:issue:`16685`)." +msgstr "" + +msgid "" +"The new *convert_charrefs* argument to :class:`~html.parser.HTMLParser` " +"currently defaults to ``False`` for backward compatibility, but will " +"eventually be changed to default to ``True``. It is recommended that you " +"add this keyword, with the appropriate value, to any :class:`~html.parser." +"HTMLParser` calls in your code (:issue:`13633`)." +msgstr "" + +msgid "" +"Since the *digestmod* argument to the :func:`hmac.new` function will in the " +"future have no default, all calls to :func:`hmac.new` should be changed to " +"explicitly specify a *digestmod* (:issue:`17276`)." +msgstr "" + +msgid "" +"Calling :func:`sysconfig.get_config_var` with the ``SO`` key, or looking " +"``SO`` up in the results of a call to :func:`sysconfig.get_config_vars` is " +"deprecated. This key should be replaced by ``EXT_SUFFIX`` or " +"``SHLIB_SUFFIX``, depending on the context (:issue:`19555`)." +msgstr "" + +msgid "" +"Any calls to ``open`` functions that specify ``U`` should be modified. ``U`` " +"is ineffective in Python3 and will eventually raise an error if used. " +"Depending on the function, the equivalent of its old Python2 behavior can be " +"achieved using either a *newline* argument, or if necessary by wrapping the " +"stream in :mod:`~io.TextIOWrapper` to use its *newline* argument (:issue:" +"`15204`)." +msgstr "" + +msgid "" +"If you use ``pyvenv`` in a script and desire that pip *not* be installed, " +"you must add ``--without-pip`` to your command invocation." +msgstr "" + +msgid "" +"The default behavior of :func:`json.dump` and :func:`json.dumps` when an " +"indent is specified has changed: it no longer produces trailing spaces after " +"the item separating commas at the ends of lines. This will matter only if " +"you have tests that are doing white-space-sensitive comparisons of such " +"output (:issue:`16333`)." +msgstr "" + +msgid "" +":mod:`doctest` now looks for doctests in extension module ``__doc__`` " +"strings, so if your doctest test discovery includes extension modules that " +"have things that look like doctests in them you may see test failures you've " +"never seen before when running your tests (:issue:`3158`)." +msgstr "" + +msgid "" +"The :mod:`collections.abc` module has been slightly refactored as part of " +"the Python startup improvements. As a consequence of this, it is no longer " +"the case that importing :mod:`collections` automatically imports :mod:" +"`collections.abc`. If your program depended on the (undocumented) implicit " +"import, you will need to add an explicit ``import collections.abc`` (:issue:" +"`20784`)." +msgstr "" + +msgid "Changes in the C API" +msgstr "" + +msgid "" +":c:func:`PyEval_EvalFrameEx`, :c:func:`PyObject_Repr`, and :c:func:" +"`PyObject_Str`, along with some other internal C APIs, now include a " +"debugging assertion that ensures they are not used in situations where they " +"may silently discard a currently active exception. In cases where discarding " +"the active exception is expected and desired (for example, because it has " +"already been saved locally with :c:func:`PyErr_Fetch` or is being " +"deliberately replaced with a different exception), an explicit :c:func:" +"`PyErr_Clear` call will be needed to avoid triggering the assertion when " +"invoking these operations (directly or indirectly) and running against a " +"version of Python that is compiled with assertions enabled." +msgstr "" + +msgid "" +":c:func:`PyErr_SetImportError` now sets :exc:`TypeError` when its **msg** " +"argument is not set. Previously only ``NULL`` was returned with no exception " +"set." +msgstr "" + +msgid "" +"The result of the :c:data:`PyOS_ReadlineFunctionPointer` callback must now " +"be a string allocated by :c:func:`PyMem_RawMalloc` or :c:func:" +"`PyMem_RawRealloc`, or ``NULL`` if an error occurred, instead of a string " +"allocated by :c:func:`PyMem_Malloc` or :c:func:`PyMem_Realloc` (:issue:" +"`16742`)" +msgstr "" + +msgid "" +":c:func:`PyThread_set_key_value` now always set the value. In Python 3.3, " +"the function did nothing if the key already exists (if the current value is " +"a non-``NULL`` pointer)." +msgstr "" + +msgid "" +"The ``f_tstate`` (thread state) field of the :c:type:`PyFrameObject` " +"structure has been removed to fix a bug: see :issue:`14432` for the " +"rationale." +msgstr "" + +msgid "Changed in 3.4.3" +msgstr "" + +msgid "" +"PEP 476: Enabling certificate verification by default for stdlib http clients" +msgstr "" + +msgid "" +":mod:`http.client` and modules which use it, such as :mod:`urllib.request` " +"and :mod:`xmlrpc.client`, will now verify that the server presents a " +"certificate which is signed by a CA in the platform trust store and whose " +"hostname matches the hostname being requested by default, significantly " +"improving security for many applications." +msgstr "" + +msgid "" +"For applications which require the old previous behavior, they can pass an " +"alternate context::" +msgstr "" diff --git a/whatsnew/3.5.po b/whatsnew/3.5.po index 2aba2d6bec..45ebcaf4a7 100644 --- a/whatsnew/3.5.po +++ b/whatsnew/3.5.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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 +27,7 @@ msgid "What's New In Python 3.5" msgstr "" msgid "Editors" -msgstr "" +msgstr "Redaktorzy" msgid "Elvis Pranskevichus , Yury Selivanov " msgstr "" @@ -324,7 +324,7 @@ msgid "" msgstr "" msgid "Examples::" -msgstr "" +msgstr "Przykłady::" msgid "" "Unicode is not allowed for ``%b``, but it is accepted by ``%a`` (equivalent " @@ -439,7 +439,7 @@ msgid "PEP 475: Retry system calls failing with EINTR" msgstr "" msgid "" -"An :py:data:`errno.EINTR` error code is returned whenever a system call, " +"An :py:const:`errno.EINTR` error code is returned whenever a system call, " "that is waiting for I/O, is interrupted by a signal. Previously, Python " "would raise :exc:`InterruptedError` in such cases. This meant that, when " "writing a Python application, the developer had two choices:" @@ -493,7 +493,7 @@ msgid "" msgstr "" msgid "" -"special cases: :func:`os.close` and :func:`os.dup2` now ignore :py:data:" +"special cases: :func:`os.close` and :func:`os.dup2` now ignore :py:const:" "`~errno.EINTR` errors; the syscall is not retried (see the PEP for the " "rationale);" msgstr "" @@ -516,7 +516,7 @@ msgid ":func:`signal.sigtimedwait` and :func:`signal.sigwaitinfo`;" msgstr "" msgid ":func:`time.sleep`." -msgstr "" +msgstr ":func:`time.sleep`." msgid ":pep:`475` -- Retry system calls failing with EINTR" msgstr "" @@ -721,7 +721,7 @@ msgid ":pep:`441` -- Improving Python ZIP Application Support" msgstr "" msgid "Improved Modules" -msgstr "" +msgstr "Ulepszone moduły" msgid "argparse" msgstr "" @@ -1013,7 +1013,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "(Contributed by Łukasz Langa in :issue:`18159`.)" msgstr "" @@ -1043,10 +1043,9 @@ msgid "curses" msgstr "" msgid "" -"The new :func:`~curses.update_lines_cols` function updates the :envvar:" -"`LINES` and :envvar:`COLS` environment variables. This is useful for " -"detecting manual screen resizing. (Contributed by Arnon Yaari in :issue:" -"`4254`.)" +"The new :func:`~curses.update_lines_cols` function updates the :data:`LINES` " +"and :data:`COLS` module variables. This is useful for detecting manual " +"screen resizing. (Contributed by Arnon Yaari in :issue:`4254`.)" msgstr "" msgid "dbm" @@ -1367,7 +1366,7 @@ msgid "(Contributed by Leon Weber in :issue:`20480`.)" msgstr "" msgid "json" -msgstr "" +msgstr "json" msgid "" "The :mod:`json.tool` command line interface now preserves the order of keys " @@ -1514,7 +1513,7 @@ msgstr "" msgid "" "New :func:`~os.get_blocking` and :func:`~os.set_blocking` functions allow " -"getting and setting a file descriptor's blocking mode (:data:`~os." +"getting and setting a file descriptor's blocking mode (:const:`~os." "O_NONBLOCK`.) (Contributed by Victor Stinner in :issue:`22054`.)" msgstr "" @@ -1828,8 +1827,8 @@ msgstr "" msgid "" "The new :meth:`SSLSocket.selected_alpn_protocol() ` returns the protocol that was selected during the " -"TLS handshake. The :data:`~ssl.HAS_ALPN` flag indicates whether ALPN support " -"is present." +"TLS handshake. The :const:`~ssl.HAS_ALPN` flag indicates whether ALPN " +"support is present." msgstr "" msgid "Other Changes" @@ -2004,8 +2003,8 @@ msgstr "" msgid "" "New :func:`~traceback.walk_stack` and :func:`~traceback.walk_tb` functions " -"to conveniently traverse frame and traceback objects. (Contributed by Robert " -"Collins in :issue:`17911`.)" +"to conveniently traverse frame and :ref:`traceback objects `. (Contributed by Robert Collins in :issue:`17911`.)" msgstr "" msgid "" @@ -2297,13 +2296,13 @@ msgid "New ``calloc`` functions were added:" msgstr "" msgid ":c:func:`PyMem_RawCalloc`," -msgstr "" +msgstr ":c:func:`PyMem_RawCalloc`," msgid ":c:func:`PyMem_Calloc`," -msgstr "" +msgstr ":c:func:`PyMem_Calloc`," msgid ":c:func:`PyObject_Calloc`." -msgstr "" +msgstr ":c:func:`PyObject_Calloc`." msgid "(Contributed by Victor Stinner in :issue:`21233`.)" msgstr "" @@ -2328,8 +2327,8 @@ msgstr "" msgid "" "A new :c:func:`PyErr_FormatV` function similar to :c:func:`PyErr_Format`, " -"but accepts a ``va_list`` argument. (Contributed by Antoine Pitrou in :issue:" -"`18711`.)" +"but accepts a :c:type:`va_list` argument. (Contributed by Antoine Pitrou in :" +"issue:`18711`.)" msgstr "" msgid "" @@ -2622,7 +2621,7 @@ msgstr "" msgid "" "The deprecated \"strict\" mode and argument of :class:`~html.parser." -"HTMLParser`, :meth:`HTMLParser.error`, and the :exc:`HTMLParserError` " +"HTMLParser`, :meth:`!HTMLParser.error`, and the :exc:`!HTMLParserError` " "exception have been removed. (Contributed by Ezio Melotti in :issue:" "`15114`.) The *convert_charrefs* argument of :class:`~html.parser." "HTMLParser` is now ``True`` by default. (Contributed by Berker Peksag in :" @@ -2698,7 +2697,7 @@ msgid "" msgstr "" msgid "" -"The :mod:`socket` module now exports the :data:`~socket.CAN_RAW_FD_FRAMES` " +"The :mod:`socket` module now exports the :const:`~socket.CAN_RAW_FD_FRAMES` " "constant on linux 3.6 and greater." msgstr "" @@ -2747,10 +2746,9 @@ msgid "Changes in the C API" msgstr "" msgid "" -"The undocumented :c:member:`~PyMemoryViewObject.format` member of the (non-" -"public) :c:type:`PyMemoryViewObject` structure has been removed. All " -"extensions relying on the relevant parts in ``memoryobject.h`` must be " -"rebuilt." +"The undocumented :c:member:`!format` member of the (non-public) :c:type:" +"`PyMemoryViewObject` structure has been removed. All extensions relying on " +"the relevant parts in ``memoryobject.h`` must be rebuilt." msgstr "" msgid "" @@ -2759,7 +2757,7 @@ msgid "" msgstr "" msgid "" -"Removed non-documented macro :c:macro:`PyObject_REPR` which leaked " +"Removed non-documented macro :c:macro:`!PyObject_REPR()` which leaked " "references. Use format character ``%R`` in :c:func:`PyUnicode_FromFormat`-" "like functions to format the :func:`repr` of the object. (Contributed by " "Serhiy Storchaka in :issue:`22453`.)" @@ -2774,8 +2772,9 @@ msgstr "" msgid "" "As part of the :pep:`492` implementation, the ``tp_reserved`` slot of :c:" -"type:`PyTypeObject` was replaced with a :c:member:`tp_as_async` slot. Refer " -"to :ref:`coro-objects` for new types, structures and functions." +"type:`PyTypeObject` was replaced with a :c:member:`~PyTypeObject." +"tp_as_async` slot. Refer to :ref:`coro-objects` for new types, structures " +"and functions." msgstr "" msgid "Notable changes in Python 3.5.4" diff --git a/whatsnew/3.6.po b/whatsnew/3.6.po new file mode 100644 index 0000000000..7777f704e5 --- /dev/null +++ b/whatsnew/3.6.po @@ -0,0 +1,2768 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2025, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.11\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:23+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" +"Language-Team: 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 "What's New In Python 3.6" +msgstr "" + +msgid "Editors" +msgstr "Redaktorzy" + +msgid "Elvis Pranskevichus , Yury Selivanov " +msgstr "" + +msgid "" +"This article explains the new features in Python 3.6, compared to 3.5. " +"Python 3.6 was released on December 23, 2016.  See the `changelog `_ for a full list of changes." +msgstr "" + +msgid ":pep:`494` - Python 3.6 Release Schedule" +msgstr "" + +msgid "Summary -- Release highlights" +msgstr "Podsumowanie – najważniejsze nowości" + +msgid "New syntax features:" +msgstr "Nowe cechy składni:" + +msgid ":ref:`PEP 498 `, formatted string literals." +msgstr "" + +msgid ":ref:`PEP 515 `, underscores in numeric literals." +msgstr "" + +msgid ":ref:`PEP 526 `, syntax for variable annotations." +msgstr "" + +msgid ":ref:`PEP 525 `, asynchronous generators." +msgstr "" + +msgid ":ref:`PEP 530 `: asynchronous comprehensions." +msgstr "" + +msgid "New library modules:" +msgstr "Nowe moduły biblioteki:" + +msgid "" +":mod:`secrets`: :ref:`PEP 506 -- Adding A Secrets Module To The Standard " +"Library `." +msgstr "" + +msgid "CPython implementation improvements:" +msgstr "" + +msgid "" +"The :ref:`dict ` type has been reimplemented to use a :ref:" +"`more compact representation ` based on `a proposal " +"by Raymond Hettinger `_ and similar to the `PyPy dict implementation`_. " +"This resulted in dictionaries using 20% to 25% less memory when compared to " +"Python 3.5." +msgstr "" + +msgid "" +"Customization of class creation has been simplified with the :ref:`new " +"protocol `." +msgstr "" + +msgid "" +"The class attribute definition order is :ref:`now preserved `." +msgstr "" + +msgid "" +"The order of elements in ``**kwargs`` now :ref:`corresponds to the order " +"` in which keyword arguments were passed to the function." +msgstr "" + +msgid "" +"DTrace and SystemTap :ref:`probing support ` has been " +"added." +msgstr "" + +msgid "" +"The new :ref:`PYTHONMALLOC ` environment variable " +"can now be used to debug the interpreter memory allocation and access errors." +msgstr "" + +msgid "Significant improvements in the standard library:" +msgstr "" + +msgid "" +"The :mod:`asyncio` module has received new features, significant usability " +"and performance improvements, and a fair amount of bug fixes. Starting with " +"Python 3.6 the ``asyncio`` module is no longer provisional and its API is " +"considered stable." +msgstr "" + +msgid "" +"A new :ref:`file system path protocol ` has been " +"implemented to support :term:`path-like objects `. All " +"standard library functions operating on paths have been updated to work with " +"the new protocol." +msgstr "" + +msgid "" +"The :mod:`datetime` module has gained support for :ref:`Local Time " +"Disambiguation `." +msgstr "" + +msgid "" +"The :mod:`typing` module received a number of :ref:`improvements `." +msgstr "" + +msgid "" +"The :mod:`tracemalloc` module has been significantly reworked and is now " +"used to provide better output for :exc:`ResourceWarning` as well as provide " +"better diagnostics for memory allocation errors. See the :ref:`PYTHONMALLOC " +"section ` for more information." +msgstr "" + +msgid "Security improvements:" +msgstr "" + +msgid "" +"The new :mod:`secrets` module has been added to simplify the generation of " +"cryptographically strong pseudo-random numbers suitable for managing secrets " +"such as account authentication, tokens, and similar." +msgstr "" + +msgid "" +"On Linux, :func:`os.urandom` now blocks until the system urandom entropy " +"pool is initialized to increase the security. See the :pep:`524` for the " +"rationale." +msgstr "" + +msgid "The :mod:`hashlib` and :mod:`ssl` modules now support OpenSSL 1.1.0." +msgstr "" + +msgid "" +"The default settings and feature set of the :mod:`ssl` module have been " +"improved." +msgstr "" + +msgid "" +"The :mod:`hashlib` module received support for the BLAKE2, SHA-3 and SHAKE " +"hash algorithms and the :func:`~hashlib.scrypt` key derivation function." +msgstr "" + +msgid "Windows improvements:" +msgstr "" + +msgid "" +":ref:`PEP 528 ` and :ref:`PEP 529 `, " +"Windows filesystem and console encoding changed to UTF-8." +msgstr "" + +msgid "" +"The ``py.exe`` launcher, when used interactively, no longer prefers Python 2 " +"over Python 3 when the user doesn't specify a version (via command line " +"arguments or a config file). Handling of shebang lines remains unchanged - " +"\"python\" refers to Python 2 in that case." +msgstr "" + +msgid "" +"``python.exe`` and ``pythonw.exe`` have been marked as long-path aware, " +"which means that the 260 character path limit may no longer apply. See :ref:" +"`removing the MAX_PATH limitation ` for details." +msgstr "" + +msgid "" +"A ``._pth`` file can be added to force isolated mode and fully specify all " +"search paths to avoid registry and environment lookup. See :ref:`the " +"documentation ` for more information." +msgstr "" + +msgid "" +"A ``python36.zip`` file now works as a landmark to infer :envvar:" +"`PYTHONHOME`. See :ref:`the documentation ` for " +"more information." +msgstr "" + +msgid "New Features" +msgstr "Nowe funkcjonalności" + +msgid "PEP 498: Formatted string literals" +msgstr "" + +msgid "" +":pep:`498` introduces a new kind of string literals: *f-strings*, or :ref:" +"`formatted string literals `." +msgstr "" + +msgid "" +"Formatted string literals are prefixed with ``'f'`` and are similar to the " +"format strings accepted by :meth:`str.format`. They contain replacement " +"fields surrounded by curly braces. The replacement fields are expressions, " +"which are evaluated at run time, and then formatted using the :func:`format` " +"protocol::" +msgstr "" + +msgid ":pep:`498` -- Literal String Interpolation." +msgstr "" + +msgid "PEP written and implemented by Eric V. Smith." +msgstr "" + +msgid ":ref:`Feature documentation `." +msgstr "" + +msgid "PEP 526: Syntax for variable annotations" +msgstr "" + +msgid "" +":pep:`484` introduced the standard for type annotations of function " +"parameters, a.k.a. type hints. This PEP adds syntax to Python for annotating " +"the types of variables including class variables and instance variables::" +msgstr "" + +msgid "" +"Just as for function annotations, the Python interpreter does not attach any " +"particular meaning to variable annotations and only stores them in the " +"``__annotations__`` attribute of a class or module." +msgstr "" + +msgid "" +"In contrast to variable declarations in statically typed languages, the goal " +"of annotation syntax is to provide an easy way to specify structured type " +"metadata for third party tools and libraries via the abstract syntax tree " +"and the ``__annotations__`` attribute." +msgstr "" + +msgid ":pep:`526` -- Syntax for variable annotations." +msgstr "" + +msgid "" +"PEP written by Ryan Gonzalez, Philip House, Ivan Levkivskyi, Lisa Roach, and " +"Guido van Rossum. Implemented by Ivan Levkivskyi." +msgstr "" + +msgid "" +"Tools that use or will use the new syntax: `mypy `_, `pytype `_, PyCharm, etc." +msgstr "" + +msgid "PEP 515: Underscores in Numeric Literals" +msgstr "" + +msgid "" +":pep:`515` adds the ability to use underscores in numeric literals for " +"improved readability. For example::" +msgstr "" + +msgid "" +"Single underscores are allowed between digits and after any base specifier. " +"Leading, trailing, or multiple underscores in a row are not allowed." +msgstr "" + +msgid "" +"The :ref:`string formatting ` language also now has support for " +"the ``'_'`` option to signal the use of an underscore for a thousands " +"separator for floating point presentation types and for integer presentation " +"type ``'d'``. For integer presentation types ``'b'``, ``'o'``, ``'x'``, and " +"``'X'``, underscores will be inserted every 4 digits::" +msgstr "" + +msgid ":pep:`515` -- Underscores in Numeric Literals" +msgstr "" + +msgid "PEP written by Georg Brandl and Serhiy Storchaka." +msgstr "" + +msgid "PEP 525: Asynchronous Generators" +msgstr "" + +msgid "" +":pep:`492` introduced support for native coroutines and ``async`` / " +"``await`` syntax to Python 3.5. A notable limitation of the Python 3.5 " +"implementation is that it was not possible to use ``await`` and ``yield`` in " +"the same function body. In Python 3.6 this restriction has been lifted, " +"making it possible to define *asynchronous generators*::" +msgstr "" + +msgid "The new syntax allows for faster and more concise code." +msgstr "" + +msgid ":pep:`525` -- Asynchronous Generators" +msgstr "" + +msgid "PEP written and implemented by Yury Selivanov." +msgstr "" + +msgid "PEP 530: Asynchronous Comprehensions" +msgstr "" + +msgid "" +":pep:`530` adds support for using ``async for`` in list, set, dict " +"comprehensions and generator expressions::" +msgstr "" + +msgid "" +"Additionally, ``await`` expressions are supported in all kinds of " +"comprehensions::" +msgstr "" + +msgid ":pep:`530` -- Asynchronous Comprehensions" +msgstr "" + +msgid "PEP 487: Simpler customization of class creation" +msgstr "" + +msgid "" +"It is now possible to customize subclass creation without using a metaclass. " +"The new ``__init_subclass__`` classmethod will be called on the base class " +"whenever a new subclass is created::" +msgstr "" + +msgid "" +"In order to allow zero-argument :func:`super` calls to work correctly from :" +"meth:`~object.__init_subclass__` implementations, custom metaclasses must " +"ensure that the new ``__classcell__`` namespace entry is propagated to " +"``type.__new__`` (as described in :ref:`class-object-creation`)." +msgstr "" + +msgid ":pep:`487` -- Simpler customization of class creation" +msgstr "" + +msgid "PEP written and implemented by Martin Teichmann." +msgstr "" + +msgid ":ref:`Feature documentation `" +msgstr "" + +msgid "PEP 487: Descriptor Protocol Enhancements" +msgstr "" + +msgid "" +":pep:`487` extends the descriptor protocol to include the new optional :meth:" +"`~object.__set_name__` method. Whenever a new class is defined, the new " +"method will be called on all descriptors included in the definition, " +"providing them with a reference to the class being defined and the name " +"given to the descriptor within the class namespace. In other words, " +"instances of descriptors can now know the attribute name of the descriptor " +"in the owner class::" +msgstr "" + +msgid ":ref:`Feature documentation `" +msgstr "" + +msgid "PEP 519: Adding a file system path protocol" +msgstr "" + +msgid "" +"File system paths have historically been represented as :class:`str` or :" +"class:`bytes` objects. This has led to people who write code which operate " +"on file system paths to assume that such objects are only one of those two " +"types (an :class:`int` representing a file descriptor does not count as that " +"is not a file path). Unfortunately that assumption prevents alternative " +"object representations of file system paths like :mod:`pathlib` from working " +"with pre-existing code, including Python's standard library." +msgstr "" + +msgid "" +"To fix this situation, a new interface represented by :class:`os.PathLike` " +"has been defined. By implementing the :meth:`~os.PathLike.__fspath__` " +"method, an object signals that it represents a path. An object can then " +"provide a low-level representation of a file system path as a :class:`str` " +"or :class:`bytes` object. This means an object is considered :term:`path-" +"like ` if it implements :class:`os.PathLike` or is a :" +"class:`str` or :class:`bytes` object which represents a file system path. " +"Code can use :func:`os.fspath`, :func:`os.fsdecode`, or :func:`os.fsencode` " +"to explicitly get a :class:`str` and/or :class:`bytes` representation of a " +"path-like object." +msgstr "" + +msgid "" +"The built-in :func:`open` function has been updated to accept :class:`os." +"PathLike` objects, as have all relevant functions in the :mod:`os` and :mod:" +"`os.path` modules, and most other functions and classes in the standard " +"library. The :class:`os.DirEntry` class and relevant classes in :mod:" +"`pathlib` have also been updated to implement :class:`os.PathLike`." +msgstr "" + +msgid "" +"The hope is that updating the fundamental functions for operating on file " +"system paths will lead to third-party code to implicitly support all :term:" +"`path-like objects ` without any code changes, or at least " +"very minimal ones (e.g. calling :func:`os.fspath` at the beginning of code " +"before operating on a path-like object)." +msgstr "" + +msgid "" +"Here are some examples of how the new interface allows for :class:`pathlib." +"Path` to be used more easily and transparently with pre-existing code::" +msgstr "" + +msgid "" +"(Implemented by Brett Cannon, Ethan Furman, Dusty Phillips, and Jelle " +"Zijlstra.)" +msgstr "" + +msgid ":pep:`519` -- Adding a file system path protocol" +msgstr "" + +msgid "PEP written by Brett Cannon and Koos Zevenhoven." +msgstr "" + +msgid "PEP 495: Local Time Disambiguation" +msgstr "" + +msgid "" +"In most world locations, there have been and will be times when local clocks " +"are moved back. In those times, intervals are introduced in which local " +"clocks show the same time twice in the same day. In these situations, the " +"information displayed on a local clock (or stored in a Python datetime " +"instance) is insufficient to identify a particular moment in time." +msgstr "" + +msgid "" +":pep:`495` adds the new *fold* attribute to instances of :class:`datetime." +"datetime` and :class:`datetime.time` classes to differentiate between two " +"moments in time for which local times are the same::" +msgstr "" + +msgid "" +"The values of the :attr:`fold ` attribute have the " +"value ``0`` for all instances except those that represent the second " +"(chronologically) moment in time in an ambiguous case." +msgstr "" + +msgid ":pep:`495` -- Local Time Disambiguation" +msgstr "" + +msgid "" +"PEP written by Alexander Belopolsky and Tim Peters, implementation by " +"Alexander Belopolsky." +msgstr "" + +msgid "PEP 529: Change Windows filesystem encoding to UTF-8" +msgstr "" + +msgid "" +"Representing filesystem paths is best performed with str (Unicode) rather " +"than bytes. However, there are some situations where using bytes is " +"sufficient and correct." +msgstr "" + +msgid "" +"Prior to Python 3.6, data loss could result when using bytes paths on " +"Windows. With this change, using bytes to represent paths is now supported " +"on Windows, provided those bytes are encoded with the encoding returned by :" +"func:`sys.getfilesystemencoding()`, which now defaults to ``'utf-8'``." +msgstr "" + +msgid "" +"Applications that do not use str to represent paths should use :func:`os." +"fsencode()` and :func:`os.fsdecode()` to ensure their bytes are correctly " +"encoded. To revert to the previous behaviour, set :envvar:" +"`PYTHONLEGACYWINDOWSFSENCODING` or call :func:`sys." +"_enablelegacywindowsfsencoding`." +msgstr "" + +msgid "" +"See :pep:`529` for more information and discussion of code modifications " +"that may be required." +msgstr "" + +msgid "PEP 528: Change Windows console encoding to UTF-8" +msgstr "" + +msgid "" +"The default console on Windows will now accept all Unicode characters and " +"provide correctly read str objects to Python code. ``sys.stdin``, ``sys." +"stdout`` and ``sys.stderr`` now default to utf-8 encoding." +msgstr "" + +msgid "" +"This change only applies when using an interactive console, and not when " +"redirecting files or pipes. To revert to the previous behaviour for " +"interactive console use, set :envvar:`PYTHONLEGACYWINDOWSSTDIO`." +msgstr "" + +msgid ":pep:`528` -- Change Windows console encoding to UTF-8" +msgstr "" + +msgid "PEP written and implemented by Steve Dower." +msgstr "" + +msgid "PEP 520: Preserving Class Attribute Definition Order" +msgstr "" + +msgid "" +"Attributes in a class definition body have a natural ordering: the same " +"order in which the names appear in the source. This order is now preserved " +"in the new class's :attr:`~object.__dict__` attribute." +msgstr "" + +msgid "" +"Also, the effective default class *execution* namespace (returned from :ref:" +"`type.__prepare__() `) is now an insertion-order-preserving mapping." +msgstr "" + +msgid ":pep:`520` -- Preserving Class Attribute Definition Order" +msgstr "" + +msgid "PEP written and implemented by Eric Snow." +msgstr "" + +msgid "PEP 468: Preserving Keyword Argument Order" +msgstr "" + +msgid "" +"``**kwargs`` in a function signature is now guaranteed to be an insertion-" +"order-preserving mapping." +msgstr "" + +msgid ":pep:`468` -- Preserving Keyword Argument Order" +msgstr "" + +msgid "New :ref:`dict ` implementation" +msgstr "" + +msgid "" +"The :ref:`dict ` type now uses a \"compact\" representation " +"based on `a proposal by Raymond Hettinger `_ which was `first implemented by PyPy " +"`_. The memory usage of the new :func:`dict` is between 20% and 25% " +"smaller compared to Python 3.5." +msgstr "" + +msgid "" +"The order-preserving aspect of this new implementation is considered an " +"implementation detail and should not be relied upon (this may change in the " +"future, but it is desired to have this new dict implementation in the " +"language for a few releases before changing the language spec to mandate " +"order-preserving semantics for all current and future Python " +"implementations; this also helps preserve backwards-compatibility with older " +"versions of the language where random iteration order is still in effect, e." +"g. Python 3.5)." +msgstr "" + +msgid "" +"(Contributed by INADA Naoki in :issue:`27350`. Idea `originally suggested by " +"Raymond Hettinger `_.)" +msgstr "" + +msgid "PEP 523: Adding a frame evaluation API to CPython" +msgstr "" + +msgid "" +"While Python provides extensive support to customize how code executes, one " +"place it has not done so is in the evaluation of frame objects. If you " +"wanted some way to intercept frame evaluation in Python there really wasn't " +"any way without directly manipulating function pointers for defined " +"functions." +msgstr "" + +msgid "" +":pep:`523` changes this by providing an API to make frame evaluation " +"pluggable at the C level. This will allow for tools such as debuggers and " +"JITs to intercept frame evaluation before the execution of Python code " +"begins. This enables the use of alternative evaluation implementations for " +"Python code, tracking frame evaluation, etc." +msgstr "" + +msgid "" +"This API is not part of the limited C API and is marked as private to signal " +"that usage of this API is expected to be limited and only applicable to very " +"select, low-level use-cases. Semantics of the API will change with Python as " +"necessary." +msgstr "" + +msgid ":pep:`523` -- Adding a frame evaluation API to CPython" +msgstr "" + +msgid "PEP written by Brett Cannon and Dino Viehland." +msgstr "" + +msgid "PYTHONMALLOC environment variable" +msgstr "" + +msgid "" +"The new :envvar:`PYTHONMALLOC` environment variable allows setting the " +"Python memory allocators and installing debug hooks." +msgstr "" + +msgid "" +"It is now possible to install debug hooks on Python memory allocators on " +"Python compiled in release mode using ``PYTHONMALLOC=debug``. Effects of " +"debug hooks:" +msgstr "" + +msgid "Newly allocated memory is filled with the byte ``0xCB``" +msgstr "" + +msgid "Freed memory is filled with the byte ``0xDB``" +msgstr "" + +msgid "" +"Detect violations of the Python memory allocator API. For example, :c:func:" +"`PyObject_Free` called on a memory block allocated by :c:func:`PyMem_Malloc`." +msgstr "" + +msgid "Detect writes before the start of a buffer (buffer underflows)" +msgstr "" + +msgid "Detect writes after the end of a buffer (buffer overflows)" +msgstr "" + +msgid "" +"Check that the :term:`GIL ` is held when allocator " +"functions of :c:macro:`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) " +"and :c:macro:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) domains are " +"called." +msgstr "" + +msgid "Checking if the GIL is held is also a new feature of Python 3.6." +msgstr "" + +msgid "" +"See the :c:func:`PyMem_SetupDebugHooks` function for debug hooks on Python " +"memory allocators." +msgstr "" + +msgid "" +"It is now also possible to force the usage of the :c:func:`malloc` allocator " +"of the C library for all Python memory allocations using " +"``PYTHONMALLOC=malloc``. This is helpful when using external memory " +"debuggers like Valgrind on a Python compiled in release mode." +msgstr "" + +msgid "" +"On error, the debug hooks on Python memory allocators now use the :mod:" +"`tracemalloc` module to get the traceback where a memory block was allocated." +msgstr "" + +msgid "" +"Example of fatal error on buffer overflow using ``python3.6 -X " +"tracemalloc=5`` (store 5 frames in traces)::" +msgstr "" + +msgid "(Contributed by Victor Stinner in :issue:`26516` and :issue:`26564`.)" +msgstr "" + +msgid "DTrace and SystemTap probing support" +msgstr "" + +msgid "" +"Python can now be built ``--with-dtrace`` which enables static markers for " +"the following events in the interpreter:" +msgstr "" + +msgid "function call/return" +msgstr "" + +msgid "garbage collection started/finished" +msgstr "" + +msgid "line of code executed." +msgstr "" + +msgid "" +"This can be used to instrument running interpreters in production, without " +"the need to recompile specific :ref:`debug builds ` or " +"providing application-specific profiling/debugging code." +msgstr "" + +msgid "More details in :ref:`instrumentation`." +msgstr "" + +msgid "" +"The current implementation is tested on Linux and macOS. Additional markers " +"may be added in the future." +msgstr "" + +msgid "" +"(Contributed by Łukasz Langa in :issue:`21590`, based on patches by Jesús " +"Cea Avión, David Malcolm, and Nikhil Benesch.)" +msgstr "" + +msgid "Other Language Changes" +msgstr "" + +msgid "Some smaller changes made to the core Python language are:" +msgstr "" + +msgid "" +"A ``global`` or ``nonlocal`` statement must now textually appear before the " +"first use of the affected name in the same scope. Previously this was a :exc:" +"`SyntaxWarning`." +msgstr "" + +msgid "" +"It is now possible to set a :ref:`special method ` to ``None`` " +"to indicate that the corresponding operation is not available. For example, " +"if a class sets :meth:`__iter__` to ``None``, the class is not iterable. " +"(Contributed by Andrew Barnert and Ivan Levkivskyi in :issue:`25958`.)" +msgstr "" + +msgid "" +"Long sequences of repeated traceback lines are now abbreviated as " +"``\"[Previous line repeated {count} more times]\"`` (see :ref:`whatsnew36-" +"traceback` for an example). (Contributed by Emanuel Barry in :issue:`26823`.)" +msgstr "" + +msgid "" +"Import now raises the new exception :exc:`ModuleNotFoundError` (subclass of :" +"exc:`ImportError`) when it cannot find a module. Code that currently checks " +"for ImportError (in try-except) will still work. (Contributed by Eric Snow " +"in :issue:`15767`.)" +msgstr "" + +msgid "" +"Class methods relying on zero-argument ``super()`` will now work correctly " +"when called from metaclass methods during class creation. (Contributed by " +"Martin Teichmann in :issue:`23722`.)" +msgstr "" + +msgid "New Modules" +msgstr "" + +msgid "secrets" +msgstr "" + +msgid "" +"The main purpose of the new :mod:`secrets` module is to provide an obvious " +"way to reliably generate cryptographically strong pseudo-random values " +"suitable for managing secrets, such as account authentication, tokens, and " +"similar." +msgstr "" + +msgid "" +"Note that the pseudo-random generators in the :mod:`random` module should " +"*NOT* be used for security purposes. Use :mod:`secrets` on Python 3.6+ and :" +"func:`os.urandom()` on Python 3.5 and earlier." +msgstr "" + +msgid ":pep:`506` -- Adding A Secrets Module To The Standard Library" +msgstr "" + +msgid "PEP written and implemented by Steven D'Aprano." +msgstr "" + +msgid "Improved Modules" +msgstr "Ulepszone moduły" + +msgid "array" +msgstr "" + +msgid "" +"Exhausted iterators of :class:`array.array` will now stay exhausted even if " +"the iterated array is extended. This is consistent with the behavior of " +"other mutable sequences." +msgstr "" + +msgid "Contributed by Serhiy Storchaka in :issue:`26492`." +msgstr "" + +msgid "ast" +msgstr "" + +msgid "" +"The new :class:`ast.Constant` AST node has been added. It can be used by " +"external AST optimizers for the purposes of constant folding." +msgstr "" + +msgid "Contributed by Victor Stinner in :issue:`26146`." +msgstr "" + +msgid "asyncio" +msgstr "" + +msgid "" +"Starting with Python 3.6 the ``asyncio`` module is no longer provisional and " +"its API is considered stable." +msgstr "" + +msgid "" +"Notable changes in the :mod:`asyncio` module since Python 3.5.0 (all " +"backported to 3.5.x due to the provisional status):" +msgstr "" + +msgid "" +"The :func:`~asyncio.get_event_loop` function has been changed to always " +"return the currently running loop when called from coroutines and callbacks. " +"(Contributed by Yury Selivanov in :issue:`28613`.)" +msgstr "" + +msgid "" +"The :func:`~asyncio.ensure_future` function and all functions that use it, " +"such as :meth:`loop.run_until_complete() `, " +"now accept all kinds of :term:`awaitable objects `. (Contributed " +"by Yury Selivanov.)" +msgstr "" + +msgid "" +"New :func:`~asyncio.run_coroutine_threadsafe` function to submit coroutines " +"to event loops from other threads. (Contributed by Vincent Michel.)" +msgstr "" + +msgid "" +"New :meth:`Transport.is_closing() ` method " +"to check if the transport is closing or closed. (Contributed by Yury " +"Selivanov.)" +msgstr "" + +msgid "" +"The :meth:`loop.create_server() ` method can now " +"accept a list of hosts. (Contributed by Yann Sionneau.)" +msgstr "" + +msgid "" +"New :meth:`loop.create_future() ` method to " +"create Future objects. This allows alternative event loop implementations, " +"such as `uvloop `_, to provide a " +"faster :class:`asyncio.Future` implementation. (Contributed by Yury " +"Selivanov in :issue:`27041`.)" +msgstr "" + +msgid "" +"New :meth:`loop.get_exception_handler() ` method to get the current exception handler. " +"(Contributed by Yury Selivanov in :issue:`27040`.)" +msgstr "" + +msgid "" +"New :meth:`StreamReader.readuntil() ` method " +"to read data from the stream until a separator bytes sequence appears. " +"(Contributed by Mark Korenberg.)" +msgstr "" + +msgid "" +"The performance of :meth:`StreamReader.readexactly() ` has been improved. (Contributed by Mark Korenberg in :issue:" +"`28370`.)" +msgstr "" + +msgid "" +"The :meth:`loop.getaddrinfo() ` method is " +"optimized to avoid calling the system ``getaddrinfo`` function if the " +"address is already resolved. (Contributed by A. Jesse Jiryu Davis.)" +msgstr "" + +msgid "" +"The :meth:`loop.stop() ` method has been changed to stop " +"the loop immediately after the current iteration. Any new callbacks " +"scheduled as a result of the last iteration will be discarded. (Contributed " +"by Guido van Rossum in :issue:`25593`.)" +msgstr "" + +msgid "" +":meth:`Future.set_exception ` will now " +"raise :exc:`TypeError` when passed an instance of the :exc:`StopIteration` " +"exception. (Contributed by Chris Angelico in :issue:`26221`.)" +msgstr "" + +msgid "" +"New :meth:`loop.connect_accepted_socket() ` method to be used by servers that accept " +"connections outside of asyncio, but that use asyncio to handle them. " +"(Contributed by Jim Fulton in :issue:`27392`.)" +msgstr "" + +msgid "" +"``TCP_NODELAY`` flag is now set for all TCP transports by default. " +"(Contributed by Yury Selivanov in :issue:`27456`.)" +msgstr "" + +msgid "" +"New :meth:`loop.shutdown_asyncgens() ` to " +"properly close pending asynchronous generators before closing the loop. " +"(Contributed by Yury Selivanov in :issue:`28003`.)" +msgstr "" + +msgid "" +":class:`Future ` and :class:`Task ` classes " +"now have an optimized C implementation which makes asyncio code up to 30% " +"faster. (Contributed by Yury Selivanov and INADA Naoki in :issue:`26081` " +"and :issue:`28544`.)" +msgstr "" + +msgid "binascii" +msgstr "" + +msgid "" +"The :func:`~binascii.b2a_base64` function now accepts an optional *newline* " +"keyword argument to control whether the newline character is appended to the " +"return value. (Contributed by Victor Stinner in :issue:`25357`.)" +msgstr "" + +msgid "cmath" +msgstr "" + +msgid "" +"The new :const:`cmath.tau` (*τ*) constant has been added. (Contributed by " +"Lisa Roach in :issue:`12345`, see :pep:`628` for details.)" +msgstr "" + +msgid "" +"New constants: :const:`cmath.inf` and :const:`cmath.nan` to match :const:" +"`math.inf` and :const:`math.nan`, and also :const:`cmath.infj` and :const:" +"`cmath.nanj` to match the format used by complex repr. (Contributed by Mark " +"Dickinson in :issue:`23229`.)" +msgstr "" + +msgid "collections" +msgstr "" + +msgid "" +"The new :class:`~collections.abc.Collection` abstract base class has been " +"added to represent sized iterable container classes. (Contributed by Ivan " +"Levkivskyi, docs by Neil Girdhar in :issue:`27598`.)" +msgstr "" + +msgid "" +"The new :class:`~collections.abc.Reversible` abstract base class represents " +"iterable classes that also provide the :meth:`__reversed__` method. " +"(Contributed by Ivan Levkivskyi in :issue:`25987`.)" +msgstr "" + +msgid "" +"The new :class:`~collections.abc.AsyncGenerator` abstract base class " +"represents asynchronous generators. (Contributed by Yury Selivanov in :issue:" +"`28720`.)" +msgstr "" + +msgid "" +"The :func:`~collections.namedtuple` function now accepts an optional keyword " +"argument *module*, which, when specified, is used for the ``__module__`` " +"attribute of the returned named tuple class. (Contributed by Raymond " +"Hettinger in :issue:`17941`.)" +msgstr "" + +msgid "" +"The *verbose* and *rename* arguments for :func:`~collections.namedtuple` are " +"now keyword-only. (Contributed by Raymond Hettinger in :issue:`25628`.)" +msgstr "" + +msgid "" +"Recursive :class:`collections.deque` instances can now be pickled. " +"(Contributed by Serhiy Storchaka in :issue:`26482`.)" +msgstr "" + +msgid "concurrent.futures" +msgstr "" + +msgid "" +"The :class:`ThreadPoolExecutor ` " +"class constructor now accepts an optional *thread_name_prefix* argument to " +"make it possible to customize the names of the threads created by the pool. " +"(Contributed by Gregory P. Smith in :issue:`27664`.)" +msgstr "" + +msgid "contextlib" +msgstr "" + +msgid "" +"The :class:`contextlib.AbstractContextManager` class has been added to " +"provide an abstract base class for context managers. It provides a sensible " +"default implementation for ``__enter__()`` which returns ``self`` and leaves " +"``__exit__()`` an abstract method. A matching class has been added to the :" +"mod:`typing` module as :class:`typing.ContextManager`. (Contributed by Brett " +"Cannon in :issue:`25609`.)" +msgstr "" + +msgid "datetime" +msgstr "" + +msgid "" +"The :class:`~datetime.datetime` and :class:`~datetime.time` classes have the " +"new :attr:`~time.fold` attribute used to disambiguate local time when " +"necessary. Many functions in the :mod:`datetime` have been updated to " +"support local time disambiguation. See :ref:`Local Time Disambiguation " +"` section for more information. (Contributed by Alexander " +"Belopolsky in :issue:`24773`.)" +msgstr "" + +msgid "" +"The :meth:`datetime.strftime() ` and :meth:`date." +"strftime() ` methods now support ISO 8601 date " +"directives ``%G``, ``%u`` and ``%V``. (Contributed by Ashley Anderson in :" +"issue:`12006`.)" +msgstr "" + +msgid "" +"The :func:`datetime.isoformat() ` function now " +"accepts an optional *timespec* argument that specifies the number of " +"additional components of the time value to include. (Contributed by " +"Alessandro Cucci and Alexander Belopolsky in :issue:`19475`.)" +msgstr "" + +msgid "" +"The :meth:`datetime.combine() ` now accepts an " +"optional *tzinfo* argument. (Contributed by Alexander Belopolsky in :issue:" +"`27661`.)" +msgstr "" + +msgid "decimal" +msgstr "" + +msgid "" +"New :meth:`Decimal.as_integer_ratio() ` " +"method that returns a pair ``(n, d)`` of integers that represent the given :" +"class:`~decimal.Decimal` instance as a fraction, in lowest terms and with a " +"positive denominator::" +msgstr "" + +msgid "(Contributed by Stefan Krah amd Mark Dickinson in :issue:`25928`.)" +msgstr "" + +msgid "distutils" +msgstr "" + +msgid "" +"The ``default_format`` attribute has been removed from :class:`distutils." +"command.sdist.sdist` and the ``formats`` attribute defaults to " +"``['gztar']``. Although not anticipated, any code relying on the presence of " +"``default_format`` may need to be adapted. See :issue:`27819` for more " +"details." +msgstr "" + +msgid "email" +msgstr "" + +msgid "" +"The new email API, enabled via the *policy* keyword to various constructors, " +"is no longer provisional. The :mod:`email` documentation has been " +"reorganized and rewritten to focus on the new API, while retaining the old " +"documentation for the legacy API. (Contributed by R. David Murray in :issue:" +"`24277`.)" +msgstr "" + +msgid "" +"The :mod:`email.mime` classes now all accept an optional *policy* keyword. " +"(Contributed by Berker Peksag in :issue:`27331`.)" +msgstr "" + +msgid "" +"The :class:`~email.generator.DecodedGenerator` now supports the *policy* " +"keyword." +msgstr "" + +msgid "" +"There is a new :mod:`~email.policy` attribute, :attr:`~email.policy.Policy." +"message_factory`, that controls what class is used by default when the " +"parser creates new message objects. For the :attr:`email.policy.compat32` " +"policy this is :class:`~email.message.Message`, for the new policies it is :" +"class:`~email.message.EmailMessage`. (Contributed by R. David Murray in :" +"issue:`20476`.)" +msgstr "" + +msgid "encodings" +msgstr "" + +msgid "" +"On Windows, added the ``'oem'`` encoding to use ``CP_OEMCP``, and the " +"``'ansi'`` alias for the existing ``'mbcs'`` encoding, which uses the " +"``CP_ACP`` code page. (Contributed by Steve Dower in :issue:`27959`.)" +msgstr "" + +msgid "enum" +msgstr "" + +msgid "" +"Two new enumeration base classes have been added to the :mod:`enum` module: :" +"class:`~enum.Flag` and :class:`~enum.IntFlags`. Both are used to define " +"constants that can be combined using the bitwise operators. (Contributed by " +"Ethan Furman in :issue:`23591`.)" +msgstr "" + +msgid "" +"Many standard library modules have been updated to use the :class:`~enum." +"IntFlags` class for their constants." +msgstr "" + +msgid "" +"The new :class:`enum.auto` value can be used to assign values to enum " +"members automatically::" +msgstr "" + +msgid "faulthandler" +msgstr "" + +msgid "" +"On Windows, the :mod:`faulthandler` module now installs a handler for " +"Windows exceptions: see :func:`faulthandler.enable`. (Contributed by Victor " +"Stinner in :issue:`23848`.)" +msgstr "" + +msgid "fileinput" +msgstr "" + +msgid "" +":func:`~fileinput.hook_encoded` now supports the *errors* argument. " +"(Contributed by Joseph Hackman in :issue:`25788`.)" +msgstr "" + +msgid "hashlib" +msgstr "" + +msgid "" +":mod:`hashlib` supports OpenSSL 1.1.0. The minimum recommend version is " +"1.0.2. (Contributed by Christian Heimes in :issue:`26470`.)" +msgstr "" + +msgid "" +"BLAKE2 hash functions were added to the module. :func:`~hashlib.blake2b` " +"and :func:`~hashlib.blake2s` are always available and support the full " +"feature set of BLAKE2. (Contributed by Christian Heimes in :issue:`26798` " +"based on code by Dmitry Chestnykh and Samuel Neves. Documentation written by " +"Dmitry Chestnykh.)" +msgstr "" + +msgid "" +"The SHA-3 hash functions :func:`~hashlib.sha3_224`, :func:`~hashlib." +"sha3_256`, :func:`~hashlib.sha3_384`, :func:`~hashlib.sha3_512`, and SHAKE " +"hash functions :func:`~hashlib.shake_128` and :func:`~hashlib.shake_256` " +"were added. (Contributed by Christian Heimes in :issue:`16113`. Keccak Code " +"Package by Guido Bertoni, Joan Daemen, Michaël Peeters, Gilles Van Assche, " +"and Ronny Van Keer.)" +msgstr "" + +msgid "" +"The password-based key derivation function :func:`~hashlib.scrypt` is now " +"available with OpenSSL 1.1.0 and newer. (Contributed by Christian Heimes in :" +"issue:`27928`.)" +msgstr "" + +msgid "http.client" +msgstr "" + +msgid "" +":meth:`HTTPConnection.request() ` and :" +"meth:`~http.client.HTTPConnection.endheaders` both now support chunked " +"encoding request bodies. (Contributed by Demian Brecht and Rolf Krahl in :" +"issue:`12319`.)" +msgstr "" + +msgid "idlelib and IDLE" +msgstr "" + +msgid "" +"The idlelib package is being modernized and refactored to make IDLE look and " +"work better and to make the code easier to understand, test, and improve. " +"Part of making IDLE look better, especially on Linux and Mac, is using ttk " +"widgets, mostly in the dialogs. As a result, IDLE no longer runs with tcl/" +"tk 8.4. It now requires tcl/tk 8.5 or 8.6. We recommend running the latest " +"release of either." +msgstr "" + +msgid "" +"'Modernizing' includes renaming and consolidation of idlelib modules. The " +"renaming of files with partial uppercase names is similar to the renaming " +"of, for instance, Tkinter and TkFont to tkinter and tkinter.font in 3.0. As " +"a result, imports of idlelib files that worked in 3.5 will usually not work " +"in 3.6. At least a module name change will be needed (see idlelib/README." +"txt), sometimes more. (Name changes contributed by Al Swiegart and Terry " +"Reedy in :issue:`24225`. Most idlelib patches since have been and will be " +"part of the process.)" +msgstr "" + +msgid "" +"In compensation, the eventual result with be that some idlelib classes will " +"be easier to use, with better APIs and docstrings explaining them. " +"Additional useful information will be added to idlelib when available." +msgstr "" + +msgid "New in 3.6.2:" +msgstr "" + +msgid "" +"Multiple fixes for autocompletion. (Contributed by Louie Lu in :issue:" +"`15786`.)" +msgstr "" + +msgid "New in 3.6.3:" +msgstr "" + +msgid "" +"Module Browser (on the File menu, formerly called Class Browser), now " +"displays nested functions and classes in addition to top-level functions and " +"classes. (Contributed by Guilherme Polo, Cheryl Sabella, and Terry Jan Reedy " +"in :issue:`1612262`.)" +msgstr "" + +msgid "" +"The IDLE features formerly implemented as extensions have been reimplemented " +"as normal features. Their settings have been moved from the Extensions tab " +"to other dialog tabs. (Contributed by Charles Wohlganger and Terry Jan Reedy " +"in :issue:`27099`.)" +msgstr "" + +msgid "" +"The Settings dialog (Options, Configure IDLE) has been partly rewritten to " +"improve both appearance and function. (Contributed by Cheryl Sabella and " +"Terry Jan Reedy in multiple issues.)" +msgstr "" + +msgid "New in 3.6.4:" +msgstr "" + +msgid "" +"The font sample now includes a selection of non-Latin characters so that " +"users can better see the effect of selecting a particular font. (Contributed " +"by Terry Jan Reedy in :issue:`13802`.) The sample can be edited to include " +"other characters. (Contributed by Serhiy Storchaka in :issue:`31860`.)" +msgstr "" + +msgid "New in 3.6.6:" +msgstr "" + +msgid "" +"Editor code context option revised. Box displays all context lines up to " +"maxlines. Clicking on a context line jumps the editor to that line. " +"Context colors for custom themes is added to Highlights tab of Settings " +"dialog. (Contributed by Cheryl Sabella and Terry Jan Reedy in :issue:" +"`33642`, :issue:`33768`, and :issue:`33679`.)" +msgstr "" + +msgid "" +"On Windows, a new API call tells Windows that tk scales for DPI. On Windows " +"8.1+ or 10, with DPI compatibility properties of the Python binary " +"unchanged, and a monitor resolution greater than 96 DPI, this should make " +"text and lines sharper. It should otherwise have no effect. (Contributed by " +"Terry Jan Reedy in :issue:`33656`.)" +msgstr "" + +msgid "New in 3.6.7:" +msgstr "" + +msgid "" +"Output over N lines (50 by default) is squeezed down to a button. N can be " +"changed in the PyShell section of the General page of the Settings dialog. " +"Fewer, but possibly extra long, lines can be squeezed by right clicking on " +"the output. Squeezed output can be expanded in place by double-clicking the " +"button or into the clipboard or a separate window by right-clicking the " +"button. (Contributed by Tal Einat in :issue:`1529353`.)" +msgstr "" + +msgid "importlib" +msgstr "" + +msgid "" +"Import now raises the new exception :exc:`ModuleNotFoundError` (subclass of :" +"exc:`ImportError`) when it cannot find a module. Code that current checks " +"for ``ImportError`` (in try-except) will still work. (Contributed by Eric " +"Snow in :issue:`15767`.)" +msgstr "" + +msgid "" +":class:`importlib.util.LazyLoader` now calls :meth:`~importlib.abc.Loader." +"create_module` on the wrapped loader, removing the restriction that :class:" +"`importlib.machinery.BuiltinImporter` and :class:`importlib.machinery." +"ExtensionFileLoader` couldn't be used with :class:`importlib.util." +"LazyLoader`." +msgstr "" + +msgid "" +":func:`importlib.util.cache_from_source`, :func:`importlib.util." +"source_from_cache`, and :func:`importlib.util.spec_from_file_location` now " +"accept a :term:`path-like object`." +msgstr "" + +msgid "inspect" +msgstr "" + +msgid "" +"The :func:`inspect.signature() ` function now reports the " +"implicit ``.0`` parameters generated by the compiler for comprehension and " +"generator expression scopes as if they were positional-only parameters " +"called ``implicit0``. (Contributed by Jelle Zijlstra in :issue:`19611`.)" +msgstr "" + +msgid "" +"To reduce code churn when upgrading from Python 2.7 and the legacy :func:" +"`inspect.getargspec` API, the previously documented deprecation of :func:" +"`inspect.getfullargspec` has been reversed. While this function is " +"convenient for single/source Python 2/3 code bases, the richer :func:" +"`inspect.signature` interface remains the recommended approach for new code. " +"(Contributed by Nick Coghlan in :issue:`27172`)" +msgstr "" + +msgid "json" +msgstr "json" + +msgid "" +":func:`json.load` and :func:`json.loads` now support binary input. Encoded " +"JSON should be represented using either UTF-8, UTF-16, or UTF-32. " +"(Contributed by Serhiy Storchaka in :issue:`17909`.)" +msgstr "" + +msgid "logging" +msgstr "" + +msgid "" +"The new :meth:`WatchedFileHandler.reopenIfNeeded() ` method has been added to add the ability " +"to check if the log file needs to be reopened. (Contributed by Marian Horban " +"in :issue:`24884`.)" +msgstr "" + +msgid "math" +msgstr "" + +msgid "" +"The tau (*τ*) constant has been added to the :mod:`math` and :mod:`cmath` " +"modules. (Contributed by Lisa Roach in :issue:`12345`, see :pep:`628` for " +"details.)" +msgstr "" + +msgid "multiprocessing" +msgstr "" + +msgid "" +":ref:`Proxy Objects ` returned by :func:" +"`multiprocessing.Manager` can now be nested. (Contributed by Davin Potts in :" +"issue:`6766`.)" +msgstr "" + +msgid "os" +msgstr "" + +msgid "" +"See the summary of :ref:`PEP 519 ` for details on how " +"the :mod:`os` and :mod:`os.path` modules now support :term:`path-like " +"objects `." +msgstr "" + +msgid ":func:`~os.scandir` now supports :class:`bytes` paths on Windows." +msgstr "" + +msgid "" +"A new :meth:`~os.scandir.close` method allows explicitly closing a :func:" +"`~os.scandir` iterator. The :func:`~os.scandir` iterator now supports the :" +"term:`context manager` protocol. If a :func:`scandir` iterator is neither " +"exhausted nor explicitly closed a :exc:`ResourceWarning` will be emitted in " +"its destructor. (Contributed by Serhiy Storchaka in :issue:`25994`.)" +msgstr "" + +msgid "" +"The Linux ``getrandom()`` syscall (get random bytes) is now exposed as the " +"new :func:`os.getrandom` function. (Contributed by Victor Stinner, part of " +"the :pep:`524`)" +msgstr "" + +msgid "pathlib" +msgstr "" + +msgid "" +":mod:`pathlib` now supports :term:`path-like objects `. " +"(Contributed by Brett Cannon in :issue:`27186`.)" +msgstr "" + +msgid "See the summary of :ref:`PEP 519 ` for details." +msgstr "" + +msgid "pdb" +msgstr "" + +msgid "" +"The :class:`~pdb.Pdb` class constructor has a new optional *readrc* argument " +"to control whether ``.pdbrc`` files should be read." +msgstr "" + +msgid "pickle" +msgstr "" + +msgid "" +"Objects that need ``__new__`` called with keyword arguments can now be " +"pickled using :ref:`pickle protocols ` older than protocol " +"version 4. Protocol version 4 already supports this case. (Contributed by " +"Serhiy Storchaka in :issue:`24164`.)" +msgstr "" + +msgid "pickletools" +msgstr "" + +msgid "" +":func:`pickletools.dis()` now outputs the implicit memo index for the " +"``MEMOIZE`` opcode. (Contributed by Serhiy Storchaka in :issue:`25382`.)" +msgstr "" + +msgid "pydoc" +msgstr "" + +msgid "" +"The :mod:`pydoc` module has learned to respect the ``MANPAGER`` environment " +"variable. (Contributed by Matthias Klose in :issue:`8637`.)" +msgstr "" + +msgid "" +":func:`help` and :mod:`pydoc` can now list named tuple fields in the order " +"they were defined rather than alphabetically. (Contributed by Raymond " +"Hettinger in :issue:`24879`.)" +msgstr "" + +msgid "random" +msgstr "" + +msgid "" +"The new :func:`~random.choices` function returns a list of elements of " +"specified size from the given population with optional weights. (Contributed " +"by Raymond Hettinger in :issue:`18844`.)" +msgstr "" + +msgid "re" +msgstr "" + +msgid "" +"Added support of modifier spans in regular expressions. Examples: ``'(?i:" +"p)ython'`` matches ``'python'`` and ``'Python'``, but not ``'PYTHON'``; ``'(?" +"i)g(?-i:v)r'`` matches ``'GvR'`` and ``'gvr'``, but not ``'GVR'``. " +"(Contributed by Serhiy Storchaka in :issue:`433028`.)" +msgstr "" + +msgid "" +"Match object groups can be accessed by ``__getitem__``, which is equivalent " +"to ``group()``. So ``mo['name']`` is now equivalent to ``mo." +"group('name')``. (Contributed by Eric Smith in :issue:`24454`.)" +msgstr "" + +msgid "" +":class:`~re.Match` objects now support :meth:`index-like objects ` as group indices. (Contributed by Jeroen Demeyer and Xiang Zhang " +"in :issue:`27177`.)" +msgstr "" + +msgid "readline" +msgstr "" + +msgid "" +"Added :func:`~readline.set_auto_history` to enable or disable automatic " +"addition of input to the history list. (Contributed by Tyler Crompton in :" +"issue:`26870`.)" +msgstr "" + +msgid "rlcompleter" +msgstr "" + +msgid "" +"Private and special attribute names now are omitted unless the prefix starts " +"with underscores. A space or a colon is added after some completed " +"keywords. (Contributed by Serhiy Storchaka in :issue:`25011` and :issue:" +"`25209`.)" +msgstr "" + +msgid "shlex" +msgstr "" + +msgid "" +"The :class:`~shlex.shlex` has much :ref:`improved shell compatibility " +"` through the new *punctuation_chars* argument " +"to control which characters are treated as punctuation. (Contributed by " +"Vinay Sajip in :issue:`1521950`.)" +msgstr "" + +msgid "site" +msgstr "" + +msgid "" +"When specifying paths to add to :data:`sys.path` in a ``.pth`` file, you may " +"now specify file paths on top of directories (e.g. zip files). (Contributed " +"by Wolfgang Langner in :issue:`26587`)." +msgstr "" + +msgid "sqlite3" +msgstr "" + +msgid "" +":attr:`sqlite3.Cursor.lastrowid` now supports the ``REPLACE`` statement. " +"(Contributed by Alex LordThorsen in :issue:`16864`.)" +msgstr "" + +msgid "socket" +msgstr "" + +msgid "" +"The :func:`~socket.socket.ioctl` function now supports the :const:`~socket." +"SIO_LOOPBACK_FAST_PATH` control code. (Contributed by Daniel Stokes in :" +"issue:`26536`.)" +msgstr "" + +msgid "" +"The :meth:`~socket.socket.getsockopt` constants ``SO_DOMAIN``, " +"``SO_PROTOCOL``, ``SO_PEERSEC``, and ``SO_PASSSEC`` are now supported. " +"(Contributed by Christian Heimes in :issue:`26907`.)" +msgstr "" + +msgid "" +"The :meth:`~socket.socket.setsockopt` now supports the ``setsockopt(level, " +"optname, None, optlen: int)`` form. (Contributed by Christian Heimes in :" +"issue:`27744`.)" +msgstr "" + +msgid "" +"The socket module now supports the address family :const:`~socket.AF_ALG` to " +"interface with Linux Kernel crypto API. ``ALG_*``, ``SOL_ALG`` and :meth:" +"`~socket.socket.sendmsg_afalg` were added. (Contributed by Christian Heimes " +"in :issue:`27744` with support from Victor Stinner.)" +msgstr "" + +msgid "" +"New Linux constants ``TCP_USER_TIMEOUT`` and ``TCP_CONGESTION`` were added. " +"(Contributed by Omar Sandoval, :issue:`26273`)." +msgstr "" + +msgid "socketserver" +msgstr "" + +msgid "" +"Servers based on the :mod:`socketserver` module, including those defined in :" +"mod:`http.server`, :mod:`xmlrpc.server` and :mod:`wsgiref.simple_server`, " +"now support the :term:`context manager` protocol. (Contributed by Aviv " +"Palivoda in :issue:`26404`.)" +msgstr "" + +msgid "" +"The :attr:`~socketserver.StreamRequestHandler.wfile` attribute of :class:" +"`~socketserver.StreamRequestHandler` classes now implements the :class:`io." +"BufferedIOBase` writable interface. In particular, calling :meth:`~io." +"BufferedIOBase.write` is now guaranteed to send the data in full. " +"(Contributed by Martin Panter in :issue:`26721`.)" +msgstr "" + +msgid "ssl" +msgstr "" + +msgid "" +":mod:`ssl` supports OpenSSL 1.1.0. The minimum recommend version is 1.0.2. " +"(Contributed by Christian Heimes in :issue:`26470`.)" +msgstr "" + +msgid "" +"3DES has been removed from the default cipher suites and ChaCha20 Poly1305 " +"cipher suites have been added. (Contributed by Christian Heimes in :issue:" +"`27850` and :issue:`27766`.)" +msgstr "" + +msgid "" +":class:`~ssl.SSLContext` has better default configuration for options and " +"ciphers. (Contributed by Christian Heimes in :issue:`28043`.)" +msgstr "" + +msgid "" +"SSL session can be copied from one client-side connection to another with " +"the new :class:`~ssl.SSLSession` class. TLS session resumption can speed up " +"the initial handshake, reduce latency and improve performance (Contributed " +"by Christian Heimes in :issue:`19500` based on a draft by Alex Warhawk.)" +msgstr "" + +msgid "" +"The new :meth:`~ssl.SSLContext.get_ciphers` method can be used to get a list " +"of enabled ciphers in order of cipher priority." +msgstr "" + +msgid "" +"All constants and flags have been converted to :class:`~enum.IntEnum` and :" +"class:`~enum.IntFlags`. (Contributed by Christian Heimes in :issue:`28025`.)" +msgstr "" + +msgid "" +"Server and client-side specific TLS protocols for :class:`~ssl.SSLContext` " +"were added. (Contributed by Christian Heimes in :issue:`28085`.)" +msgstr "" + +msgid "" +"Added :attr:`ssl.SSLContext.post_handshake_auth` to enable and :meth:`ssl." +"SSLSocket.verify_client_post_handshake` to initiate TLS 1.3 post-handshake " +"authentication. (Contributed by Christian Heimes in :gh:`78851`.)" +msgstr "" + +msgid "statistics" +msgstr "" + +msgid "" +"A new :func:`~statistics.harmonic_mean` function has been added. " +"(Contributed by Steven D'Aprano in :issue:`27181`.)" +msgstr "" + +msgid "struct" +msgstr "" + +msgid "" +":mod:`struct` now supports IEEE 754 half-precision floats via the ``'e'`` " +"format specifier. (Contributed by Eli Stevens, Mark Dickinson in :issue:" +"`11734`.)" +msgstr "" + +msgid "subprocess" +msgstr "" + +msgid "" +":class:`subprocess.Popen` destructor now emits a :exc:`ResourceWarning` " +"warning if the child process is still running. Use the context manager " +"protocol (``with proc: ...``) or explicitly call the :meth:`~subprocess." +"Popen.wait` method to read the exit status of the child process. " +"(Contributed by Victor Stinner in :issue:`26741`.)" +msgstr "" + +msgid "" +"The :class:`subprocess.Popen` constructor and all functions that pass " +"arguments through to it now accept *encoding* and *errors* arguments. " +"Specifying either of these will enable text mode for the *stdin*, *stdout* " +"and *stderr* streams. (Contributed by Steve Dower in :issue:`6135`.)" +msgstr "" + +msgid "sys" +msgstr "sys" + +msgid "" +"The new :func:`~sys.getfilesystemencodeerrors` function returns the name of " +"the error mode used to convert between Unicode filenames and bytes " +"filenames. (Contributed by Steve Dower in :issue:`27781`.)" +msgstr "" + +msgid "" +"On Windows the return value of the :func:`~sys.getwindowsversion` function " +"now includes the *platform_version* field which contains the accurate major " +"version, minor version and build number of the current operating system, " +"rather than the version that is being emulated for the process (Contributed " +"by Steve Dower in :issue:`27932`.)" +msgstr "" + +msgid "telnetlib" +msgstr "" + +msgid "" +":class:`~telnetlib.Telnet` is now a context manager (contributed by Stéphane " +"Wirtel in :issue:`25485`)." +msgstr "" + +msgid "time" +msgstr "" + +msgid "" +"The :class:`~time.struct_time` attributes :attr:`tm_gmtoff` and :attr:" +"`tm_zone` are now available on all platforms." +msgstr "" + +msgid "timeit" +msgstr "" + +msgid "" +"The new :meth:`Timer.autorange() ` convenience " +"method has been added to call :meth:`Timer.timeit() ` " +"repeatedly so that the total run time is greater or equal to 200 " +"milliseconds. (Contributed by Steven D'Aprano in :issue:`6422`.)" +msgstr "" + +msgid "" +":mod:`timeit` now warns when there is substantial (4x) variance between best " +"and worst times. (Contributed by Serhiy Storchaka in :issue:`23552`.)" +msgstr "" + +msgid "tkinter" +msgstr "" + +msgid "" +"Added methods :meth:`~tkinter.Variable.trace_add`, :meth:`~tkinter.Variable." +"trace_remove` and :meth:`~tkinter.Variable.trace_info` in the :class:" +"`tkinter.Variable` class. They replace old methods :meth:`~tkinter.Variable." +"trace_variable`, :meth:`~tkinter.Variable.trace`, :meth:`~tkinter.Variable." +"trace_vdelete` and :meth:`~tkinter.Variable.trace_vinfo` that use obsolete " +"Tcl commands and might not work in future versions of Tcl. (Contributed by " +"Serhiy Storchaka in :issue:`22115`)." +msgstr "" + +msgid "traceback" +msgstr "" + +msgid "" +"Both the traceback module and the interpreter's builtin exception display " +"now abbreviate long sequences of repeated lines in tracebacks as shown in " +"the following example::" +msgstr "" + +msgid "(Contributed by Emanuel Barry in :issue:`26823`.)" +msgstr "" + +msgid "tracemalloc" +msgstr "" + +msgid "" +"The :mod:`tracemalloc` module now supports tracing memory allocations in " +"multiple different address spaces." +msgstr "" + +msgid "" +"The new :class:`~tracemalloc.DomainFilter` filter class has been added to " +"filter block traces by their address space (domain)." +msgstr "" + +msgid "(Contributed by Victor Stinner in :issue:`26588`.)" +msgstr "" + +msgid "typing" +msgstr "" + +msgid "" +"Since the :mod:`typing` module is :term:`provisional `, all " +"changes introduced in Python 3.6 have also been backported to Python 3.5.x." +msgstr "" + +msgid "" +"The :mod:`typing` module has a much improved support for generic type " +"aliases. For example ``Dict[str, Tuple[S, T]]`` is now a valid type " +"annotation. (Contributed by Guido van Rossum in `Github #195 `_.)" +msgstr "" + +msgid "" +"The :class:`typing.ContextManager` class has been added for representing :" +"class:`contextlib.AbstractContextManager`. (Contributed by Brett Cannon in :" +"issue:`25609`.)" +msgstr "" + +msgid "" +"The :class:`typing.Collection` class has been added for representing :class:" +"`collections.abc.Collection`. (Contributed by Ivan Levkivskyi in :issue:" +"`27598`.)" +msgstr "" + +msgid "" +"The :const:`typing.ClassVar` type construct has been added to mark class " +"variables. As introduced in :pep:`526`, a variable annotation wrapped in " +"ClassVar indicates that a given attribute is intended to be used as a class " +"variable and should not be set on instances of that class. (Contributed by " +"Ivan Levkivskyi in `Github #280 `_.)" +msgstr "" + +msgid "" +"A new :const:`~typing.TYPE_CHECKING` constant that is assumed to be ``True`` " +"by the static type checkers, but is ``False`` at runtime. (Contributed by " +"Guido van Rossum in `Github #230 `_.)" +msgstr "" + +msgid "" +"A new :func:`~typing.NewType` helper function has been added to create " +"lightweight distinct types for annotations::" +msgstr "" + +msgid "" +"The static type checker will treat the new type as if it were a subclass of " +"the original type. (Contributed by Ivan Levkivskyi in `Github #189 `_.)" +msgstr "" + +msgid "unicodedata" +msgstr "" + +msgid "" +"The :mod:`unicodedata` module now uses data from `Unicode 9.0.0 `_. (Contributed by Benjamin Peterson.)" +msgstr "" + +msgid "unittest.mock" +msgstr "" + +msgid "The :class:`~unittest.mock.Mock` class has the following improvements:" +msgstr "" + +msgid "" +"Two new methods, :meth:`Mock.assert_called() ` and :meth:`Mock.assert_called_once() ` to check if the mock object was called. (Contributed by " +"Amit Saha in :issue:`26323`.)" +msgstr "" + +msgid "" +"The :meth:`Mock.reset_mock() ` method now has " +"two optional keyword only arguments: *return_value* and *side_effect*. " +"(Contributed by Kushal Das in :issue:`21271`.)" +msgstr "" + +msgid "urllib.request" +msgstr "" + +msgid "" +"If a HTTP request has a file or iterable body (other than a bytes object) " +"but no ``Content-Length`` header, rather than throwing an error, :class:" +"`~urllib.request.AbstractHTTPHandler` now falls back to use chunked transfer " +"encoding. (Contributed by Demian Brecht and Rolf Krahl in :issue:`12319`.)" +msgstr "" + +msgid "urllib.robotparser" +msgstr "" + +msgid "" +":class:`~urllib.robotparser.RobotFileParser` now supports the ``Crawl-" +"delay`` and ``Request-rate`` extensions. (Contributed by Nikolay Bogoychev " +"in :issue:`16099`.)" +msgstr "" + +msgid "venv" +msgstr "" + +msgid "" +":mod:`venv` accepts a new parameter ``--prompt``. This parameter provides an " +"alternative prefix for the virtual environment. (Proposed by Łukasz " +"Balcerzak and ported to 3.6 by Stéphane Wirtel in :issue:`22829`.)" +msgstr "" + +msgid "warnings" +msgstr "" + +msgid "" +"A new optional *source* parameter has been added to the :func:`warnings." +"warn_explicit` function: the destroyed object which emitted a :exc:" +"`ResourceWarning`. A *source* attribute has also been added to :class:" +"`warnings.WarningMessage` (contributed by Victor Stinner in :issue:`26568` " +"and :issue:`26567`)." +msgstr "" + +msgid "" +"When a :exc:`ResourceWarning` warning is logged, the :mod:`tracemalloc` " +"module is now used to try to retrieve the traceback where the destroyed " +"object was allocated." +msgstr "" + +msgid "Example with the script ``example.py``::" +msgstr "" + +msgid "Output of the command ``python3.6 -Wd -X tracemalloc=5 example.py``::" +msgstr "" + +msgid "" +"The \"Object allocated at\" traceback is new and is only displayed if :mod:" +"`tracemalloc` is tracing Python memory allocations and if the :mod:" +"`warnings` module was already imported." +msgstr "" + +msgid "winreg" +msgstr "" + +msgid "" +"Added the 64-bit integer type :data:`REG_QWORD `. " +"(Contributed by Clement Rouault in :issue:`23026`.)" +msgstr "" + +msgid "winsound" +msgstr "" + +msgid "" +"Allowed keyword arguments to be passed to :func:`Beep `, :" +"func:`MessageBeep `, and :func:`PlaySound ` (:issue:`27982`)." +msgstr "" + +msgid "xmlrpc.client" +msgstr "" + +msgid "" +"The :mod:`xmlrpc.client` module now supports unmarshalling additional data " +"types used by the Apache XML-RPC implementation for numerics and ``None``. " +"(Contributed by Serhiy Storchaka in :issue:`26885`.)" +msgstr "" + +msgid "zipfile" +msgstr "" + +msgid "" +"A new :meth:`ZipInfo.from_file() ` class method " +"allows making a :class:`~zipfile.ZipInfo` instance from a filesystem file. A " +"new :meth:`ZipInfo.is_dir() ` method can be used to " +"check if the :class:`~zipfile.ZipInfo` instance represents a directory. " +"(Contributed by Thomas Kluyver in :issue:`26039`.)" +msgstr "" + +msgid "" +"The :meth:`ZipFile.open() ` method can now be used to " +"write data into a ZIP file, as well as for extracting data. (Contributed by " +"Thomas Kluyver in :issue:`26039`.)" +msgstr "" + +msgid "zlib" +msgstr "zlib" + +msgid "" +"The :func:`~zlib.compress` and :func:`~zlib.decompress` functions now accept " +"keyword arguments. (Contributed by Aviv Palivoda in :issue:`26243` and Xiang " +"Zhang in :issue:`16764` respectively.)" +msgstr "" + +msgid "Optimizations" +msgstr "" + +msgid "" +"The Python interpreter now uses a 16-bit wordcode instead of bytecode which " +"made a number of opcode optimizations possible. (Contributed by Demur Rumed " +"with input and reviews from Serhiy Storchaka and Victor Stinner in :issue:" +"`26647` and :issue:`28050`.)" +msgstr "" + +msgid "" +"The :class:`asyncio.Future` class now has an optimized C implementation. " +"(Contributed by Yury Selivanov and INADA Naoki in :issue:`26081`.)" +msgstr "" + +msgid "" +"The :class:`asyncio.Task` class now has an optimized C implementation. " +"(Contributed by Yury Selivanov in :issue:`28544`.)" +msgstr "" + +msgid "" +"Various implementation improvements in the :mod:`typing` module (such as " +"caching of generic types) allow up to 30 times performance improvements and " +"reduced memory footprint." +msgstr "" + +msgid "" +"The ASCII decoder is now up to 60 times as fast for error handlers " +"``surrogateescape``, ``ignore`` and ``replace`` (Contributed by Victor " +"Stinner in :issue:`24870`)." +msgstr "" + +msgid "" +"The ASCII and the Latin1 encoders are now up to 3 times as fast for the " +"error handler ``surrogateescape`` (Contributed by Victor Stinner in :issue:" +"`25227`)." +msgstr "" + +msgid "" +"The UTF-8 encoder is now up to 75 times as fast for error handlers " +"``ignore``, ``replace``, ``surrogateescape``, ``surrogatepass`` (Contributed " +"by Victor Stinner in :issue:`25267`)." +msgstr "" + +msgid "" +"The UTF-8 decoder is now up to 15 times as fast for error handlers " +"``ignore``, ``replace`` and ``surrogateescape`` (Contributed by Victor " +"Stinner in :issue:`25301`)." +msgstr "" + +msgid "" +"``bytes % args`` is now up to 2 times faster. (Contributed by Victor Stinner " +"in :issue:`25349`)." +msgstr "" + +msgid "" +"``bytearray % args`` is now between 2.5 and 5 times faster. (Contributed by " +"Victor Stinner in :issue:`25399`)." +msgstr "" + +msgid "" +"Optimize :meth:`bytes.fromhex` and :meth:`bytearray.fromhex`: they are now " +"between 2x and 3.5x faster. (Contributed by Victor Stinner in :issue:" +"`25401`)." +msgstr "" + +msgid "" +"Optimize ``bytes.replace(b'', b'.')`` and ``bytearray.replace(b'', b'.')``: " +"up to 80% faster. (Contributed by Josh Snider in :issue:`26574`)." +msgstr "" + +msgid "" +"Allocator functions of the :c:func:`PyMem_Malloc` domain (:c:macro:" +"`PYMEM_DOMAIN_MEM`) now use the :ref:`pymalloc memory allocator ` " +"instead of :c:func:`malloc` function of the C library. The pymalloc " +"allocator is optimized for objects smaller or equal to 512 bytes with a " +"short lifetime, and use :c:func:`malloc` for larger memory blocks. " +"(Contributed by Victor Stinner in :issue:`26249`)." +msgstr "" + +msgid "" +":func:`pickle.load` and :func:`pickle.loads` are now up to 10% faster when " +"deserializing many small objects (Contributed by Victor Stinner in :issue:" +"`27056`)." +msgstr "" + +msgid "" +"Passing :term:`keyword arguments ` to a function has an " +"overhead in comparison with passing :term:`positional arguments `. Now in extension functions implemented with using Argument " +"Clinic this overhead is significantly decreased. (Contributed by Serhiy " +"Storchaka in :issue:`27574`)." +msgstr "" + +msgid "" +"Optimized :func:`~glob.glob` and :func:`~glob.iglob` functions in the :mod:" +"`glob` module; they are now about 3--6 times faster. (Contributed by Serhiy " +"Storchaka in :issue:`25596`)." +msgstr "" + +msgid "" +"Optimized globbing in :mod:`pathlib` by using :func:`os.scandir`; it is now " +"about 1.5--4 times faster. (Contributed by Serhiy Storchaka in :issue:" +"`26032`)." +msgstr "" + +msgid "" +":class:`xml.etree.ElementTree` parsing, iteration and deepcopy performance " +"has been significantly improved. (Contributed by Serhiy Storchaka in :issue:" +"`25638`, :issue:`25873`, and :issue:`25869`.)" +msgstr "" + +msgid "" +"Creation of :class:`fractions.Fraction` instances from floats and decimals " +"is now 2 to 3 times faster. (Contributed by Serhiy Storchaka in :issue:" +"`25971`.)" +msgstr "" + +msgid "Build and C API Changes" +msgstr "" + +msgid "" +"Python now requires some C99 support in the toolchain to build. Most " +"notably, Python now uses standard integer types and macros in place of " +"custom macros like ``PY_LONG_LONG``. For more information, see :pep:`7` and :" +"issue:`17884`." +msgstr "" + +msgid "" +"Cross-compiling CPython with the Android NDK and the Android API level set " +"to 21 (Android 5.0 Lollipop) or greater runs successfully. While Android is " +"not yet a supported platform, the Python test suite runs on the Android " +"emulator with only about 16 tests failures. See the Android meta-issue :" +"issue:`26865`." +msgstr "" + +msgid "" +"The ``--enable-optimizations`` configure flag has been added. Turning it on " +"will activate expensive optimizations like PGO. (Original patch by " +"Alecsandru Patrascu of Intel in :issue:`26359`.)" +msgstr "" + +msgid "" +"The :term:`GIL ` must now be held when allocator " +"functions of :c:macro:`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) " +"and :c:macro:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) domains are " +"called." +msgstr "" + +msgid "" +"New :c:func:`Py_FinalizeEx` API which indicates if flushing buffered data " +"failed. (Contributed by Martin Panter in :issue:`5319`.)" +msgstr "" + +msgid "" +":c:func:`PyArg_ParseTupleAndKeywords` now supports :ref:`positional-only " +"parameters `. Positional-only parameters are " +"defined by empty names. (Contributed by Serhiy Storchaka in :issue:`26282`)." +msgstr "" + +msgid "" +"``PyTraceback_Print`` method now abbreviates long sequences of repeated " +"lines as ``\"[Previous line repeated {count} more times]\"``. (Contributed " +"by Emanuel Barry in :issue:`26823`.)" +msgstr "" + +msgid "" +"The new :c:func:`PyErr_SetImportErrorSubclass` function allows for " +"specifying a subclass of :exc:`ImportError` to raise. (Contributed by Eric " +"Snow in :issue:`15767`.)" +msgstr "" + +msgid "" +"The new :c:func:`PyErr_ResourceWarning` function can be used to generate a :" +"exc:`ResourceWarning` providing the source of the resource allocation. " +"(Contributed by Victor Stinner in :issue:`26567`.)" +msgstr "" + +msgid "" +"The new :c:func:`PyOS_FSPath` function returns the file system " +"representation of a :term:`path-like object`. (Contributed by Brett Cannon " +"in :issue:`27186`.)" +msgstr "" + +msgid "" +"The :c:func:`PyUnicode_FSConverter` and :c:func:`PyUnicode_FSDecoder` " +"functions will now accept :term:`path-like objects `." +msgstr "" + +msgid "Other Improvements" +msgstr "" + +msgid "" +"When :option:`--version` (short form: :option:`-V`) is supplied twice, " +"Python prints :data:`sys.version` for detailed information." +msgstr "" + +msgid "Deprecated" +msgstr "" + +msgid "New Keywords" +msgstr "" + +msgid "" +"``async`` and ``await`` are not recommended to be used as variable, class, " +"function or module names. Introduced by :pep:`492` in Python 3.5, they will " +"become proper keywords in Python 3.7. Starting in Python 3.6, the use of " +"``async`` or ``await`` as names will generate a :exc:`DeprecationWarning`." +msgstr "" + +msgid "Deprecated Python behavior" +msgstr "" + +msgid "" +"Raising the :exc:`StopIteration` exception inside a generator will now " +"generate a :exc:`DeprecationWarning`, and will trigger a :exc:`RuntimeError` " +"in Python 3.7. See :ref:`whatsnew-pep-479` for details." +msgstr "" + +msgid "" +"The :meth:`__aiter__` method is now expected to return an asynchronous " +"iterator directly instead of returning an awaitable as previously. Doing the " +"former will trigger a :exc:`DeprecationWarning`. Backward compatibility " +"will be removed in Python 3.7. (Contributed by Yury Selivanov in :issue:" +"`27243`.)" +msgstr "" + +msgid "" +"A backslash-character pair that is not a valid escape sequence now generates " +"a :exc:`DeprecationWarning`. Although this will eventually become a :exc:" +"`SyntaxError`, that will not be for several Python releases. (Contributed by " +"Emanuel Barry in :issue:`27364`.)" +msgstr "" + +msgid "" +"When performing a relative import, falling back on ``__name__`` and " +"``__path__`` from the calling module when ``__spec__`` or ``__package__`` " +"are not defined now raises an :exc:`ImportWarning`. (Contributed by Rose " +"Ames in :issue:`25791`.)" +msgstr "" + +msgid "Deprecated Python modules, functions and methods" +msgstr "" + +msgid "asynchat" +msgstr "" + +msgid "" +"The :mod:`asynchat` has been deprecated in favor of :mod:`asyncio`. " +"(Contributed by Mariatta in :issue:`25002`.)" +msgstr "" + +msgid "asyncore" +msgstr "" + +msgid "" +"The :mod:`asyncore` has been deprecated in favor of :mod:`asyncio`. " +"(Contributed by Mariatta in :issue:`25002`.)" +msgstr "" + +msgid "dbm" +msgstr "" + +msgid "" +"Unlike other :mod:`dbm` implementations, the :mod:`dbm.dumb` module creates " +"databases with the ``'rw'`` mode and allows modifying the database opened " +"with the ``'r'`` mode. This behavior is now deprecated and will be removed " +"in 3.8. (Contributed by Serhiy Storchaka in :issue:`21708`.)" +msgstr "" + +msgid "" +"The undocumented ``extra_path`` argument to the :class:`~distutils." +"Distribution` constructor is now considered deprecated and will raise a " +"warning if set. Support for this parameter will be removed in a future " +"Python release. See :issue:`27919` for details." +msgstr "" + +msgid "grp" +msgstr "" + +msgid "" +"The support of non-integer arguments in :func:`~grp.getgrgid` has been " +"deprecated. (Contributed by Serhiy Storchaka in :issue:`26129`.)" +msgstr "" + +msgid "" +"The :meth:`importlib.machinery.SourceFileLoader.load_module` and :meth:" +"`importlib.machinery.SourcelessFileLoader.load_module` methods are now " +"deprecated. They were the only remaining implementations of :meth:`importlib." +"abc.Loader.load_module` in :mod:`importlib` that had not been deprecated in " +"previous versions of Python in favour of :meth:`importlib.abc.Loader." +"exec_module`." +msgstr "" + +msgid "" +"The :class:`importlib.machinery.WindowsRegistryFinder` class is now " +"deprecated. As of 3.6.0, it is still added to :data:`sys.meta_path` by " +"default (on Windows), but this may change in future releases." +msgstr "" + +msgid "" +"Undocumented support of general :term:`bytes-like objects ` as paths in :mod:`os` functions, :func:`compile` and similar " +"functions is now deprecated. (Contributed by Serhiy Storchaka in :issue:" +"`25791` and :issue:`26754`.)" +msgstr "" + +msgid "" +"Support for inline flags ``(?letters)`` in the middle of the regular " +"expression has been deprecated and will be removed in a future Python " +"version. Flags at the start of a regular expression are still allowed. " +"(Contributed by Serhiy Storchaka in :issue:`22493`.)" +msgstr "" + +msgid "" +"OpenSSL 0.9.8, 1.0.0 and 1.0.1 are deprecated and no longer supported. In " +"the future the :mod:`ssl` module will require at least OpenSSL 1.0.2 or " +"1.1.0." +msgstr "" + +msgid "" +"SSL-related arguments like ``certfile``, ``keyfile`` and ``check_hostname`` " +"in :mod:`ftplib`, :mod:`http.client`, :mod:`imaplib`, :mod:`poplib`, and :" +"mod:`smtplib` have been deprecated in favor of ``context``. (Contributed by " +"Christian Heimes in :issue:`28022`.)" +msgstr "" + +msgid "" +"A couple of protocols and functions of the :mod:`ssl` module are now " +"deprecated. Some features will no longer be available in future versions of " +"OpenSSL. Other features are deprecated in favor of a different API. " +"(Contributed by Christian Heimes in :issue:`28022` and :issue:`26470`.)" +msgstr "" + +msgid "" +"The :mod:`tkinter.tix` module is now deprecated. :mod:`tkinter` users " +"should use :mod:`tkinter.ttk` instead." +msgstr "" + +msgid "" +"The ``pyvenv`` script has been deprecated in favour of ``python3 -m venv``. " +"This prevents confusion as to what Python interpreter ``pyvenv`` is " +"connected to and thus what Python interpreter will be used by the virtual " +"environment. (Contributed by Brett Cannon in :issue:`25154`.)" +msgstr "" + +msgid "xml" +msgstr "" + +msgid "" +"As mitigation against DTD and external entity retrieval, the :mod:`xml.dom." +"minidom` and :mod:`xml.sax` modules no longer process external entities by " +"default. (Contributed by Christian Heimes in :gh:`61441`.)" +msgstr "" + +msgid "Deprecated functions and types of the C API" +msgstr "" + +msgid "" +"Undocumented functions :c:func:`!PyUnicode_AsEncodedObject`, :c:func:`!" +"PyUnicode_AsDecodedObject`, :c:func:`!PyUnicode_AsEncodedUnicode` and :c:" +"func:`!PyUnicode_AsDecodedUnicode` are deprecated now. Use the :ref:`generic " +"codec based API ` instead." +msgstr "" + +msgid "Deprecated Build Options" +msgstr "" + +msgid "" +"The ``--with-system-ffi`` configure flag is now on by default on non-macOS " +"UNIX platforms. It may be disabled by using ``--without-system-ffi``, but " +"using the flag is deprecated and will not be accepted in Python 3.7. macOS " +"is unaffected by this change. Note that many OS distributors already use " +"the ``--with-system-ffi`` flag when building their system Python." +msgstr "" + +msgid "Removed" +msgstr "" + +msgid "API and Feature Removals" +msgstr "" + +msgid "" +"Unknown escapes consisting of ``'\\'`` and an ASCII letter in regular " +"expressions will now cause an error. In replacement templates for :func:`re." +"sub` they are still allowed, but deprecated. The :const:`re.LOCALE` flag can " +"now only be used with binary patterns." +msgstr "" + +msgid "" +"``inspect.getmoduleinfo()`` was removed (was deprecated since CPython 3.3). :" +"func:`inspect.getmodulename` should be used for obtaining the module name " +"for a given path. (Contributed by Yury Selivanov in :issue:`13248`.)" +msgstr "" + +msgid "" +"``traceback.Ignore`` class and ``traceback.usage``, ``traceback.modname``, " +"``traceback.fullmodname``, ``traceback.find_lines_from_code``, ``traceback." +"find_lines``, ``traceback.find_strings``, ``traceback." +"find_executable_lines`` methods were removed from the :mod:`traceback` " +"module. They were undocumented methods deprecated since Python 3.2 and " +"equivalent functionality is available from private methods." +msgstr "" + +msgid "" +"The ``tk_menuBar()`` and ``tk_bindForTraversal()`` dummy methods in :mod:" +"`tkinter` widget classes were removed (corresponding Tk commands were " +"obsolete since Tk 4.0)." +msgstr "" + +msgid "" +"The :meth:`~zipfile.ZipFile.open` method of the :class:`zipfile.ZipFile` " +"class no longer supports the ``'U'`` mode (was deprecated since Python 3.4). " +"Use :class:`io.TextIOWrapper` for reading compressed text files in :term:" +"`universal newlines` mode." +msgstr "" + +msgid "" +"The undocumented ``IN``, ``CDROM``, ``DLFCN``, ``TYPES``, ``CDIO``, and " +"``STROPTS`` modules have been removed. They had been available in the " +"platform specific ``Lib/plat-*/`` directories, but were chronically out of " +"date, inconsistently available across platforms, and unmaintained. The " +"script that created these modules is still available in the source " +"distribution at `Tools/scripts/h2py.py `_." +msgstr "" + +msgid "The deprecated ``asynchat.fifo`` class has been removed." +msgstr "" + +msgid "Porting to Python 3.6" +msgstr "" + +msgid "" +"This section lists previously described changes and other bugfixes that may " +"require changes to your code." +msgstr "" + +msgid "Changes in 'python' Command Behavior" +msgstr "" + +msgid "" +"The output of a special Python build with defined ``COUNT_ALLOCS``, " +"``SHOW_ALLOC_COUNT`` or ``SHOW_TRACK_COUNT`` macros is now off by default. " +"It can be re-enabled using the ``-X showalloccount`` option. It now outputs " +"to ``stderr`` instead of ``stdout``. (Contributed by Serhiy Storchaka in :" +"issue:`23034`.)" +msgstr "" + +msgid "Changes in the Python API" +msgstr "" + +msgid "" +":func:`open() ` will no longer allow combining the ``'U'`` mode flag " +"with ``'+'``. (Contributed by Jeff Balogh and John O'Connor in :issue:" +"`2091`.)" +msgstr "" + +msgid "" +":mod:`sqlite3` no longer implicitly commits an open transaction before DDL " +"statements." +msgstr "" + +msgid "" +"On Linux, :func:`os.urandom` now blocks until the system urandom entropy " +"pool is initialized to increase the security." +msgstr "" + +msgid "" +"When :meth:`importlib.abc.Loader.exec_module` is defined, :meth:`importlib." +"abc.Loader.create_module` must also be defined." +msgstr "" + +msgid "" +":c:func:`PyErr_SetImportError` now sets :exc:`TypeError` when its **msg** " +"argument is not set. Previously only ``NULL`` was returned." +msgstr "" + +msgid "" +"The format of the :attr:`~codeobject.co_lnotab` attribute of code objects " +"changed to support a negative line number delta. By default, Python does not " +"emit bytecode with a negative line number delta. Functions using :attr:" +"`frame.f_lineno`, ``PyFrame_GetLineNumber()`` or ``PyCode_Addr2Line()`` are " +"not affected. Functions directly decoding :attr:`!co_lnotab` should be " +"updated to use a signed 8-bit integer type for the line number delta, but " +"this is only required to support applications using a negative line number " +"delta. See ``Objects/lnotab_notes.txt`` for the :attr:`!co_lnotab` format " +"and how to decode it, and see the :pep:`511` for the rationale." +msgstr "" + +msgid "" +"The functions in the :mod:`compileall` module now return booleans instead of " +"``1`` or ``0`` to represent success or failure, respectively. Thanks to " +"booleans being a subclass of integers, this should only be an issue if you " +"were doing identity checks for ``1`` or ``0``. See :issue:`25768`." +msgstr "" + +msgid "" +"Reading the :attr:`~urllib.parse.SplitResult.port` attribute of :func:" +"`urllib.parse.urlsplit` and :func:`~urllib.parse.urlparse` results now " +"raises :exc:`ValueError` for out-of-range values, rather than returning :" +"const:`None`. See :issue:`20059`." +msgstr "" + +msgid "" +"The :mod:`imp` module now raises a :exc:`DeprecationWarning` instead of :exc:" +"`PendingDeprecationWarning`." +msgstr "" + +msgid "" +"The following modules have had missing APIs added to their :attr:`__all__` " +"attributes to match the documented APIs: :mod:`calendar`, :mod:`cgi`, :mod:" +"`csv`, :mod:`~xml.etree.ElementTree`, :mod:`enum`, :mod:`fileinput`, :mod:" +"`ftplib`, :mod:`logging`, :mod:`mailbox`, :mod:`mimetypes`, :mod:" +"`optparse`, :mod:`plistlib`, :mod:`smtpd`, :mod:`subprocess`, :mod:" +"`tarfile`, :mod:`threading` and :mod:`wave`. This means they will export " +"new symbols when ``import *`` is used. (Contributed by Joel Taddei and Jacek " +"Kołodziej in :issue:`23883`.)" +msgstr "" + +msgid "" +"When performing a relative import, if ``__package__`` does not compare equal " +"to ``__spec__.parent`` then :exc:`ImportWarning` is raised. (Contributed by " +"Brett Cannon in :issue:`25791`.)" +msgstr "" + +msgid "" +"When a relative import is performed and no parent package is known, then :" +"exc:`ImportError` will be raised. Previously, :exc:`SystemError` could be " +"raised. (Contributed by Brett Cannon in :issue:`18018`.)" +msgstr "" + +msgid "" +"Servers based on the :mod:`socketserver` module, including those defined in :" +"mod:`http.server`, :mod:`xmlrpc.server` and :mod:`wsgiref.simple_server`, " +"now only catch exceptions derived from :exc:`Exception`. Therefore if a " +"request handler raises an exception like :exc:`SystemExit` or :exc:" +"`KeyboardInterrupt`, :meth:`~socketserver.BaseServer.handle_error` is no " +"longer called, and the exception will stop a single-threaded server. " +"(Contributed by Martin Panter in :issue:`23430`.)" +msgstr "" + +msgid "" +":func:`spwd.getspnam` now raises a :exc:`PermissionError` instead of :exc:" +"`KeyError` if the user doesn't have privileges." +msgstr "" + +msgid "" +"The :meth:`socket.socket.close` method now raises an exception if an error " +"(e.g. ``EBADF``) was reported by the underlying system call. (Contributed by " +"Martin Panter in :issue:`26685`.)" +msgstr "" + +msgid "" +"The *decode_data* argument for the :class:`smtpd.SMTPChannel` and :class:" +"`smtpd.SMTPServer` constructors is now ``False`` by default. This means that " +"the argument passed to :meth:`~smtpd.SMTPServer.process_message` is now a " +"bytes object by default, and ``process_message()`` will be passed keyword " +"arguments. Code that has already been updated in accordance with the " +"deprecation warning generated by 3.5 will not be affected." +msgstr "" + +msgid "" +"All optional arguments of the :func:`~json.dump`, :func:`~json.dumps`, :func:" +"`~json.load` and :func:`~json.loads` functions and :class:`~json." +"JSONEncoder` and :class:`~json.JSONDecoder` class constructors in the :mod:" +"`json` module are now :ref:`keyword-only `. " +"(Contributed by Serhiy Storchaka in :issue:`18726`.)" +msgstr "" + +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 "" + +msgid "" +"As part of :pep:`487`, the handling of keyword arguments passed to :class:" +"`type` (other than the metaclass hint, ``metaclass``) is now consistently " +"delegated to :meth:`object.__init_subclass__`. This means that :meth:`type." +"__new__` and :meth:`type.__init__` both now accept arbitrary keyword " +"arguments, but :meth:`object.__init_subclass__` (which is called from :meth:" +"`type.__new__`) will reject them by default. Custom metaclasses accepting " +"additional keyword arguments will need to adjust their calls to :meth:`type." +"__new__` (whether direct or via :class:`super`) accordingly." +msgstr "" + +msgid "" +"In :class:`distutils.command.sdist.sdist`, the ``default_format`` attribute " +"has been removed and is no longer honored. Instead, the gzipped tarfile " +"format is the default on all platforms and no platform-specific selection is " +"made. In environments where distributions are built on Windows and zip " +"distributions are required, configure the project with a ``setup.cfg`` file " +"containing the following:" +msgstr "" + +msgid "" +"This behavior has also been backported to earlier Python versions by " +"Setuptools 26.0.0." +msgstr "" + +msgid "" +"In the :mod:`urllib.request` module and the :meth:`http.client." +"HTTPConnection.request` method, if no Content-Length header field has been " +"specified and the request body is a file object, it is now sent with HTTP " +"1.1 chunked encoding. If a file object has to be sent to a HTTP 1.0 server, " +"the Content-Length value now has to be specified by the caller. (Contributed " +"by Demian Brecht and Rolf Krahl with tweaks from Martin Panter in :issue:" +"`12319`.)" +msgstr "" + +msgid "" +"The :class:`~csv.DictReader` now returns rows of type :class:`~collections." +"OrderedDict`. (Contributed by Steve Holden in :issue:`27842`.)" +msgstr "" + +msgid "" +"The :const:`crypt.METHOD_CRYPT` will no longer be added to ``crypt.methods`` " +"if unsupported by the platform. (Contributed by Victor Stinner in :issue:" +"`25287`.)" +msgstr "" + +msgid "" +"On Linux, :func:`ctypes.util.find_library` now looks in ``LD_LIBRARY_PATH`` " +"for shared libraries. (Contributed by Vinay Sajip in :issue:`9998`.)" +msgstr "" + +msgid "" +"The :class:`imaplib.IMAP4` class now handles flags containing the ``']'`` " +"character in messages sent from the server to improve real-world " +"compatibility. (Contributed by Lita Cho in :issue:`21815`.)" +msgstr "" + +msgid "" +"The :func:`mmap.write() ` function now returns the number of " +"bytes written like other write methods. (Contributed by Jakub Stasiak in :" +"issue:`26335`.)" +msgstr "" + +msgid "" +"The :func:`pkgutil.iter_modules` and :func:`pkgutil.walk_packages` functions " +"now return :class:`~pkgutil.ModuleInfo` named tuples. (Contributed by " +"Ramchandra Apte in :issue:`17211`.)" +msgstr "" + +msgid "" +":func:`re.sub` now raises an error for invalid numerical group references in " +"replacement templates even if the pattern is not found in the string. The " +"error message for invalid group references now includes the group index and " +"the position of the reference. (Contributed by SilentGhost, Serhiy Storchaka " +"in :issue:`25953`.)" +msgstr "" + +msgid "" +":class:`zipfile.ZipFile` will now raise :exc:`NotImplementedError` for " +"unrecognized compression values. Previously a plain :exc:`RuntimeError` was " +"raised. Additionally, calling :class:`~zipfile.ZipFile` methods on a closed " +"ZipFile or calling the :meth:`~zipfile.ZipFile.write` method on a ZipFile " +"created with mode ``'r'`` will raise a :exc:`ValueError`. Previously, a :exc:" +"`RuntimeError` was raised in those scenarios." +msgstr "" + +msgid "" +"when custom metaclasses are combined with zero-argument :func:`super` or " +"direct references from methods to the implicit ``__class__`` closure " +"variable, the implicit ``__classcell__`` namespace entry must now be passed " +"up to ``type.__new__`` for initialisation. Failing to do so will result in " +"a :exc:`DeprecationWarning` in Python 3.6 and a :exc:`RuntimeError` in " +"Python 3.8." +msgstr "" + +msgid "" +"With the introduction of :exc:`ModuleNotFoundError`, import system consumers " +"may start expecting import system replacements to raise that more specific " +"exception when appropriate, rather than the less-specific :exc:" +"`ImportError`. To provide future compatibility with such consumers, " +"implementors of alternative import systems that completely replace :func:" +"`__import__` will need to update their implementations to raise the new " +"subclass when a module can't be found at all. Implementors of compliant " +"plugins to the default import system shouldn't need to make any changes, as " +"the default import system will raise the new subclass when appropriate." +msgstr "" + +msgid "Changes in the C API" +msgstr "" + +msgid "" +"The :c:func:`PyMem_Malloc` allocator family now uses the :ref:`pymalloc " +"allocator ` rather than the system :c:func:`malloc`. Applications " +"calling :c:func:`PyMem_Malloc` without holding the GIL can now crash. Set " +"the :envvar:`PYTHONMALLOC` environment variable to ``debug`` to validate the " +"usage of memory allocators in your application. See :issue:`26249`." +msgstr "" + +msgid "" +":c:func:`Py_Exit` (and the main interpreter) now override the exit status " +"with 120 if flushing buffered data failed. See :issue:`5319`." +msgstr "" + +msgid "CPython bytecode changes" +msgstr "" + +msgid "" +"There have been several major changes to the :term:`bytecode` in Python 3.6." +msgstr "" + +msgid "" +"The Python interpreter now uses a 16-bit wordcode instead of bytecode. " +"(Contributed by Demur Rumed with input and reviews from Serhiy Storchaka and " +"Victor Stinner in :issue:`26647` and :issue:`28050`.)" +msgstr "" + +msgid "" +"The new :opcode:`FORMAT_VALUE` and :opcode:`BUILD_STRING` opcodes as part of " +"the :ref:`formatted string literal ` implementation. " +"(Contributed by Eric Smith in :issue:`25483` and Serhiy Storchaka in :issue:" +"`27078`.)" +msgstr "" + +msgid "" +"The new :opcode:`BUILD_CONST_KEY_MAP` opcode to optimize the creation of " +"dictionaries with constant keys. (Contributed by Serhiy Storchaka in :issue:" +"`27140`.)" +msgstr "" + +msgid "" +"The function call opcodes have been heavily reworked for better performance " +"and simpler implementation. The :opcode:`MAKE_FUNCTION`, :opcode:" +"`CALL_FUNCTION`, :opcode:`CALL_FUNCTION_KW` and :opcode:" +"`BUILD_MAP_UNPACK_WITH_CALL` opcodes have been modified, the new :opcode:" +"`CALL_FUNCTION_EX` and :opcode:`BUILD_TUPLE_UNPACK_WITH_CALL` have been " +"added, and ``CALL_FUNCTION_VAR``, ``CALL_FUNCTION_VAR_KW`` and " +"``MAKE_CLOSURE`` opcodes have been removed. (Contributed by Demur Rumed in :" +"issue:`27095`, and Serhiy Storchaka in :issue:`27213`, :issue:`28257`.)" +msgstr "" + +msgid "" +"The new :opcode:`SETUP_ANNOTATIONS` and :opcode:`STORE_ANNOTATION` opcodes " +"have been added to support the new :term:`variable annotation` syntax. " +"(Contributed by Ivan Levkivskyi in :issue:`27985`.)" +msgstr "" + +msgid "Notable changes in Python 3.6.2" +msgstr "" + +msgid "New ``make regen-all`` build target" +msgstr "" + +msgid "" +"To simplify cross-compilation, and to ensure that CPython can reliably be " +"compiled without requiring an existing version of Python to already be " +"available, the autotools-based build system no longer attempts to implicitly " +"recompile generated files based on file modification times." +msgstr "" + +msgid "" +"Instead, a new ``make regen-all`` command has been added to force " +"regeneration of these files when desired (e.g. after an initial version of " +"Python has already been built based on the pregenerated versions)." +msgstr "" + +msgid "" +"More selective regeneration targets are also defined - see :source:`Makefile." +"pre.in` for details." +msgstr "" + +msgid "(Contributed by Victor Stinner in :issue:`23404`.)" +msgstr "" + +msgid "Removal of ``make touch`` build target" +msgstr "" + +msgid "" +"The ``make touch`` build target previously used to request implicit " +"regeneration of generated files by updating their modification times has " +"been removed." +msgstr "" + +msgid "It has been replaced by the new ``make regen-all`` target." +msgstr "" + +msgid "Notable changes in Python 3.6.4" +msgstr "" + +msgid "" +"The ``PyExc_RecursionErrorInst`` singleton that was part of the public API " +"has been removed as its members being never cleared may cause a segfault " +"during finalization of the interpreter. (Contributed by Xavier de Gaye in :" +"issue:`22898` and :issue:`30697`.)" +msgstr "" + +msgid "Notable changes in Python 3.6.5" +msgstr "" + +msgid "" +"The :func:`locale.localeconv` function now sets temporarily the ``LC_CTYPE`` " +"locale to the ``LC_NUMERIC`` locale in some cases. (Contributed by Victor " +"Stinner in :issue:`31900`.)" +msgstr "" + +msgid "Notable changes in Python 3.6.7" +msgstr "" + +msgid "" +":mod:`xml.dom.minidom` and :mod:`xml.sax` modules no longer process external " +"entities by default. See also :gh:`61441`." +msgstr "" + +msgid "" +"In 3.6.7 the :mod:`tokenize` module now implicitly emits a ``NEWLINE`` token " +"when provided with input that does not have a trailing new line. This " +"behavior now matches what the C tokenizer does internally. (Contributed by " +"Ammar Askar in :issue:`33899`.)" +msgstr "" + +msgid "Notable changes in Python 3.6.10" +msgstr "" + +msgid "" +"Due to significant security concerns, the *reuse_address* parameter of :meth:" +"`asyncio.loop.create_datagram_endpoint` is no longer supported. This is " +"because of the behavior of the socket option ``SO_REUSEADDR`` in UDP. For " +"more details, see the documentation for ``loop.create_datagram_endpoint()``. " +"(Contributed by Kyle Stanley, Antoine Pitrou, and Yury Selivanov in :issue:" +"`37228`.)" +msgstr "" + +msgid "Notable changes in Python 3.6.13" +msgstr "" + +msgid "" +"Earlier Python versions allowed using both ``;`` and ``&`` as query " +"parameter separators in :func:`urllib.parse.parse_qs` and :func:`urllib." +"parse.parse_qsl`. Due to security concerns, and to conform with newer W3C " +"recommendations, this has been changed to allow only a single separator key, " +"with ``&`` as the default. This change also affects :func:`cgi.parse` and :" +"func:`cgi.parse_multipart` as they use the affected functions internally. " +"For more details, please see their respective documentation. (Contributed by " +"Adam Goldschmidt, Senthil Kumaran and Ken Jin in :issue:`42967`.)" +msgstr "" + +msgid "Notable changes in Python 3.6.14" +msgstr "" + +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates RFC 3986, " +"ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are stripped from " +"the URL by the parser :func:`urllib.parse` preventing such attacks. The " +"removal characters are controlled by a new module level variable ``urllib." +"parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" diff --git a/whatsnew/3.7.po b/whatsnew/3.7.po index 6e9c48f8b6..b9a8721aa5 100644 --- a/whatsnew/3.7.po +++ b/whatsnew/3.7.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-30 16:16+0000\n" +"PO-Revision-Date: 2023-05-24 02:24+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,7 +39,7 @@ msgid "" msgstr "" msgid "Summary -- Release Highlights" -msgstr "" +msgstr "Podsumowanie - najważniejsze informacje o wydaniu" msgid "New syntax features:" msgstr "Nowe cechy składni:" @@ -66,7 +65,7 @@ msgid ":mod:`dataclasses`: :ref:`PEP 557 -- Data Classes `" msgstr "" msgid ":ref:`whatsnew37_importlib_resources`" -msgstr "" +msgstr ":ref:`whatsnew37_importlib_resources`" msgid "New built-in features:" msgstr "Nowe wbudowane funkcje:" @@ -402,22 +401,22 @@ msgid "" msgstr "" msgid ":func:`time.clock_gettime_ns`" -msgstr "" +msgstr ":func:`time.clock_gettime_ns`" msgid ":func:`time.clock_settime_ns`" -msgstr "" +msgstr ":func:`time.clock_settime_ns`" msgid ":func:`time.monotonic_ns`" -msgstr "" +msgstr ":func:`time.monotonic_ns`" msgid ":func:`time.perf_counter_ns`" -msgstr "" +msgstr ":func:`time.perf_counter_ns`" msgid ":func:`time.process_time_ns`" -msgstr "" +msgstr ":func:`time.process_time_ns`" msgid ":func:`time.time_ns`" -msgstr "" +msgstr ":func:`time.time_ns`" msgid "The new functions return the number of nanoseconds as an integer value." msgstr "" @@ -627,9 +626,9 @@ msgstr "" msgid "" "In order to better support dynamic creation of stack traces, :class:`types." -"TracebackType` can now be instantiated from Python code, and the ``tb_next`` " -"attribute on :ref:`tracebacks ` is now writable. " -"(Contributed by Nathaniel J. Smith in :issue:`30579`.)" +"TracebackType` can now be instantiated from Python code, and the :attr:" +"`~traceback.tb_next` attribute on :ref:`tracebacks ` is " +"now writable. (Contributed by Nathaniel J. Smith in :issue:`30579`.)" msgstr "" msgid "" @@ -683,7 +682,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid ":pep:`557` -- Data Classes" msgstr "" @@ -713,7 +712,7 @@ msgid "" msgstr "" msgid "Improved Modules" -msgstr "" +msgstr "Ulepszone moduły" msgid "argparse" msgstr "" @@ -1513,14 +1512,14 @@ msgid "" msgstr "" msgid "" -"The :mod:`socket` module now exposes the :data:`socket.TCP_CONGESTION` " -"(Linux 2.6.13), :data:`socket.TCP_USER_TIMEOUT` (Linux 2.6.37), and :data:" +"The :mod:`socket` module now exposes the :const:`socket.TCP_CONGESTION` " +"(Linux 2.6.13), :const:`socket.TCP_USER_TIMEOUT` (Linux 2.6.37), and :const:" "`socket.TCP_NOTSENT_LOWAT` (Linux 3.12) constants. (Contributed by Omar " "Sandoval in :issue:`26273` and Nathaniel J. Smith in :issue:`29728`.)" msgstr "" msgid "" -"Support for :data:`socket.AF_VSOCK` sockets has been added to allow " +"Support for :const:`socket.AF_VSOCK` sockets has been added to allow " "communication between virtual machines and their hosts. (Contributed by " "Cathy Avery in :issue:`27584`.)" msgstr "" @@ -1637,9 +1636,15 @@ msgid "" "`32609`.)" msgstr "" -msgid "string" +msgid "" +"Added :attr:`ssl.SSLContext.post_handshake_auth` to enable and :meth:`ssl." +"SSLSocket.verify_client_post_handshake` to initiate TLS 1.3 post-handshake " +"authentication. (Contributed by Christian Heimes in :gh:`78851`.)" msgstr "" +msgid "string" +msgstr "ciąg znaków" + msgid "" ":class:`string.Template` now lets you to optionally modify the regular " "expression pattern for braced placeholders and non-braced placeholders " @@ -1652,7 +1657,7 @@ msgstr "" msgid "" "The :func:`subprocess.run` function accepts the new *capture_output* keyword " "argument. When true, stdout and stderr will be captured. This is equivalent " -"to passing :data:`subprocess.PIPE` as *stdout* and *stderr* arguments. " +"to passing :const:`subprocess.PIPE` as *stdout* and *stderr* arguments. " "(Contributed by Bo Bayles in :issue:`32102`.)" msgstr "" @@ -1713,18 +1718,18 @@ msgid "New clock identifiers have been added:" msgstr "" msgid "" -":data:`time.CLOCK_BOOTTIME` (Linux): Identical to :data:`time." +":const:`time.CLOCK_BOOTTIME` (Linux): Identical to :const:`time." "CLOCK_MONOTONIC`, except it also includes any time that the system is " "suspended." msgstr "" msgid "" -":data:`time.CLOCK_PROF` (FreeBSD, NetBSD and OpenBSD): High-resolution per-" +":const:`time.CLOCK_PROF` (FreeBSD, NetBSD and OpenBSD): High-resolution per-" "process CPU timer." msgstr "" msgid "" -":data:`time.CLOCK_UPTIME` (FreeBSD, OpenBSD): Time whose absolute value is " +":const:`time.CLOCK_UPTIME` (FreeBSD, OpenBSD): Time whose absolute value is " "the time the system has been running and not suspended, providing accurate " "uptime measurement." msgstr "" @@ -1901,6 +1906,15 @@ msgid "" "(Contributed by Nick Coghlan in :issue:`31975`.)" msgstr "" +msgid "xml" +msgstr "" + +msgid "" +"As mitigation against DTD and external entity retrieval, the :mod:`xml.dom." +"minidom` and :mod:`xml.sax` modules no longer process external entities by " +"default. (Contributed by Christian Heimes in :gh:`61441`.)" +msgstr "" + msgid "xml.etree" msgstr "" @@ -1993,9 +2007,9 @@ msgid "" msgstr "" msgid "" -"The fields :c:member:`name` and :c:member:`doc` of structures :c:type:" +"The fields :c:member:`!name` and :c:member:`!doc` of structures :c:type:" "`PyMemberDef`, :c:type:`PyGetSetDef`, :c:type:`PyStructSequence_Field`, :c:" -"type:`PyStructSequence_Desc`, and :c:type:`wrapperbase` are now of type " +"type:`PyStructSequence_Desc`, and :c:struct:`wrapperbase` are now of type " "``const char *`` rather of ``char *``. (Contributed by Serhiy Storchaka in :" "issue:`28761`.)" msgstr "" @@ -2280,9 +2294,9 @@ msgstr "" msgid "" "Trace hooks may now opt out of receiving the ``line`` and opt into receiving " -"the ``opcode`` events from the interpreter by setting the corresponding new " -"``f_trace_lines`` and ``f_trace_opcodes`` attributes on the frame being " -"traced. (Contributed by Nick Coghlan in :issue:`31344`.)" +"the ``opcode`` events from the interpreter by setting the corresponding new :" +"attr:`~frame.f_trace_lines` and :attr:`~frame.f_trace_opcodes` attributes on " +"the frame being traced. (Contributed by Nick Coghlan in :issue:`31344`.)" msgstr "" msgid "" @@ -2551,9 +2565,8 @@ msgid "" msgstr "" msgid "" -"The ``splitunc()`` function in the :mod:`ntpath` module was deprecated in " -"Python 3.1, and has now been removed. Use the :func:`~os.path.splitdrive` " -"function instead." +"The :func:`!ntpath.splitunc` function was deprecated in Python 3.1, and has " +"now been removed. Use :func:`~os.path.splitdrive` instead." msgstr "" msgid "" @@ -3070,3 +3083,39 @@ msgid "" "For more details, please see their respective documentation. (Contributed by " "Adam Goldschmidt, Senthil Kumaran and Ken Jin in :issue:`42967`.)" msgstr "" + +msgid "Notable changes in Python 3.7.11" +msgstr "" + +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates RFC 3986, " +"ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are stripped from " +"the URL by the parser :func:`urllib.parse` preventing such attacks. The " +"removal characters are controlled by a new module level variable ``urllib." +"parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" + +msgid "Notable security feature in 3.7.14" +msgstr "" + +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" diff --git a/whatsnew/3.8.po b/whatsnew/3.8.po index 700a51a10b..c3b1011463 100644 --- a/whatsnew/3.8.po +++ b/whatsnew/3.8.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 +# Rafael Fontenelle , 2024 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-16 16:11+0000\n" +"PO-Revision-Date: 2023-05-24 02:24+0000\n" +"Last-Translator: Rafael Fontenelle , 2024\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -106,8 +106,8 @@ msgid "" "There is a new function parameter syntax ``/`` to indicate that some " "function parameters must be specified positionally and cannot be used as " "keyword arguments. This is the same notation shown by ``help()`` for C " -"functions annotated with Larry Hastings' :ref:`Argument Clinic ` tool." +"functions annotated with Larry Hastings' `Argument Clinic `__ tool." msgstr "" msgid "" @@ -283,97 +283,97 @@ msgid "New structures:" msgstr "" msgid ":c:type:`PyConfig`" -msgstr "" +msgstr ":c:type:`PyConfig`" msgid ":c:type:`PyPreConfig`" -msgstr "" +msgstr ":c:type:`PyPreConfig`" msgid ":c:type:`PyStatus`" -msgstr "" +msgstr ":c:type:`PyStatus`" msgid ":c:type:`PyWideStringList`" -msgstr "" +msgstr ":c:type:`PyWideStringList`" msgid "New functions:" msgstr "" msgid ":c:func:`PyConfig_Clear`" -msgstr "" +msgstr ":c:func:`PyConfig_Clear`" msgid ":c:func:`PyConfig_InitIsolatedConfig`" -msgstr "" +msgstr ":c:func:`PyConfig_InitIsolatedConfig`" msgid ":c:func:`PyConfig_InitPythonConfig`" -msgstr "" +msgstr ":c:func:`PyConfig_InitPythonConfig`" msgid ":c:func:`PyConfig_Read`" -msgstr "" +msgstr ":c:func:`PyConfig_Read`" msgid ":c:func:`PyConfig_SetArgv`" -msgstr "" +msgstr ":c:func:`PyConfig_SetArgv`" msgid ":c:func:`PyConfig_SetBytesArgv`" -msgstr "" +msgstr ":c:func:`PyConfig_SetBytesArgv`" msgid ":c:func:`PyConfig_SetBytesString`" -msgstr "" +msgstr ":c:func:`PyConfig_SetBytesString`" msgid ":c:func:`PyConfig_SetString`" -msgstr "" +msgstr ":c:func:`PyConfig_SetString`" msgid ":c:func:`PyPreConfig_InitIsolatedConfig`" -msgstr "" +msgstr ":c:func:`PyPreConfig_InitIsolatedConfig`" msgid ":c:func:`PyPreConfig_InitPythonConfig`" -msgstr "" +msgstr ":c:func:`PyPreConfig_InitPythonConfig`" msgid ":c:func:`PyStatus_Error`" -msgstr "" +msgstr ":c:func:`PyStatus_Error`" msgid ":c:func:`PyStatus_Exception`" -msgstr "" +msgstr ":c:func:`PyStatus_Exception`" msgid ":c:func:`PyStatus_Exit`" -msgstr "" +msgstr ":c:func:`PyStatus_Exit`" msgid ":c:func:`PyStatus_IsError`" -msgstr "" +msgstr ":c:func:`PyStatus_IsError`" msgid ":c:func:`PyStatus_IsExit`" -msgstr "" +msgstr ":c:func:`PyStatus_IsExit`" msgid ":c:func:`PyStatus_NoMemory`" -msgstr "" +msgstr ":c:func:`PyStatus_NoMemory`" msgid ":c:func:`PyStatus_Ok`" -msgstr "" +msgstr ":c:func:`PyStatus_Ok`" msgid ":c:func:`PyWideStringList_Append`" -msgstr "" +msgstr ":c:func:`PyWideStringList_Append`" msgid ":c:func:`PyWideStringList_Insert`" -msgstr "" +msgstr ":c:func:`PyWideStringList_Insert`" msgid ":c:func:`Py_BytesMain`" -msgstr "" +msgstr ":c:func:`Py_BytesMain`" msgid ":c:func:`Py_ExitStatusException`" -msgstr "" +msgstr ":c:func:`Py_ExitStatusException`" msgid ":c:func:`Py_InitializeFromConfig`" -msgstr "" +msgstr ":c:func:`Py_InitializeFromConfig`" msgid ":c:func:`Py_PreInitialize`" -msgstr "" +msgstr ":c:func:`Py_PreInitialize`" msgid ":c:func:`Py_PreInitializeFromArgs`" -msgstr "" +msgstr ":c:func:`Py_PreInitializeFromArgs`" msgid ":c:func:`Py_PreInitializeFromBytesArgs`" -msgstr "" +msgstr ":c:func:`Py_PreInitializeFromBytesArgs`" msgid ":c:func:`Py_RunMain`" -msgstr "" +msgstr ":c:func:`Py_RunMain`" msgid "" "This PEP also adds ``_PyRuntimeState.preconfig`` (:c:type:`PyPreConfig` " @@ -465,7 +465,8 @@ msgid "" msgstr "" msgid "" -"Added support of ``\\N{name}`` escapes in :mod:`regular expressions `::" +"Added support of :samp:`\\\\N\\\\{{name}\\\\}` escapes in :mod:`regular " +"expressions `::" msgstr "" msgid "" @@ -593,7 +594,7 @@ msgid "(Contributed by Barry Warsaw and Jason R. Coombs in :issue:`34632`.)" msgstr "" msgid "Improved Modules" -msgstr "" +msgstr "Ulepszone moduły" msgid "ast" msgstr "" @@ -783,10 +784,10 @@ msgstr "" msgid "" "Added new alternate constructors :meth:`datetime.date.fromisocalendar` and :" -"meth:`datetime.datetime.fromisocalendar`, which construct :class:`date` and :" -"class:`datetime` objects respectively from ISO year, week number, and " -"weekday; these are the inverse of each class's ``isocalendar`` method. " -"(Contributed by Paul Ganssle in :issue:`36004`.)" +"meth:`datetime.datetime.fromisocalendar`, which construct :class:`~datetime." +"date` and :class:`~datetime.datetime` objects respectively from ISO year, " +"week number, and weekday; these are the inverse of each class's " +"``isocalendar`` method. (Contributed by Paul Ganssle in :issue:`36004`.)" msgstr "" msgid "functools" @@ -967,7 +968,7 @@ msgid "" msgstr "" msgid "" -"(Suggested by Raymond Hettinger, implemented by Dong-hee Na, and reviewed by " +"(Suggested by Raymond Hettinger, implemented by Donghee Na, and reviewed by " "Vinay Sajip in :issue:`33897`.)" msgstr "" @@ -1338,8 +1339,8 @@ msgid "time" msgstr "" msgid "" -"Added new clock :data:`~time.CLOCK_UPTIME_RAW` for macOS 10.12. (Contributed " -"by Joannah Nanjekye in :issue:`35702`.)" +"Added new clock :const:`~time.CLOCK_UPTIME_RAW` for macOS 10.12. " +"(Contributed by Joannah Nanjekye in :issue:`35702`.)" msgstr "" msgid "typing" @@ -1423,7 +1424,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "venv" msgstr "" @@ -1662,17 +1663,17 @@ msgid ":c:func:`PyObject_INIT`, :c:func:`PyObject_INIT_VAR`" msgstr "" msgid "" -"Private functions: :c:func:`_PyObject_GC_TRACK`, :c:func:" -"`_PyObject_GC_UNTRACK`, :c:func:`_Py_Dealloc`" +"Private functions: :c:func:`!_PyObject_GC_TRACK`, :c:func:`!" +"_PyObject_GC_UNTRACK`, :c:func:`!_Py_Dealloc`" msgstr "" msgid "(Contributed by Victor Stinner in :issue:`35059`.)" msgstr "" msgid "" -"The :c:func:`PyByteArray_Init` and :c:func:`PyByteArray_Fini` functions have " -"been removed. They did nothing since Python 2.7.4 and Python 3.2.0, were " -"excluded from the limited API (stable ABI), and were not documented. " +"The :c:func:`!PyByteArray_Init` and :c:func:`!PyByteArray_Fini` functions " +"have been removed. They did nothing since Python 2.7.4 and Python 3.2.0, " +"were excluded from the limited API (stable ABI), and were not documented. " "(Contributed by Victor Stinner in :issue:`35713`.)" msgstr "" @@ -1733,7 +1734,7 @@ msgid "" msgstr "" msgid "" -":c:func:`Py_SetPath` now sets :data:`sys.executable` to the program full " +":c:func:`!Py_SetPath` now sets :data:`sys.executable` to the program full " "path (:c:func:`Py_GetProgramFullPath`) rather than to the program name (:c:" "func:`Py_GetProgramName`). (Contributed by Victor Stinner in :issue:`38234`.)" msgstr "" @@ -1762,9 +1763,9 @@ msgid "" msgstr "" msgid "" -"The :meth:`__getitem__` methods of :class:`xml.dom.pulldom.DOMEventStream`, :" -"class:`wsgiref.util.FileWrapper` and :class:`fileinput.FileInput` have been " -"deprecated." +"The :meth:`~object.__getitem__` methods of :class:`xml.dom.pulldom." +"DOMEventStream`, :class:`wsgiref.util.FileWrapper` and :class:`fileinput." +"FileInput` have been deprecated." msgstr "" msgid "" @@ -1838,7 +1839,7 @@ msgstr "" msgid "" "The :meth:`~threading.Thread.isAlive()` method of :class:`threading.Thread` " -"has been deprecated. (Contributed by Dong-hee Na in :issue:`35283`.)" +"has been deprecated. (Contributed by Donghee Na in :issue:`35283`.)" msgstr "" msgid "" @@ -2014,7 +2015,7 @@ msgid "" msgstr "" msgid "" -"On AIX, :attr:`sys.platform` doesn't contain the major version anymore. It " +"On AIX, :data:`sys.platform` doesn't contain the major version anymore. It " "is always ``'aix'``, instead of ``'aix3'`` .. ``'aix7'``. Since older " "Python versions include the version number, so it is recommended to always " "use ``sys.platform.startswith('aix')``. (Contributed by M. Felt in :issue:" @@ -2022,13 +2023,12 @@ msgid "" msgstr "" msgid "" -":c:func:`PyEval_AcquireLock` and :c:func:`PyEval_AcquireThread` now " +":c:func:`!PyEval_AcquireLock` and :c:func:`!PyEval_AcquireThread` now " "terminate the current thread if called while the interpreter is finalizing, " "making them consistent with :c:func:`PyEval_RestoreThread`, :c:func:" "`Py_END_ALLOW_THREADS`, and :c:func:`PyGILState_Ensure`. If this behavior is " -"not desired, guard the call by checking :c:func:`_Py_IsFinalizing` or :c:" -"func:`sys.is_finalizing`. (Contributed by Joannah Nanjekye in :issue:" -"`36475`.)" +"not desired, guard the call by checking :c:func:`!_Py_IsFinalizing` or :func:" +"`sys.is_finalizing`. (Contributed by Joannah Nanjekye in :issue:`36475`.)" msgstr "" msgid "Changes in the Python API" @@ -2227,8 +2227,8 @@ msgid "" msgstr "" msgid "" -"The :c:func:`PyEval_ReInitThreads` function has been removed from the C API. " -"It should not be called explicitly: use :c:func:`PyOS_AfterFork_Child` " +"The :c:func:`!PyEval_ReInitThreads` function has been removed from the C " +"API. It should not be called explicitly: use :c:func:`PyOS_AfterFork_Child` " "instead. (Contributed by Victor Stinner in :issue:`36728`.)" msgstr "" @@ -2276,14 +2276,14 @@ msgstr "" msgid "" "Remove :c:macro:`Py_INCREF` on the type object after allocating an instance " -"- if any. This may happen after calling :c:func:`PyObject_New`, :c:func:" +"- if any. This may happen after calling :c:macro:`PyObject_New`, :c:macro:" "`PyObject_NewVar`, :c:func:`PyObject_GC_New`, :c:func:`PyObject_GC_NewVar`, " "or any other custom allocator that uses :c:func:`PyObject_Init` or :c:func:" "`PyObject_INIT`." msgstr "" msgid "Example:" -msgstr "" +msgstr "Przykład:" msgid "" "Ensure that all custom ``tp_dealloc`` functions of heap-allocated types " @@ -2306,7 +2306,7 @@ msgid "" "extension types across feature releases, anymore. A :c:type:`PyTypeObject` " "exported by a third-party extension module is supposed to have all the slots " "expected in the current Python version, including :c:member:`~PyTypeObject." -"tp_finalize` (:const:`Py_TPFLAGS_HAVE_FINALIZE` is not checked anymore " +"tp_finalize` (:c:macro:`Py_TPFLAGS_HAVE_FINALIZE` is not checked anymore " "before reading :c:member:`~PyTypeObject.tp_finalize`)." msgstr "" @@ -2314,8 +2314,9 @@ msgid "(Contributed by Antoine Pitrou in :issue:`32388`.)" msgstr "" msgid "" -"The functions :c:func:`PyNode_AddChild` and :c:func:`PyParser_AddToken` now " -"accept two additional ``int`` arguments *end_lineno* and *end_col_offset*." +"The functions :c:func:`!PyNode_AddChild` and :c:func:`!PyParser_AddToken` " +"now accept two additional ``int`` arguments *end_lineno* and " +"*end_col_offset*." msgstr "" msgid "" @@ -2405,6 +2406,25 @@ msgid "" "`37228`.)" msgstr "" +msgid "Notable changes in Python 3.8.2" +msgstr "" + +msgid "" +"Fixed a regression with the ``ignore`` callback of :func:`shutil.copytree`. " +"The argument types are now str and List[str] again. (Contributed by Manuel " +"Barkhau and Giampaolo Rodola in :gh:`83571`.)" +msgstr "" + +msgid "Notable changes in Python 3.8.3" +msgstr "" + +msgid "" +"The constant values of future flags in the :mod:`__future__` module are " +"updated in order to prevent collision with compiler flags. Previously " +"``PyCF_ALLOW_TOP_LEVEL_AWAIT`` was clashing with ``CO_FUTURE_DIVISION``. " +"(Contributed by Batuhan Taskaya in :gh:`83743`)" +msgstr "" + msgid "Notable changes in Python 3.8.8" msgstr "" @@ -2419,6 +2439,53 @@ msgid "" "Adam Goldschmidt, Senthil Kumaran and Ken Jin in :issue:`42967`.)" msgstr "" +msgid "Notable changes in Python 3.8.9" +msgstr "" + +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +msgid "Notable changes in Python 3.8.10" +msgstr "" + +msgid "macOS 11.0 (Big Sur) and Apple Silicon Mac support" +msgstr "" + +msgid "" +"As of 3.8.10, Python now supports building and running on macOS 11 (Big Sur) " +"and on Apple Silicon Macs (based on the ``ARM64`` architecture). A new " +"universal build variant, ``universal2``, is now available to natively " +"support both ``ARM64`` and ``Intel 64`` in one set of executables. Note that " +"support for \"weaklinking\", building binaries targeted for newer versions " +"of macOS that will also run correctly on older versions by testing at " +"runtime for missing features, is not included in this backport from Python " +"3.9; to support a range of macOS versions, continue to target for and build " +"on the oldest version in the range." +msgstr "" + +msgid "" +"(Originally contributed by Ronald Oussoren and Lawrence D'Anna in :gh:" +"`85272`, with fixes by FX Coudert and Eli Rykoff, and backported to 3.8 by " +"Maxime Bélanger and Ned Deily)" +msgstr "" + +msgid "urllib.parse" +msgstr "" + +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates :rfc:" +"`3986`, ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are " +"stripped from the URL by the parser in :mod:`urllib.parse` preventing such " +"attacks. The removal characters are controlled by a new module level " +"variable ``urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :issue:`43882`)" +msgstr "" + msgid "Notable changes in Python 3.8.12" msgstr "" @@ -2435,3 +2502,32 @@ msgid "" "(Originally contributed by Christian Heimes in :issue:`36384`, and " "backported to 3.8 by Achraf Merzouki.)" msgstr "" + +msgid "Notable security feature in 3.8.14" +msgstr "" + +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" + +msgid "Notable changes in 3.8.17" +msgstr "" + +msgid "" +"The extraction methods in :mod:`tarfile`, and :func:`shutil.unpack_archive`, " +"have a new a *filter* argument that allows limiting tar features than may be " +"surprising or dangerous, such as creating files outside the destination " +"directory. See :ref:`tarfile-extraction-filter` for details. In Python 3.12, " +"use without the *filter* argument will show a :exc:`DeprecationWarning`. In " +"Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " +"Viktorin in :pep:`706`.)" +msgstr "" diff --git a/whatsnew/3.9.po b/whatsnew/3.9.po index a07b576352..3a22f1907c 100644 --- a/whatsnew/3.9.po +++ b/whatsnew/3.9.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Krzysztof Abramowicz, 2022 -# Maciej Olko , 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-12 14:12+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Maciej Olko , 2023\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:24+0000\n" +"Last-Translator: Rafael Fontenelle , 2025\n" "Language-Team: 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,12 +34,10 @@ msgstr "Łukasz Langa" msgid "" "This article explains the new features in Python 3.9, compared to 3.8. " -"Python 3.9 was released on October 5, 2020." +"Python 3.9 was released on October 5, 2020. For full details, see the :ref:" +"`changelog `." msgstr "" -msgid "For full details, see the :ref:`changelog `." -msgstr "Pełne szczegóły znajdziesz w :ref:`changelogu `." - msgid ":pep:`596` - Python 3.9 Release Schedule" msgstr ":pep:`596` - Python 3.9 Release Schedule" @@ -224,7 +220,7 @@ msgid "" msgstr "" msgid "Example::" -msgstr "" +msgstr "Przykład::" msgid "" "See :pep:`584` for a full description. (Contributed by Brandt Bucher in :" @@ -255,7 +251,7 @@ msgid "" msgstr "" msgid "Example:" -msgstr "" +msgstr "Przykład:" msgid "" "See :pep:`585` for more details. (Contributed by Guido van Rossum, Ethan " @@ -401,7 +397,7 @@ msgid "" msgstr "" msgid "Improved Modules" -msgstr "" +msgstr "Ulepszone moduły" msgid "ast" msgstr "" @@ -527,7 +523,7 @@ msgid "" "The :meth:`~datetime.date.isocalendar()` of :class:`datetime.date` and :meth:" "`~datetime.datetime.isocalendar()` of :class:`datetime.datetime` methods now " "returns a :func:`~collections.namedtuple` instead of a :class:`tuple`. " -"(Contributed by Dong-hee Na in :issue:`24416`.)" +"(Contributed by Donghee Na in :issue:`24416`.)" msgstr "" msgid "distutils" @@ -543,8 +539,9 @@ msgid "fcntl" msgstr "" msgid "" -"Added constants :data:`~fcntl.F_OFD_GETLK`, :data:`~fcntl.F_OFD_SETLK` and :" -"data:`~fcntl.F_OFD_SETLKW`. (Contributed by Dong-hee Na in :issue:`38602`.)" +"Added constants :const:`~fcntl.F_OFD_GETLK`, :const:`~fcntl.F_OFD_SETLK` " +"and :const:`~fcntl.F_OFD_SETLKW`. (Contributed by Donghee Na in :issue:" +"`38602`.)" msgstr "" msgid "ftplib" @@ -553,7 +550,7 @@ msgstr "" msgid "" ":class:`~ftplib.FTP` and :class:`~ftplib.FTP_TLS` now raise a :class:" "`ValueError` if the given timeout for their constructor is zero to prevent " -"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:" +"the creation of a non-blocking socket. (Contributed by Donghee Na in :issue:" "`39259`.)" msgstr "" @@ -594,7 +591,7 @@ msgstr "" msgid "" "HTTP status codes ``103 EARLY_HINTS``, ``418 IM_A_TEAPOT`` and ``425 " -"TOO_EARLY`` are added to :class:`http.HTTPStatus`. (Contributed by Dong-hee " +"TOO_EARLY`` are added to :class:`http.HTTPStatus`. (Contributed by Donghee " "Na in :issue:`39509` and Ross Rhodes in :issue:`39507`.)" msgstr "" @@ -651,7 +648,7 @@ msgid "" "*timeout* parameter for their constructors. Also, the :meth:`~imaplib.IMAP4." "open` method now has an optional *timeout* parameter with this change. The " "overridden methods of :class:`~imaplib.IMAP4_SSL` and :class:`~imaplib." -"IMAP4_stream` were applied to this change. (Contributed by Dong-hee Na in :" +"IMAP4_stream` were applied to this change. (Contributed by Donghee Na in :" "issue:`38615`.)" msgstr "" @@ -661,7 +658,7 @@ msgid "" "the server to the authenticated state. This command performs the same " "actions as :meth:`imaplib.IMAP4.close`, except that no messages are " "permanently removed from the currently selected mailbox. (Contributed by " -"Dong-hee Na in :issue:`40375`.)" +"Donghee Na in :issue:`40375`.)" msgstr "" msgid "importlib" @@ -760,7 +757,7 @@ msgstr "" msgid "" ":class:`~nntplib.NNTP` and :class:`~nntplib.NNTP_SSL` now raise a :class:" "`ValueError` if the given timeout for their constructor is zero to prevent " -"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:" +"the creation of a non-blocking socket. (Contributed by Donghee Na in :issue:" "`39259`.)" msgstr "" @@ -768,12 +765,12 @@ msgid "os" msgstr "" msgid "" -"Added :data:`~os.CLD_KILLED` and :data:`~os.CLD_STOPPED` for :attr:" -"`si_code`. (Contributed by Dong-hee Na in :issue:`38493`.)" +"Added :const:`~os.CLD_KILLED` and :const:`~os.CLD_STOPPED` for :attr:" +"`si_code`. (Contributed by Donghee Na in :issue:`38493`.)" msgstr "" msgid "" -"Exposed the Linux-specific :func:`os.pidfd_open` (:issue:`38692`) and :data:" +"Exposed the Linux-specific :func:`os.pidfd_open` (:issue:`38692`) and :const:" "`os.P_PIDFD` (:issue:`38713`) for process management with file descriptors." msgstr "" @@ -814,7 +811,7 @@ msgstr "" msgid "" ":class:`~poplib.POP3` and :class:`~poplib.POP3_SSL` now raise a :class:" "`ValueError` if the given timeout for their constructor is zero to prevent " -"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:" +"the creation of a non-blocking socket. (Contributed by Donghee Na in :issue:" "`39259`.)" msgstr "" @@ -858,26 +855,26 @@ msgstr "" msgid "" ":class:`~smtplib.SMTP` and :class:`~smtplib.SMTP_SSL` now raise a :class:" "`ValueError` if the given timeout for their constructor is zero to prevent " -"the creation of a non-blocking socket. (Contributed by Dong-hee Na in :issue:" +"the creation of a non-blocking socket. (Contributed by Donghee Na in :issue:" "`39259`.)" msgstr "" msgid "" ":class:`~smtplib.LMTP` constructor now has an optional *timeout* parameter. " -"(Contributed by Dong-hee Na in :issue:`39329`.)" +"(Contributed by Donghee Na in :issue:`39329`.)" msgstr "" msgid "socket" msgstr "" msgid "" -"The :mod:`socket` module now exports the :data:`~socket." +"The :mod:`socket` module now exports the :const:`~socket." "CAN_RAW_JOIN_FILTERS` constant on Linux 4.1 and greater. (Contributed by " "Stefan Tatschner and Zackery Spytz in :issue:`25780`.)" msgstr "" msgid "" -"The socket module now supports the :data:`~socket.CAN_J1939` protocol on " +"The socket module now supports the :const:`~socket.CAN_J1939` protocol on " "platforms that support it. (Contributed by Karl Ding in :issue:`40291`.)" msgstr "" @@ -901,7 +898,7 @@ msgid "sys" msgstr "sys" msgid "" -"Added a new :attr:`sys.platlibdir` attribute: name of the platform-specific " +"Added a new :data:`sys.platlibdir` attribute: name of the platform-specific " "library directory. It is used to build the path of standard library and the " "paths of installed extension modules. It is equal to ``\"lib\"`` on most " "platforms. On Fedora and SuSE, it is equal to ``\"lib64\"`` on 64-bit " @@ -910,7 +907,7 @@ msgid "" msgstr "" msgid "" -"Previously, :attr:`sys.stderr` was block-buffered when non-interactive. Now " +"Previously, :data:`sys.stderr` was block-buffered when non-interactive. Now " "``stderr`` defaults to always being line-buffered. (Contributed by Jendrik " "Seipp in :issue:`13601`.)" msgstr "" @@ -1011,7 +1008,7 @@ msgstr "" msgid "" "A number of Python builtins (:class:`range`, :class:`tuple`, :class:`set`, :" "class:`frozenset`, :class:`list`, :class:`dict`) are now sped up by using :" -"pep:`590` vectorcall protocol. (Contributed by Dong-hee Na, Mark Shannon, " +"pep:`590` vectorcall protocol. (Contributed by Donghee Na, Mark Shannon, " "Jeroen Demeyer and Petr Viktorin in :issue:`37207`.)" msgstr "" @@ -1032,7 +1029,7 @@ msgstr "" msgid "" ":term:`floor division` of float operation now has a better performance. Also " "the message of :exc:`ZeroDivisionError` for this operation is updated. " -"(Contributed by Dong-hee Na in :issue:`39434`.)" +"(Contributed by Donghee Na in :issue:`39434`.)" msgstr "" msgid "" @@ -1080,9 +1077,9 @@ msgid "" msgstr "" msgid "" -"The Public C API functions :c:func:`PyParser_SimpleParseStringFlags`, :c:" -"func:`PyParser_SimpleParseStringFlagsFilename`, :c:func:" -"`PyParser_SimpleParseFileFlags` and :c:func:`PyNode_Compile` are deprecated " +"The Public C API functions :c:func:`!PyParser_SimpleParseStringFlags`, :c:" +"func:`!PyParser_SimpleParseStringFlagsFilename`, :c:func:`!" +"PyParser_SimpleParseFileFlags` and :c:func:`!PyNode_Compile` are deprecated " "and will be removed in Python 3.10 together with the old parser." msgstr "" @@ -1152,11 +1149,11 @@ msgid "" msgstr "" msgid "" -"The :c:func:`PyEval_InitThreads` and :c:func:`PyEval_ThreadsInitialized` " +"The :c:func:`!PyEval_InitThreads` and :c:func:`!PyEval_ThreadsInitialized` " "functions are now deprecated and will be removed in Python 3.11. Calling :c:" -"func:`PyEval_InitThreads` now does nothing. The :term:`GIL` is initialized " -"by :c:func:`Py_Initialize()` since Python 3.7. (Contributed by Victor " -"Stinner in :issue:`39877`.)" +"func:`!PyEval_InitThreads` now does nothing. The :term:`GIL` is initialized " +"by :c:func:`Py_Initialize` since Python 3.7. (Contributed by Victor Stinner " +"in :issue:`39877`.)" msgstr "" msgid "" @@ -1196,7 +1193,7 @@ msgid "" "removed. These methods are deprecated since Python 3.3. Generally, these " "extensions are not supported or not enabled by NNTP server administrators. " "For ``xgtitle()``, please use :meth:`nntplib.NNTP.descriptions` or :meth:" -"`nntplib.NNTP.description` instead. (Contributed by Dong-hee Na in :issue:" +"`nntplib.NNTP.description` instead. (Contributed by Donghee Na in :issue:" "`39366`.)" msgstr "" @@ -1242,7 +1239,7 @@ msgstr "" msgid "" "The :meth:`~threading.Thread.isAlive()` method of :class:`threading.Thread` " "has been removed. It was deprecated since Python 3.8. Use :meth:`~threading." -"Thread.is_alive()` instead. (Contributed by Dong-hee Na in :issue:`37804`.)" +"Thread.is_alive()` instead. (Contributed by Donghee Na in :issue:`37804`.)" msgstr "" msgid "" @@ -1362,7 +1359,7 @@ msgid "" msgstr "" msgid "" -"The :meth:`select.epoll.unregister` method no longer ignores the :data:" +"The :meth:`select.epoll.unregister` method no longer ignores the :const:" "`~errno.EBADF` error. (Contributed by Victor Stinner in :issue:`39239`.)" msgstr "" @@ -1406,10 +1403,10 @@ msgid "" msgstr "" msgid "" -"``array('u')`` now uses ``wchar_t`` as C type instead of ``Py_UNICODE``. " -"This change doesn't affect to its behavior because ``Py_UNICODE`` is alias " -"of ``wchar_t`` since Python 3.3. (Contributed by Inada Naoki in :issue:" -"`34538`.)" +"``array('u')`` now uses :c:type:`wchar_t` as C type instead of " +"``Py_UNICODE``. This change doesn't affect to its behavior because " +"``Py_UNICODE`` is alias of :c:type:`wchar_t` since Python 3.3. (Contributed " +"by Inada Naoki in :issue:`34538`.)" msgstr "" msgid "" @@ -1422,11 +1419,11 @@ msgid "" msgstr "" msgid "" -"Division handling of :class:`~pathlib.PurePath` now returns " -"``NotImplemented`` instead of raising a :exc:`TypeError` when passed " -"something other than an instance of ``str`` or :class:`~pathlib.PurePath`. " -"This allows creating compatible classes that don't inherit from those " -"mentioned types. (Contributed by Roger Aiudi in :issue:`34775`)." +"Division handling of :class:`~pathlib.PurePath` now returns :data:" +"`NotImplemented` instead of raising a :exc:`TypeError` when passed something " +"other than an instance of ``str`` or :class:`~pathlib.PurePath`. This " +"allows creating compatible classes that don't inherit from those mentioned " +"types. (Contributed by Roger Aiudi in :issue:`34775`)." msgstr "" msgid "" @@ -1517,8 +1514,8 @@ msgstr "" msgid "" "Added ``--with-platlibdir`` option to the ``configure`` script: name of the " -"platform-specific library directory, stored in the new :attr:`sys." -"platlibdir` attribute. See :attr:`sys.platlibdir` attribute for more " +"platform-specific library directory, stored in the new :data:`sys." +"platlibdir` attribute. See :data:`sys.platlibdir` attribute for more " "information. (Contributed by Jan Matějek, Matěj Cepl, Charalampos Stratakis " "and Victor Stinner in :issue:`1294959`.)" msgstr "" @@ -1575,7 +1572,7 @@ msgstr "Zmiany w C API" msgid "" ":pep:`573`: Added :c:func:`PyType_FromModuleAndSpec` to associate a module " "with a class; :c:func:`PyType_GetModule` and :c:func:`PyType_GetModuleState` " -"to retrieve the module and its state; and :c:data:`PyCMethod` and :c:data:" +"to retrieve the module and its state; and :c:type:`PyCMethod` and :c:macro:" "`METH_METHOD` to allow a method to access the class it was defined in. " "(Contributed by Marcel Plch and Petr Viktorin in :issue:`38787`.)" msgstr "" @@ -1628,7 +1625,7 @@ msgstr "" msgid "" "The :c:func:`PyModule_AddType` function is added to help adding a type to a " -"module. (Contributed by Dong-hee Na in :issue:`40024`.)" +"module. (Contributed by Donghee Na in :issue:`40024`.)" msgstr "" msgid "" @@ -1699,8 +1696,8 @@ msgstr "" msgid "" "The ``Py_UNICODE_COPY``, ``Py_UNICODE_FILL``, ``PyUnicode_WSTR_LENGTH``, :c:" -"func:`PyUnicode_FromUnicode`, :c:func:`PyUnicode_AsUnicode`, " -"``_PyUnicode_AsUnicode``, and :c:func:`PyUnicode_AsUnicodeAndSize` are " +"func:`!PyUnicode_FromUnicode`, :c:func:`!PyUnicode_AsUnicode`, " +"``_PyUnicode_AsUnicode``, and :c:func:`!PyUnicode_AsUnicodeAndSize` are " "marked as deprecated in C. They have been deprecated by :pep:`393` since " "Python 3.3. (Contributed by Inada Naoki in :issue:`36346`.)" msgstr "" @@ -1725,10 +1722,10 @@ msgid ":c:func:`PyObject_IS_GC` macro was converted to a function." msgstr "" msgid "" -"The :c:func:`PyObject_NEW` macro becomes an alias to the :c:func:" +"The :c:func:`PyObject_NEW` macro becomes an alias to the :c:macro:" "`PyObject_New` macro, and the :c:func:`PyObject_NEW_VAR` macro becomes an " -"alias to the :c:func:`PyObject_NewVar` macro. They no longer access directly " -"the :c:member:`PyTypeObject.tp_basicsize` member." +"alias to the :c:macro:`PyObject_NewVar` macro. They no longer access " +"directly the :c:member:`PyTypeObject.tp_basicsize` member." msgstr "" msgid "" @@ -1773,55 +1770,55 @@ msgid "" msgstr "" msgid "``_Py_CheckRecursionLimit``" -msgstr "" +msgstr "``_Py_CheckRecursionLimit``" msgid "``_Py_NewReference()``" -msgstr "" +msgstr "``_Py_NewReference()``" msgid "``_Py_ForgetReference()``" -msgstr "" +msgstr "``_Py_ForgetReference()``" msgid "``_PyTraceMalloc_NewReference()``" -msgstr "" +msgstr "``_PyTraceMalloc_NewReference()``" msgid "``_Py_GetRefTotal()``" -msgstr "" +msgstr "``_Py_GetRefTotal()``" msgid "The trashcan mechanism which never worked in the limited C API." msgstr "" msgid "``PyTrash_UNWIND_LEVEL``" -msgstr "" +msgstr "``PyTrash_UNWIND_LEVEL``" msgid "``Py_TRASHCAN_BEGIN_CONDITION``" -msgstr "" +msgstr "``Py_TRASHCAN_BEGIN_CONDITION``" msgid "``Py_TRASHCAN_BEGIN``" -msgstr "" +msgstr "``Py_TRASHCAN_BEGIN``" msgid "``Py_TRASHCAN_END``" -msgstr "" +msgstr "``Py_TRASHCAN_END``" msgid "``Py_TRASHCAN_SAFE_BEGIN``" -msgstr "" +msgstr "``Py_TRASHCAN_SAFE_BEGIN``" msgid "``Py_TRASHCAN_SAFE_END``" -msgstr "" +msgstr "``Py_TRASHCAN_SAFE_END``" msgid "Moved following functions and definitions to the internal C API:" msgstr "" msgid "``_PyDebug_PrintTotalRefs()``" -msgstr "" +msgstr "``_PyDebug_PrintTotalRefs()``" msgid "``_Py_PrintReferences()``" -msgstr "" +msgstr "``_Py_PrintReferences()``" msgid "``_Py_PrintReferenceAddresses()``" -msgstr "" +msgstr "``_Py_PrintReferenceAddresses()``" msgid "``_Py_tracemalloc_config``" -msgstr "" +msgstr "``_Py_tracemalloc_config``" msgid "``_Py_AddToAllObjects()`` (specific to ``Py_TRACE_REFS`` build)" msgstr "" @@ -1840,22 +1837,22 @@ msgid "" msgstr "" msgid "``PyAsyncGen_ClearFreeLists()``" -msgstr "" +msgstr "``PyAsyncGen_ClearFreeLists()``" msgid "``PyContext_ClearFreeList()``" -msgstr "" +msgstr "``PyContext_ClearFreeList()``" msgid "``PyDict_ClearFreeList()``" -msgstr "" +msgstr "``PyDict_ClearFreeList()``" msgid "``PyFloat_ClearFreeList()``" -msgstr "" +msgstr "``PyFloat_ClearFreeList()``" msgid "``PyFrame_ClearFreeList()``" -msgstr "" +msgstr "``PyFrame_ClearFreeList()``" msgid "``PyList_ClearFreeList()``" -msgstr "" +msgstr "``PyList_ClearFreeList()``" msgid "" "``PyMethod_ClearFreeList()`` and ``PyCFunction_ClearFreeList()``: the free " @@ -1867,7 +1864,7 @@ msgid "" msgstr "" msgid "``PyTuple_ClearFreeList()``" -msgstr "" +msgstr "``PyTuple_ClearFreeList()``" msgid "" "``PyUnicode_ClearFreeList()``: the Unicode free list has been removed in " @@ -1980,3 +1977,58 @@ msgid "" "For more details, please see their respective documentation. (Contributed by " "Adam Goldschmidt, Senthil Kumaran and Ken Jin in :issue:`42967`.)" msgstr "" + +msgid "Notable changes in Python 3.9.3" +msgstr "" + +msgid "" +"A security fix alters the :class:`ftplib.FTP` behavior to not trust the IPv4 " +"address sent from the remote server when setting up a passive data channel. " +"We reuse the ftp server IP address instead. For unusual code requiring the " +"old behavior, set a ``trust_server_pasv_ipv4_address`` attribute on your FTP " +"instance to ``True``. (See :gh:`87451`)" +msgstr "" + +msgid "Notable changes in Python 3.9.5" +msgstr "" + +msgid "" +"The presence of newline or tab characters in parts of a URL allows for some " +"forms of attacks. Following the WHATWG specification that updates :rfc:" +"`3986`, ASCII newline ``\\n``, ``\\r`` and tab ``\\t`` characters are " +"stripped from the URL by the parser in :mod:`urllib.parse` preventing such " +"attacks. The removal characters are controlled by a new module level " +"variable ``urllib.parse._UNSAFE_URL_BYTES_TO_REMOVE``. (See :gh:`88048`)" +msgstr "" + +msgid "Notable security feature in 3.9.14" +msgstr "" + +msgid "" +"Converting between :class:`int` and :class:`str` in bases other than 2 " +"(binary), 4, 8 (octal), 16 (hexadecimal), or 32 such as base 10 (decimal) " +"now raises a :exc:`ValueError` if the number of digits in string form is " +"above a limit to avoid potential denial of service attacks due to the " +"algorithmic complexity. This is a mitigation for `CVE-2020-10735 `_. This limit can be " +"configured or disabled by environment variable, command line flag, or :mod:" +"`sys` APIs. See the :ref:`integer string conversion length limitation " +"` documentation. The default limit is 4300 digits in " +"string form." +msgstr "" + +msgid "Notable changes in 3.9.17" +msgstr "" + +msgid "tarfile" +msgstr "" + +msgid "" +"The extraction methods in :mod:`tarfile`, and :func:`shutil.unpack_archive`, " +"have a new a *filter* argument that allows limiting tar features than may be " +"surprising or dangerous, such as creating files outside the destination " +"directory. See :ref:`tarfile-extraction-filter` for details. In Python 3.12, " +"use without the *filter* argument will show a :exc:`DeprecationWarning`. In " +"Python 3.14, the default will switch to ``'data'``. (Contributed by Petr " +"Viktorin in :pep:`706`.)" +msgstr "" diff --git a/whatsnew/changelog.po b/whatsnew/changelog.po index 54a915f33b..c1e96e00c3 100644 --- a/whatsnew/changelog.po +++ b/whatsnew/changelog.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2024, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2024-11-22 15:32+0000\n" +"PO-Revision-Date: 2023-05-24 02:24+0000\n" +"Last-Translator: Rafael Fontenelle , 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" diff --git a/whatsnew/index.po b/whatsnew/index.po index b5976a30ba..d5cdb51bad 100644 --- a/whatsnew/index.po +++ b/whatsnew/index.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2025, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# Rafael Fontenelle , 2023 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.11\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-04-28 14:13+0000\n" -"PO-Revision-Date: 2021-06-29 13:04+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2025-05-23 16:05+0000\n" +"PO-Revision-Date: 2023-05-24 02:24+0000\n" +"Last-Translator: Rafael Fontenelle , 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" pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy